InquiryPriceInstanceBandwidth

1. 接口描述

调用本接口用于实例修改带宽询价。

注意事项

  • 仅当机器的internetChargeTypeByBandwidth时可用,且当修改的带宽大于默认带宽时,接口会返回价格。

  • 机器的instanceChargeType不同,返回的价格结构是不同的。

2. 请求参数

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

参数名称
必选
类型
描述

instanceId

String

待操作的实例ID。

可通过DescribeInstances接口返回值中的instanceId获取。

bandwidthOutMbps

Integer

带宽大小。

3. 响应结果

参数名称
类型
描述

bandwidthPrice

Array of Price

公网带宽价格。 可能有多个价格,比如流量包计费,包含包的价格和用量超出包后的价格。

requestId

String

唯一请求 ID。

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

4. 代码示例

1. 实例修改带宽询价

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

Request:
{
  "instanceId": "instanceId",
  "bandwidthOutMbps": 100
}

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

5. 开发者工具

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

6. 错误码

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

HTTP状态码
错误码
说明

404

INVALID_INSTANCE_NOT_FOUND

指定的实例不存在。

403

OPERATION_DENIED_INTERNET_CHARGE_TYPE_NOT_SUPPORT

指定的实例网络模型不是ByBandwidth。

400

INVALID_INSTANCE_TYPE_ZONE_NO_SELL

指定的实例的带宽暂不支持售卖。

最后更新于