Help Center/ KooGallery/ Access Guide/ SaaS Access Guide V2.0 (New Products)/ Basic Interfaces/ Upgrading an Instance
Updated on 2024-05-31 GMT+08:00
View PDF
Share

Upgrading an Instance

Description

A customer upgrades a purchased resource. After the upgrade order is paid, KooGallery calls this interface to ask you to upgrade the resource and record the upgraded product data.

The following figure shows the process of upgrading a product.

Request Message

The following table describes the request parameters.

Request method: POST

Parameter

Mandatory

Type

Maximum Length

Description

activity

Yes

String

32

Request ID, which is used to distinguish the scenario.

For upgrades, the value is upgradeInstance.

instanceId

Yes

String

64

Instance ID.

NOTE:

The upgrade does not change instanceId.

orderId

Yes

String

64

Upgrade order ID.

NOTE:

An order is generated for the upgrade.

orderLineId

Yes

String

64

KooGallery order line ID.

testFlag

No

String

2

Whether a request is submitted for debugging.

  • 1: debugging request.
  • 0: non-debugging request.

The default value is 0.

Example request:

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=9D49F9BF09D69F7A98B847978D6091A9ADF3B40E07AF95FEE9E5BEF5218DA407&timestamp=1680510876429&nonce=D8FE86FA6ABE90CA63A72B3256743D3D869648FE99A96354E635F032629F6C21' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -d'{"activity":"upgradeInstance","instanceId":"10e758d0-31ad-4c4b-8f1b-81d03469a10e","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"0"}'

The following table describes the response parameters.

Parameter

Mandatory

Type

Maximum Length

Description

resultCode

Yes

String

6

Result code.

For details, see Result Codes.

resultMsg

No

String

255

Result message.

Example response:

{ 
    "resultCode":"000000", 
    "resultMsg":"success." 
}
Parent topic: Basic Interfaces