实例续费
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
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 | 参数缺失 |
400 | InvalidParam | 参数无效 |
400 | InvalidIdempotentParams | ClientToken对应的参数发生变更,请更换ClientToken |
400 | InvalidParam | |
403 | RequestReject | 您涉及违规操作,暂时无法使用该功能 |
404 | RecordNotFound | 记录未找到 |
409 | IdempotentRequestConflict | 幂等冲突 |
412 | CannotRenew | 存在强绑定关系没有一起续费,续费周期不合法,实例处于其他交付流程等原因无法发起续费 |
412 | StatusWrong | 实例状态不符合预期 |
429 | FrequentRequest | 操作频繁,请稍后尝试 |
500 | InternalError | 服务内部异常 |