> 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/public-ipv6/inquirypricemodifyipv6bandwidth.md).

# InquiryPriceModifyIpv6Bandwidth

## 1. API Description

This API (InquiryPriceModifyIpv6Bandwidth) is used to inquire the price after adjusting the IPv6 bandwidth. The currently effective price of each billing item before the change is also returned through previousPrices, so that you can compare which billing items have price changes.

{% hint style="info" %}
**Notes**

* Only IPv6 addresses billed by bandwidth (`ByBandwidth`) support this operation.
  {% endhint %}

## 2. Input Parameters

The following request parameter list only provides API request parameters.

| Parameter Name | Required | Type    | Description                                                                                                                                                                    |
| -------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ipv6Id         | Yes      | String  | <p>Public IPv6 address to be operated on.</p><p>It can be obtained by calling <a href="/api-reference/zec/public-ipv6/describeipv6addresses.md">DescribeIpv6Addresses</a>.</p> |
| bandwidth      | Yes      | Integer | <p>Bandwidth limit after adjustment.</p><p>Unit: Mbps.</p><p>Value range: \[1, +)</p>                                                                                          |

## 3. Output Parameters

| Parameter Name | Type                                                                         | Description                                                                                                                                                                                                                       |
| -------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| requestId      | String                                                                       | <p>The unique request ID, which is returned for each request.</p><p>RequestId is required for locating a problem.</p>                                                                                                             |
| ipv6Price      | [PriceItem](/api-reference/zec/datastructure.md#priceitem)                   | Retention price of the public IPv6 address.                                                                                                                                                                                       |
| bandwidthPrice | [PriceItem](/api-reference/zec/datastructure.md#priceitem)                   | Bandwidth price for the public IPv6 address.                                                                                                                                                                                      |
| previousPrices | [Ipv6PreviousPrices](/api-reference/zec/datastructure.md#ipv6previousprices) | <p>Currently effective price of each billing item before the change. The fields correspond one by one to those above and are used to compare which billing items have price changes.</p><p>It is null when there is no order.</p> |

## 4. Code Example

{% tabs %}
{% tab title="Example" %}
**Inquire the price after adjusting the IPv6 bandwidth to 20 Mbps.**

```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: InquiryPriceModifyIpv6Bandwidth
<Common Request Params>

Request：
{
  "ipv6Id": "ipv6-xxx",
  "bandwidth": 20
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
    "ipv6Price": null,
    "bandwidthPrice": {
      "discount": 100.0,
      "discountPrice": null,
      "originalPrice": null,
      "unitPrice": 0.02,
      "discountUnitPrice": 0.02,
      "chargeUnit": "HOUR",
      "stepPrices": null
    },
    "previousPrices": {
      "ipv6Price": null,
      "bandwidthPrice": {
        "discount": 100.0,
        "discountPrice": null,
        "originalPrice": null,
        "unitPrice": 0.015,
        "discountUnitPrice": 0.015,
        "chargeUnit": "HOUR",
        "stepPrices": 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                                                |
| ---------------- | ------------------------------------------------------- | ---------------------------------------------------------- |
| 404              | INVALID\_IPV6\_NOT\_FOUND                               | The IPv6 address is not found.                             |
| 400              | OPERATION\_DENIED\_INTERNET\_CHARGE\_TYPE\_NOT\_SUPPORT | IP network billing type is not supported.                  |
| 500              | OPERATION\_DENIED\_IPV6\_BANDWIDTH\_NOT\_SUPPORT        | The IPv6 bandwidth status does not support this operation. |
| 400              | INVALID\_PARAMETER\_BANDWIDTH\_EXCEED                   | Bandwidth size exceeds the upper limit.                    |