调用AllocatePublicIpAddress为一台ECS实例分配一个固定公网IP地址。
接口说明
调用该接口时，您需要注意：
- 分配公网IP地址之前，实例必须处于运行中（
Running）或者已停止（Stopped）状态。 - 被安全控制的实例的
OperationLocks中标记了"LockReason" : "security"时，不能分配公网IP地址。 - 一台实例只能分配一个公网IP地址。如果实例已经拥有一个公网IP地址，将报错
AllocatedAlready。 - 重启实例（RebootInstance）或者启动实例（StartInstance）后，新的公网IP地址生效。
除分配公网IP之外，您还可以给VPC类型ECS实例绑定弹性公网IP（EIP）。详情请参见AssociateEipAddress。
说明 当VPC类型实例绑定了EIP后，则无法再分配公网IP。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AllocatePublicIpAddress |
系统规定参数。取值：AllocatePublicIpAddress。 |
| InstanceId | String | 是 | i-bp1gtjxuuvwj17zr**** |
需要分配IP地址的实例ID。 |
| IpAddress | String | 否 | 112.124.**.** |
实例的公网IP地址。如果该参数值为空，则默认由系统随机分配IP地址。 |
| VlanId | String | 否 | 720 |
实例的VLAN ID。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| IpAddress | String | 112.124.**.** |
实例的公网IP地址。 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-bp1gtjxuuvwj17zr****
&IpAddress=112.124.**.**
&正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
F2EF6A3B-E345-46B9-931E-0EA094818567
112.124.**.**
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F2EF6A3B-E345-46B9-931E-0EA094818567",
"IpAddress" : "112.124.**.**"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | OperationDenied | Specified operation is denied as your instance is in VPC. | 由于实例存在于 VPC 中，指定的操作不合法。 |
| 400 | AllocateIpInvalidInstanceBandwidth | OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0. |
当前操作无效，请保证最大输出带宽大于0。 |
| 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). |
包年包月实例已过期，请您续费后再进行操作。 |
| 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 地址。 |
| 403 | NAT_PUBLIC_IP_ALLOCATE_FAILED | Nat public ip binding failed. | 公网 IP 绑定失败。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在，请您检查实例ID是否正确。 |
| 404 | InvalidVlanId.NotFound | The VlanId provided does not exist in our records. | 指定的虚拟局域网 ID 不存在。 |
| 404 | InvalidIpAddress.NotFound | The specified IP is not in the specified vlan. | 指定的 IP 不在指定的虚拟局域网内。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/151603.html
