轮换 EAB

POST

/openapi/v3/acme/eabs/:kid/rotate

轮换 EAB 凭证：作废旧凭证，签发新的 eab_kid + eab_mac_key。本文示例中的 Directory URL 仅为示例地址，以接口实际返回的 directory 为准。

Path 参数

参数	类型	必填	说明
kid	string	是	当前有效 EAB 的 Key ID；不存在或已失效时返回 409

返回数据

参数名称	类型	描述
order_id	string	EAB 绑定的订单 ID
directory	string	该订单的 ACME Directory URL
eab_kid	string	新 EAB Key ID
eab_mac_key	string	新 EAB MAC Key。仅在轮换成功时返回一次，请妥善保存
existing	bool	固定为 false
white_ips	array[string]	新 EAB 继承的 IP 白名单

轮换语义

• 轮换成功后旧 EAB 立即失效，使用旧凭证的 ACME 客户端将无法注册新账户，需用新凭证重新注册。
• 重试或并发提交的多个轮换请求中，只有携带当前有效 kid 的请求会成功一次，其余返回 only_current_active_eab_can_rotate（409）。轮换失败重试前，请先通过创建 ACME EAB 确认当前有效的 eab_kid。

curl -X POST 'https://api.certcloud.cn/openapi/v3/acme/eabs/eab-9f3k2d/rotate' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

const response = await fetch('https://api.certcloud.cn/openapi/v3/acme/eabs/eab-9f3k2d/rotate', {
  method: 'POST',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
})
const data = await response.json()

req, _ := http.NewRequest("POST",
  "https://api.certcloud.cn/openapi/v3/acme/eabs/eab-9f3k2d/rotate", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.post(
    'https://api.certcloud.cn/openapi/v3/acme/eabs/eab-9f3k2d/rotate',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
)
data = response.json()

200成功

{
  "data": {
    "order_id": "TIT6R0qv",
    "directory": "https://acme.example.com/acme/v2/directory",
    "eab_kid": "eab-7h2m9x",
    "eab_mac_key": "bmV3LW1hYy1rZXk",
    "existing": false,
    "white_ips": []
  },
  "code": "success"
}

错误说明

编号	code	HTTP	说明
19505	order_not_found	400	EAB 所属订单不存在，或当前账户无权访问
33020	33020	400	当前订单状态无法生成 ACME EAB（如订单已取消、过期或无可用域名）
33074	33074	400	该产品目前不支持 ACME
33181	order_org_validation_not_passed_for_acme_eab	400	订单组织验证未通过，无法生成 ACME EAB
33185	only_current_active_eab_can_rotate	409	kid 不存在或已失效

通用错误（unauthenticated_request、permission_denied 等）见错误码说明。本接口无接口级限流，仅受全局限流保护。