InquiryPriceChangeUnmanagedEgressIpInternetChargeType

1. 接口描述

本接口(InquiryPriceChangeUnmanagedEgressIpInternetChargeType)用于查询变更非托管出口IP网络计费模式后的价格。

注意事项

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

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

• 变更为共享带宽包计费（BandwidthCluster）时，bandwidthPrice 返回null（不收费）。

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

2. 请求参数

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

参数名称	必选	类型	描述
unmanagedEgressIpId	是	String	要操作的非托管出口IP。
internetChargeType	是	InternetChargeType	要变更的目标网络计费类型。
bandwidth	否	Integer	带宽限速。 单位：Mbps。 变更为按带宽计费（ByBandwidth）时必传。 可选值范围：[1, +)
flowPackage	否	Float	流量包大小。 单位：TB，为0或0.1的倍数。 变更为流量包计费（ByTrafficPackage）时必传。 可选值范围：[0.0, +)

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
bandwidthPrice	PriceItem	非托管出口IP的带宽价格。 变更为共享带宽包计费（BandwidthCluster）时为null（免费）。

4. 代码示例

示例

查询将非托管出口IP变更为按带宽计费（带宽20Mbps）后的价格。

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

Request：
{
  "unmanagedEgressIpId": "uneip-xxx",
  "internetChargeType": "ByBandwidth",
  "bandwidth": 20
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
    "bandwidthPrice": {
      "discount": 100.0,
      "discountPrice": null,
      "originalPrice": null,
      "unitPrice": 0.02,
      "discountUnitPrice": 0.02,
      "chargeUnit": "HOUR",
      "stepPrices": null
    }
  }
}

5. 开发者工具

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

6. 错误码

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

HTTP状态码	错误码	说明
404	INVALID_UNMANAGED_EGRESS_IP_NOT_FOUND	非托管出口IP不存在。
400	OPERATION_DENIED_UNMANAGED_EGRESS_IP_UNSUPPORTED_INTERNET_CHARGE_TYPE	非托管出口IP不支持该网络类型变更。
400	OPERATION_DENIED_FLOW_PACKAGE_NOT_SUPPORTED_HOUR_PERIOD	当前产品周期为小时计费，不支持设置保底流量包大小。