续订包年/包月资源(旧)
Web UI
资源即将到期时,已经购买包年/包月产品的客户,可以在费用中心执行续订操作。
- 进入“ 续费管理”页面。
- 设置查询条件。
- 开通了企业项目管理的客户可以设置查询条件筛选该客户下各企业项目的名称,查询各企业项目待续费的资源。
- 单击“设置统一到期日”,可以设置资源的统一到期日,设置资源统一到期日的步骤请参见如何设置统一到期日。
- 可在“手动续费项”、“自动续费项”、“到期转按需项”“到期不续费项”页签查询全部待续费资源。
- 可对“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签的资源进行手动续费的操作。
- 所有需手动续费的资源都可归置到“手动续费项”页签。请参见如何恢复为手动续费。
- 单个续费与批量续费可使用不同的操作方式:
- 进入续费管理页面,默认隐藏有待支付订单的资源,可取消勾选页面中间“隐藏有待支付订单的资源”展示出来。
- 若资源有续费待支付订单,对该资源进行续费时弹出提示:资源有待支付订单,完成支付或取消订单后才能续费订单。可点击提示框的订单号进入订单页面,完成支付或取消该订单后,该资源恢复可续费状态。
- 确认需要续费的资源信息,并设置续费时长,单击“去支付”。
- 选择优惠和支付方式,单击“确认付款”。
REST API
客户在自建平台完成包年/包月资源的续订。
- 该接口只允许使用客户AK/SK或者Token调用。
- 调用接口后,如果某个主资源ID有对应的从资源ID,系统会将主资源ID和从资源ID一起续订,存在主从资源关系的资源为:
- 云主机为主资源,对应的从资源为云硬盘
- 共享带宽的情况下,带宽为主资源,对应的从资源为弹性IP(可能包含多个IP)
- 独享带宽的情况下,弹性IP为主资源,对应的从资源为带宽
- 本接口支持自动支付,自动支付时支持使用折扣、优惠券。支付时使用折扣或优惠券的说明,请参见支付使用折扣或优惠券说明。
- URI
POST /v1.0/{domain_id}/common/order-mgr/resources/renew
参数说明请参见下表。
表1 URI参数说明 参数
是否必选
取值范围
描述
domain_id
是
最大长度:64
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。
- 请求消息
参数
是否必选
参数类型
取值范围
描述
resource_ids
是
List<String>
[1-10]
资源ID列表。
只支持传入主资源ID,最多10个资源ID。
哪些资源是主资源请根据“查询客户包年/包月资源列表(旧)”接口响应参数中的“is_main_resource”来标识。
period_type
是
Integer
[2|3]
周期类型:
- 2:月
- 3:年
period_num
是
Integer
[1-11]
周期数目:
- 如果是月,目前支持1-11
- 如果是年,目前支持1-3
expire_mode
否
Integer
[0-3]
到期策略(字段已废弃,请勿使用):
- 0:进入宽限期
- 1:转按需
- 2:自动退订
- 3:自动续订
isAutoPay
否
Integer
[0-1]
是否自动支付。
- 0:否
- 1:是
不填写的话,默认值是0,不自动支付。自动支付仅仅支持从余额付款。
此参数不携带或携带值为null或携带值为空串时,取值为0;不支持携带值为空。
请求示例POST https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/renew HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "resource_ids": ["53fe*****068b"], "period_type":2, "period_num":2, "expire_mode":0 }
- 响应消息
参数
参数类型
描述
error_code
String
状态码。
具体请参见4。
error_msg
String
错误描述信息。
order_ids
List<String>
续订资源生成的订单ID的列表。
expiredResourceIds
List<string>
因资源过期无法续费的资源列表。
只有错误码为3016时,该参数才有值。
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "order_ids": ["xxxxxxxxxx"], "expiredResouceIds":[] }
- 状态码
- 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
- 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。
HTTP状态码
错误码
描述
200
CBC.0000
成功。
200/400
CBC.0100
参数错误。
500
CBC.0999
其他错误。
403
CBC.0151
访问拒绝。
200
CBC.7281
您的账号已被冻结,无法续订/退订。
200
CBC.3016
存在过期资源。
200
CBC.99003144
资源有处理中的订单,不能进行当前操作。
400
CBC.99003154
资源已购买时长加本次续费时长后已超过最大值,请重新选择续费时长。
200
CBC.3144
资源有处理中的订单,不能进行当前操作。
200
CBC.99003631
退订中/删除中/释放中的资源不能续费。
200
CBC.30010036
续费的资源非主资源,不允许续费。
200
CBC.30010069
不存在的续费周期。
200
CBC.30050006
订单自动支付失败。