Help Center/ Partner Center/ API Reference/ Partner Operations Capability APIs (Reseller Model)

Updated on 2024-09-26 GMT+08:00

View PDF

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.
	Partner bill management	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.