Help Center/ Partner Center/ API Reference/ Partner Operations Capability APIs (Reseller Model)
Updated on 2024-09-26 GMT+08:00

Partner Operations Capability APIs (Reseller Model)

HUAWEI CLOUD provides the operation capabilities in the reseller model for partners to manage customers, credits, coupons, transactions, cloud services, bills, service tickets, products, and invoices on the partner sales platform.

Table 1 APIs and descriptions

Scenario

Sub-Scenario

API Name

Description

Product management

Product information query

Querying Cloud Service Types

This API is used to query cloud service types on the partner sales platform.

Querying Resource Types

This API is used to query the resource types on the partner sales platform.

Querying Resources by Cloud Service Type

This API is used to query the resource type code and name by associated cloud service on the partner sales platform and to query the price of a pay-per-use or yearly/monthly product.

Querying Usage Types

This API is used to query resource usage types on the partner sales platform.

Querying Measurement Units

This API is used to query the resource usage, measurement unit for the duration and amount of a yearly/monthly resource, as well as the measurement unit type on the partner sales platform.

Querying the Measurement Unit Number System

This API is used to query the measurement unit number system on the partner sales platform.

Product price query

Querying the Price of a Pay-per-Use Product

Partners can query the price of a pay-per-use product by criteria on the sales platform.

Querying the Price of a Yearly/Monthly Product

Partners can use this API to query prices of yearly/monthly products for new subscriptions on their sales platforms.

Querying the Renewal Price of a Yearly/Monthly Resource

Customers can query the renewal price of a yearly/monthly resource by criteria on the partner sales platform.

Customer management

Customer registration

Verifying Customer Registration Information

This API is used to check whether the account name, and mobile number or email address entered by the customer can be used for registration.

Sending a Verification Code

If a customer enters an email address during registration, the system sends a registration verification code to the email address to verify the information.

Creating a Customer

This API is used to create a Huawei Cloud account for a customer when the customer creates an account on your sales platform, and bind the customer account on the partner sales platform to the HUAWEI CLOUD account. In addition, the Huawei Cloud account is bound to the partner account.

Real-name authentication

Requesting an Individual Real-name Authentication

This API can be used to submit an individual real-name authentication application.

Requesting an Enterprise Real-name Authentication

This API can be used to submit an enterprise real-name authentication application.

Requesting a Real-Name Authentication Change

This API can be used to submit a real-name authentication change application.

Querying the Real-Name Authentication Review Result

If the response to a real-name authentication application or real-name authentication change application indicates that manual review is required, this API can be used to query the review result.

Customer management

Querying Customers

This API is used to query your customers.

Freezing a Customer Account

A partner can freeze an account of a customer associated with the partner by reseller model.

Unfreezing a Customer Account

A partner can unfreeze an account of a customer associated with the partner by reseller model.

Reseller management

Querying resellers

Querying Huawei Cloud Resellers

A Huawei Cloud distributor can query the list of its associated Huawei Cloud resellers.

Credit management

Managing credits

Querying Consumption Quota

Partners can query their expenditure quotas.

Transaction management

Customer budget management

Querying Customers' Budgets

This API is used to query the budget of a customer for the partner to determine whether to adjust the budget.

Batch Querying Customer Budgets

This API is used to batch query budgets of multiple customers. You can decide whether to adjust budgets for your customers based on the query results.

Setting Customer Budgets

This API is used to set or adjust a customer's budget.

Coupon management

Querying Coupons

Partners can query information about their coupons.

Yearly/monthly order management

Querying Orders

After a customer purchases yearly/monthly resources, it can query the orders in different statuses, such as in the pending approval, processing, canceled, completed, and pending payment statuses.

Querying Order Details

Customers can view order details on the partner sales platform.

Paying Yearly/Monthly Product Orders

A customer can invoke this API to pay yearly-monthly product orders in the pending payment status.

Canceling Orders in the Pending Payment Status

A customer can invoke this API to cancel orders in the pending payment status.

Querying the Amount of Unsubscription Orders

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.

Yearly/Monthly resource management

Querying Customer's Yearly/Monthly Resources

A customer can query one or all yearly/monthly resources on the partner sales platform.

Renewing Yearly/Monthly Resources

A customer can renew subscription to yearly/monthly resources on the partner sales platform.

Unsubscribing Yearly/Monthly Resources

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.

Configuring Automatic Renewal for Yearly/Monthly Resources

A customer can use this API to enable automatic subscription renewal for its long-term yearly/monthly resources to prevent the resources from being deleted when they are expired.

Canceling Automatic Renewal for Yearly/Monthly Resources

A customer can disable automatic subscription renewal when needed. After disabling this function, the customer needs to manually renew the subscription to the resources before they expire.

Enabling/Canceling the Change from Yearly/Monthly to Pay-per-Use upon Expiration

A customer can change the billing mode of resources from yearly/monthly to pay-per-use after the resources expire. The pay-per-use mode takes effect upon a yearly/monthly expiration.

Resource package management

Querying Resource Packages

This API is used to query resource packages.

Querying the Resource Usage

Partners can query the resource package usage of customers on the partner sales platform by resource.

Querying Resource Package Usage Details

Customer can use this API to query details of resource package usage in their partners' sales platforms.

Pay-per-use resource management

Querying Customer's Pay-per-Use Resources

A partner can query the pay-per-use resources that have been provisioned for customers associated with the partner in the Reseller model.

Cloud service resource management

Cloud service resource management

Switching from the partner sales platform to the HUAWEI CLOUD portal

This API is used to switch from the partner sales platform to the HUAWEI CLOUD portal using a link to manage cloud service resources.

Bill management

Customer resource usage management

Querying Customer Resource Usage

This API is used to query customer resource usage.

Partner bill management

Querying Monthly Bills

You can query your monthly bills that cover amount due, expenditures, refunds, and adjustments.

Querying Bill Details of Monthly Expenditures

A partner can subscribe to the partner bill (customer resource usage) in the HUAWEI CLOUD Partner Center. For details, see File Subscription. Your sales platform will calculate the customer expenditures and generate the customer bills based on this bill and then you can perform reconciliation with HUAWEI CLOUD.

Invoice management

Invoice management

Querying the Invoice List

Partners can query the invoice list.

Managing service tickets

Managing service tickets

Service ticket management APIs

Partners and customers can submit HUAWEI CLOUD service tickets on the partner sales platform. When receiving the service tickets, the HUAWEI CLOUD after-sales service team will assist the customers to handle the problems related to HUAWEI CLOUD usage.