letsencrypt/dnsrecords

GET

Gets DNS challenge records for Let’s Encrypt DNS challenge for a specified FQDN.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

DS-SECURITY-KEY:READ

Response Type:

Array

Request Structure

Table 361 Request Query Parameters

Name

Required

Description

fqdn

no

Return only DNS challenge records for the specified FQDN

#856 Request Example
GET /api/4.0/letsencrypt/dnsrecord?fqdn=_acme-challenge.demo1.example.com. HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...

Response Structure

fqdn:

The FQDN for the TXT record location to complete the DNS challenge

record:

The record provided by Let’s Encrypt to complete the DNS challenge

#857 Response Example
HTTP/1.1 200 OK
Content-Type: application/json

{ "response": [
    {
        "fqdn":"_acme-challenge.demo1.example.com.",
        "record":"testRecord"
    }
]}