更新时间:2022-12-16 GMT+08:00

设置包年/包月资源自动续费

功能介绍

为防止资源到期被删除,客户可为长期使用的包年/包月资源开通自动续费。

客户在费用中心开通自动续费请参见这里

  • 首先要客户成功支付包年/包月资源订单,才能进行自动续费的开通。
  • 目前支持设置自动续费的包年/包月产品请参见自动续费规则说明
  • 在调用本接口前,您可以调用“查询客户包年/包月资源列表”接口获取资源ID、资源过期时间以及资源过期后扣费策略等信息。
  • 自动续费将于产品到期前7天的凌晨3:00开始扣款,请保持账户充足。若由于账户中不足等原因导致第一次未扣费成功,系统将每天凌晨3:00尝试进行一次扣款,直到扣款成功或保留产品资源的最后一天。
  • 续费周期与原资源的购买周期一致。

接口约束

该接口只允许使用客户AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/orders/subscriptions/resources/autorenew/{resource_id}

参数说明请参见下表。

表1 路径参数

参数

是否必选

取值范围

描述

resource_id

最大长度:64

资源ID。

您可以调用“查询客户包年/包月资源列表”接口获取资源ID。

设置主资源时会将从资源一起设置,主从关系为:

  • 云主机为主资源,对应的从资源为云硬盘
  • 共享带宽的情况下,带宽为主资源,对应的从资源为弹性IP(可能包含多个IP)
  • 独享带宽的情况下,弹性IP为主资源,对应的从资源为带宽

设置从资源自动续费,主资源也一并续费。

请求消息

请求参数

无。

请求示例

POST https://bss-intl.myhuaweicloud.com/v2/orders/subscriptions/resources/autorenew/eb1cac79-773b-414b-8915-6c3eed8ddf24 HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。

具体请参见状态码

error_msg

String

错误描述信息。

响应示例:

HTTP/1.1 204 No Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time   

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

描述

400

CBC.0100

参数错误。

400

CBC.99003012

资源ID不存在。

400

CBC.99003602

资源已过期或被冻结,不允许自动续费。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。