You need to enable JavaScript to run this app.
导航
RenewInstance - 实例续费
最近更新时间:2025.07.07 14:24:24首次发布时间:2025.07.07 14:20:00
我的收藏
有用
有用
无用
无用

实例续费

使用说明

  1. 此接口仅支持续费符合续费规则的包年包月实例或包月预留实例券
  2. 续费规则可参考续费规则概览--费用中心-火山引擎,机器学习平台暂不支持OpenAPI续费

注意事项

  1. 单账号QPS上限为30
  2. 子用户使用该接口时,应具备BillingCenterFullAccess或BillingCenterRefundAccess权限策略

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Action string %%require%% 示例值:RenewInstance
要执行的操作,取值:RenewInstance。

Version string %%require%% 示例值:2022-01-01
API的版本,取值:2022-01-01。

UnitedExpireDay string 可选 示例值:1
设置统一续费到期日
续费周期为月时,支持设置为每月的1~28号
续费周期为年或日时,不支持

InstanceID string %%require%% 示例值:ins123456780
实例ID

Product string %%require%% 示例值:ecs
商品code

RenewalDurationUnit string %%require%% 示例值:Month
自动续费的周期单位。后付费不返回此字段 年 Year 月 Month 天 Day

RenewalDuration long 可选 示例值:1
续费周期
如果是天,支持:1~365
如果是月,支持:1~12,24,36
如果是年,支持:1~3

RenewRelatedInstance boolean 可选 示例值:true
是否同一实例组内的强关系实例一起续费
true: 同实例组强绑定关系实例一起续
false : 不一起续,若存在强绑定关系实例则报错

ClientToken string 可选 示例值:t12345bvhj
幂等token, (36 字符)多次调用传入同样的值,会返回第一次请求的响应。多次请求使用同一个token 请求内容却发生了变化会报错

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构

SuccessInstanceList object[] 示例值: [ { "InstanceID": "ins23", "Product": "p1" } ]
续费成功实例列表

InstanceID string
实例ID

Product string
商品code

OrderIDList string[] 示例值:["order1"]
订单号列表

请求示例

POST /?Action=RenewInstance&Version=2022-01-01 HTTP/1.1
Host: volcengineapi-boe.byted.org
Content-Type: application/json; charset=UTF-8
X-Date: 20250210T112600Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250210/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "InstanceID": "ins123456780",
  "RenewalTimes": 1,
  "UnitedExpireTime": 1,
  "RenewRelatedInstance": false,
  "ClientToken": "tq4"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250210192609163025253195E9AC22",
    "Action": "RenewInstance",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
  "Result": {
    "OrderIDList": [
      "[\"order1\"]"
    ],
    "SuccessInstanceList": [
      {
        "InstanceID": "qaQ6",
        "Product": "vu"
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
MissingParameter

The request is missing %s parameter.

参数缺失

400
InvalidParam

The parameter %s is invalid.

参数无效

400
InvalidIdempotentParams

ClientToken is illegal.

ClientToken对应的参数发生变更,请更换ClientToken

400
InvalidParam

RenewalTimes and UnitedExpireTime can not both exist.

403
RequestReject

You have engaged in unauthorized operations, and the function is temporarily unavailable.

您涉及违规操作,暂时无法使用该功能

404
RecordNotFound

Record not found

记录未找到

409
IdempotentRequestConflict

The request is already being processed. Please try again later.

幂等冲突

412
CannotRenew

This instance can not be renewed.

存在强绑定关系没有一起续费,续费周期不合法,实例处于其他交付流程等原因无法发起续费

412
StatusWrong

The instance's status is unexpected.

实例状态不符合预期

429
FrequentRequest

Frequent operations, please try again later.

操作频繁,请稍后尝试

500
InternalError

Service has some internal Error. Pls Contact With Admin.

服务内部异常