AllocateEipSegmentAddress - 弹性公网 IP

调试

您可以在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.	请求冲突，请稍后重试。

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