创建IP地址组
功能介绍
创建IP地址组。输入的ip可为ip地址、CIDR子网或者ip地址段，格式为ip-ip，例如10.12.3.1-10.12.3.10，支持IPV4和IPV6。
需要注意0.0.0.0与0.0.0.0/32视为重复，0:0:0:0:0:0:0:1与::1与::1/128视为重复，只会保存其中一个。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/elb/ipgroups
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释：IAM鉴权Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ipgroup |
是 |
CreateIpGroupOption object |
参数解释：创建IP地址组的请求体。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
否 |
String |
参数解释：IP地址组所在的项目ID。 |
|
description |
否 |
String |
参数解释：IP地址组的描述。 |
|
name |
否 |
String |
参数解释：IP地址组的名称。 |
|
ip_list |
是 |
Array of CreateIpGroupIpOption objects |
参数解释：IP地址组中包含的IP或网段列表。[]表示任意IP。 |
|
enterprise_project_id |
否 |
String |
参数解释：IP地址组所在的企业项目ID。 |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ipgroup |
IpGroup object |
参数解释：创建IP地址组的响应体。 |
|
request_id |
String |
参数解释：请求ID。 注：自动生成 。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释：IP地址组的ID。 |
|
name |
String |
参数解释：IP地址组的名称。 |
|
description |
String |
参数解释：IP地址组的描述信息。 |
|
ip_list |
Array of IpInfo objects |
参数解释：IP地址组中包含的IP或网段列表。[]表示任意IP。 |
|
listeners |
Array of ListenerRef objects |
参数解释：与IP地址组关联的监听器的ID列表。 |
|
project_id |
String |
参数解释：IP地址组的项目ID。 |
|
enterprise_project_id |
String |
参数解释：IP地址组所在的企业项目ID。 |
|
created_at |
String |
参数解释：IP地址组的创建时间。 |
|
updated_at |
String |
参数解释：IP地址组的更新时间。 |
请求示例
创建一个IP地址组，并指定其中包含的IP地址
POST https://{ELB_Endpoint}/v3/45977fa2dbd7482098dd68d0d8970117/elb/ipgroups
{
"ipgroup" : {
"name" : "test_ipg",
"ip_list" : [ {
"ip" : "192.168.1.123"
}, {
"ip" : "192.168.3.0/24",
"description" : "test_ip"
}, {
"ip" : "2001:0DB8:02de:0000:0000:0000:0000:0e13"
} ]
}
}
响应示例
状态码：201
参数解释：POST操作正常返回。
{
"ipgroup" : {
"description" : "",
"id" : "8722e0e0-9cc9-4490-9660-8c9a5732fbb0",
"name" : "test_ipg",
"project_id" : "45977fa2dbd7482098dd68d0d8970117",
"ip_list" : [ {
"ip" : "192.168.1.123",
"description" : ""
}, {
"ip" : "192.168.3.0/24",
"description" : "test_ip"
} ],
"listeners" : [ {
"id" : "88f9c079-29cb-435a-b98f-0c5c0b90c2bd"
}, {
"id" : "2f4c9644-d5d2-4cf8-a3c0-944239a4f58c"
} ],
"created_at" : "2018-01-16T03:19:16",
"updated_at" : "2018-01-16T03:19:16"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
参数解释：POST操作正常返回。 |
错误码
请参见错误码。
