Help Center/ KooGallery/ Access Guide/ SaaS Access Guide V1.0 (Existing Products)/ Interface Description/ Resource Release
Updated on 2025-01-17 GMT+08:00
View PDF
Share

Resource Release

Description

  • KooGallery calls this interface to request you to delete a purchased product and sends you a notification. You must delete the instance of the purchased product after receiving the product deletion notification.
  • If a customer does not renew an expired product in the retention period, or the customer has unsubscribed from the product, KooGallery releases the purchased product resources.
  • If the resource release interface fails to be called, KooGallery will retry for an hour. You can view the interface exception information on the Application Tools > Service Interface Messages page. If the interface exception is rectified, the next call will be successful. If the exception persists after an hour, KooGallery stops calling the interface. In this case, rectify the exception. Then go to the Seller Console, locate the order on the Application Tools > Service Interface Messages page, and click Restart Debugging in the same row to call the interface again.
    • Check the email address bound to your Huawei Cloud account. If you receive an email about an interface calling failure, rectify the exception as soon as possible.
    • KooGallery monitors interface exceptions. If releasing resources of a SaaS product frequently fails due to interface exceptions, KooGallery will remove the product from the catalog.

The following figure shows the process of releasing resources.

Request Message

The following table describes the request parameters.

Request method: GET

Parameter

Mandatory

Type

Maximum Length

Description

activity

Yes

String

20

Interface request ID, which is used to distinguish interface request scenarios.

For resource release, the value is releaseInstance.

instanceId

Yes

String

64

Instance ID.

orderId

Yes

String

64

Same as the ID of the subscription order.

testFlag

No

String

2

Whether a request is submitted for debugging.

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

The default value is 0.

authToken

Yes

String

50

Security verification token.

For details about the values, see authToken Value.

timeStamp

Yes

String

20

UTC timestamp when a request is initiated.

Format: yyyyMMddHHmmssSSS

orderAmount

No

bigdecimal

20

Order amount.

NOTE:

The amount is the actual payment amount, which you can check during reconciliation.

The amount is greater than or equal to 0 and can contain a maximum of three decimal places.

Unit: USD

Example request:

https://isvserver.com/produceAPI?activity=releaseInstance&instanceId=03pf80c2bae96vc49b80b917bea776d7 &timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=

Response Message

The following table describes the response parameters.

Parameter

Mandatory

Type

Maximum Length

Description

resultCode

Yes

String

6

Result code.

For details, see Invocation Result Codes.

resultMsg

No

String

255

Result message.
  • When processing an interface request, your server must ensure idempotency.
  • KooGallery may resend requests for a single order. When receiving a duplicate order with the same instanceId value, your server needs to return a success response, rather than release the instance again.

Example response:

{
    "resultCode":"000000",
    "resultMsg":"success."
}
Parent topic: Interface Description