InquiryCreateIPTransitPrice

1. 接口描述

调用本接口用于创建一条IP Transit 的询价。

2. 请求参数

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

参数名称

必选

类型

描述

peerPortId

是

String

端口的ID。

iptDcId

否

String

IP Transit 目的地数据中心ID。如果不指定，则代表和端口位于同一个数据中心。

internetType

否

InternetType

IP Transit的带宽计费方式。

commitBandwidth

否

Integer

保底带宽。单位Mbps。有且仅当internetType=ByInstanceBandwidth95时该字段必传。

bandwidth

是

Integer

带宽限速。单位Mbps 最小值不能低于10Mbps。

routingType

是

IPTransitRouteType

路由类型。

publicIPv4BlockSize

否

Array of Integer

公网IPv4地址。

网段范围：24～30 有且仅当路由类型是Static 或 Gateway时必须指定。目前只允许指定一个公网CIDR。

3. 响应结果

参数名称

类型

描述

requestId

String

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

iptBandwidthPrice

Price

IP Transit 的公网带宽价格。

publicIpPrices

Array of IPPrice

IP Transit 的公网IP价格

privateConnectPrice

Price

IP Transit 的专线价格。如果IP Transit 和端口位于同一个数据中心，则取值为null。

4. 代码示例

1. 查询创建一条IP Transit，公网地址使用/25的CIDR。带宽限速为50Mbps, 计费方式为固定带宽。

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

Request：
{
  "iptDescription": "test_ipt_desc",
  "peerPortId": "your-port-id",
  "internetType": "ByBandwidth",
  "bandwidth": 50,
  "iptDcId": "AMS1",
  "routingType": "Static",
  "publicIPv4BlockSize": [
    25
  ]
}

Response：
{
    "requestId": "TBE062689-3CF2-429C-BD2A-6CB7BAB39C11",
    "response": {
        "publicIpPrices": [
            {
                "netmask": 25,
                "price": {
                    "unitPrice": 0.233334,
                    "originalPrice": null,
                    "discountPrice": null,
                    "discount": 100,
                    "stepPrices": null,
                    "discountUnitPrice": 0.233334,
                    "chargeUnit": "DAY",
                    "amountUnit": null
                },
                "qty": 1
            }
        ],
        "requestId": "TBE062689-3CF2-429C-BD2A-6CB7BAB39C11",
        "privateConnectPrice": {
            "unitPrice": 8.250000,
            "originalPrice": null,
            "discountPrice": null,
            "discount": 100,
            "stepPrices": null,
            "discountUnitPrice": 8.250000,
            "chargeUnit": "DAY",
            "amountUnit": null
        },
        "iptBandwidthPrice": {
            "unitPrice": 3.333334,
            "originalPrice": null,
            "discountPrice": null,
            "discount": 100,
            "stepPrices": null,
            "discountUnitPrice": 3.333334,
            "chargeUnit": "DAY",
            "amountUnit": null
        }
    }
}

5. 开发者工具

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

6. 错误码

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

HTTP状态码

错误码

说明

404

INVALID_PORT_NOT_FOUND

数据中心端口不存在

400

INVALID_PORT_STATUS

数据中心连通性状态不是UP，无法操作

400

INVALID_ENDPOINT_PARAMETER

端点的参数不正确，无法判断类型

400

INVALID_CONNECT_ENDPOINT_CONFLICT

A-Z 两端的信息不能一样

最后更新于2个月前