调用AllocateEipAddressPro申请指定的弹性公网IP(EIP)。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AllocateEipAddressPro |
要执行的操作,取值:AllocateEipAddressPro。 |
RegionId | String | 是 | cn-hangzhou |
要指定申请的EIP所在的地域ID。 您可以通过调用DescribeRegions接口获取地域ID。 |
IpAddress | String | 否 | 12.XX.XX.23 |
要指定申请的EIP的IP地址。 IpAddress和InstanceId参数仅需传入一个,如果都不传,系统会随机申请EIP。 |
InstanceId | String | 否 | eip-25877c70gddh**** |
要指定申请的EIP的实例ID。 IpAddress和InstanceId参数仅需传入一个,如果都不传,系统会随机申请EIP。 |
Bandwidth | String | 否 | 5 |
要指定申请的EIP的带宽峰值,单位为Mbps。 默认为5 Mbps。 |
Period | Integer | 否 | 1 |
购买时长。
如果InstanceChargeType参数的值为PrePaid时,该参数必选。 如果InstanceChargeType参数的值为PostPaid时,该参数不填。 |
ISP | String | 否 | BGP |
线路类型,默认值为BGP。
|
Netmode | String | 否 | public |
网络类型,仅取值为public(公网)。 默认值为public(公网)。 |
AutoPay | Boolean | 否 | true |
是否自动付费,取值:
当InstanceChargeType参数的值为PrePaid时,该参数必选。 当InstanceChargeType参数的值为PostPaid时,该参数可不填。 |
PricingCycle | String | 否 | Month |
包年包月的计费周期,取值:
当InstanceChargeType参数的值为PrePaid时,该参数必选;当InstanceChargeType参数的值为PostPaid时,该参数可不填。 |
InstanceChargeType | String | 否 | PostPaid |
要指定申请的EIP的计费方式,取值:
当InstanceChargeType取值为PrePaid时,InternetChargeType必须取值PayByBandwidth。 当InstanceChargeType取值为PostPaid时,InternetChargeType可取值PayByBandwidth或PayByTraffic。 |
InternetChargeType | String | 否 | PayByBandwidth |
要指定申请的EIP的计量方式,取值:
当InstanceChargeType取值为PrePaid时,InternetChargeType必须取值PayByBandwidth。 当InstanceChargeType取值为PostPaid时,InternetChargeType可取值PayByBandwidth或PayByTraffic。 |
ResourceGroupId | String | 否 | rg-resourcegroup**** |
要指定申请的EIP所属的资源组ID。 |
ClientToken | String | 否 | 0c593ea1-3bea-11e9-b96b-88e9fe6**** |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AllocationId | String | eip-25877c70gddh**** |
EIP的ID。 |
EipAddress | String | 12.XX.XX.23 |
指定申请的EIP的IP地址。 |
OrderId | Long | 20190000 |
订单ID。 |
RequestId | String | 4EC47282-1B74-4534-BD0E-403F3EE64CAF |
请求ID。 |
ResourceGroupId | String | rg-resourcegroup**** |
资源组ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=AllocateEipAddressPro
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<AllocateEipAddressProResponse>
<ResourceGroupId>rg-resourcegroup****</ResourceGroupId>
<RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
<AllocationId>eip-25877c70gddh****</AllocationId>
<EipAddress>12.XX.XX.23</EipAddress>
<OrderId>20190000</OrderId>
</AllocateEipAddressProResponse>
JSON
格式
{
"ResourceGroupId": "rg-resourcegroup****",
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
"AllocationId": "eip-25877c70gddh****",
"EipAddress": "12.XX.XX.23",
"OrderId": 20190000
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Forbbiden | User not authorized to operate on the specified resource. | 您没有权限操作该资源,请您申请操作权限后再试。 |
400 | QuotaExceeded.Eip | Elastic IP address quota exceeded | 弹性公网 IP 的个数超过额度限制,如果您有更多额度的需求,请提交工单申请增加限额,建议您考虑使用NAT网关。 |
400 | InvalidParameter | Specified value of "InternetChargeType" is not valid | 参数InternetChargeType的值不合法。 |
400 | InvalidParameter | Specified value of "Bandwidth" is not valid. | 该带宽不合法。 |
400 | InsufficientBalance | Your account does not have enough balance. | 账户余额不足,请先充值再操作。 |
400 | QuotaExceeded.Eip | Elastic IP address quota exceeded. | 弹性公网 IP 的个数超过额度限制,如果您有更多额度的需求,请提交工单申请增加限额,建议您考虑使用NAT网关。 |
400 | ReserveIpFail | Reserve eip failed. | EIP预留失败。 |
400 | InvalidRegion.NotSupport | The specified region does not support. | 该 RegionId 不支持此操作。 |
400 | InvalidResourceGroupId | The specified ResourceGroupId does not exist. | 资源组ID不存在。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交