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 511 Request Query Parameters

Name

Required

Description

fqdn

no

Return only DNS challenge records for the specified FQDN

#1242 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

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

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