调用AllocatePublicIpAddress为一台ECS实例分配一个公网IP地址。

接口说明

调用该接口时,您需要注意:

  • 分配公网IP地址之前,实例必须处于运行中(Running)或者已停止(Stopped)状态。
  • 当VPC类型实例已经绑定了弹性公网IP(EIP),则无法再分配公网IP。
  • 一台实例只能分配一个公网IP地址。如果实例已经拥有一个公网IP地址,将报错AllocatedAlready。
  • 重启实例(RebootInstance)或者启动实例(StartInstance)后,新的公网IP地址生效。
  • 安全控制的实例的OperationLocks中标记了"LockReason" : "security"时,不能分配公网IP地址。

除分配公网IP之外,您还可以给实例绑定EIP。更多详情,请参见AssociateEipAddress

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String i-instance1

需要分配IP地址的实例ID。

Action String AllocatePublicIpAddress

系统规定参数。对于您自行拼凑HTTP/HTTPS URL发起的API请求,Action为必选参数。取值:AllocatePublicIpAddress

IpAddress String 10.1.***.159

实例的公网IP地址。

VlanId String 100

VLAN ID。

返回数据

名称 类型 示例值 描述
IpAddress String 10.1.***.159

实例的公网IP地址。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<AllocatePublicIpAddressResponse>
  <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
  <IpAddress>10.1.***.159</IpAddress>
</AllocatePublicIpAddressResponse>

JSON 格式

{
	"RequestId":"F2EF6A3B-E345-46B9-931E-0EA094818567",
	"IpAddress":"10.1.***.159"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
400 InvalidIpAddress.Malformed The specified parameter "IpAddress" is not valid. 指定的 IpAddress 不合法。
404 InvalidVlanId.NotFound The VlanId provided does not exist in our records. 指定的虚拟局域网ID不存在。
403 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). 包年包月实例已过期,请您续费后再进行操作。
404 InvalidIpAddress.NotFound The specified IP is not in the specified vlan. 指定的 IP 不在指定的虚拟局域网内。
403 IpInUse The specified IP is already in use. (用户使用指定IP进行绑定时,)IP已经被使用在别的机器上。
403 AllocatedAlready There is an IpAddress allocated already for the specified instance. (用户使用指定IP进行绑定时,)该实例已经被分配了别的IP地址。
400 OperationDenied Specified operation is denied as your instance is in VPC. 由于实例存在于 VPC 中,指定的操作不合法。
400 InsufficientPublicIp Ip address not found 未找到 IP 地址。
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。如果多次尝试失败,请提交工单
400 AllocateIpInvalidInstanceBandwidth OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0. 请确保公网带宽至少大于0 才可分配 IP 地址。
400 OperationDenied The specified parameter "VlanId" is not valid or vlan has not enough IP address. 指定的 VlanId 不合法,或已超出最大 IP 地址数限制。
403 NAT_PUBLIC_IP_BINDING_FAILED Binding nat public ip failed 绑定公网 IP(NatPublicIp)失败。
403 NAT_PUBLIC_IP_ALLOCATE_FAILED Nat public ip binding failed. 分配公网 IP(NatPublicIp)失败。

访问错误中心查看更多错误码。