Change History

This issue is the forty-third official release.

This release incorporates the following change:

Added the response parameter fail_resource_infos (used for query the resources that fails to be subscribed to or unsubscribed from) to the APIs for renewing subscription to yearly/monthly resources and unsubscribing from yearly/monthly resources.

2023-2-9

This issue is the forty-second official release.

This release incorporates the following changes:

• Added the API for querying resource package usage details.
• Added the following response parameters to the APIs for viewing resource usage details and viewing resource expenditures:

  "sub_service_type_code", "sub_service_type_name", "sub_resource_type_code", "sub_resource_type_name", "sub_resource_id", and "sub_resource_name"

2022-12-27

This issue is the forty-first official release.

This release incorporates the following change:

• Changed the value range of the parameter groupby of the API for querying cost data to "A maximum of 2 values".
• Added the response parameter formula to the API for viewing resource expenditures.

2022-11-29

This issue is the fortieth official release.

This release incorporates the following changes:

• Brought the V1 API for enabling automatic subscription renewal for yearly/monthly resources offline.
• Brought the V1 API for disabling automatic subscription renewal for yearly/monthly resources offline.

2022-11-17

This issue is the thirty-ninth official release.

This release incorporates the following change:

Added the V3 API for paying yearly/monthly product orders, and moved the V2 API for paying yearly/monthly product orders to API to Be Brought Offline.

2022-09-27

This issue is the thirty-eighth official release.

This release incorporates the following change:

Added response parameters root_resource_id, parent_resource_id, trade_id, and product_spec_desc to the API for querying resource usage details.

2022-09-13

This issue is the thirty-seventh official release,

This release incorporates the following change:

A value of the response parameter feeSourceOperation of the API for viewing resource expenditures has been changed to 20: Refund - change (entire server), and the value 21: Refund – change (specification downgrade) is added.

2022-08-30

This issue is the thirty-sixth official release.

This release incorporates the following change:

Add the API for querying cost data. Customers can query the cost data on their self-built platform through this API.

2022-08-16

This issue is the thirty-fifth official release.

This release incorporates the following change:

Changed Marketplace to KooGallery.

2022-08-10

This issue is the thirty-fourth official release.

This release incorporates the following changes:

• Added the error code CBC.30010035 to the API for unsubscribing from yearly/monthly resources.

2022-07-19

This issue is the thirty-third official release.

This release incorporates the following changes:

Added the following description for the API in Unsubscribing from Yearly/Monthly Resources: Confirm the resource information and the refund before unsubscribing from in-use resources. After being unsubscribed from, the resources not in the recycle bin cannot be restored. If you wan to continue using these resources, unsubscribe from the subscription term renewed but not used yet.

2022-07-05

This issue is the thirty-second official release.

This release incorporates the following changes:

• Added period_type to the response parameters of the API in Viewing Resource Usage Details.
• Added the API for querying cloud service types, and moved the old API for querying cloud service types to API to Be Brought Offline.
• Added the API for querying resource types, and moved the old API for querying resource types to API to Be Brought Offline.
• Added service_type_name, indicating the cloud service type, and resource_type_name, indicating the resource type, to the response parameters of the APIs for querying usage types, paying yearly/monthly product orders, querying the amount of unsubscription orders, querying customer's yearly/monthly resources, and querying summary bills.
• Added cloud_service_type_name, indicating the cloud service type, and resource_type_name, indicating the resource type, to the response parameters of the APIs for viewing resource usage details and viewing resource expenditures.
• Added service_type_name, indicating the cloud service type, to the response parameters of the APIs for querying order details and querying resource packages.

2022-04-12

This issue is the thirty-first official release.

This release incorporates the following changes:

• The transaction model name in Chinese for Referral has been changed, but the English name remains unchanged.
• Added the enumerated value 7: Deposit for the account_type parameter in the response of the V2 API for querying the account balance.

2022-03-25

This issue is the thirtieth official release.

This release incorporates the following change:

Added error code CBC.99003605 in the response of the V2 API for canceling automatic renewal for yearly/monthly resources.

2022-03-15

This issue is the twenty-ninth official release.

This release incorporates the following change:

Added the enumerated value 20: refund-change for the bill_type parameter of the API for querying resource usage details.

2022-02-15

This issue is the twenty-eighth official release.

This release incorporates the following changes:

