调用ModifyEipAddressAttribute接口修改指定后付费类型EIP的名称、描述信息和带宽峰值。该接口不支持修改预付费类型EIP的名称、描述信息和带宽峰值。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyEipAddressAttribute

系统规定参数。取值：ModifyEipAddressAttribute。
AllocationId String 是 eip-2zeerraiwb7uj6i0d****

需要修改的后付费类型EIP的ID。
Bandwidth String 否 100

需要修改EIP的带宽峰值，取值：

  • 1~200，按使用流量计费，单位为Mbps。
  • 1~500，按固定带宽计费，单位为Mbps。
RegionId String 否 cn-hangzhou

EIP所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

Name String 否 Test123

需要修改的EIP的名称。

长度为1~128个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-）。
Description String 否 abc

需要修改的EIP描述信息。

长度为2~256个字符，必须以字母或中文开头，但不能以http://或https://开头。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyEipAddressAttribute
&AllocationId=eip-2zeerraiwb7uj6i0d****
&Bandwidth=100
&RegionId=cn-hangzhou
&Name=Test123
&Description=abc
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyEipAddressAttributeResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</ModifyEipAddressAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HttpCode 错误码 错误信息 描述
400 OrderError.EIP The Account failed to create order. 下单失败
400 InsufficientBalance.Eip Your account does not have enough balance. 账户余额不足，请先充值再操作。
400 InvalidParameter Specified value of "Bandwidth" is not supported. 该带宽不合法。
400 IncorrectEipStatus Current elastic IP status does not support this operation. 指定的EIP状态不支持此操作。
400 InvalidParameter The parameter is invalid. 该参数值不合法。
400 InvalidEIPStatus.BizDisabled The EIP has been locked. EIP实例被锁定
400 OperationFailed.SyncOrderToSub SyncOrderToSub error. 操作失败
400 Forbidden.FinancialLocked The ip business status is invalid. 该实例已欠费锁定，无法操作
404 InvalidAllocationId.NotFound Specified allocation id is not found. 指定的公网 IP 不存在，请您检查填写的公网 IP 是否正确。
404 Forbidden.RegionNotFound Specified region is not found during access authentication. 指定 Region 不存在，请您检查该 Region 是否正确。
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 内部错误

访问错误中心查看更多错误码。