AllocatePublicIpAddress

Description

When you call this operation, take note of the following items:

• The instance must be in the Running (Running) or Stopped (Stopped) state.
• If ~~25695~~OperationLocks in the DescribeInstances response contains "LockReason" : "security" for an instance, the instance is locked for security reasons and cannot be assigned public IP addresses through calls to this operation.
• You can assign only one public IP address to an instance. If the instance already has a public IP address, the AllocatedAlready error code is returned.
• After you assign a new public IP address to an instance, you must restart the instance (RebootInstance) or start the instance (StartInstance) for the public IP address to take effect.

In addition to assigning a public IP address, you can also associate an elastic IP address (EIP) with a VPC-type instance. For more information, see AssociateEipAddress.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-bp1gtjxuuvwj17zr****
&IpAddress=112.124.**.**
&<Common request parameters>

Sample success responses

XML format

<AllocatePublicIpAddressResponse>
      <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
      <IpAddress>112.124.**.**</IpAddress>
</AllocatePublicIpAddressResponse>

JSON format

{
    "RequestId": "F2EF6A3B-E345-46B9-931E-0EA094818567",
    "IpAddress": "112.124.**.**"
}

Error codes

For a list of error codes, visit the API Error Center.