> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/zec/instance/inquirypricecreateinstance.md). # InquiryPriceCreateInstance ## 1. 接口描述 本接口(InquiryPriceCreateInstance)用于查询创建虚拟机实例的价格。 {% hint style="info" %} **注意事项** * 查询GPU实例询价时，`instanceType` 请传入[`DescribeZoneGpuInstanceConfigInfos`](/api-reference/cn/zec/instance/describezonegpuinstanceconfiginfos.md)返回的 `instanceType` 字段。此时返回结果中 `gpuPrice` 为GPU规格费用，`specPrice`/`acceleratorPrice` 为空。 * 查询加速卡实例询价时，`instanceType` 请传入[`DescribeZoneAcceleratorConfigInfos`](/api-reference/cn/zec/instance/describezoneacceleratorconfiginfos.md)返回的 `instanceType` 字段。此时返回结果中 `acceleratorPrice` 为加速卡规格费用，`specPrice`/`gpuPrice` 为空。 * 查询普通实例询价时，`instanceType` 请传入[`DescribeZoneInstanceConfigInfos`](/api-reference/cn/zec/instance/describezoneinstanceconfiginfos.md)返回的 `instanceType` 字段。此时返回结果中 `specPrice` 为规格费用，`gpuPrice`/`acceleratorPrice` 为空。 * 保底流量包大小仅对计费周期为月有效。 {% endhint %} ## 2. 请求参数 以下请求参数列表仅列出了接口中需要的请求参数 | 参数名称 | 必选 | 类型 | 描述 | | ------------------ | -- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | zoneId | 是 | String |

可用区ID。

可通过调用 DescribeZones 获取。

| | instanceType | 是 | String |

实例机型。

普通实例取值可通过 DescribeZoneInstanceConfigInfos 获得；GPU实例取值可通过 DescribeZoneGpuInstanceConfigInfos 获得。

| | instanceCount | 是 | Integer |

实例数量。

可选值范围：\[1, 100]

默认值：1

| | systemDisk | 是 | [SystemDisk](/api-reference/cn/zec/datastructure.md#systemdisk) | 系统盘相关信息。 | | eipV4Type \[已废弃] | 否 | [EipNetworkType](/api-reference/cn/zec/datastructure.md#eipnetworktype) |

公网IPv4的线路类型。

已废弃，请使用networkLineType。

| | networkLineType | 否 | [NetworkLineType](/api-reference/cn/zec/datastructure.md#networklinetype) | 公网IPv4的线路类型。当`internetChargeType`有值时必填。 | | internetChargeType | 否 | [InternetChargeType](/api-reference/cn/zec/datastructure.md#internetchargetype) | 公网IP的网络计费类型。如果不指定，则不会询价公网IP。 | | trafficPackageSize | 否 | Float |

流量包订购大小。

单位为TB。

该值必须在internetChargeType = ByTrafficPackage时才会生效。

可选值范围：\[0.0, +)

| | bandwidth | 否 | Integer |

公网出带宽上限。

单位：Mbps。

可选值范围：\[1, +)

| | dataDisk | 否 | [DataDisk](/api-reference/cn/zec/datastructure.md#datadisk) | 数据盘相关信息。只能配置1块数据盘，配置多块数据盘请使用`dataDisks`；同时指定时以`dataDisks`为准。 | | dataDisks | 否 | Array of [DataDisk](/api-reference/cn/zec/datastructure.md#datadisk) |

数据盘相关信息，支持传入多块数据盘。

若不指定该参数，则回退使用dataDisk。

| ## 3. 响应结果 | 参数名称 | 类型 | 描述 | | ------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | requestId | String |

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 requestId。

| | specPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 规格的价格。 | | gpuPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | GPU规格的价格。 | | acceleratorPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 加速卡规格的价格。 | | ipv4Price | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 公网IPv4的保留价格。仅当`internetChargeType`有值时返回。 | | ipv4BandwidthPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 公网IPv4的带宽价格。仅当`internetChargeType`有值时返回。 | | ipv4BandwidthPrices | Array of [BandwidthPriceResponseItem](/api-reference/cn/zec/datastructure.md#bandwidthpriceresponseitem) |

各流量方向的IPv4带宽价格明细。

仅当internetChargeType有值时返回。

PathBasedBandwidthIP线路返回多项（ipv4BandwidthPrice为null）；其他线路该字段为null，带宽价格见ipv4BandwidthPrice。

| | ipv6Price | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 公网IPv6的价格。仅当`internetChargeType`有值时返回。 | | ipv6BandwidthPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 公网IPv6的带宽价格。仅当`internetChargeType`有值时返回。 | | systemDiskPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 系统盘的价格。 | | dataDiskPrice | [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 数据盘的价格。仅当配置1块数据盘时返回。完整价格明细见`dataDiskPrices`。 | | dataDiskPrices | Array of [PriceItem](/api-reference/cn/zec/datastructure.md#priceitem) | 数据盘的价格明细，与请求中的`dataDisks`按顺序一一对应。 | ## 4. 代码示例 {% tabs %} {% tab title="示例" %} **1. 查询实例的询价（无公网IP）。** ```json POST /api/v2/zec HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateInstance Request： { "zoneId":"asia-east-1a", "instanceType":"z2a.cpu.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": null, "acceleratorPrice": null, "ipv4Price": null, "ipv4BandwidthPrice": null, "ipv4BandwidthPrices": null, "ipv6Price": null, "ipv6BandwidthPrice": null, "systemDiskPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrice": null, "dataDiskPrices": null } } ``` **2. 查询实例的询价（PremiumBGP线路，按带宽计费）。** ```json POST /api/v2/zec HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateInstance Request： { "zoneId":"asia-east-1a", "instanceType":"z2a.cpu.1", "networkLineType": "PremiumBGP", "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": null, "acceleratorPrice": null, "ipv4Price": { "discount": 100, "discountPrice": null, "originalPrice": null, "unitPrice": 0.076389, "discountUnitPrice": 0.076389, "chargeUnit": "HOUR", "stepPrices": null }, "ipv4BandwidthPrice": { "discount": 100, "discountPrice": null, "originalPrice": null, "unitPrice": 0.061112, "discountUnitPrice": 0.061112, "chargeUnit": "HOUR", "stepPrices": null }, "ipv4BandwidthPrices": null, "ipv6Price": null, "ipv6BandwidthPrice": null, "systemDiskPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrice": null, "dataDiskPrices": null } } ``` **3. 查询实例的询价（PathBasedBandwidthIP线路，按带宽计费）。ipv4BandwidthPrice为null，带宽明细见ipv4BandwidthPrices。** ```json POST /api/v2/zec HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateInstance Request： { "zoneId":"SEA-A", "instanceType":"c.1c2g", "networkLineType": "PathBasedBandwidthIP", "internetChargeType":"ByBandwidth", "bandwidth":1, "instanceCount": 1, "systemDisk":{ "diskSize":10 } } Response： { "requestId":"T14792277-G757-5G7B-BF7G-7DGG19EF71C4", "response":{ "requestId":"T14792277-G757-5G7B-BF7G-7DGG19EF71C4", "specPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "gpuPrice": null, "acceleratorPrice": null, "ipv4Price": { "discount": 100, "discountPrice": null, "originalPrice": null, "unitPrice": 0.076389, "discountUnitPrice": 0.076389, "chargeUnit": "HOUR", "stepPrices": null }, "ipv4BandwidthPrice": null, "ipv4BandwidthPrices": [ { "trafficType": "LOCAL", "price": { "discount": 100, "discountPrice": null, "originalPrice": null, "unitPrice": 0.042000, "discountUnitPrice": 0.042000, "chargeUnit": "HOUR", "stepPrices": null } }, { "trafficType": "INTERNATIONAL", "price": { "discount": 100, "discountPrice": null, "originalPrice": null, "unitPrice": 0.088000, "discountUnitPrice": 0.088000, "chargeUnit": "HOUR", "stepPrices": null } } ], "ipv6Price": null, "ipv6BandwidthPrice": null, "systemDiskPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrice": null, "dataDiskPrices": null } } ``` **4. 查询实例的询价，配置多块数据盘。此时 `dataDiskPrice` 为null，完整价格明细见 `dataDiskPrices`。** ```json POST /api/v2/zec HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateInstance Request： { "zoneId":"asia-east-1a", "instanceType":"z2a.cpu.1", "instanceCount": 1, "systemDisk":{ "diskSize":10 }, "dataDisks":[ { "diskSize":100, "diskCategory":"Standard NVMe SSD" }, { "diskSize":200, "diskCategory":"Standard NVMe SSD" } ] } 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": null, "acceleratorPrice": null, "ipv4Price": null, "ipv4BandwidthPrice": null, "ipv4BandwidthPrices": null, "ipv6Price": null, "ipv6BandwidthPrice": null, "systemDiskPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrice": null, "dataDiskPrices": [ { "discount": 95.0, "discountPrice": 144.0, "originalPrice": 152.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, { "discount": 95.0, "discountPrice": 288.0, "originalPrice": 304.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null } ] } } ``` **5. 查询实例的询价，只配置1块数据盘。此时 `dataDiskPrice` 与 `dataDiskPrices` 均返回该数据盘的价格。** ```json POST /api/v2/zec HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateInstance Request： { "zoneId":"asia-east-1a", "instanceType":"z2a.cpu.1", "instanceCount": 1, "systemDisk":{ "diskSize":10 }, "dataDisks":[ { "diskSize":100, "diskCategory":"Standard NVMe SSD" } ] } 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": null, "acceleratorPrice": null, "ipv4Price": null, "ipv4BandwidthPrice": null, "ipv4BandwidthPrices": null, "ipv6Price": null, "ipv6BandwidthPrice": null, "systemDiskPrice": { "discount": 95.0, "discountPrice": 1444.0, "originalPrice": 1520.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrice": { "discount": 95.0, "discountPrice": 144.0, "originalPrice": 152.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null }, "dataDiskPrices": [ { "discount": 95.0, "discountPrice": 144.0, "originalPrice": 152.0, "unitPrice": null, "discountUnitPrice": null, "chargeUnit": null, "stepPrices": null } ] } } ``` {% endtab %} {% endtabs %} ## 5. 开发者工具 Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。 ## 6. 错误码 下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md) | HTTP状态码 | 错误码 | 说明 | | ------- | -------------------------------------------------------------- | ------------------------- | | 400 | INVALID\_DISK\_CATEGORY\_TYPE | 云盘的类型不合法。 | | 404 | INVALID\_INSTANCE\_TYPE\_NOT\_FOUND | 实例规格不存在。 | | 404 | INVALID\_ZONE\_NOT\_FOUND | 可用区不存在。 | | 400 | OPERATION\_DENIED\_EIP\_UNSUPPORTED\_NETWORK\_TYPE | EIP网络计费方式不支持。 | | 400 | OPERATION\_DENIED\_EIP\_NETWORK\_LINE\_TYPE\_NOT\_ON\_SALE | IP线路类型在该节点不可售。 | | 400 | OPERATION\_DENIED\_EIP\_INTERNET\_CHARGE\_TYPE\_NOT\_AVAILABLE | 该节点下指定IP线路类型不支持此网络计费方式。 | | 400 | OPERATION\_DENIED\_FLOW\_PACKAGE\_NOT\_SUPPORTED\_HOUR\_PERIOD | 当前产品周期为小时计费，不支持设置保底流量包大小。 |