查询ACL项目标签
功能介绍
查询租户在指定Project中ACL实例的所有资源标签集合。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。
URI
GET /v3/{project_id}/firewalls/tags
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
功能说明：查询记录数 最小值：1 最大值：1000 缺省值：1000 |
|
offset |
否 |
Integer |
功能说明：索引位置， 从第一条数据偏移offset条数据后开始查询 约束：默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数 缺省值：0 |
请求参数
无
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
tags |
Array of ListTag objects |
tag对象列表 |
|
request_id |
String |
请求ID |
|
total_count |
Integer |
资源数量 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
功能说明：标签键 约束：key不能为空 最小长度：1 最大长度：128 |
|
values |
Array of strings |
功能描述：标签值列表。 如果values为空列表，则表示any_value（查询任意value）。value之间为或的关系。 最大长度：255 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码： 401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码： 403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码： 404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID。 |
|
error_msg |
String |
错误消息。 |
|
error_code |
String |
错误码。 |
请求示例
查询网络ACL项目标签。
GET https://{Endpoint}/v3/{project_id}/firewalls/tags
响应示例
状态码： 200
操作正常返回
{
"request_id" : "65ae533b-f32c-49df-9b5d-e55eda8f2c25",
"tags" : [ {
"key" : "key1",
"values" : [ "value1", "value2" ]
}, {
"key" : "key2",
"values" : [ "value2" ]
}, {
"key" : "key3",
"values" : [ "value3" ]
}, {
"key" : "key4",
"values" : [ "value4" ]
}, {
"key" : "key5",
"values" : [ "value5" ]
}, {
"key" : "keyyyy",
"values" : [ "value2" ]
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
操作正常返回 |
|
400 |
参数非法 |
|
401 |
鉴权失败 |
|
403 |
权限不足 |
|
404 |
资源未找到 |
|
500 |
系统异常 |
错误码
请参见错误码。
