设置包年/包月资源自动续费-AutoRenewalResources
功能介绍
为防止资源到期被删除,客户可为长期使用的包年/包月资源开通自动续费。
客户在费用中心开通自动续费请参见这里。
- 首先要客户成功支付包年/包月资源订单,才能进行自动续费的开通。
- 目前支持设置自动续费的包年/包月产品请参见自动续费规则说明。
- 在调用本接口前,您可以调用“查询客户包年/包月资源列表-ListPayPerUseCustomerResources”接口获取资源ID、资源过期时间以及资源过期后扣费策略等信息。
- 自动续费将于产品到期前7天的凌晨3:00开始扣款,请保持账户余额充足。若由于账户中余额不足等原因导致第一次未扣费成功,系统将每天凌晨3:00尝试进行一次扣款,直到扣款成功或保留产品资源的最后一天。
- 在原资源计费模式下,续费周期为该产品最小售卖周期。
接口约束
该接口只允许使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见策略授权参考。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
描述
访问级别
资源类型(*为必须)
条件键
别名
billing:subscription:renew
授予续费、设置自动续费、设置到期策略、按需转包年/包月的权限
write
-
-
-
URI
POST /v2/orders/subscriptions/resources/autorenew/{resource_id}
参数说明请参见下表。
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource_id | 是 | String | 参数解释: 资源ID。 约束限制: 您可以调用“查询客户包年/包月资源列表-ListPayPerUseCustomerResources”接口获取资源ID。 设置主资源时会将从资源一起设置,主从关系为:
设置从资源自动续费,主资源也一并续费。 取值范围: 最大长度:64 默认取值: 不涉及 |
请求消息
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| auto_renew_times | 否 | Integer | 参数解释: 自动续费次数。在设定的自动续费次数周期完成后,结束自动续费。 约束限制: 首次开通自动续费,此参数不携带或携带值为null时,默认为不限制次数; 已开通自动续费,重置自动续费次数时此参数必填,否则不做处理,不进行修改。 取值范围: [0-99] 说明: 0代表不限制次数。 默认取值: 不涉及 |
| period_type | 否 | String | 参数解释: 自动续费的周期类型 约束限制: 不涉及 取值范围:
默认取值: 此参数不携带或携带值为null时,按照如下规则处理:
|
请求示例
POST https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/autorenew/eb1cac79-773b-414b-8915-6c3eed8ddf24 HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "auto_renew_times": 3, "period_type": "MONTH" }
响应消息
响应参数
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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.30010001 | 您所购买的产品已下架,不支持自动续费。 |
| 400 | CBC.99003012 | 资源ID不存在。 |
| 400 | CBC.99003602 | 资源已过期或被冻结,不允许自动续费。 |
| 400 | CBC.30010097 | 您选择的续费周期该产品暂不支持 |
| 403 | CBC.0151 | 访问拒绝。 |
| 500 | CBC.0999 | 其他错误。 |