InquiryPriceCreateInstance

1. API Description

This API (InquiryPriceCreateInstance) is used to query the price of creating instance.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
zoneId	Yes	String	Zone ID of the instance.
instanceTypeId	Yes	String	Instance model ID. To view specific values, you can call DescribeInstanceTypes .
instanceChargeType	Yes	ChargeType	Instance pricing model . PREPAID: subscription POSTPAID: pay-as-you-go
internetChargeType	Yes	InternetChargeType	Network pricing model.
instanceChargePrepaid	No	ChargePrepaid	Details of the monthly subscription, including the purchase period, auto-renewal. It is required if the chargeType is PREPAID.
trafficPackageSize	No	Float	Traffic package size (TB). The parameter is valid only when internetChargeType is ByTrafficPackage . If not passed in, the default value will be the size of the free traffic package. Value range: [0.0, +)
internetMaxBandwidthOut	No	Integer	Public network bandwidth cap (Mbps). Default value: 1 Mbps. The parameter value differs by different instance models. Value range: [0, +) Default value: 1

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.
instancePrice	PriceItem	Price of the instance.
bandwidthPrice	Array of PriceItem	Price of public bandwidth. Kinds of prices may exist. For example, traffic package billing method may contain the package price and overage price.
primaryIpPrice	PriceItem	Price of the primary IP.

4. Code Example

Example

Query the price of a subscription instance with the billing method of flat rate

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

Request:
{
  "zoneId": "SEL-A",
  "instanceTypeId": "M6C",
  "instanceChargeType": "PREPAID",
  "instanceChargePrepaid": {
    "period": 1
  },
  "trafficPackageSize": 100,
  "internetMaxBandwidthOut": 200,
  "internetChargeType": "ByBandwidth"
}

Response:
{
  "requestId": "T01F25348-DA67-4726-97C1-538BAE714F8B",
  "response": {
    "requestId": "T01F25348-DA67-4726-97C1-538BAE714F8B",
    "instancePrice": {
      "discount": 95.0,
      "discountPrice": 426.55,
      "originalPrice": 449.0,
      "unitPrice": null,
      "discountUnitPrice": null,
      "chargeUnit": null,
      "stepPrices": null
    },
    "bandwidthPrice": [
      {
        "discount": 95.0,
        "discountPrice": 1444.0,
        "originalPrice": 1520.0,
        "unitPrice": null,
        "discountUnitPrice": null,
        "chargeUnit": null,
        "stepPrices": null
      }
    ]
  }
}

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_ZONE_NOT_FOUND	Zone not found.
404	INVALID_INSTANCE_TYPE_NOT_FOUND	Instance type not found.
403	INVALID_CHARGE_TYPE_NOT_SUPPORT	The current account does not support the specified pricing model.
400	INVALID_INSTANCE_BANDWIDTH_ZONE_NO_SELL	The specified public network billing model is not supported in the selected zone.
400	INVALID_INSTANCE_TYPE_ZONE_NO_SELL	Traffic package of the specified instance is not currently available for sale.