> 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/compute/zec/elastic-ip/describeeipprice.md).
# DescribeEipPrice
## 1. API Description
This API (DescribeEipPrice) is used to query the price of elastic IPs.
{% 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 | Region ID |
| internetChargeType | Yes | [InternetChargeType](/api-reference/compute/zec/datastructure.md#internetchargetype) | Network billing methods. |
| amount | No | Integer | Quantity.
Value range: \[1, +)
Default value: 1
|
| eipV4Type \[Deprecated] | No | [EipNetworkType](/api-reference/compute/zec/datastructure.md#eipnetworktype) | Network types of public IPv4.
Deprecated. Please use networkLineType instead.
|
| networkLineType | No | [NetworkLineType](/api-reference/compute/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 | CIDR ID. Specifies the CIDR block from which an elastic IP is allocated.
This field and eipV4Type cannot be specified at the same time.
|
| 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/compute/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/compute/zec/datastructure.md#priceitem) | Price of bandwidth. |
| bandwidthPrices | Array of [BandwidthPriceResponseItem](/api-reference/compute/zec/datastructure.md#bandwidthpriceresponseitem) | Bandwidth price details for each traffic direction. |
| remoteBandwidthPrice | [PriceItem](/api-reference/compute/zec/datastructure.md#priceitem) | Price of remote ipt. |
## 4. Code Example
{% tabs %}
{% tab title="Example" %}
**1. Query the price of a BGP public IP, using traffic package billing. The traffic package size is 10TB.**
```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 50Mbps. Domestic and international bandwidth prices 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 | 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. |