分配公網 IP 地址

　　描述

　　給一個特定實例分配一個可用公網IP地址。

　　實例的狀態必須為 Running 或 Stopped 狀態，才可以調用此接口。

　　分配的 IP 必須在實例啟動或重啟后才能生效。

　　分配的時候只能是 IP，不能是 IP 段。

　　目前，一個實例只能分配一個 IP。當調用此接口時，如果實例已經擁有一個公網 IP，將直接返回原 IP 地址。

　　被安全控制在實例的 OperationLocks 中標記了 "LockReason" : "security" 的鎖定狀態時，不能分配公網 IP。

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統規定參數，取值：AllocatePublicIpAddress  
InstanceId   String   是   需要分配 IP 地址的實例 ID  

　　返回參數

名稱 類型 描述
IpAddress   String   分配的公網 IP 地址  

　　錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidInstanceId.NotFound   The InstanceId provided does not exist in our records.   404   指定的 InstanceId 不存在  
MissingParameter   The input parameter "InstanceId" that is mandatory for processing this request is not supplied.   400   缺少 InstanceId 值  
IncorrectInstanceStatus   The current status of the resource does not support this operation.   403   該資源目前的狀態不支持此操作  
InstanceLockedForSecurity   The specified operation is denied as your instance is locked for security reasons.   403   該資源目前被安全鎖定被拒絕操作  
InstanceExpiredOrInArrears   The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).   403   實例到期或者欠費（是指該實例是包年包月或者按量欠費的情況）  
IpInUse   The specified IP is already in use.   403   用戶使用指定 IP 進行綁定時，IP 已經被使用在別的機器上  
AllocatedAlready   There is an IpAddress allocated already for the specified instance.   403   用戶使用指定 IP 進行綁定時，該實例已經被分配了別的 IP 地址  

　　示例

　　請求示例

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

　　&InstanceId=i-instance1

　　&<公共請求參數>