查询地址组列表
功能介绍
查询地址组列表,根据过滤条件进行过滤。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。
URI
GET /v3/{project_id}/vpc/address-groups
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 获取方式请参见获取项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
|
marker |
否 |
String |
分页查询起始的资源ID,为空时查询第一页。 |
id |
否 |
Array of strings |
地址组唯一标识,填写后接口按照id进行过滤,支持多ID同时过滤。 |
name |
否 |
Array of strings |
地址组名称,填写后按照名称进行过滤,支持多名称同时过滤。 |
ip_version |
否 |
Integer |
|
description |
否 |
Array of strings |
地址组描述信息,填写后按照地址组描述信息过滤,支持多描述同时过滤。 |
enterprise_project_id |
否 |
String |
最大长度:36 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
request_id |
String |
请求ID。 |
address_groups |
Array of AddressGroup objects |
地址组列表响应体。 |
page_info |
PageInfo object |
分页信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
|
name |
String |
|
description |
String |
|
max_capacity |
Integer |
|
ip_set |
Array of strings |
|
ip_version |
Integer |
|
created_at |
String |
|
updated_at |
String |
|
tenant_id |
String |
|
enterprise_project_id |
String |
最大长度:36 |
tags |
Array of ResourceTag objects |
|
status |
String |
|
status_message |
String |
|
ip_extra_set |
Array of IpExtraSetRespOption objects |
|
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
最小长度:1 最大长度:128 |
value |
String |
最大长度:255 |
请求示例
组合过滤条件查询地址组列表。
GET https://{{endpoint}}/v3/b2782e6708b8475c993e6064bc456bf8/vpc/address-groups?name=vkvgykvsvhjaaaa1&description=xxxxxxxxxx&ip_version=4
响应示例
状态码: 200
GET操作正常返回,更多状态码请参见状态码。
-
{ "address_groups" : [ { "id" : "dd18a501-fcd5-4adc-acfe-b0e2384baf08", "name" : "AutoTester746010.580123789", "tenant_id" : "b2782e6708b8475c993e6064bc456bf8", "ip_version" : 4, "max_capacity" : 20, "ip_set" : [ "192.168.5.0/24", "192.168.3.20-192.168.3.100", "192.168.3.40", "192.168.3.2" ], "ip_extra_set" : [ { "ip" : "192.168.5.0/24", "remarks" : null }, { "ip" : "192.168.3.20-192.168.3.100", "remarks" : null }, { "ip" : "192.168.3.40", "remarks" : null }, { "ip" : "192.168.3.2", "remarks" : null } ], "enterprise_project_id" : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "created_at" : "2019-06-28T02:06:38.000+00:00", "updated_at" : "2019-06-28T02:06:38.000+00:00", "description" : "test", "status" : "NORMAL", "status_message" : "" } ], "page_info" : { "previous_marker" : "dd18a501-fcd5-4adc-acfe-b0e2384baf08", "current_count" : 1 }, "request_id" : "e51fa17c-3259-4122-afb1-9c03d4ef5408" }
状态码
状态码 |
描述 |
---|---|
200 |
GET操作正常返回,更多状态码请参见状态码。 |
错误码
请参见错误码。