> 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/zlb/load-balancer-instance/inquirypricecreateloadbalancer.md). # InquiryPriceCreateLoadBalancer ## 1. 接口描述 本接口(InquiryPriceCreateLoadBalancer)用于查询创建负载均衡的价格。 ## 2. 请求参数 以下请求参数列表仅列出了接口中需要的请求参数 | 参数名称 | 必选 | 类型 | 描述 | | -------------------- | -- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | regionId | 是 | String |

区域节点ID。

可通过调用 DescribeRegions 获取。

| | ipStackType | 否 | [LoadBalancerIpStackType](/api-reference/cn/zlb/datastructure.md#loadbalanceripstacktype) |

IP堆栈类型。

负载均衡实例只支持单栈，即IPv4或IPv6，不支持双栈。

指定为IPv6时不支持配置公网网络参数（internetChargeType、networkLineType、bandwidthMbps、trafficPackageSize、bandwidthClusterId）——IPv6负载均衡的公网地址通过 AssignLoadBalancerIpv6 接口单独分配。

默认值：IPv4

| | internetChargeType | 否 | [InternetChargeType](/api-reference/cn/zlb/datastructure.md#internetchargetype) |

IP网络计费模式。

使用已有EIP创建负载均衡时请勿传本参数——不传表示本次不新建EIP，询价结果中不含EIP相关费用；传了则按新建EIP计价，会多算一份EIP费用。

| | ipNetworkType \[已废弃] | 否 | [EipNetworkType](/api-reference/cn/zlb/datastructure.md#eipnetworktype) |

IP的网络类型。

已废弃，请使用networkLineType。

| | networkLineType | 否 | [NetworkLineType](/api-reference/cn/zlb/datastructure.md#networklinetype) | IP的网络类型。 | | bandwidthMbps | 否 | Integer |

EIP的最大出带宽。单位为Mbps。最大限制通常为10000，如果有额外要求，请联系Support。当internetChargeType为ByBandwidth时，此参数必填。

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

| | trafficPackageSize | 否 | Float |

流量包大小。

指定此参数时，IP网络计费模式(internetChargeType)需为ByTrafficPackage，否则该参数不生效。

仅当计费周期为月时支持设置，小时计费不支持。

可选值范围：\[0.0, 999999.0]

| | bandwidthClusterId | 否 | String |

共享带宽包ID。

指定此参数时，IP网络计费模式(internetChargeType)需为BandwidthCluster，否则该参数不生效。

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

唯一请求 ID。

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

| | loadBalancerInstancePrice | [PriceItem](/api-reference/cn/zlb/datastructure.md#priceitem) | 负载均衡实例的价格。 | | eipPrice | [PriceItem](/api-reference/cn/zlb/datastructure.md#priceitem) | 弹性IP的价格。 | | eipNetworkPrice | [PriceItem](/api-reference/cn/zlb/datastructure.md#priceitem) | 弹性IP的网络计费的价格。 | | eipNetworkPrices | Array of [BandwidthPriceResponseItem](/api-reference/cn/zlb/datastructure.md#bandwidthpriceresponseitem) |

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

PathBasedBandwidthIP线路返回多项（eipNetworkPrice为null）；其他线路返回单项（trafficType=ALL）。

| | lcuPrice | [PriceItem](/api-reference/cn/zlb/datastructure.md#priceitem) | 负载均衡实例LCU的价格。 | ## 4. 代码示例 {% tabs %} {% tab title="示例" %} **1. 查询创建一个公网负载均衡实例价格（PremiumBGP线路，按带宽计费）。** ```json POST /api/v2/zlb HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateLoadBalancer Request： { "regionId" : "asia-east-1", "internetChargeType" : "ByBandwidth", "networkLineType" : "PremiumBGP", "bandwidthMbps" : 2, "trafficPackageSize" : null } Response： { "requestId": "T775F300E-F989-4CC8-BB6E-0452A4C7EA03", "response": { "requestId": "T775F300E-F989-4CC8-BB6E-0452A4C7EA03", "lcuPrice": { "unitPrice": null, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": [ { "unitPrice": 1, "stepStart": 0, "discountUnitPrice": 1, "stepEnd": null } ], "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": null, "chargeUnit": "HOUR", "amountUnit": "LCU", "excessDiscountUnitPrice": null }, "loadBalancerInstancePrice": { "unitPrice": 0.016806, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.016806, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipPrice": { "unitPrice": 0.076389, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.076389, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipNetworkPrice": { "unitPrice": 0.061112, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.061112, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipNetworkPrices": [ { "trafficType": "ALL", "price": { "unitPrice": 0.061112, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.061112, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null } } ] } } ``` **2. 查询创建一个公网负载均衡实例价格（PathBasedBandwidthIP线路，按带宽计费）。eipNetworkPrice为null，带宽明细见eipNetworkPrices。** ```json POST /api/v2/zlb HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateLoadBalancer Request： { "regionId" : "asia-east-1", "internetChargeType" : "ByBandwidth", "networkLineType" : "PathBasedBandwidthIP", "bandwidthMbps" : 2, "trafficPackageSize" : null } Response： { "requestId": "T885F400E-G990-4DD8-CC7F-1563B5D8FB04", "response": { "requestId": "T885F400E-G990-4DD8-CC7F-1563B5D8FB04", "lcuPrice": { "unitPrice": null, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": [ { "unitPrice": 1, "stepStart": 0, "discountUnitPrice": 1, "stepEnd": null } ], "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": null, "chargeUnit": "HOUR", "amountUnit": "LCU", "excessDiscountUnitPrice": null }, "loadBalancerInstancePrice": { "unitPrice": 0.016806, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.016806, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipPrice": { "unitPrice": 0.076389, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.076389, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipNetworkPrice": null, "eipNetworkPrices": [ { "trafficType": "LOCAL", "price": { "unitPrice": 0.042000, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.042000, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null } }, { "trafficType": "INTERNATIONAL", "price": { "unitPrice": 0.088000, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.088000, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null } } ] } } ``` **3. 使用已有的弹性公网IP（EIP）创建负载均衡实例的询价。不传IP网络相关参数即表示不新建EIP，故`eipPrice`、`eipNetworkPrice`、`eipNetworkPrices`均为空。** ```json POST /api/v2/zlb HTTP/1.1 Host: console.zenlayer.com Content-Type: application/json X-ZC-Action: InquiryPriceCreateLoadBalancer Request： { "regionId" : "asia-east-1" } Response： { "requestId": "T996G500F-H001-4EE9-DD8G-2674C6E9GC15", "response": { "requestId": "T996G500F-H001-4EE9-DD8G-2674C6E9GC15", "lcuPrice": { "unitPrice": null, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": [ { "unitPrice": 1, "stepStart": 0, "discountUnitPrice": 1, "stepEnd": null } ], "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": null, "chargeUnit": "HOUR", "amountUnit": "LCU", "excessDiscountUnitPrice": null }, "loadBalancerInstancePrice": { "unitPrice": 0.016806, "originalPrice": null, "discountPrice": null, "discount": 100, "stepPrices": null, "excessUnitPrice": null, "excessAmountUnit": null, "discountUnitPrice": 0.016806, "chargeUnit": "HOUR", "amountUnit": null, "excessDiscountUnitPrice": null }, "eipPrice": null, "eipNetworkPrice": null, "eipNetworkPrices": 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 | OPERATION\_DENIED\_FLOW\_PACKAGE\_NOT\_SUPPORTED\_HOUR\_PERIOD | 当前产品周期为小时计费，不支持设置保底流量包大小。 |