全部产品
云服务器 ECS

AllocatePublicIpAddress

更新时间:2017-09-13 12:57:28   分享:   

描述

给一个特定实例分配一个可用公网IP地址。

  • 弹性公网 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 specified InstanceId does not exist. 404 指定的 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 地址。
OperationDenied Specified operation is denied as your instance is in VPC. 400 指定实例在 VPC 中。
InsufficientPublicIp Ip address not found 400 IP 资源库存不足。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
  2. &InstanceId=i-instance1
  3. &<公共请求参数>

返回示例

XML格 式

  1. <AllocatePublicIpAddressResponse>
  2. <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
  3. <IpAddress>10.1.149.159</IpAddress>
  4. </AllocatePublicIpAddressResponse>

JSON 格式

  1. {
  2. "RequestId": "F2EF6A3B-E345-46B9-931E-0EA094818567",
  3. "IpAddress": "10.1.149.159"
  4. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?