閱讀970 返回首頁    go 阿裏雲

分配公網 IP 地址__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

給一個特定實例分配一個可用公網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
&<公共請求參數>

返回示例

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"
}

最後更新：2016-11-23 16:03:50

  上一篇：go 導入鏡像__鏡像相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 修改實例網絡規格__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