- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- API
- API V3
- 应用示例
-
权限和授权项
- 策略及授权项说明
- VPC
- 子网
- 端口
- 对等连接
- VPC路由
- 路由表
- 配额
- 私有IP
- 安全组
- 安全组规则
- VPC标签
- 子网标签
- VPC流日志
- 端口(Openstack Neutron API)
- 网络(Openstack Neutron API)
- 子网(Openstack Neutron API)
- 路由器(Openstack Neutron API)
- 网络ACL(Openstack Neutron API)
- 安全组(Openstack Neutron API)
- VPC(API V3)
- 安全组(API V3)
- 安全组规则(API V3)
- IP地址组(API V3)
- 辅助弹性网卡(API V3)
- 流量镜像会话(API V3)
- 流量镜像筛选条件(API V3)
- 流量镜像筛选规则(API V3)
- 网络ACL(API V3)
- 网络ACL标签(API V3)
- 端口(API V3)
- API授权项注意事项
- 常见问题
- 历史API
- 附录
- SDK参考
- 场景代码示例
-
常见问题
- 计费类
- 虚拟私有云与子网类
- 弹性公网IP类
- 对等连接类
- 虚拟IP类
- 带宽类
-
网络连接类
- VPN支持将两个VPC互连吗?
- ECS有多个网卡时,为何无法通过域名访问公网网站及云中的内部域名?
- 同时拥有自定义路由和EIP的ECS访问外网的优先级是什么?
- 本地主机访问使用弹性云服务器搭建的网站出现间歇性中断怎么办?
- 同一个子网下的弹性云服务器只能通过内网IP地址单向通信怎么办?
- 同一个VPC内的两台弹性云服务器无法互通或者出现丢包等现象时,如何排查?
- Cloud-init连接出现问题时,如何排查?
- EIP连接出现问题时,如何排查?
- 二三层通信出现问题时,如何排查?
- 裸机网络出现问题时,如何排查?
- 弹性云服务器IP获取不到时,如何排查?
- VPN及专线网络连接出现问题时,如何排查?
- 外网能访问服务器,但是服务器无法访问外网时,如何排查?
- 配置了IPv6双栈,为什么无法访问IPv6网站?
- 弹性云服务器防火墙配置完成后,为什么网络不通?
- 路由类
- 安全类
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
查询安全组资源实例
功能介绍
使用标签过滤实例
URI
POST /v2.0/{project_id}/security-groups/resource_instances/action
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
功能说明:操作标识 取值范围:filter(过滤),count(查询总条数) |
limit |
否 |
Integer |
功能说明:查询记录数 取值范围:1-1000 约束:action为count时此参数不生效;action为filter时默认为1000 |
offset |
否 |
Integer |
功能说明:索引位置, 从offset指定的下一条数据开始查询。 查询第一页数据时,不需要传入此参数,查询后续页码数据时,将查询前一页数据时响应体中的值带入此参数 约束:action为count时无此参数;action为filter时默认为0;必须为数字,不能为负数 |
matches |
否 |
Array of Match objects |
功能说明:搜索字段,key为要匹配的字段,value为匹配的值 约束:当前仅支持resource_name |
tags |
否 |
Array of ListTag objects |
包含标签,最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
resources |
Array of ListResourceResp objects |
资源列表 |
total_count |
Integer |
资源数量 |
参数 |
参数类型 |
描述 |
---|---|---|
resource_detail |
Object |
资源详情。 资源对象,用于扩展。默认为空 |
resource_id |
String |
资源ID |
resource_name |
String |
资源名称,没有默认为空字符串 |
tags |
Array of ResourceTag objects |
标签列表,没有标签默认为空数组 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
功能说明:标签键 约束:同一资源的key值不能重复。 最小长度:0 最大长度:36 |
value |
String |
功能说明:标签值 最小长度:0 最大长度:43 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
状态码: 409
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
请求返回的错误码 |
message |
String |
请求返回的错误信息 最小长度:1 最大长度:999 |
请求示例
-
查询安全组资源实例,action为filter时请求体。
POST https://{Endpoint}/v2.0/{project_id}/security-groups/resource_instances/action { "offset" : "0", "limit" : "100", "action" : "filter", "matches" : [ { "key" : "resource_name", "value" : "resource1" } ], "tags" : [ { "key" : "key1", "values" : [ "*value1", "value2" ] } ] }
-
example-2:action为count时请求体
POST https://{Endpoint}/v2.0/{project_id}/security-groups/resource_instances/action { "action" : "count", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ] }
响应示例
状态码: 200
请求体action为filter时返回资源tag列表,action为count时返回tag总数
{ "resources" : [ { "resource_id" : "cdfs_cefs_wesas_12_dsad", "resource_name" : "resouece1", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] } ], "total_count" : 1000 }
状态码
状态码 |
描述 |
---|---|
200 |
请求体action为filter时返回资源tag列表,action为count时返回tag总数 |
400 |
服务器未能处理请求。 |
401 |
被请求的页面需要用户名和密码。 |
403 |
对被请求页面的访问被禁止。 |
404 |
服务器无法找到被请求的页面。 |
409 |
由于冲突,请求无法被完成。 |
500 |
请求未完成。服务异常。 |
错误码
请参见错误码。