• Added error code CBC.30010036 in the response of the API for renewing subscription to yearly/monthly resources.
• Added error code CBC.99003602 in the response of the API for enabling automatic subscription renewal for yearly/monthly resources.
• Added enumerated values 19: Change - specifications upgrade and 20: Change - specifications downgrade for the response parameter feeSourceOperation of the old API for querying resource expenditures.

2022-01-25

This issue is the twenty-seventh official release.

This release incorporates the following changes:

• Added error code CBC.0250 to the response of the API for querying the price of a yearly/monthly product.
• Added error code CBC.30050006 in the response of the API for renewing subscription to yearly/monthly resources.
• Added error code CBC.99003115 to the response of the V2 API for paying yearly/monthly product orders.
• Added error code CBC.99003156 to the response of the V2 API for paying yearly/monthly product orders.
• Added error code CBC.99003156 to the response of the V1 API for paying yearly/monthly product orders.

2022-01-11

This issue is the twenty-sixth official release.

This release incorporates the following changes:

• Added the request parameter statistic_type and the response parameter bill_date for the API in Viewing Resource Usage Details to support querying resource usage details by day.
• Deleted error code CBC.99003001 from the API in Renewing Subscription to Yearly/Monthly Resources.

2021-11-30

This issue is the twenty-fifth official release.

This release incorporates the following change:

Change the description of the error message for CBC.99003016 to "The resources have expired and been deleted or do not exist." in Renewing Subscription to Yearly/Monthly Resources.

2021-11-02

This issue is the twenty-fourth official release.

This release incorporates the following changes:

• Added the V3 API for querying resource packages and moved the V2 API for querying resource packages to API to Be Brought Offline.
• Added request parameters expire_time_begin and expire_time_end to the API in Querying Customer's Yearly/Monthly Resources. These two parameters are used to query the list of resources that expire in a specified period.

2021-09-28

This issue is the twenty-third official release.

This release incorporates the following changes:

• Added error code CBC.30000010 to the API for paying yearly/monthly product orders.
• Added a description for the Unit parameter in Viewing Resource Expenditures to differentiate the unit of the linear products from that of non-linear products.

2021-08-31

This issue is the twenty-second official release.

This release incorporates the following change:

Moved Querying the Package Usage to API to Be Brought Offline.

2021-08-10

This issue is the twenty-first official release.

This release incorporates the following change:

Added user_name in the response parameters of the API in Querying Order Details to specify the order creator returned by the API for querying order details.

2021-07-13

This issue is the twentieth official release.

This release incorporates the following changes:

• Added the API for querying the resource packages of a customer in Querying Resource Packages.
• Added the API for querying the resource package usage in Viewing Resource Package Usage.

2021-06-15

This issue is the nineteenth official release.

This release incorporates the following change:

Added Querying Available Discounts of an Order. You can invoke this API to query available discounts when paying an order.

2021-04-28

This issue is the eighteenth official release.

This release incorporates the following changes:

• Modified Viewing Resource Usage Details. Specifically, added parameters sku_code and region_name, which are used to return the SKU attribute and cloud service region, respectively, in the response message during an API call.

• Modified Viewing Resource Expenditures. Request parameters bill_date_begin and bill_date_end are added to customize the dates for querying consumption records in a billing cycle and response parameter region_name is added to return the cloud service region during an API call.

2021-01-13

This issue is the seventeenth official release.

This release incorporates the following changes:

• Added Querying Measurement Units and Querying the Measurement Unit Number System.

• Modified the V2 interface in Viewing Resource Expenditures. Specifically, parameter charge_mode is changed from mandatory to optional. The enumerated value 17: expenditure-difference amount (min. guaranteed-actual) is added for parameter bill_type.

2020-12-25

This issue is the sixteenth official release.

This release incorporates the following change:

Added the parameter discount_infos and table DiscountSimpleInfo for the API that is used for paying yearly/monthly product orders to query available discounts that can be used for paying yearly/monthly orders.

2020-12-16

This issue is the fifteenth official release.

This release incorporates the following changes:

• Added Querying Usage Types for querying usage types.
• Added Enabling/Canceling the Change from Yearly/Monthly to Pay-per-Use upon Expiration for querying resource types.
• Added the enumerated value "610: Discount amount" for parameter discount_type in Querying Orders, Querying Order Details, and Querying Summary Bills, as well as Querying Orders and Querying Order Details to be brought offline.

2020-11-18

This issue is the fourteenth official release.

This release incorporates the following changes:

Added Querying Cloud Service Types (Old) for querying cloud service types.

Added Querying Resource Types (Old) for querying resource types.

