调用 ModifyEipAddressAttributes 接口，修改公网IP的名称、 描述、带宽上限。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ModifyEipAddressAttributes | 要执行的操作，取值：ModifyEipAddressAttributes。 |
| Version | String | 是 | 2020-04-01 | API的版本信息，当前版本为2020-04-01。 |
AllocationId | String | 是 | eip-2zb7u8xscd**** | 公网IP的ID。 |
Name | String | 否 | eip-1 | 公网IP的名称。
|
DirectMode | Boolean | 否 | false | 绑定公网IP时是否启用直通模式。取值如下：
说明 EIP直通功能正在邀测中，如需试用，请联系客户经理申请。 |
Description | String | 否 | This is an eip | 公网IP的描述。
|
Bandwidth | Integer | 否 | 10 | 公网IP的带宽上限，单位为Mbps。
|
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 2021062415303301022514515207C4**** | 请求ID。 |
GET /?Action=ModifyEipAddressAttributes&Version=2020-04-01&AllocationId=eip-2zb7uj8xscd****&Bandwidth=10 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ModifyEipAddressAttributes", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result":{ "RequestId": "2021062415303301022514515207C4****" } }
公共错误码，请参见 公共错误码 。
HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidBandwidth.Malformed | The specified bandwidth is malformed.Ensure that bandwidth is not smaller than 1. | 指定的带宽不合法。如果指定带宽，请确保不小于1。 |
| 400 | InvalidDescription.Malformed | The specified description is malformed. Ensure the maximum length of description is 255. | 指定的描述格式不合法。描述长度不能超过255个字符。 |
| 400 | InvalidDescription.Malformed | The specified description is malformed. | 指定的描述格式不合法。请修复描述格式后重试。 |
| 400 | InvalidEip.InvalidStatus | The specified elastic ip is not in the correct status for the request. The specified elastic ip is in freeze. | 指定的公网IP或私有网络所处的状态无法响应该请求。当前公网IP被冻结。 |
| 400 | InvalidDirectModeEip.EIPInBindedMode | EIP in binded mode can not be modified to direct mode. | BINDED模式的EIP不能被更改为直通模式。 |
| 400 | InvalidDirectModeEip.InstanceMismatch | The specified instance type does not support direct mode EIP. | 指定的实例类型不支持EIP直通模式。 |
| 400 | InvalidDirectModeEip.InvalidBindInstanceType | Only elastic network interface bound to ECS support associating direct mode EIP. | 只有绑定了ECS的弹性网卡支持绑定直通EIP。 |
| 400 | InvalidDirectModeEip.InvalidStatus | Only attached EIP support modifying direct mode. | 只有绑定状态的EIP支持修改直通模式。 |
| 400 | InvalidEni.InvalidStatus | The specified elastic network interface is not in the correct status for the request. | 指定的弹性网卡所处的状态无法响应该请求。 |
| 400 | InvalidName.Malformed | The specified name is malformed. Ensure the maximum length of name is 128. | 指定的名称格式不合法。名称长度不能超过128个字符。 |
| 400 | InvalidName.Malformed | The specified name is malformed. | 指定的名称格式不合法。请修复名称格式后重试。 |
| 400 | LimitExceeded.BandwidthPerEip | You've reached the limit on the bandwidth of elastic ip that you can create. | 已达到EIP带宽上限。 |
| 400 | OrderError | Failed to create an order in one step. | 创建订单并支付失败。 |
| 400 | UnsupportedOperation | The request on the specified instance is denied due to the account in arrears status. | 因账户处于欠费状态，对于该实例的操作请求被拒绝。 |
| 400 | UnsupportedOperation | The request on the specified instance is denied due to the account balance and available vouchers are less than 100 yuan in total. | 因账户余额及可用代金券共不足100元，对于该实例的操作请求被拒绝。 |
| 403 | Forbidden | You are not authorized to associate direct mode EIP with ECS. | 无权限绑定直通EIP到ECS上。 |
| 403 | Forbidden.PurchaseLimited | The account is not authorized to purchase the resource. | 此账户无权限购买资源。 |
| 404 | InvalidEip.GetInstanceDetail | Get instance detail failed. | 获取实例信息失败。 |
| 404 | InvalidEip.NotFound | The specified EIP does not exist. | 指定的EIP不存在。 |