Method: acmeChallengeSets.rotateChallenges

Rotate the ACME challenges for a given domain name. By default, removes any challenges that are older than 30 days. Domain names must be provided in Punycode.

HTTP request

POST https://acmedns.googleapis.com/v1/acmeChallengeSets/{rootDomain}:rotateChallenges

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
rootDomain

string

Required. SLD + TLD domain name to update records for. For example, this would be "google.com" for any FQDN under "google.com". That includes challenges for "subdomain.google.com". This MAY be Unicode or Punycode.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "accessToken": string,
  "recordsToAdd": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "recordsToRemove": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "keepExpiredRecords": boolean
}
Fields
accessToken

string (bytes format)

Required. ACME DNS access token. This is a base64 token secret that is procured from the Google Domains website. It authorizes ACME TXT record updates for a domain.

A base64-encoded string.
recordsToAdd[]

object (AcmeTxtRecord)

ACME TXT record challenges to add. Supports multiple challenges on the same FQDN.
recordsToRemove[]

object (AcmeTxtRecord)

ACME TXT record challenges to remove.
keepExpiredRecords

boolean

Keep records older than 30 days that were used for previous requests.

Response body

If successful, the response body contains an instance of AcmeChallengeSet.