Modifies the name, description, and bandwidth limit of a pay-as-you-go elastic IP address (EIP). You cannot call this operation to modify the name, description, or bandwidth limit of a subscription EIP.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyEipAddressAttribute |
The operation that you want to perform. Set the value to ModifyEipAddressAttribute. |
AllocationId | String | Yes | eip-2zeerraiwb7uj6i0d**** |
The ID of the pay-as-you-go EIP. |
Bandwidth | String | No | 100 |
The new bandwidth limit of the EIP. Valid values:
|
RegionId | String | Yes | cn-hangzhou |
The region ID of the EIP. |
Name | String | No | Test123 |
The new name of the EIP. The name must be 1 to 128 characters in length, and can contain digits, periods (.),
underscores (_), and hyphens (-). The name must start with a letter but cannot start
with |
Description | String | No | abc |
The new description for the EIP. The description must be 2 to 256 characters in length. It must start with a letter,
but cannot start with |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=ModifyEipAddressAttribute
&AllocationId=eip-2zeerraiwb7uj6i0d****
&<Common request parameters>
Sample success responses
XML
format
<ModifyEipAddressAttributeResponse>
<RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</ModifyEipAddressAttributeResponse>
JSON
format
null
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InsufficientBalance.Eip | Your account does not have enough balance. | The error message returned because your account balance is insufficient. Top up your account and try again. |
404 | InvalidAllocationId.NotFound | Specified allocation ID is not found | The error message returned because the specified EIP does not exist. Check whether the specified value is valid. |
400 | InvalidParameter | Specified value of "Bandwidth" is not supported. | The error message returned because the specified bandwidth value is invalid. |
500 | InternalError | The request processing has failed due to some unknown error. | The error message returned because an unknown error occurred. |
400 | IncorrectEipStatus | Current elastic IP status does not support this operation. | The error message returned because you cannot perform the operation when the specified EIP is in the current state. |
404 | InvalidAllocationId.NotFound | Specified allocation ID is not found.. | The error message returned because the specified EIP does not exist. Check whether the value of the parameter is valid. |
400 | InvalidParameter | The parameter is invalid. | The error message returned because the parameter is set to an invalid value. |
404 | Forbidden.RegionNotFound | Specified region is not found during access authentication. | The error message returned because the specified region does not exist. Check whether the specified region ID is valid. |
For a list of error codes, visit the API Error Center.