全部产品
Search
文档中心

专有网络 VPC:AllocateEipAddressPro - 申请指定的EIP

更新时间:Mar 04, 2024

调用AllocateEipAddressPro申请指定的EIP,可用于特定的网络配置需求。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:AllocateEipAddressProWrite
  • Address
    acs:vpc:{#regionId}:{#accountId}:eip/*

请求参数

名称类型必填描述示例值
RegionIdstring

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

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

cn-hangzhou
IpAddressstring

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

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

192.0.XX.XX
InstanceIdstring

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

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

eip-25877c70gddh****
Bandwidthstring

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

  • InstanceChargeType 取值为 PostPaid,且 InternetChargeType 取值为 PayByBandwidth 时,Bandwidth 取值范围为 1~500

  • InstanceChargeType 取值为 PostPaid,且 InternetChargeType 取值为 PayByTraffic 时,Bandwidth 取值范围为 1~200

  • InstanceChargeType 取值为 PrePaid 时,Bandwidth 取值范围为 1~1000

默认值:5Mbps。

5
Periodinteger

购买时长。

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

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

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

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

1
ISPstring

线路类型。取值:

  • BGP(默认值):BGP(多线)线路。目前全部地域都支持 BGP(多线)线路 EIP。
  • BGP_PRO:BGP(多线)_精品线路。目前仅中国香港、新加坡、马来西亚(吉隆坡)、菲律宾(马尼拉)、印度尼西亚(雅加达)和泰国(曼谷)地域支持 BGP(多线)_精品线路 EIP。

关于 BGP(多线)线路和 BGP(多线)_精品线路的更多信息,请参见 EIP 线路类型

  • 如果您是单线带宽的白名单用户,您还可以选择以下类型:
    • ChinaTelecom:中国电信
    • ChinaUnicom:中国联通
    • ChinaMobile:中国移动
    • ChinaTelecom_L2:中国电信 L2
    • ChinaUnicom_L2:中国联通 L2
    • ChinaMobile_L2:中国移动 L2
  • 如果您是杭州金融云用户,该字段必填,取值:BGP_FinanceCloud
BGP
Netmodestring

网络类型,仅取值为 public(默认值),表示公网。

public
AutoPayboolean

是否自动付费,取值:

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

  • true:开启自动付费,自动支付订单。

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

true
PricingCyclestring

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

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

  • Year:按年付费。

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

Month
InstanceChargeTypestring

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

  • PrePaid:包年包月。

  • PostPaid(默认值):按量计费。

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

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

PostPaid
InternetChargeTypestring

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

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

  • PayByTraffic:按流量计费。

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

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

PayByBandwidth
ResourceGroupIdstring

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

rg-resourcegroup****
ClientTokenstring

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

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。
0c593ea1-3bea-11e9-b96b-88e9fe6****
SecurityProtectionTypesarray

安全防护级别。

  • 配置为空时,默认为 DDoS 防护(基础版)。

  • 配置为AntiDDoS_Enhanced时,表示 DDoS 防护(增强版)。

您最多可以为 10 个 EIP 设置安全防护级别。

string

安全防护级别。

  • 配置为空时,默认为 DDoS 防护(基础版)。

  • 配置为AntiDDoS_Enhanced时,表示 DDoS 防护(增强版)。

您最多可以为 10 个 EIP 设置安全防护级别。

AntiDDoS_Enhanced
PublicIpAddressPoolIdstring

IP 地址池 ID。

EIP 将从该 IP 地址池中分配。

IP 地址池功能默认不开放。如需使用,请在配额中心申请 IP 地址池功能权益配额。具体操作,请参见通过配额中心提升配额

pippool-2vc0kxcedhquybdsz****

返回参数

名称类型描述示例值
object

返回信息列表。

RequestIdstring

请求 ID。

4EC47282-1B74-4534-BD0E-403F3EE64CAF
OrderIdlong

订单 ID。

当 InstanceChargeType(要指定申请的 EIP 的计费方式)取值为 PrePaid(包年包月)时,返回该参数。如果 AutoPay 取值为 false,即未开启自动支付账单时,请前往订单中心完成支付。

20190000
ResourceGroupIdstring

资源组 ID。仅 InstanceChargeType 取值为 PostPaid 时返回。

rg-resourcegroup****
EipAddressstring

您指定申请的 EIP 被分配到的 IP 地址。仅 InstanceChargeType 取值为 PostPaid 时返回。

192.0.XX.XX
AllocationIdstring

EIP 的 ID。

eip-25877c70gddh****

示例

正常返回示例

JSON格式

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "OrderId": 20190000,
  "ResourceGroupId": "rg-resourcegroup****",
  "EipAddress": "192.0.XX.XX",
  "AllocationId": "eip-25877c70gddh****"
}

