Method: acmeChallengeSets.rotateChallenges

轮替给定域名的 ACME 验证。默认情况下,系统会移除超过 30 天的挑战。必须在 Punycode 中提供域名。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
rootDomain

string

必需。要为其更新记录的 SLD + TLD 域名。例如,在“google.com”下,任何 FQDN 都是“google.com”。这包括针对“subdomain.google.com”的质疑。这可以是 Unicode 或 Punycode。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "accessToken": string,
  "recordsToAdd": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "recordsToRemove": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "keepExpiredRecords": boolean
}
字段
accessToken

string (bytes format)

必需。ACME DNS 访问令牌。这是从 Google Domains 网站获得的 base64 令牌密钥。它会授权网域的 ACME TXT 记录更新。

使用 base64 编码的字符串。

recordsToAdd[]

object (AcmeTxtRecord)

需要添加 ACME TXT 记录挑战。支持同一 FQDN 中的多个质询。

recordsToRemove[]

object (AcmeTxtRecord)

要移除的 ACME TXT 记录挑战。

keepExpiredRecords

boolean

保留用于先前请求的 30 天之前的记录。

响应正文

如果成功,响应正文将包含一个 AcmeChallengeSet 实例。