AllocatePublicIpAddress

Description

When you call this operation, note that:

• Before you can assign a public IP address to an instance, the instance must be in the Running or Stopped state.
• No public IP addresses can be assigned to a VPC-connected instance bound with an Elastic IP (EIP).
• You can assign only one public IP address to an instance. If an instance has a public IP address, the AllocatedAlready error message is returned.
• After you restart an instance (RebootInstance) or start an instance (StartInstance), the new public IP address takes effect.
• If an instance is locked for security reasons (the OperationLocks parameter is "LockReason": "security"), no public IP addresses can be assigned to the instance.

You can also bind an EIP to an instance. For more information, see AssociateEipAddress.

Debugging

You can use API Explorer to perform debugging. API Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Response parameters

Examples

Sample requests

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

Successful response examples

XML format

<AllocatePublicIpAddressResponse>
  <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
   <IpAddress>10.1.149.159</IpAddress>
</AllocatePublicIpAddressResponse>

JSON format

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

Error codes

View error codes