文档中心

域名服务

域名续费

API 说明

API 名称：RenewDomain

API 域名：domain-openapi.volcengineapi.com

API 描述：对指定的一个域名进行续费。该 API 会创建一个异步任务。您可以使用 GetAsyncTask 查询该任务的状态。

请求方法

POST

使用限制

节流限制：您每秒最多可以发送 20 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。

公共参数

在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：

参数名称	数据类型	必选	参数说明
Action	string	是	表示 API 的名称。该参数的取值是 RenewDomain。
Version	string	是	表示 API 的版本。该参数的取值是 2022-12-12。

请求参数

该 API 的请求参数的类型是请求正文参数。

参数名称	数据类型	必选	参数说明	示例
domain	string	是	表示需要续费的一个域名。	example.com
period	int	否	表示域名需要续费的年数。您可以指定最少 1 年，最大 10 年。该参数的默认值是 1。	1
current_expired_time	int	是	表示域名的过期时间，格式是 Unix 时间戳（秒级）。该值应使用 GetDomain 或 ListDomains 返回的 expired_time 字段。如果该参数指定的过期时间与域名的实际过期日期不符，该 API 生成的续费任务会执行失败。建议在调用本 API 前通过 GetDomain 获取最新的 expired_time 值；若续费任务执行失败，请重新获取该值后再调用 RenewDomain。	1693312998

返回参数

参数名称	数据类型	参数说明	示例
task_no	string	任务 ID。	renew-6f2911508dfb12829

请求示例

响应示例

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。

最近更新时间：2026.10.28 19:05:49

这个页面对您有帮助吗？

有用

无用