Partner CenterPartner Center

Compute
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Networking
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
Domain Name Service
VPC Endpoint
Cloud Connect
Enterprise Switch
Security & Compliance
Anti-DDoS
Web Application Firewall
Host Security Service
Data Encryption Workshop
Database Security Service
Advanced Anti-DDoS
Data Security Center
Container Guard Service
Situation Awareness
Managed Threat Detection
Compass
Cloud Certificate Manager
Anti-DDoS Service
Databases
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GaussDB NoSQL
GaussDB(for MySQL)
Distributed Database Middleware
GaussDB(for openGauss)
Developer Services
ServiceStage
Distributed Cache Service
Simple Message Notification
Application Performance Management
Application Operations Management
Blockchain Service
API Gateway
Cloud Performance Test Service
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
DevCloud
ProjectMan
CodeHub
CloudRelease
CloudPipeline
CloudBuild
CloudDeploy
Cloud Communications
Message & SMS
Cloud Ecosystem
Marketplace
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP License Service
Support Plans
Customer Operation Capabilities
Partner Support Plans
Professional Services
enterprise-collaboration
Meeting
IoT
IoT
Intelligent EdgeFabric
DeveloperTools
SDK Developer Guide
API Request Signing Guide
Terraform
HCloud CLI
Updated at: Apr 27, 2022 GMT+08:00

Querying the Amount of Unsubscription Orders

Function

A customer can query the resources and original orders of the unsubscription amount for an unsubscription order or degrade order on the partner sales platform.

Notes:

  • This API can be invoked using the AK/SK or token of the partner or of the partner's customer.
  • After you invoke the API in Unsubscribing from Yearly/Monthly Resources to generate an unsubscription order ID, you can invoke this API to query the resources and amount of an unsubscription order. For example, after you invoke the API in Unsubscribing from Yearly/Monthly Resources, you can invoke this API to query the original order ID and original subscription renewal order ID.
  • You can query original order IDs for only unsubscription orders generated after May 2018.

    This API is about to be brought offline. For details about how to query the amount of unsubscription orders, see Querying the Amount of Unsubscription Orders.

URI

GET /v1.0/{domain_id}/common/order-mgr/orders/refund-order

The following table describes the parameters.

Table 1 URI parameters

Parameter

Mandatory

Maximum Length of Characters

Description

domain_id

Yes

A maximum of 64 characters

Table 2 Request parameters

Parameter

Mandatory

Type

Maximum Length of Characters

Description

order_id

Yes

String

A maximum of 64 characters

ID of an unsubscription or degrade order.

Request

Request Parameters

None

Example Request

GET https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/orders/refund-order?order_id=CS1*****GT HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

Response

Response Parameters

Parameter

Mandatory

Type

Description

error_code

Yes

String

Error code.

For details, see Status Code.

error_msg

Yes

String

Error description.

total_count

No

Integer

Total number of queries.

resource_info_list

No

List<ResourceInfo>

Resource list.

For details, see Table 3.

Table 3 ResourceInfo

Parameter

Mandatory

Type

Description

id

Yes

String

Record ID.

resource_id

No

String

Resource ID.

If the resource does not have an ID, this field is left empty.

Currently, this field is reserved and no value is returned.

amount

Yes

BigDecimal

Amount.

  • A negative number indicates the unsubscription amount.
  • A positive amount indicates the consumption amount or the unsubscription handling fee.

measure_id

Yes

String

Measurement unit.

  • 1: Dollar
  • 2: Dime
  • 3: Cent

customer_id

Yes

String

Customer ID.

resourceType

Yes

String

Resource type code. For example, the VM resource type code of ECS is hws.resource.type.vm. To obtain a specific resource type, call the API in Querying Resource Types.

cloudServiceType

Yes

String

Cloud service type code. For example, the cloud service type code of OBS is hws.service.type.obs. To obtain a specific service type, call the API in Querying Cloud Service Types.

regionCode

Yes

String

Cloud service region code, for example, ap-southeast-1. Obtain the value from the Region column in Regions and Endpoints.

preOrderId

No

String

ID of the original order corresponding to the unsubscription amount, consumption amount, or unsubscription handling fee.

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",
    "total_count": 3,
    "resource_info_list": [
        {
            "id": "0b8**c**f3",
            "amount": -288,
            "resourceType": "hws.resource.type.volume",
            "cloudServiceType": "hws.service.type.ebs",
            "regionCode": "cn-north-1",
            "preOrderId": "CS1806201614MS037",
            "resource_id": null,
            "measure_id": "3",
            "customer_id": "f8*****231d"
        },
        {
            "id": "2ba*****2a9",
            "amount": 28,
            "resourceType": "hws.resource.type.volume",
            "cloudServiceType": "hws.service.type.ebs",
            "regionCode": "cn-north-1",
            "preOrderId": "CS18062016100U54J",
            "resource_id": null,
            "measure_id": "3",
            "customer_id": "f80*****31d"
        },
        {
            "id": "abe3*****5312",
            "amount": -260,
            "resourceType": "hws.resource.type.volume",
            "cloudServiceType": "hws.service.type.ebs",
            "regionCode": "cn-north-1",
            "preOrderId": "CS18062016100U54J",
            "resource_id": null,
            "measure_id": "3",
            "customer_id": "f80*****31d"
        }
    ]
}

Status Code

  • 4xx: This class of HTTP status code is intended for situations in which the error seems to have been caused by the client, for example, the request contains bad syntax or incorrect parameters. You must ensure the request is correct.
  • 5xx: This class of HTTP status code is intended for cases in which the Huawei Cloud server is aware that it has encountered an error or is otherwise incapable of performing the request. In this case, contact Huawei Cloud customer service.

Status Code

Description

CBC.0000

Succeeded.

CBC.0999

Other errors.

CBC.0151

Access denied.

CBC.5026

The order is not a degrade or unsubscription order.

Did you find this page helpful?

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