调用 ModifyEipAddressAttributes 接口，修改公网IP的名称、描述、带宽上限。 ## 调用说明 * 降低带宽上限，可能会影响业务流量造成丢包，请充分评估可能对业务产生的影响，并谨慎操作。 * 以下可选参数如不配置，则保持不变。 ## 调试 ## 请求参数 |参数名称 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |ModifyEipAddressAttributes |要执行的操作，取值：ModifyEipAddressAttributes。 | |Version |String |是 |2020\-04\-01 |API的版本信息，当前版本为2020\-04\-01。 | |AllocationId |String |是 |eip\-2zb7u8xscd\*\*\*\* |公网IP的ID。|\ | | | | |您可以调用 [DescribeEipAddresses](https://www.volcengine.com/docs/6402/71035) 接口，查询公网IP的ID。 | |Name |String |否 |eip\-1 |公网IP的名称。|\ | | | | ||\ | | | | |* 长度限制为1 ~ 128个字符。|\ | | | | |* 需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短划线（\-）。 | |DirectMode |Boolean |否 |false |绑定公网IP时是否启用直通模式。请严格按照以下枚举值的大小写输入，不要传入其他取值。|\ | | | | ||\ | | | | |* false（默认）：不使用直通模式。|\ | | | | |* true：使用直通模式。|\ | | | | ||\ | | | | |:::tip|\ | | | | |EIP直通功能正在邀测中，如需试用，请联系客户经理申请。|\ | | | | ||\ | | | | |:::| |Description |String |否 |This is an eip |公网IP的描述。|\ | | | | ||\ | | | | |* 长度限制为0~ 255个字符。|\ | | | | |* 需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。）。 | |Bandwidth |Integer |否 |10 |公网IP的带宽上限，单位为Mbps。|\ | | | | ||\ | | | | |* 按量计费\-按实际流量计费：取值范围1 ~ 200。|\ | | | | |* 按量计费\-按带宽上限计费：取值范围1 ~ 1000。|\ | | | | |* 包年包月计费：取值范围1 ~ 1000。 | ## 返回数据 |参数名称 |类型 |示例值 |描述 | |---|---|---|---| |RequestId |String |2021062415303301022514515207C4\*\*\*\* |请求ID。 | ## 请求示例 ```Plain Text GET /?Action=ModifyEipAddressAttributes&Version=2020-04-01&AllocationId=eip-2zb7uj8xscd****&Bandwidth=10 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing ``` ## 返回示例 ```Plain Text { "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ModifyEipAddressAttributes", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result":{ "RequestId": "2021062415303301022514515207C4****" } } ``` ## 错误码公共错误码，请参见 [公共错误码](https://www.volcengine.com/docs/6402/71033) 。 |HttpCode |错误码 |错误信息 |描述 | |---|---|---|---| |400 |DryRunOperation |Exception raised to indicate a successfully authorized action when the DryRun flag is set to true. |该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。 | |^^|InvaildIpv6.NotSupport |The specified IPv6 address does not support this operation. |指定的IPv6地址不支持此操作。 | |^^|InvalidBandwidth.Malformed |The specified bandwidth is malformed.Ensure that bandwidth is not smaller than 1. |指定的带宽不合法。如果指定带宽，请确保不小于1。 | |^^|InvalidBandwidth.Malformed|The specified bandwidth is malformed. During the temporary upgrade period, the bandwidth can only be greater。 |指定的带宽不合法。临时升配期间只能调高带宽。 |\ | | | | | |^^|InvalidDescription.Malformed |The specified description is malformed. Ensure the maximum length of description is 255. |指定的描述格式不合法。描述长度不能超过255个字符。 | |^^|InvalidDescription.Malformed |The specified description is malformed. |指定的描述格式不合法。请修复描述格式后重试。 | |^^|InvalidDirectModeEip.EIPInBindedMode |EIP in binded mode can not be modified to direct mode. |BINDED模式的EIP不能被更改为直通模式。 | |^^|InvalidDirectModeEip.IPv4GatewayEnabled |EIP not allowed to open direct mode when VPC has enabled IPv4 gateway. |VPC已开启IPv4网关，EIP无法开启直通模式。 | |^^|InvalidDirectModeEip.InstanceMismatch |The specified instance type does not support direct mode EIP. |指定的实例类型不支持直通EIP。 | |^^|InvalidDirectModeEip.InvalidBindInstanceType |Only elastic network interface bound to ECS support associating direct mode EIP. |只有绑定了ECS的弹性网卡支持绑定直通EIP。 | |^^|InvalidDirectModeEip.InvalidStatus |Only attached EIP support modifying direct mode. |只有绑定状态的EIP支持修改直通模式。 | |^^|InvalidEip.InUse |The specified EIP is being operated by another request. |指定的EIP正被另一个请求操作，请稍后再试。 | |^^|InvalidEip.InvalidStatus |The specified elastic ip is not in the correct status for the request. The specified elastic ip is in freeze. |指定的弹性公网IP或私有网络所处的状态无法响应该请求。当前弹性公网IP被冻结。 | |^^|InvalidEip.InvalidStatus |The specified elastic ip is not in the correct status for the request. |指定的弹性公网IP所处的状态无法响应该请求。 | |^^|InvalidEip.NotSupported |The specified elastic IP does not support temporary upgrade. |指定的弹性公网IP不支持临时升配。|\ | | | | | |^^|InvalidEni.InvalidStatus |The specified elastic network interface is not in the correct status for the request. |指定的弹性网卡所处的状态无法响应该请求。 | |^^|InvalidModeEip.DirectMode |EIP not allowed to open direct mode. |EIP 无法开启直通模式。 | |^^|InvalidName.Malformed |The specified name is malformed. Ensure the maximum length of name is 128. |指定的名称格式不合法。名称长度不能超过128个字符。 | |^^|InvalidName.Malformed |The specified name is malformed. |指定的名称格式不合法。请修复名称格式后重试。 | |^^|InvalidOperation.InvalidBindInstanceType |Only EIPs bound to ECS support releasing with instances. |EIP随实例释放功能只对绑定ECS实例时生效。 | |^^|InvalidOperation.InvalidEipBillingType |Only postpaid EIPs support releasing with instances. |只有按量付费EIP支持随实例释放功能。 | |^^|InvalidVpc.InvalidStatus |The specified VPC is not in the correct status for the request. |指定的VPC所处状态无法响应该请求。 | |^^|LimitExceeded.BandwidthPerEip |You've reached the limit on the bandwidth of elastic ip that you can create. |已达到EIP带宽上限。 | |^^|OrderError |Failed to create an order in one step. |创建订单并支付失败。 | |^^|PreOrderError |Failed to create pre order. |创建配置单失败。 | |^^|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元，对于该实例的操作请求被拒绝。 | |^^|UnsupportedOperation |The request on the specified instance is denied due to the account in arrears status. |因账户处于欠费状态，对于该实例的操作请求被拒绝。 | |403 |Forbidden |You are not authorized to associate direct mode EIP with ECS. |无权限绑定直通EIP到ECS上。 | |^^|Forbidden |You are not authorized to perform operations on the specified EIP. The specified EIP is a service\-managed EIP. |无权限对指定EIP进行操作。指定的EIP为云产品托管的EIP。 | |^^|Forbidden.PurchaseLimited |The account is not authorized to purchase the resource. |此账户无权限购买资源。 | |404 |InvalidEip.GetInstanceDetail |Get instance detail failed. |获取实例信息失败。 | |^^|InvalidEip.NotFound |The specified EIP does not exist. |指定的EIP不存在。 |