轮替给定域名的 ACME 验证。默认情况下,系统会移除超过 30 天的挑战。必须在 Punycode 中提供域名。
HTTP 请求
POST https://acmedns.googleapis.com/v1/acmeChallengeSets/{rootDomain}:rotateChallenges
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
rootDomain |
必需。要为其更新记录的 SLD + TLD 域名。例如,在“google.com”下,任何 FQDN 都是“google.com”。这包括针对“subdomain.google.com”的质疑。这可以是 Unicode 或 Punycode。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "accessToken": string, "recordsToAdd": [ { object ( |
字段 | |
---|---|
accessToken |
必需。ACME DNS 访问令牌。这是从 Google Domains 网站获得的 base64 令牌密钥。它会授权网域的 ACME TXT 记录更新。 使用 base64 编码的字符串。 |
recordsToAdd[] |
需要添加 ACME TXT 记录挑战。支持同一 FQDN 中的多个质询。 |
recordsToRemove[] |
要移除的 ACME TXT 记录挑战。 |
keepExpiredRecords |
保留用于先前请求的 30 天之前的记录。 |
响应正文
如果成功,响应正文将包含一个 AcmeChallengeSet
实例。