InquiryPriceCreateDisks

1. API Description

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

Note

• Only operations on data disks are supported.

• For a PREPAID disk, call this API to query the subscription price; for a POSTPAID disk, query the pay-as-you-go price. If you need to purchase specified disks, please contact Zenlayer Support.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
zoneId	Yes	String	ID of zone to which the disk belongs. Call DescribeZones to obtain.
diskSize	Yes	Integer	Storage space. Unit: GB.
diskCategory	No	String	Disk type. Standard Disk: Hard Disk Drive SSD: Solid State Drive
diskAmount	No	Integer	Quantity of cloud disks. Minimum value: 1 (default value); Maximum value: 50.
chargeType	Yes	String	Cloud disk pricing model. PREPAID: subscription POSTPAID: pay-as-you-go
chargePrepaid	No	ChargePrepaid	Details of the monthly subscription, including the purchase period, auto-renewal. It is required if the chargeType is PREPAID.

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	Price	Price of a disk.

4. Code Example

Example

Query the price of creating a disk.

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

Request:
{
  "zoneId": "HKG-A",
  "diskSize": 2000,
  "chargeType": "PREPAID",
  "chargePrepaid": {
    "period": 1,
    "periodUnit": "Month"
  }
}

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	Zone does not exist.
400	INVALID_CHARGE_PREPAID_CAN_NOT_BE_NULL	chargePrepaid is required when the chargeType is PREPAID.
400	INVALID_CHARGE_TYPE	Invalid billing model.
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.