Added Querying Resources by Cloud Service Type for querying resource list by cloud service type.

2020-11-04

This issue is the thirteenth official release.

This release incorporates the following changes:

Added parameter trade_id in Viewing Resource Expenditures to identify transaction or order ID.

2020-10-21

This issue is the twelfth official release.

This release incorporates the following changes:

• Added query parameters method and sub_customer_id in Viewing Resource Expenditures.
• Added query parameters method and sub_customer_id and response parameter customer_id in Viewing Resource Usage Details.

Supported the function of querying bill data of only a sub customer of an enterprise or a customer itself.

2020-09-28

This issue is the eleventh official release.

This release incorporates the following changes:

• Added response parameters product_owner_service and commercial_resource in Querying Order Details.
• Changed the default value of measure_id in the following APIs from cent to dollar. After this modification, the unit for the values of currency-related fields is also changed to dollar. Check the currency unit in use during an API call.
  • Querying Orders
  • Querying Order Details
  • Querying the Amount of Unsubscription Orders
  • Viewing Resource Usage Details
  • Viewing Resource Expenditures
  • Querying the Account Balance

2020-09-16

This issue is the tenth official release.

This release incorporates the following changes:

• Modified Viewing Resource Expenditures and added parameters enterprise_project_name and product_spec_desc in Table 3.
• Added error codes CBC.99006006, CBC.99006055, and CBC.99006074 in Querying the Price of a Pay-Per-Use Product and Querying the Price of a Yearly/Monthly Product

2020-09-02

This issue is the ninth official release.

This release incorporates the following change:

Added the V2 interface in Querying the Account Balance and moved the V1 interface in Querying the Account Balance to API to Be Brought Offline.

2020-08-12

This issue is the eighth official release.

This release incorporates the following changes:

• Added the V2 interface in Querying the Amount of Unsubscription Orders.
• Added the V2 interface in Querying Customer's Yearly/Monthly Resources and moved the V1 interface in Querying Customer's Yearly/Monthly Resources to API to Be Brought Offline.
• Added the V2 interface in Enabling Automatic Subscription Renewal for Yearly/Monthly Resources and moved the V1 interface in Enabling Automatic Subscription Renewal for Yearly/Monthly Resources to API to Be Brought Offline.
• Added the V2 interface in Disabling Automatic Subscription Renewal for Yearly/Monthly Resources and moved the V1 interface in Disabling Automatic Subscription Renewal for Yearly/Monthly Resources to API to Be Brought Offline.

2020-06-30

This issue is the seventh official release.

This release incorporates the following changes:

• Added the V2 interface in Querying Orders and moved the V1 interface in Querying Orders to API to Be Brought Offline.
• Added the V2 interface in Querying Order Details and moved the V1 interface in Querying Order Details to API to Be Brought Offline.
• Added the V2 API for paying yearly/monthly product orders. Moved the V1 API from Paying Yearly/Monthly Product Orders (Old) to API to Be Brought Offline.
• Added the V2 interface in Canceling Orders in the Pending Payment Status and moved the V1 interface in Canceling Orders in the Pending Payment Status to API to Be Brought Offline.
• Added the V2 interface in Renewing Subscription to Yearly/Monthly Resources and moved the V1 interface in Renewing Subscription to Yearly/Monthly Resources to API to Be Brought Offline.
• Added the V2 interface in Unsubscribing from Yearly/Monthly Resources and moved the V1 interface in Unsubscribing from Yearly/Monthly Resources to API to Be Brought Offline.

2020-06-17

This issue is the sixth official release.

This release incorporates the following changes:

• Brought the V2 API in Viewing Resource Expenditures online and the API in Viewing Resource Expenditures (Old) offline.
• Brought the V2 API in Viewing Resource Usage Details online and the API in Viewing Resource Usage Details (Old) offline.

2020-04-22

This issue is the fifth official release.

This release incorporates the following changes:

Added Querying the Price of a Pay-Per-Use Product and Querying the Price of a Yearly/Monthly Product.

2020-03-25

This issue is the fourth official release.

This release incorporates the following change:

Added Querying Package Usage.

2020-01-17

This issue is the third official release.

This release incorporates the following change:

Added Querying the Invoice List.

2020-01-15

This issue is the second official release.

This release incorporates the following change:

Added the following response parameters in Querying Summary Bills: total_amount, debt_amount, coupon_amount, cashcoupon_amount, storedcard_amount, debit_amount, credit_amount, and measure_id.

2019-12-25

This issue is the first official release.

2019-09-17