InquiryPriceCreateDisks

1. API Description

This API is used to query the price of creating a disk.

Note

Only operations on disks are supported.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name
Required
Type
Description

zoneId

Yes

String

Availability zone ID.

diskSize

Yes

Integer

Disk size.

Unit: GB.

diskAmount

No

Integer

Quantity of disks.

Minimum value: 1 (default value); Maximum value: 50.

diskCategory

No

String

Disk type.

  • Standard: the Standard NVMe SSD.

  • SSD: the Basic NVMe SSD.

Default value: Standard. Call DescribeDiskCategory to obtain disk type.

3. Output Parameters

Parameter Name
Type
Description

requestId

String

The unique request ID,

which is returned for each request. RequestId is required for locating a problem.

dataDiskPrice

Disk price.

4. Code Example

Query the price of creating a disk.

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: InquiryPriceCreateDisks
<Common Request Params>

Request:
{
  "zoneId": "HKG-A",
  "diskSize": 2000
}

Response:
{
  "requestId": "TF84F83D3-8F9B-4F49-952E-A7278F7C1183",
  "response": {
    "dataDiskPrice": {
      "discount": 100.0,
      "discountPrice": 2000.0,
      "originalPrice": 2000.0,
      "unitPrice": null,
      "discountUnitPrice": null,
      "chargeUnit": null,
      "stepPrices": null
    },
    "requestId": "TF84F83D3-8F9B-4F49-952E-A7278F7C1183"
  }
}

5. Developer Resources

Zenlayer Cloud API 2.0 integrates SDKs to make it easier for you to call APIs. More programming languages will be supported.

6. Error Codes

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.​

HTTP Status Code
Error Code
Description

404

INVALID_PRODUCT_NOT_FOUND

Product does not exist.

404

INVALID_ZONE_NOT_FOUND

Availability zone does not exist.

400

INVALID_DISK_CATEGORY_ZONE_NO_SELL

Disk type not for sale in the zone.

400

INVALID_DISK_CATEGORY_ZONE_NOT_SUPPORT

Unavailable disk type in the zone.

Last updated