Help Center > > API Reference> API to Be Brought Offline> Transaction Management> Managing Yearly/Monthly Orders> Resource Management> Unsubscribing from Yearly/Monthly Resources

Unsubscribing from Yearly/Monthly Resources

Updated at: Jun 30, 2020 GMT+08:00

Function

If a customer has subscribed to a yearly/monthly resource, the customer can use this API to unsubscribe from the resource, including the renewed part and currently used part. The customer cannot use the resources after unsubscription.

Web UI

If a customer has subscribed to a yearly/monthly resource, the customer can use this API to unsubscribe from the resource in the Billing Center.

  1. Go to the Unsubscriptions page.
  2. Click the Succeeded Resources tab.
  3. Unsubscribe from resources separately or in batches.

    • Unsubscribe from a single resource: Click Unsubscribe for a resource from which you want to unsubscribe.

    • Batch unsubscribe from resources: Select the target resources from the resource list and click Unsubscribe in the upper left corner of the resource list.

  4. View the unsubscription information, select I have confirmed that a handling fee will be charged for this unsubscription, and click Unsubscribe.

REST API

A customer can unsubscribe from its yearly/monthly resources on the customer platform.

A yearly/monthly resource can be unsubscribed from only after it has been successfully paid and provisioned.

  • This API can be invoked using the customer AK/SK or token only.
  • For details about the cloud service types that support unsubscription, see Cloud Service Types Supported by Yearly/Monthly Resource Subscription Renewal and Unsubscription.
  • After you invoke this API, if a primary resource ID has an attached resource ID, the system will unsubscribe from both the primary resource and attached resource.
    • For example, ECS is the primary resource, and EVS is the attached resource.
    • If the shared bandwidth is used, the bandwidth is the primary resource, and EIPs are the attached resource.
    • If the exclusive bandwidth is used, EIPs are the primary resources, and the bandwidth is the attached resource.
  • This API supports five-day unconditional full refund. For details, see Unsubscription Rules.

  1. URI

    POST /v1.0/{domain_id}/common/order-mgr/resources/delete

    The following table describes the parameters.

    Table 1 URI parameter description

    Parameter

    Mandatory

    Value Range

    Description

    domain_id

    Yes

    A maximum 64 characters

    Customer account ID. For details, see How Do I Obtain customer_id/domain_id Values?.

  1. Request

    Request Parameters

    Parameter

    Mandatory

    Type

    Value Range

    Description

    resourceIds

    Yes

    List<String>

    A maximum 10 IDs

    Resource IDs.

    A maximum of 10 resource IDs can be entered at a time. Only the primary resource IDs can be entered.

    Determine whether a resource is a primary resource based on is_main_resource in the response of the API described in Querying Customer's Yearly/Monthly Resources.

    unSubType

    Yes

    Integer

    [1-2]

    Unsubscription type. The value can be:

    • 1: Unsubscribe from the resource and its renewal periods.
    • 2: Unsubscribe from only the resource renewal periods.

    unsubscribeReasonType

    No

    Integer

    [1-5]

    Unsubscription cause. The value can be:

    • 1: The product is of poor usability.
    • 2: The product functions cannot meet the requirements.
    • 3: Customers do not know how to use the product, or the product operations are complex.
    • 4: Customers are not satisfied with the service.
    • 5: Others

    unsubscribeReason

    No

    String

    A maximum of 512 characters

    Unsubscription reason, which is generally specified by the customer.

    Example Request

    POST https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/delete HTTP/1.1
    Content-Type: application/json
    X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
    
    {
      "resourceIds": ["53fa7828774df68b","72a256456xdf45g"],
      "unSubType":2,
      "unsubscribeReasonType":2,
      "unsubscribeReason":"xxxxxxx"
    }

  1. Response

    Response Parameters

    Parameter

    Type

    Description

    error_code

    String

    Status code.

    For details, see 4.

    error_msg

    String

    Error description.

    orderIds

    List<String>

    Unsubscription order IDs.

    Example Response

    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",
        "orderIds": ["xxxxxxxxxx"]
    }

  1. Returned Values

    Status Code

    Description

    CBC.0000

    Success.

    CBC.0100

    Invalid input parameter.

    CBC.0151

    Access denied.

    CBC.0999

    Other errors.

    CBC.3001

    The resource has expired.

    CBC.3002

    The resource has been locked.

    CBC.3004

    The resource has dependencies.

    CBC.3005

    The resource is being provisioned.

    CBC.3006

    Unsupported cloud service type.

    CBC.3128

    The resource does not have renewed periods or the renewed periods have taken effect, and the renewal periods cannot be unsubscribed.

    CBC.3185

    The cloud service can only be unsubscribed from as a whole.

    CBC.3640

    Bandwidth add-on packages cannot be unsubscribed from.

    CBC.5042

    Resources cannot be found.

    CBC.7281

    You cannot renew or cancel subscription because your account has been frozen.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel