Customer Operation Capabilities
| Details
  • Registering a Customer (Partner)
    • CheckUserIdentity
    • CreateSubCustomer
    • SendVerificationMessageCode
  • Managing Customers (Partner)
    • FreezeSubCustomers
    • ListSubCustomers
    • UnfreezeSubCustomers
  • Real-Name Authentication (Partner)
    • ChangeEnterpriseRealnameAuthentication
    • CreateEnterpriseRealnameAuthentication
    • CreatePersonalRealnameAuth
    • ShowRealnameAuthenticationReviewResult
  • Managing Coupons (Public)
    • ListSubCustomerCoupons
  • Managing Customer Budgets (Partner)
    • ListSubCustomerBudget
    • ShowSubCustomerBudget
    • UpdateSubCustomerBudget
  • Managing Accounts (Customer)
    • ShowCustomerAccountBalances
  • Purchasing a Cloud Service (Public)
    • ListFreeResourceUsages
    • ListOnDemandResourceRatings
    • ListRateOnPeriodDetail
    • ListRenewRateOnPeriod
  • Managing Yearly/Monthly Orders (Public)
    • ListCustomerOrders
    • ShowCustomerOrderDetails
    • ShowRefundOrderDetails
  • Managing Yearly/Monthly Orders (Customer)
    • AutoRenewalResources
    • CancelAutoRenewalResources
    • CancelCustomerOrder
    • CancelResourcesSubscription
    • ListOrderDiscounts
    • ListPayPerUseCustomerResources
    • PayOrders
    • RenewalResources
    • UpdatePeriodToOnDemand
  • Managing Pay-Per-Use Resources (Partner)
    • ListCustomerOnDemandResources
  • Managing Bills (Partner)
    • ListPostpaidBillSum
  • Managing Bills (Customer)
    • ListCustomerselfResourceRecordDetails
    • ListCustomerselfResourceRecords
    • ListMonthlyExpenditures
  • Managing Enterprise Projects (Customer)
    • CreateEnterpriseProjectAuth
  • Managing Enterprise Accounts (Customer)
    • ListEnterpriseSubCustomers
  • Managing Products (Public)
    • ListConversions
    • ListMeasureUnits
    • ListResourceTypes
    • ListServiceResources
    • ListServiceTypes
    • ListUsageTypes
  • Managing Resource Packages (Customer)
    • ListFreeResourceInfos
    • ListFreeResourcesUsageRecords
  • Managing Huawei Cloud Resellers (Partner)
    • ListIndirectPartners
  • Cost Management (Customer)
    • ListCosts
  • Managing Credits(Partner)
    • ShowPartnerConsumptionQuota
  • Managing Invoices (Public)
    • ListInvoices

RenewalResources

POST
https://bss-intl.myhuaweicloud.com/v2/orders/subscriptions/resources/renew
Advanced
Required parameters only
Default
Encrypt sensitive parameters
*
Region
Headers
*
Authorization
Body
*{
*
resource_ids
: [
+Add
*]
*
period_type
:
*
period_num
:
*
expire_policy
:
*
is_auto_pay
:
}
API Description

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.
Constraints

This API can be invoked only by a customer AK/SK or token.

URL
POST  https://bss-intl.myhuaweicloud.com/v2/orders/subscriptions/resources/renew
Request Parameters
NameTypeINMandatoryDescription
X-Auth-Token
stringheader Yes

Call with customer token

Body Parameters
NameTypeMandatoryDescription
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).

Response Parameters
Status code: 200

RenewalResources Responses

NameTypeDescription
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.

200 fail_resource_infos
NameTypeDescription
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.

Status code: 400

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.

Example Request
Example 1
"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 }
Example Response
Status code: 200

RenewalResources Responses

Example 1
{
"order_ids": [
"CS19040119281JMYC"
],
"fail_resource_infos": []
}
SDK
Click Customer Operation Capabilities (BSSINTL) SDK to download the SDK in your programming language or view the SDK documentation. To learn how to install an SDK and perform authentication, read Usage.
Error Code
Change History
Sep 26, 2024
Renewing Subscription to Yearly/Monthly Resources
POST
   RenewalResources
Modify
Modified Parameters
Jul 11, 2024
Renewing Subscription to Yearly/Monthly Resources
POST
   RenewalResources
Modify
Modified Parameters
May 30, 2024
Renewing Subscription to Yearly/Monthly Resources
POST
   RenewalResources
Modify
Modified Parameters

Outline

API Description
Constraints
URL
Request Parameters
Response Parameters
Example Request
Example Response
SDK
Error Code
Change History