All Products
Search
Document Center

Elastic Compute Service:ModifyEipAddressAttribute

Last Updated:Jul 28, 2026

ModifyEipAddressAttribute

Note

This API has been deprecated. We recommend migrating to Vpc(2016-04-28) - ModifyEipAddressAttribute for enhanced functionality and continued support. While the deprecated API remains temporarily accessible, no further updates or bug fixes will be provided.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vpc:ModifyEipAddressAttribute

update

*Address

acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

AllocationId

string

Yes

Bandwidth

string

Yes

Response elements

Element

Type

Description

Example

object

RequestId

string

Examples

Success response

JSON format

{
  "RequestId": ""
}

Error codes

HTTP status code

Error code

Error message

Description

400 InsufficientBalance.Eip Your account does not have enough balance. Your account balance is insufficient. Add funds to your account and try again.
400 InvalidParameter Specified value of "Bandwidth" is not supported.
400 IncorrectEipStatus Current elastic IP status does not support this operation. The EIP is in a state that does not support the operation.
400 InvalidParam The Ecmp routerEntry with router interfaces local vgw vip not match. The route entry does not match the local gateway VIP of the router interface.
400 Forbidden.ChargeTypeIsPrepaid It?s forbidden to change prepaid EIP?s bandwidth by API. It can be changed on Aliyun web console.
400 InvalidBandwidth.OutOfMaxTrafficBindedOnNatgw
400 QuotaExceeded.LargeSpecEip Elastic IP address with large spec quota exceeded.
400 InvalidEipAddressName.Malformed The specified Name is not valid.
400 ResourceQueryError The specified resource is queried error.
400 InvalidDescription.Malformed Invalid description.
400 InvalidEIPStatus.BizDisabled The EIP has been locked.
400 OperationFailed.SyncOrderToSub SyncOrderToSub error.
400 COMMODITY.INVALID_COMPONENT The instance component is invalid.
400 OperationFailed.CompleteUserInfo Complete user info failed.
400 OperationFailed.ConcurrentRequest Operation failed because concurrent request.
400 IncorrectStatus.ResourceStatus Resource status is abnormal for renew.
400 OperationFailed.SaleValidate Validate sale condition with subArticle failed.
500 InternalError The request processing has failed due to some unknown error.
500 SYSTEM.UNKNOWN.ERROR The Account failed to create order.
404 InvalidAllocationId.NotFound Specified allocation ID is not found The specified EIP does not exist. Check whether the parameter value is correct.
404 Forbidden.InCommonBandwidthPackage Specified allocation ID in common bandwidth package.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.