调用AllocateEipSegmentAddress接口申请连续EIP。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
ClientToken String 否 02fb3da4-130e-11e9-8e44-001****

客户端Token，用于保证请求的幂等性。

由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
Action String 是 AllocateEipSegmentAddress

系统规定参数。取值：AllocateEipSegmentAddress。

Bandwidth String 否 5

EIP的带宽峰值。单位：Mbps。

  • 当InstanceChargeType取值为PostPaid，且InternetChargeType取值为PayByBandwidth时，Bandwidth取值范围为1~500。
  • 当InstanceChargeType取值为PostPaid，且InternetChargeType取值为PayByTraffic时，Bandwidth取值范围为1~200。
  • 当InstanceChargeType取值为PrePaid时，Bandwidth取值范围为1~1000。

默认值为5 Mbps。

RegionId String 是 cn-hangzhou

连续EIP所在的地域ID。

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

EipMask String 是 28

连续EIP的掩码，取值：

  • 28：单次调用，系统将分配16个连续EIP。
  • 27：单次调用，系统将分配32个连续EIP。
  • 26：单次调用，系统将分配64个连续EIP。
  • 25：单次调用，系统将分配128个连续EIP。
  • 24：单次调用，系统将分配256个连续EIP。
说明 由于IP地址保留，实际申请到的连续EIP可能缺少1、3或者4个EIP。
Netmode String 否 public

网络类型，取值：

  • public（默认值）：公网。连续EIP和云资源绑定后，云资源可以通过EIP与公网通信。
  • hybrid：混合云。连续EIP和云资源绑定后，云资源可以通过EIP进行混合云通信。
说明 仅具有混合云白名单的用户支持选择混合云类型，如需使用，请联系您的客户经理。
InternetChargeType String 否 PayByBandwidth

连续EIP的计费方式，取值：

  • PayByBandwidth（默认值）：按固定带宽计费。
  • PayByTraffic：按使用流量计费。
说明 如果Netmode取值为hybrid时，InternetChargeType仅支持取值为PayByBandwidth。
ResourceGroupId String 否 rg-bp67acfmxazb4ph****

资源组ID。
Isp String 否 BGP

线路类型，目前只支持在创建按量付费实例时指定线路类型，取值：

  • BGP：BGP（多线）线路。

    BGP（多线）线路在全球有多达89条优质BGP线路，在中国内地的每个地域均提供电信、联通、移动、铁通、网通、教育网、广电、鹏博士、方正宽带等多条线路的直连覆盖。

  • BGP_PRO：BGP（多线）精品线路。

    BGP（多线）_精品线路是一种优化海外回中国内地流量的公网线路，可以提高国际业务访问质量。相比普通BGP（多线）线路， BGP（多线）_精品线路在为中国内地终端客户（不包括中国内地数据中心）提供服务时，通过中国境内运营商公网直连中国内地，时延更低。

    目前，全部地域都支持BGP（多线）线路EIP，仅中国（香港）地域支持BGP（多线）精品线路EIP。

说明 如果您是开通了单线带宽白名单的用户，ISP字段可以设置为ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和ChinaMobile（中国移动）；如果您是杭州金融云用户，该字段必填，取值：BGP_FinanceCloud。

返回数据

名称 类型 示例值 描述
RequestId String F7A6301A-64BA-41EC-8284-8F4838C15D1F

请求ID。
OrderId Long 2019****

订单ID。
EipSegmentInstanceId String eipsg-2zett8ba055tbsxme****

连续EIP组的实例ID。

示例

请求示例

http(s)://[Endpoint]/?ClientToken=02fb3da4-130e-11e9-8e44-001****
&Action=AllocateEipSegmentAddress
&Bandwidth=5
&RegionId=cn-hangzhou
&EipMask=28
&Netmode=public
&InternetChargeType=PayByBandwidth
&ResourceGroupId=rg-bp67acfmxazb4ph****
&Isp=BGP
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<AllocateEipSegmentAddressResponse>
    <RequestId>F7A6301A-64BA-41EC-8284-8F4838C15D1F	</RequestId>
    <EipSegmentInstanceId>eipsg-2zett8ba055tbsxme****</EipSegmentInstanceId>
</AllocateEipSegmentAddressResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F7A6301A-64BA-41EC-8284-8F4838C15D1F\t",
  "EipSegmentInstanceId" : "eipsg-2zett8ba055tbsxme****"
}

错误码

HttpCode 错误码 错误信息 描述
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不存在。
400 ORDER.QUANTITY_INVALID User quota has exceeded the limit. 您当前保有的EIP数量已达上限，可前往配额管理提升EIP数量配额
400 OrderError.EIP The Account failed to create order. 下单失败
403 Forbbiden User not authorized to operate on the specified resource. 您没有权限操作该资源，请您申请操作权限后再试。
409 OperationConflict Request was denied due to conflict with a previos request. 请求冲突，请稍后重试。

访问错误中心查看更多错误码。