描述
调用该接口时,您需要注意:
分配公网 IP 地址之前,实例必须处于 运行中(Running)或者 已停止(Stopped)状态。
当VPC类型实例已经绑定了 EIP,则无法再分配公网 IP。
一台实例只能分配一个公网 IP 地址。如果实例已经拥有一个公网 IP 地址,将报错 AllocatedAlready。
重启实例(RebootInstance)或者启动实例(StartInstance)后,新的公网 IP 地址生效。
被 安全控制 的实例的 OperationLocks 中标记了 "LockReason" : "security" 时,不能分配公网 IP 地址。
除分配公网 IP 之外,您还可以给实例绑定弹性公网 IP(EIP)。更多详情,请参阅 AssociateEipAddress。
请求参数
返回参数
示例
请求示例
https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-instance1
&<公共请求参数>
返回示例
XML 格式
<AllocatePublicIpAddressResponse>
<RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
<IpAddress>10.1.149.159</IpAddress>
</AllocatePublicIpAddressResponse>
JSON 格式
{
"RequestId": "F2EF6A3B-E345-46B9-931E-0EA094818567",
"IpAddress": "10.1.149.159"
}
错误码
以下为本接口特有的错误码。更多错误码,请访问 API 错误中心。