InquiryPriceCreateInstance

1. 接口描述

本接口用于创建虚拟机实例询价。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
zoneId	是	String	可用区ID。
instanceType	是	String	实例机型。 具体取值可通过调用接口DescribeZoneInstanceConfigInfos来获得最新的规格表。
eipV4Type	否	EipNetworkType	公网IPv4的线路类型。 目前不支持三线IP(ThreeLine)。
internetChargeType	是	InternetChargeType	公网IP的网络计费类型。
trafficPackageSize	否	Float	流量包订购大小。 单位为TB。 该值必须在internetChargeType = ByTrafficPackage时才会生效。 可选值范围：[0.0, +)。
bandwidth	否	Integer	公网出带宽上限。 单位：Mbps。 可选值范围：[1, +)。
instanceCount	是	Integer	实例数量。 可选值范围：[1, 100]。 默认值：1。
systemDisk	是	SystemDisk	系统盘相关信息。
dataDisk	否	DataDisk	数据盘相关信息。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
specPrice	PriceItem	规格的价格。
gpuPrice	PriceItem	GPU规格的价格。
ipv4Price	PriceItem	公网IPv4的保留价格。
ipv4BandwidthPrice	PriceItem	公网IPv4的带宽价格。
ipv6Price	PriceItem	IPv6的价格。
ipv6BandwidthPrice	PriceItem	IPv6的带宽价格。
systemDiskPrice	PriceItem	系统盘的价格。
dataDiskPrice	PriceItem	数据盘的价格。

4. 代码示例

示例

1. 查询实例的询价，带宽计费为固定带宽。

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

Request：
{
  "zoneId":"SAO-A",
  "instanceType":"c.1c2g",
  "eipV4Type": "xxx",
  "internetChargeType":"ByBandwidth",
  "bandwidth":1,
  "instanceCount": 1,
  "systemDisk":{
    "diskSize":10
  }
}

Response：
{
  "requestId":"T03681166-F646-4F6A-AE6E-6CFF08DE60B3",
  "response":{
      "requestId":"T03681166-F646-4F6A-AE6E-6CFF08DE60B3",
      "specPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "gpuPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "ipv4Price": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "ipv6Price": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "ipv4BandwidthPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "ipv6BandwidthPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "systemDiskPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      },
      "dataDiskPrice": {
          "discount": 95.0,
          "discountPrice": 1444.0,
          "originalPrice": 1520.0,
          "unitPrice": null,
          "discountUnitPrice": null,
          "chargeUnit": null,
          "stepPrices": null
      }
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
400	INVALID_DISK_CATEGORY_TYPE	云盘的类型不合法。
404	INVALID_INSTANCE_TYPE_NOT_FOUND	实例规格不存在。
404	INVALID_ZONE_NOT_FOUND	可用区不存在。
400	OPERATION_DENIED_EIP_UNSUPPORT_NETWORK_TYPE	EIP网络计费方式不支持。