You are not logged in.
RenewalResources
When subscription to yearly/monthly resources of a customer is about to expire, the customer can renew the subscription to the resources.
Customers can follow the instructions described in Manually Renewing a Resource to renew the subscription to the yearly/monthly resources in Billing Center.
NOTE:
- If a primary resource has resources attached, the system renews the subscription to both the primary resource and its attached ones after this API is invoked. You can invoke Querying Customer's Yearly/Monthly Resources to obtain the details of the attached resources.
- If a newly purchased EVS disk is attached to an ECS, but this disk is not the attached to any of the ECS primary resources, you must invoke Querying Customer's Yearly/Monthly Resources to obtain the details of the ECS primary resources and its attached ones.
- This API supports automatic payment. For details about how to use discounts or coupons during payment, see Support for Discounts or Coupons.
This API can be invoked only by a customer AK/SK or token.
Name | Type | IN | Mandatory | Description |
---|---|---|---|---|
X-Auth-Token | string | header | Yes | Call with customer token |
Name | Type | Mandatory | Description |
---|---|---|---|
resource_ids | Array of strings | Yes | Resource IDs. Only the primary resource ID is supported. A maximum of 10 resource IDs can be configured. To determine the primary resources, query is_main_resource in the response of the API described in Querying Customer's Yearly/Monthly Resources. |
period_type | integer | Yes | Period type. The value can be: 2: month3: year |
period_num | integer | Yes | Number of periods. Month: 1 to 11Year: 1 to 3 |
expire_policy | integer | No | Expiration policy. This field has been discarded. Do not use this field. This parameter cannot be left empty and needs to be carried. The carried enumeration does not take effect.0: Entering a grace or retention period1: Yearly/monthly to pay-per-use2: Automatic unsubscription3: Automatic renewal |
is_auto_pay | integer | No | Whether enable automatic payment. 0: No1: Yes If this parameter is left empty, default value 0 is used (automatic payment disabled). |
RenewalResources Responses
Name | Type | Description |
---|---|---|
order_ids | Array of strings | List of order IDs generated when resource subscription is renewed. |
fail_resource_infos | Array of FailResourceInfo objects | List of resources that failed to be renewed. This parameter has a value only when there are resources that fail to be renewed. For details, see Table FailResourceInfo.This parameter is reserved. |
Name | Type | Description |
---|---|---|
error_code | string | Status code.For details, see Returned Values.This parameter is reserved. |
error_msg | string | Error description.This parameter is reserved. |
resource_id | string | Resource ID.This parameter is reserved. |
CBC.0100:Parameter error. CBC.99003002:The resource has been locked. CBC.99003004:The resource has dependencies. CBC.99003005:The resource is being provisioned. CBC.99003006:Unsupported cloud service type. CBC.99003638:Subscription to bandwidth add-on packages cannot be renewed. CBC.7281:You cannot renew or cancel subscription because your account has been frozen. CBC.99003016:The resources have expired and been deleted or do not exist. CBC.99003124:Resources have been unsubscribed from. CBC.99003144:Resources have being unsubscribed from or changed. CBC.99003634:Resources in discount packages must be renewed as a whole and cannot be renewed together with other resources.
"POST https://bss-intl.myhuaweicloud.com/v2/orders/subscriptions/resources/renew"
{
"resource_ids": [
"96308d5efd7841b9a4dac673d84d0e14"
],
"period_type": 2,
"period_num": 1,
"expire_policy": 1,
"is_auto_pay": 0
}
RenewalResources Responses
{
"order_ids": [
"CS19040119281JMYC"
],
"fail_resource_infos": []
}