调用AllocateEipAddressPro申请指定的弹性公网IP(EIP)。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AllocateEipAddressPro

要执行的操作,取值:AllocateEipAddressPro

RegionId String cn-hangzhou

要指定申请的EIP所在的地域。

您可以通过调用DescribeRegions接口获取地域ID。

IpAddress String 12.xx.xx.23

要指定申请的EIP的IP地址。

IpAddressInstanceId参数仅需传入一个,如果都不传,系统会随机申请EIP。

InstanceId String eip-25877c70gddh****

要指定申请的EIP的实例ID。

IpAddressInstanceId参数仅需传入一个,如果都不传,系统会随机申请EIP。

Bandwidth String 5

要指定申请的EIP的带宽峰值,单位为Mbps。

默认为5Mbps。

Period Integer 1

购买时长。

  • PricingCycle取值Month时,Period取值范围为1~9
  • PricingCycle取值Year时,Period取值范围为1~3

如果InstanceChargeType参数的值为PrePaid时,该参数必选。

如果InstanceChargeType参数的值为PostPaid时,该参数不填。

ISP String BGP

线路类型,默认值为BGP

  • 如果是开通了单线带宽白名单的用户,ISP字段可以设置为ChinaTelecom(中国电信)、ChinaUnicom(中国联通)和ChinaMobile(中国移动)。
  • 如果是杭州金融云用户,该字段必填,取值:BGP_FinanceCloud
Netmode String public

网络类型,仅取值为public(公网)。

默认值为public(公网)。

AutoPay Boolean true

是否自动付费,取值:

  • false:不开启自动付费,生成订单后需要到订单中心完成支付。
  • true:开启自动付费,自动支付订单。

InstanceChargeType参数的值为PrePaid时,该参数必选。

InstanceChargeType参数的值为PostPaid时,该参数可不填。

PricingCycle String Month

包年包月的计费周期,取值:

  • Month(默认值):按月付费。
  • Year:按年付费。

InstanceChargeType参数的值为PrePaid时,该参数必选;当InstanceChargeType参数的值为PostPaid时,该参数可不填。

InstanceChargeType String PostPaid

要指定申请的EIP的计费方式,取值:

  • PrePaid:包年包月。
  • PostPaid(默认值):按量计费。

InstanceChargeType取值为PrePaid时,InternetChargeType必须取值PayByBandwidth

InstanceChargeType取值为PostPaid时,InternetChargeType可取值PayByBandwidthPayByTraffic

InternetChargeType String PayByBandwidth

要指定申请的EIP的计量方式,取值:

  • PayByBandwidth(默认值):按带宽计费。
  • PayByTraffic:按流量计费。

InstanceChargeType取值为PrePaid时,InternetChargeType必须取值PayByBandwidth

InstanceChargeType取值为PostPaid时,InternetChargeType可取值PayByBandwidthPayByTraffic

ResourceGroupId String rg-resourcegroup****

要指定申请的EIP所属的资源组ID。

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe637760

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。

返回数据

名称 类型 示例值 描述
AllocationId String eip-25877c70gddh****

EIP的ID。

EipAddress String 123.xx.xx.206

指定申请的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>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <AllocationId>eip-25877c70gddh****</AllocationId>
      <EipAddress>123.xx.xx.206</EipAddress>
      <OrderId>20190000</OrderId>
      <ResourceGroupId>rg-resourcegroup****</ResourceGroupId>
</AllocateEipAddressProResponse>

JSON 格式

{
	"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "AllocationId":"eip-25877c70gddh****",
    "EipAddress":"123.xx.xx.206",
    "OrderId":"20190000",
    "ResourceGroupId":"rg-resourcegroup****"
}