InquiryPriceChangeEipInternetChargeType

1. 接口描述

本接口(InquiryPriceChangeEipInternetChargeType)用于查询变更EIP网络计费模式后的价格。

注意事项

• 只有按带宽计费（ByBandwidth）和流量包计费（ByTrafficPackage）类型的EIP才支持变更网络计费模式。

• 变更为按带宽计费（ByBandwidth）时，需传入 bandwidth。

• 变更为流量包计费（ByTrafficPackage）时，需传入 flowPackage（单位TB，为0或0.1的倍数）。

• 变更为共享带宽包计费（BandwidthCluster）且 EIP 为 remoteIpt 类型时，需传入 clusterId。

• 保底流量包大小仅对计费周期为月有效。

2. 请求参数

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

参数名称	必选	类型	描述
eipId	是	String	要操作的公网弹性IP。
internetChargeType	是	InternetChargeType	要变更的目标网络计费类型。
bandwidth	否	Integer	带宽限速。 单位：Mbps。 网络计费方式为按带宽计费（ByBandwidth）时需指定。 可选值范围：[1, +)
flowPackage	否	Float	流量包大小。 单位：TB。 网络计费方式为流量包计费（ByTrafficPackage）时需指定。 可选值范围：[0.0, +)
clusterId	否	String	共享带宽包ID。 网络计费方式为共享带宽包计费（BandwidthCluster）时需指定。

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: InquiryPriceChangeEipInternetChargeType
<Common Request Params>

Request：
{
  "eipId": "eip-xxx",
  "internetChargeType": "ByBandwidth",
  "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	变更的网络计费模式不支持。