為一台執行個體分配一個公網 IP 位址。

描述

調用該介面時,您需要注意:

  • 分配公網 IP 位址之前,執行個體必須處於 運行中Running)或者 已停止Stopped)狀態。

  • 當VPC類型執行個體已經綁定了 EIP,則無法再分配公網 IP。

  • 一台執行個體只能分配一個公網 IP 位址。如果執行個體已經擁有一個公網 IP 位址,將報錯 AllocatedAlready

  • 重啟執行個體(RebootInstance)或者啟動執行個體(StartInstance)後,新的公網 IP 位址生效。

  • 安全控制 的執行個體的 OperationLocks 中標記了 "LockReason" : "security" 時,不能分配公網 IP 位址。

除分配公網 IP 之外,您還可以給執行個體綁定彈性公網 IP(EIP)。更多詳情,請參閱 AssociateEipAddress

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:AllocatePublicIpAddress
InstanceId String 需要分配 IP 位址的執行個體 ID。

返回參數

名稱 類型 描述
IpAddress String 執行個體的公網 IP 位址

樣本

請求樣本
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 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InsufficientPublicIp Ip address not found 400 公網 IP 位址資源目前庫存不足,請稍後再試。
OperationDenied Specified operation is denied as your instance is in VPC. 400 指定的 VPC 類型執行個體已綁定了 EIP。
AllocatedAlready There is an IpAddress allocated already for the specified instance. 403 這台執行個體已經擁有一個公網 IP 位址。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 分配公網 IP 位址之前,執行個體必須處於 運行中Running)或者 已停止Stopped)狀態。
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 指定的 訂用帳戶 執行個體已到期或者 隨用隨付 執行個體已欠費。
InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 403 執行個體目前被 安全控制,拒絕任何操作。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。