InquiryPriceModifyEipBandwidth

1. 接口描述

本接口(InquiryPriceModifyEipBandwidth)用于查询调整EIP带宽后的价格。

注意事项

• 只有可用状态（BINDED、UNBIND）且网络计费方式为按带宽计费（ByBandwidth）的EIP才支持该操作。

• 国际线路（PathBasedBandwidthIP）不支持该操作。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
eipId	是	String	要操作的公网弹性IP。
bandwidth	是	Integer	调整后的带宽上限。 单位：Mbps。 可选值范围：[1, +)

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
eipPrice	PriceItem	公网弹性IP的保留价格。 通过CIDR创建的IP保留价格为null。
bandwidthPrice	PriceItem	公网弹性IP的带宽价格。 PathBasedBandwidthIP线路时为null，详见bandwidthPrices。
bandwidthPrices	Array of BandwidthPriceResponseItem	各流量方向的带宽价格明细。 PathBasedBandwidthIP线路返回多项；其他线路返回单项（trafficType=ALL）。
remoteBandwidthPrice	PriceItem	Remote IPT的带宽价格。 EIP未开启Remote IPT时为null。

4. 代码示例

示例

查询将EIP带宽调整为20Mbps后的价格。

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

Request：
{
  "eipId": "eip-xxx",
  "bandwidth": 20
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
    "eipPrice": {
      "discount": 100.0,
      "discountPrice": null,
      "originalPrice": null,
      "unitPrice": 0.005,
      "discountUnitPrice": 0.005,
      "chargeUnit": "HOUR",
      "stepPrices": null
    },
    "bandwidthPrice": {
      "discount": 100.0,
      "discountPrice": null,
      "originalPrice": null,
      "unitPrice": 0.02,
      "discountUnitPrice": 0.02,
      "chargeUnit": "HOUR",
      "stepPrices": null
    },
    "bandwidthPrices": [
      {
        "trafficType": "ALL",
        "price": {
          "discount": 100.0,
          "discountPrice": null,
          "originalPrice": null,
          "unitPrice": 0.02,
          "discountUnitPrice": 0.02,
          "chargeUnit": "HOUR",
          "stepPrices": null
        }
      }
    ],
    "remoteBandwidthPrice": null
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
404	INVALID_EIP_NOT_FOUND	EIP不存在。
500	OPERATION_DENIED_EIP_STATUS_NOT_SUPPORT	EIP 状态不支持此操作。
400	OPERATION_DENIED_INTERNET_CHARGE_TYPE_NOT_SUPPORT	IP网络计费方式不支持。
400	OPERATION_DENIED_EIP_UNSUPPORTED_INTERNET_CHARGE_TYPE	变更的网络计费模式不支持。
400	INVALID_PARAMETER_BANDWIDTH_EXCEED	带宽限速值超过最大限制。