AllocateEips
更新时间:2024-12-10 11:03:08
PDF
从 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
}