从 IP 池中分配一个公网 IP，分配时可指定带宽、数量、IP 组、名称及是否需要备案。分配后的公网 IP 可跟云服务器或路由器绑定。

说明

无论公网 IP 是否与其他资源绑定，一旦分配成功，此 IP 的计费就会开始。

请求参数

参数	参数类型	描述	是否必选
bandwidth	Integer	公网 IP 带宽上限，单位为 Mbps	Yes
billing_mode	String	公网 IP 计费模式：bandwidth 按带宽计费，traffic 按流量计费，默认是 bandwidth	No
associate_mode	Integer	公网 IP 绑定模式：0 为外部绑定，1 为内部绑定，默认是 0	No
eip_name	String	公网 IP 名称	No
count	Integer	创建公网 IP 的数量，默认是 1	No
need_icp	Integer	是否需要备案，1 为需要，0 为不需要，默认是 0	No
target_user	String	目标用户 ID ，可用于主账号为其子账号创建资源。	No
zone	String	区域 ID，注意要小写	Yes

公共参数

返回数据

参数	参数类型	描述
action	String	响应动作
eips	Array	分配成功的公网 IP 列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

示例

请求示例：

https://api.qingcloud.com/iaas/?action=AllocateEips
&bandwidth=2
&billing_mode=bandwidth
&eip_name=dev
&zone=pek3a
&COMMON_PARAMS

返回示例：

{
  "action":"AllocateEipsResponse",
  "eips":["eip-j38f2h3h"]
  "ret_code":0
}