API 名称：RenewDomain
API 域名：open.volcengineapi.com
API 描述：对指定的一个域名进行续费。该 API 会创建一个异步任务。您可以使用 GetAsyncTask 查询该任务的状态。
POST
节流限制：您每秒最多可以发送 20 个请求。
每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。
在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：
| 参数名称 | 数据类型 | 必选 | 参数说明 |
|---|---|---|---|
| Action | string | 是 | 表示 API 的名称。该参数的取值是 RenewDomain。 |
| Version | string | 是 | 表示 API 的版本。该参数的取值是 2022-12-12。 |
该 API 的请求参数的类型是请求正文参数。
该 API 的请求参数的类型是请求正文参数。
| 参数名称 | 数据类型 | 必选 | 参数说明 | 示例 |
|---|---|---|---|---|
| domain | string | 是 | 表示需要续费的一个域名。 | example.com |
period | int | 否 | 表示域名需要续费的年数。您可以指定最少 1 年，最大 10 年。 |
|
current_expired_time | int | 是 | 表示域名的过期时间，格式是 Unix 时间戳。 |
|
POST https://open.volcengineapi.com?Version=2022-12-12&Action=RenewDomain { "domain":"example.com", "period":8, "current_expired_time": 1693312998 }
{ "ResponseMetadata": { "RequestId": "20230522152902BF8AE46450333517309F", "Action": "RenewDomain", "Version": "2022-12-12", "Service": "domain_openapi", "Region": "cn-north-1" } "Result": { "task_no": "renew-6f2911508dfb12829" } }
如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见 错误码。