ModifyEipBandwidth

1. 接口描述

本接口(ModifyEipBandwidth)用于调整弹性公网IP的带宽限速。

注意事项

• 只有可用状态(BINDED、UNBIND)的EIP才支持该操作。

• 该操作为异步执行，调用成功后带宽变更将在后台处理。可通过查询EIP列表接口的 operationInfo 字段获取当前操作状态。

2. 请求参数

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

参数名称	必选	类型	描述
eipId	是	String	EIP唯一标识ID。
bandwidth	是	Integer	调整带宽限速的目标值。 单位Mbps。 可选值范围：[1, +)
commitBandwidth [已废弃]	否	Integer	已废弃，该参数不再生效，传值将被忽略。 已配置突发带宽的 EIP 保持原值不变；若本次 bandwidth 超过原突发带宽，突发带宽将自动上调至与 bandwidth 一致。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。

4. 代码示例

示例

1. 调整EIP带宽限速到10Mbps。

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

Request：
{
    "eipId": "< EipId >",
    "bandwidth": 10
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3"
  }
}

5. 开发者工具

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

6. 错误码

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

HTTP状态码	错误码	说明
404	INVALID_EIP_NOT_FOUND	EIP不存在。
400	INVALID_PARAMETER_BANDWIDTH_EXCEED	带宽限速值超过最大限制。
400	OPERATION_DENIED_EIP_IN_RISK_CONTROL	EIP在风控中不支持此操作。
500	OPERATION_DENIED_EIP_STATUS_NOT_SUPPORT	EIP 状态不支持此操作。
400	OPERATION_DENIED_INTERNET_CHARGE_TYPE_NOT_SUPPORT	IP网络计费方式不支持。
400	OPERATION_DENIED_LATEST_OPERATION_NOT_FINISHED	上一操作未结束或已失败，请稍后再试。