更新IP地址组
功能介绍
更新IP地址组，只支持全量更新IP。即IP地址组中的ip_list将被全量覆盖，不在请求参数中的IP地址将被移除。 输入的ip可为ip地址或者CIDR子网，支持IPV4和IPV6。
需要注意0.0.0.0与0.0.0.0/32视为重复，0:0:0:0:0:0:0:1与::1与::1/128视为重复，只会保存其中一个。
调用方法
请参见如何调用API。
URI
PUT /v3/{project_id}/elb/ipgroups/{ipgroup_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ipgroup_id |
是 |
String |
待更新的IP地址组的ID。 |
|
project_id |
是 |
String |
项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
IAM鉴权Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ipgroup |
是 |
UpdateIpGroupOption object |
更新IP地址组请求体。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
description |
否 |
String |
IP地址组的描述信息 最小长度：0 最大长度：255 |
|
name |
否 |
String |
IP地址组的名称 最小长度：0 最大长度：255 |
|
ip_list |
否 |
Array of UpadateIpGroupIpOption objects |
IP地址组中包含的IP列表。 数组长度：0 - 300 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ipgroup |
IpGroup object |
更新IP地址组的响应体。 |
|
request_id |
String |
请求ID。 注：自动生成 。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
IP地址组的创建时间。 |
|
description |
String |
IP地址组的描述信息。 |
|
id |
String |
IP地址组的ID。 |
|
ip_list |
Array of IpInfo objects |
IP地址组中包含的IP或网段列表。[]表示任意IP。 数组长度：0 - 300 |
|
listeners |
Array of ListenerRef objects |
与IP地址组关联的监听器的ID列表。 |
|
name |
String |
IP地址组的名称。 |
|
project_id |
String |
IP地址组的项目ID。 |
|
updated_at |
String |
IP地址组的更新时间。 |
请求示例
更新IP地址组中的所有IP地址
PUT https://{ELB_Endpoint}/v3/45977fa2dbd7482098dd68d0d8970117/elb/ipgroups/8722e0e0-9cc9-4490-9660-8c9a5732fbb0
{
"ipgroup" : {
"name" : "test_ipg",
"ip_list" : [ {
"ip" : "192.168.1.123"
}, {
"ip" : "192.168.3.0/24",
"description" : "test_ip"
} ]
}
}
响应示例
状态码： 200
操作正常返回。
{
"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"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
操作正常返回。 |
错误码
请参见错误码。
