全部产品
专有网络 VPC

申请弹性公网IP

更新时间:2017-08-30 11:24:57   分享:   

申请弹性公网 IP

描述

申请 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
InstanceChargeType String PrePaid和PostPaid,默认是PostPaid 。PrePaid代表预付费,PostPaid 代表后付费。
参数选择PrePaid后会生成一个订单号,需要到订单中心手工支付。
预计9月中旬推出订单自动支付功能。
注意:参数区分大小写。
PricingCycle String Month和Year,默认是Month。
注意:参数区分大小写。
Period String 当InstanceChargeType为PrePaid是必选参数
当PricingCycle为Month时,取值范围1到9,当PricingCycle为Year时,取值范围1到3。
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。
具体参见附录

返回参数

名称 类型 描述
EipAddress String 分配的弹性公网 IP。
AllocationId String 弹性公网 IP 的实例 Id。
OrderId String 订单号。只有预付费时返回。

错误码

错误代码 描述 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

示例

请求示例

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

后付费返回示例

XML格式

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

JSON格式

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

预付费返回示例

XML格式

  1. <AllocateEipAddressResponse>
  2. <RequestId>30D996D7-05B2-4D66-A6A2-5764419CFAAE</RequestId>
  3. <OrderId>201156243980148</OrderId>
  4. <AllocationId>eip-2zecafsj3w2sriwcpi1wy</AllocationId>
  5. </AllocateEipAddressResponse>

JSON格式

本文导读目录
本文导读目录
以上内容是否对您有帮助?