申请弹性公网IP

1. 接口描述

调用 AllocateEip 接口申请一个弹性公网IP。

  • 后付费弹性IP按实际使用量收取费用,为避免账单欠费被停服,请确保账户余额充足。
  • 预付费弹性IP的购买会预先扣除本次实例购买所需金额,在调用本次接口前请确保账户余额充足。
  • 申请弹性公网IP需要通过实名认证。您可以参见实名认证相关文档完成认证。

2. 请求参数

名称 类型 是否必选 描述
Action String 固定取值:AllocateEip
RegionCode String 弹性公网IP所属的地域编码,您可以调用 DescribeRegionConfig 接口获取地域编码
BandwidthType String 弹性公网IP线路类型,您可以调用 DescribeProductConfig 查看您可购买的弹性公网IP线路类型
Bandwidth Integer 带宽大小, 单位Mbps
InternetChargeType String 计费方式,可能值:
PAY_BY_BAND_WIDTH 按带宽计费(预付费)
PAY_BY_TRAFFIC 按流量计费(后付费)
PAY_BY_BANDWIDTH_PACKAGE 按共享带宽包计费(后付费)
InstanceChargeType String 付费方式,需要与InternetChargeType对应,取值范围:
PRE_PAID 预付费
POST_PAID 后付费
AutoRenew String 是否自动续费。取值范围:
NONE 不开启自动续费
INFINITE 开启自动续费
Period Integer 购买时长
BillingCycle String 计费周期,预付费为MONTH,后付费为DAY,取值范围:
DAY 日
MONTH 月
EipSeries String 弹性公网IP系列。默认Normal,取值范围:
Normal 普通型
Enetwork 网络增强型
CidrBlock String 指定IP地址网段
IpAddress String 指定IP地址,指定IP地址时CidrBlock为必传
ClientToken String 用于保证幂等性。

3. 返回数据

名称 类型 说明
EipUUID String 弹性公网IP标识
RequestId String 请求ID

4. 示例

请求示例

https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=AllocateEip
&Format=JSON
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%
&RegionCode=cn-fuzhou-5
&BandwidthType=BGP
&Bandwidth=10
&InternetChargeType=PAY_BY_BAND_WIDTH
&InstanceChargeType=PRE_PAID
&Period=1
&BillingCycle=MONTH
&ClientToken=9a26-916650eca00f

正常返回示例

{
    "EipUUID":"eip-np00000d146o",
    "RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}

5. 错误码

错误码 错误信息
MissingParameter RegionCode 参数不能为空
MissingParameter BandwidthType 参数不能为空
MissingParameter InstanceChargeType 参数不能为空
MissingParameter InternetChargeType 参数不能为空
MissingParameter Period 参数不能为空
MissingParameter Bandwidth 参数不能为空
MissingParameter CidrBlock 参数不能为空
ValueNotSupported BillingCycle 参数不合法
ValueNotSupported BandwidthType 参数不合法
ValueNotSupported InternetChargeType 参数不合法
ValueNotSupported InstanceChargeType 参数不合法
ValueNotSupported AutoRenew 参数不合法
InvalidEipConfigNotSupported 弹性公网IP配置不合法
NoAvailableBandwidthTypeConfig 无可用线路类型配置
NoAvailableIp 无可用IP
AccountBalnceNotEnough 账户余额不足
AccountNotRealnameAuth 账户未实名认证
AllocateEipFail 分配弹性公网IP失败:xxx
kaopuyun all right reserved,powered by GitbookUpdated Time: 2024-10-09 06:22:14

results matching ""

    No results matching ""