错误码

HTTP status code错误码错误信息描述
400FrequentPurchase.EIPeip frequent purchase-
400COMMODITY_NO_EXISTcommodity is not exist-
400QuotaExceeded.EipElastic IP address quota exceeded-
400InvalidParameterSpecified value of "InternetChargeType" is not valid-
400InvalidParameterSpecified value of "Bandwidth" is not valid.该带宽不合法。
400InsufficientBalanceYour account does not have enough balance.账户余额不足,请先充值再操作。
400QuotaExceeded.EipElastic IP address quota exceeded.弹性公网IP的个数超过额度限制,如果您有更多额度的需求,建议您考虑使用NAT网关。
400ReserveIpFailReserve eip failed.EIP预留失败。
400InvalidRegion.NotSupportThe specified region does not support.该 RegionId 不支持此操作。
400InvalidBandwidth.MalformedThe specified Bandwidth is invalid.-
400INSTANCE_TYPE_NOT_SUPPORTThe instance type is invalid.-
400QueryParameter.Illegalquery parameter illegal-
400SYSTEM.UNKNOWN.ERRORThe Account failed to create order.-
400TokenVerfiy.Failedtoken verify failed.-
400OrderFailedThe Account failed to create order.-
400QuotaExceeded.LargeSpecEipElastic IP address with large spec quota exceeded.-
400InvalidResourceGroupIdThe specified ResourceGroupId does not exist.资源组ID不存在。
400Invalid.Reserve.IpThe reserve ip is invalid.-
400Ip.AllocatedThe reserve ip has been allocated.已分配保留ip。
400Ip.KeepedThe reserve ip been keeped in an hour.-
400OperationFailed.AllocateUnfamiliarIpThe operation failed because only IP addresses used within the last seven days can be allocated.指定EIP申请只允许申请7天内使用过的IP
400INVALID_INSTANCE_STATUSThe instance status is invalid.-
400OperationFailed.InstanceNotExistEip instanceId does not exist.-
400InvalidStatus.ValueNotSupportedThe specified status is not supported.-
400OperationFailed.RiskControlRisk control check failed.我们检测到您的付款方式存在安全风险。请通过电子邮件或控制台消息中的链接继续验证,并在验证后重新提交订单。
400OrderError.EIPThe Account failed to create order.下单失败
400ResourceNotEnough.PublicIpAddressPoolThe specified resource of PublicIpAddressPool is not enough.-
400Mismatch.IpAndPublicIpAddressPoolThe Ip and PublicIpAddressPool are mismatched.-
400ResourceNotFound.PublicIpAddressPoolThe specified resource of PublicIpAddressPool is not found.-
400ResourceNotFound.IpThe specified ip is not found.找不到指定的IP。
400OperationDenied.IpBelongToOtherUserThe operation is not allowed because of ip belong to other user.申请失败,该IP归属其他用户
400IncorrectStatus.IpThe status of ip is incorrect.IP的状态不正确。
400OperationFailed.IpIsLockedThe operation is failed because of ip is locked.申请失败,IP已经被锁定
400Mismatch.IpAndIspThe specified IP address does not match the ISP.申请指定IP失败,ISP和IP参数不匹配.
400IncorrectStatus.PublicIpAddressPoolThe status of PublicIpAddressPool is incorrect.地址池实例未处于稳态,不允许分配EIP。
400IllegalParam.IpAddressThe specified IpAddress (%s) is illegal.IpAddress参数不合法
400OperationFailed.ResourceNotEnoughThe resources you have applied for are insufficient.您申请的资源不足,如仍需申请,请提工单处理
400Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionTypeThe EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.EIP安全防护类型与地址池安全防护类型不匹配。
403ForbiddenUser not authorized to operate on the specified resource.您没有权限操作指定资源,请申请权限后再操作。
404InvalidRegionId.NotFoundSpecified value of "RegionId" is not supported.指定的 RegionId 不存在,请您检查此产品在该地域是否可用。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.指定的RegionId不存在。请检查该参数是否正确。
404FUWU_BIZ_COMMODITY_VERIFY_FAIL????????, ????????PD.-
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.内部错误

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

变更历史

变更时间变更内容概要操作
2024-01-22OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404
    删除错误码:500
2023-10-19OpenAPI 描述信息更新、OpenAPI 错误码发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404
    删除错误码:500
2023-07-06OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404
    删除错误码:500
2023-05-15OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 403 变更
    删除错误码:400
    删除错误码:404
    删除错误码:500
2022-12-02OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
    删除错误码:404
    删除错误码:500