- Introduction to KooGallery
-
Seller Guide
- Registration
- Joint Operations Certification and Product Access
-
Delivery Methods
- Product Release Description
- Delivery Methods
- Image Release Guide
- Releasing Professional Services
- SaaS Release Guide
- Releasing Consulting Services
- License Release Guide
- Releasing Multi-SKU Product Specifications
- Seller Management
- Product Management
- Service Supervision
- Transaction Management
- Settlement Management
- Bill Management
- Issuing Invoices to Huawei Cloud
-
FAQs
- What Enterprise Certificates Are Needed for the Registration?
- Can I Use the Same Account to Apply for Seller Registration Again After I Exit KooGallery?
- How Do I Become a KooGallery Partner?
- How Long Does It Take to Review the Registration Application?
- How Do I Release Products on KooGallery?
- How Long Does It Take to Review a Product Release Application?
- How Do I Remove a Product from the Catalog?
- When Can I Receive the Payment After a Bill Is Generated?
- When Can I Issue an Invoice for an Order?
- Is the Product Technical Support Provided by Sellers or Huawei Cloud?
- How Long Is the Validity Period of Products on KooGallery?
- How Do I Initiate an Appeal During Service Supervision?
- Can an Individual User Become a Seller on KooGallery?
- What Benefits Can I Obtain After Registering with KooGallery?
- Do I Need to Pay Deposit If I Register with KooGallery?
- How Do I Change the Company Name?
- Why Is No Bill Generated for an Order? What Are the Prerequisites for Bill Run?
- How Do I View the Sharing Ratio of a Product?
- How Do I Release a Trial SaaS Specification?
- Why Can't I Select an Image as an Image Asset?
- Reseller Guide
-
User Guide
- Support You May Need
- Huawei Cloud KooGallery Terms
- Product Purchase
- Product Use
- Service Supervision
- After-Sales Support
- Renewal Management
- Product Unsubscription
- Invoice Management
- Agencies
-
FAQs
- What Is Huawei Cloud KooGallery?
- What Software and Services Are Provided on KooGallery?
- How Do I Purchase Cloud Applications on KooGallery?
- Why Can't I Use the Pay-per-Use or Yearly/Monthly Billing Mode for Certain Products?
- How Do I View Purchased Applications?
- How Do I Request Invoices After Purchasing Products from KooGallery?
- What Do I Do If I Encounter a Problem When Using a Product?
- How Do I Renew Purchased Applications?
- What Do I Do If No Applications or Services Meet My Requirements?
- How Do I Contact a Seller?
- What Do I Do If I Cannot Contact a Seller?
- Does Huawei Cloud Support Login Through Third-Party Website?
- Common Problems About Yearly/Monthly Images
- Common Problems About Pay-per-Use Images
- How Do I Initiate an Appeal During Service Supervision?
-
Access Guide
- SaaS Access Guide V2.0 (New Products)
- SaaS Access Guide V1.0 (Existing Products)
- Automatic Deployment and Access Guide
- General Reference
Copied.
Upgrade
Description
After a customer has successfully paid for an order for upgrading a purchased product, KooGallery calls this interface to request you to upgrade the product. The ISV server needs to upgrade the product and return a notification to KooGallery.
For details about the upgrade rules, see Upgrade and Billing Rules.
The following figure shows the process of upgrading a product.
Request Message
The following table describes the request parameters.
Request method: GET
Parameter |
Mandatory |
Type |
Maximum Length of Characters |
Description |
---|---|---|---|---|
authToken |
Yes |
String |
50 |
Security verification token. For details about the value, see authToken Value. |
activity |
Yes |
String |
20 |
Interface request ID, which is used to distinguish interface request scenarios. For upgrades, the value is upgrade. |
instanceId |
Yes |
String |
64 |
Instance ID. The upgrade does not change instance ID. |
testFlag |
No |
String |
2 |
Whether a request is submitted for debugging.
The default value is 0. |
orderId |
Yes |
String |
64 |
Upgrade order ID. A new order will be generated during the upgrade and has an ID different from that of a subscription order. Use instanceId to identify the resources. |
skuCode |
Yes |
String |
64 |
Product specification ID after the upgrade. A specification with custom attributes will change if the customer selects other attribute values during the upgrade. As a result, the skuCode changes. If the customer only expands the capacity by linearly increasing the attribute value, for example, from 10 users to 20 users, the skuCode does not change. |
productId |
Yes |
String |
64 |
Product ID after the upgrade. The value of productId varies according to the skuCode. If the customer only expands the capacity, the value of productId does not change. |
timeStamp |
Yes |
String |
20 |
Time (UTC time) when a request is initiated. Format: yyyyMMddHHmmssSSS |
amount |
No |
Integer |
4 |
Product attribute of the quantity type. This parameter is optional. Attribute name: quantity (customizable) Unit: none When customers subscribe to SaaS products (billing mode: yearly/monthly or one-time) with specifications that contain the quantity type attribute, they specify or modify the number or usage times. Example: 30 users |
diskSize |
No |
Integer |
4 |
Product attribute of the quantity type. This parameter is optional. Attribute name: disk size (customizable) Unit: GB When customers subscribe to SaaS products (billing mode: yearly/monthly or one-time) with specifications that contain the disk size attribute, they specify or modify the disk size. Example: 100 GB |
bandWidth |
No |
Integer |
4 |
Product attribute of the quantity type. This parameter is optional. Attribute name: bandwidth (customizable) Unit: Mbit/s When customers subscribe to SaaS products (billing mode: yearly/monthly or one-time) with specifications that contain the bandwidth attribute, they specify or modify the amount of bandwidth. Example: 20 Mbit/s |
Example request:
http://isvserver.com/produceAPI?activity=upgrade&amount=6456&instanceId=huaweitest123456&orderId=CS1906666688ABCDE&productId=00301-666688-0-0&saasExtendParams=W3sibmFtZSI6ImlkTnVtIiwidmFsdWUiOiIzNTIyNTU1NTU1NTU2NTYifSx7Im5hbWUiOiJ1c2VyTmFtZSIsInZhbHVlIjoiaHVhd2VpMTIzIn0seyJuYW1lIjoiY3VzdEVtYWlsIiwidmFsdWUiOiIxMjNAaHVhd2VpLmNvbSJ9XQ==&skuCode=d0abcd12-1234-5678-ab90-11ab012aaaa1&testFlag=1&timeStamp=20191216013757582&authToken=a3Bl+C93xv3ENgm40ngyYvQnYcTS/pgY5ugl20wtzGg=
Response Message
The following table describes the response parameters.
Parameter |
Mandatory |
Type |
Maximum Length of Characters |
Description |
---|---|---|---|---|
resultCode |
Yes |
String |
6 |
Invocation result code. For details, see Invocation Result Codes. |
resultMsg |
No |
String |
255 |
Invocation result description. |
When processing an interface request, the ISV server must ensure idempotence.
KooGallery may resend requests for a single order. When receiving a duplicate order with the same orderId value, the ISV server needs to return a success response, rather than upgrade the instance again.
Example response:
{ "resultCode":"000000", "resultMsg":"success." }
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot