# InquiryPriceCreateInstance
## 1. 接口描述
本接口(InquiryPriceCreateInstance)用于创建虚拟机实例询价。
## 2. 请求参数
以下请求参数列表仅列出了接口中需要的请求参数
| 参数名称 | 必选 | 类型 | 描述 |
| ------------------ | -- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| zoneId | 是 | String | 可用区ID。 |
| instanceType | 是 | String | 实例机型。
具体取值可通过调用接口DescribeZoneInstanceConfigInfos来获得最新的规格表。
|
| internetChargeType | 是 | [InternetChargeType](/api-reference/cn/compute/zec/datastructure.md#internetchargetype) | 公网IP的网络计费类型。 |
| instanceCount | 是 | Integer | 实例数量。
可选值范围：\[1, 100]
默认值：1
|
| systemDisk | 是 | [SystemDisk](/api-reference/cn/compute/zec/datastructure.md#systemdisk) | 系统盘相关信息。 |
| eipV4Type \[已废弃] | 否 | [EipNetworkType](/api-reference/cn/compute/zec/datastructure.md#eipnetworktype) | 公网IPv4的线路类型。
目前不支持三线IP(ThreeLine)。
已废弃，请使用networkLineType。
|
| networkLineType | 否 | [NetworkLineType](/api-reference/cn/compute/zec/datastructure.md#networklinetype) | 公网IPv4的线路类型。
目前不支持三线IP(ThreeLine)。
|
| trafficPackageSize | 否 | Float | 流量包订购大小。
单位为TB。
该值必须在internetChargeType = ByTrafficPackage时才会生效。
可选值范围：\[0.0, +)
|
| bandwidth | 否 | Integer | 公网出带宽上限。
单位：Mbps。
可选值范围：\[1, +)
|
| dataDisk | 否 | [DataDisk](/api-reference/cn/compute/zec/datastructure.md#datadisk) | 数据盘相关信息。 |
## 3. 响应结果
| 参数名称 | 类型 | 描述 |
| ------------------ | --------------------------------------------------------------------- | -------------------------------------------------------- |
| requestId | String | 唯一请求 ID。
每次请求都会返回。定位问题时需要提供该次请求的 requestId。
|
| specPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | 规格的价格。 |
| gpuPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | GPU规格的价格。 |
| ipv4Price | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | 公网IPv4的保留价格。 |
| ipv4BandwidthPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | 公网IPv4的带宽价格。 |
| ipv6Price | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | IPv6的价格。 |
| ipv6BandwidthPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | IPv6的带宽价格。 |
| systemDiskPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | 系统盘的价格。 |
| dataDiskPrice | [PriceItem](/api-reference/cn/compute/zec/datastructure.md#priceitem) | 数据盘的价格。 |
## 4. 代码示例
{% tabs %}
{% tab title="示例" %}
**1. 查询实例的询价，带宽计费为固定带宽。**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: InquiryPriceCreateInstance
Request：
{
"zoneId":"SAO-A",
"instanceType":"c.1c2g",
"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": {
"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
}
}
}
```
{% 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网络计费方式不支持。 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.console.zenlayer.com/api-reference/cn/compute/zec/instance/inquirypricecreateinstance.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.