：AllocatePublicIpAddress

描述

調用該介面時，您需要注意：

• 分配公網 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
&<公共請求參數>

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

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

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。