> 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/zec/elastic-ip/describeeipprice.md).
# DescribeEipPrice
## 1. API Description
This API (DescribeEipPrice) is used to inquire the price of creating an elastic IP.
{% hint style="info" %}
**Notes**
* The size of the guaranteed traffic package is only valid for billing periods of one month.
{% endhint %}
## 2. Input Parameters
The following request parameter list only provides API request parameters.
| Parameter Name | Required | Type | Description |
| ----------------------- | -------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| regionId | Yes | String | ID of the region where the EIP is created.
It can be obtained by calling DescribeRegions.
|
| internetChargeType | Yes | [InternetChargeType](/api-reference/zec/datastructure.md#internetchargetype) | Network billing methods. |
| amount | No | Integer | Quantity.
Value range: \[1, +)
Default value: 1
|
| eipV4Type \[Deprecated] | No | [EipNetworkType](/api-reference/zec/datastructure.md#eipnetworktype) | Network types of public IPv4.
Deprecated. Please use networkLineType instead.
|
| networkLineType | No | [NetworkLineType](/api-reference/zec/datastructure.md#networklinetype) | Network types of public IPv4. |
| bandwidth | No | Integer | Bandwidth limit for the elastic public IP.
Unit: Mbps.
Value range: \[1, +)
|
| flowPackage | No | Float | Traffic package size of the EIP.
Unit: TB.
The value must be 0 or a multiple of 0.1.
Required when the network billing type is traffic package billing (ByTrafficPackage).
Value range: \[0.0, +)
|
| cidrId | No | String | Specify a CIDR ID to allocate the elastic IP from this CIDR block.
This field and eipV4Type cannot be specified at the same time.
It can be obtained by calling DescribeCidrs.
|
| clusterId | No | String | Shared bandwidth package ID.
Required when peerRegionId is specified and the network billing method is shared bandwidth package billing (BandwidthCluster).
|
| peerRegionId | No | String | Remote region ID. |
## 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.
|
| eipPrice | [PriceItem](/api-reference/zec/datastructure.md#priceitem) | Reservation price of the elastic public IP.
If the elastic IP is created from a CIDR block, the reservation price is null.
|
| bandwidthPrice | [PriceItem](/api-reference/zec/datastructure.md#priceitem) | Price of bandwidth. |
| bandwidthPrices | Array of [BandwidthPriceResponseItem](/api-reference/zec/datastructure.md#bandwidthpriceresponseitem) | Bandwidth price details of each traffic direction.
Multiple items are returned for the PathBasedBandwidthIP line (bandwidthPrice is null), and a single item is returned for other lines (trafficType=ALL).
|
| remoteBandwidthPrice | [PriceItem](/api-reference/zec/datastructure.md#priceitem) | Price of remote ipt. |
## 4. Code Example
{% tabs %}
{% tab title="Example" %}
**1. Query the price of a BGP public IP billed by traffic package. The traffic package size is 10 TB.**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeEipPrice
Request：
{
"regionId": "asia-east-1",
"amount": 1,
"internetChargeType": "ByTrafficPackage",
"networkLineType": "PremiumBGP",
"bandwidth": 50,
"flowPackage": 10
}
Response：
{
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"response": {
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"eipPrice": {
"discount": 95.0,
"discountPrice": 100.0,
"originalPrice": 100.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
},
"bandwidthPrice": {
"discount": 95.0,
"discountPrice": 100.0,
"originalPrice": 100.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
},
"bandwidthPrices": [
{
"trafficType": "ALL",
"price": {
"discount": 95.0,
"discountPrice": 100.0,
"originalPrice": 100.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
}
}
],
"remoteBandwidthPrice": null
}
}
```
**2. Query the price of a PathBasedBandwidthIP billed by bandwidth, with a bandwidth of 50 Mbps. The prices for domestic and international bandwidth are returned separately, and bandwidthPrice is null.**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeEipPrice
Request：
{
"regionId": "asia-east-1",
"amount": 1,
"internetChargeType": "ByBandwidth",
"networkLineType": "PathBasedBandwidthIP",
"bandwidth": 50
}
Response：
{
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"response": {
"requestId": "TBFC01FCF-6439-4530-ADBC-16809F0C3E8F",
"eipPrice": {
"discount": 95.0,
"discountPrice": 100.0,
"originalPrice": 100.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
},
"bandwidthPrice": null,
"bandwidthPrices": [
{
"trafficType": "LOCAL",
"price": {
"discount": 100.0,
"discountPrice": 80.0,
"originalPrice": 80.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
}
},
{
"trafficType": "INTERNATIONAL",
"price": {
"discount": 100.0,
"discountPrice": 120.0,
"originalPrice": 120.0,
"unitPrice": null,
"discountUnitPrice": null,
"chargeUnit": null,
"stepPrices": null
}
}
],
"remoteBandwidthPrice": null
}
}
```
{% endtab %}
{% endtabs %}
## 5. Developer Resources
Zenlayer Cloud API 2.0 integrates [SDKs](/api-reference/api-introduction/toolkit/api-sdk.md)，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](/api-reference/api-introduction/instruction/commonerrorcode.md).
| HTTP Status Code | Error Code | Description |
| ---------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| 400 | OPERATION\_DENIED\_EIP\_NETWORK\_LINE\_TYPE\_NOT\_ON\_SALE | The IP network line type is not available in this region. |
| 400 | OPERATION\_DENIED\_EIP\_INTERNET\_CHARGE\_TYPE\_NOT\_AVAILABLE | The specified IP network line type in this region does not support this network billing mode. |
| 400 | OPERATION\_DENIED\_INTERNET\_CHARGE\_TYPE\_NOT\_SUPPORT | IP network billing type is not supported. |
| 400 | INVALID\_PREFIX\_LENGTH\_OUT\_OF\_RANGE | The prefix length of the EIP is invalid. |
| 400 | OPERATION\_DENIED\_FLOW\_PACKAGE\_NOT\_SUPPORTED\_HOUR\_PERIOD | The current product cycle is based on hourly billing and does not support setting a minimum data package size. |