调用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。
默认值为5 Mbps。 |
RegionId | String | 是 | cn-hangzhou |
连续EIP所在的地域ID。 您可以通过调用DescribeRegions接口获取地域ID。 |
EipMask | String | 是 | 28 |
连续EIP的掩码,取值:
说明 由于IP地址保留,实际申请到的连续EIP可能缺少1、3或者4个EIP。
|
Netmode | String | 否 | public |
网络类型,取值:
说明 仅具有混合云白名单的用户支持选择混合云类型,如需使用,请联系您的客户经理。
|
InternetChargeType | String | 否 | PayByBandwidth |
连续EIP的计费方式,取值:
说明 如果Netmode取值为hybrid时,InternetChargeType仅支持取值为PayByBandwidth。
|
ResourceGroupId | String | 否 | rg-bp67acfmxazb4ph**** |
资源组ID。 |
Isp | String | 否 | BGP |
线路类型,目前只支持在创建按量付费实例时指定线路类型,取值:
说明 如果您是开通了单线带宽白名单的用户,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. | 请求冲突,请稍后重试。 |
访问错误中心查看更多错误码。