描述

调用该接口时，您需要注意：

分配公网 IP 地址之前，实例必须处于 运行中（Running）或者 已停止（Stopped）状态。

当VPC类型实例已经绑定了 EIP，则无法再分配公网 IP。

一台实例只能分配一个公网 IP 地址。如果实例已经拥有一个公网 IP 地址，将报错 AllocatedAlready。

重启实例（RebootInstance）或者启动实例（StartInstance）后，新的公网 IP 地址生效。

被 安全控制 的实例的 OperationLocks 中标记了 "LockReason" : "security" 时，重庆IT外包，不能分配公网 IP 地址。

除分配公网 IP 之外，您还可以给实例绑定弹性公网 IP（EIP）。更多详情，请参阅 AssociateEipAddress。

请求参数

返回参数

示例

请求示例

https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress

&InstanceId=i-instance1

&<公共请求参数>

返回示例

XML 格式

 F2EF6A3B-E345-46B9-931E-0EA094818567

 10.1.149.159

JSON 格式

{

 "RequestId": "F2EF6A3B-E345-46B9-931E-0EA094818567",

 "IpAddress": "10.1.149.159"

}

错误码

以下为本接口特有的错误码。更多错误码，请访问 API 错误中心。