阅读328 返回首页    go 阿里云


申请弹性公网 IP__网络相关接口_API 参考_云服务器 ECS-阿里云

描述

申请 EIP,新申请的 EIP 状态为 Available。

  • EIP 目前只能绑定到相同地域的 VPC 类型的 ECS 实例。
  • 每次申请会在指定的 Region 内随机分配一个 EIP。
  • EIP 目前只支持 ICMP,TCP,UDP 3 种协议,不支持 IGMP,SCTP 等传输层协议。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:AllocateEipAddress
RegionId String 申请的弹性公网 IP 所在的地域
Bandwidth String 弹性公网 IP 的限速,如果不指定,默认为 5Mbps。
InternetChargeType String PayByBandwidth 和 PayByTraffic,默认是 PayByBandwidth
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录

返回参数

名称 类型 描述
EipAddress String 分配的弹性公网 IP
AllocationId String 弹性公网 IP 的实例 Id

错误码

错误代码 描述 Http 状态码 语义
Forbbiden User not authorized to operate on the specified resource. 403 用户没有使用 EIP 产品的权限,请提交工单申请
QuotaExceeded.Eip Elastic IP address quota exceeded. 400 EIP 的个数超过额度限制
InvalidRegionId.NotFound Specified value of “RegionId” is not supported. 404 指定的 RegionId 不存在
InvalidParameter Specified value of “InternetChargeType” is not valid 400 指定的 InternetChargeType 参数不合法
InvalidParameter Specified value of “Bandwidth” is not valid. 400 指定的 Bandwidth 参数不合法
InsufficientEipCapacity Insufficient EIP capacity to fulfill your request. 500 指定 Region 的 EIP 库存不足
InsufficientBalance Your account does not have enough balance. 400 账户余额不足,无法申请 EIP

示例

请求示例

https://ecs.aliyuncs.com/?Action=AllocateEipAddress
&RegionId=cn-beijing
&<公共请求参数>

返回示例

XML格式

  <AllocationId>eip-25877c70x</AllocationId> 
  <EipAddress>123.56.0.206</EipAddress>
  <RequestId>B6B9F518-60F8-4D81-9242-1207B356754D</RequestId>

JSON格式

{
  "AllocationId": "eip-25877c70x", 
  "EipAddress": "123.56.0.206", 
  "RequestId": "B6B9F518-60F8-4D81-9242-1207B356754D"
}

最后更新:2016-11-23 16:03:50

  上一篇:go 修改实例网络规格__网络相关接口_API 参考_云服务器 ECS-阿里云
  下一篇:go 绑定弹性公网 IP__网络相关接口_API 参考_云服务器 ECS-阿里云