- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
-
常见问题
- 使用IAM用户（子账号）在CTS配置转储，操作OBS桶也必须是IAM用户么？
- 事件列表用于记录哪些信息？
- 用户公有云账户欠费给云审计服务带来的影响？
- 哪些用户应该开通云审计服务？
- 如果用户已开通云审计服务，但OBS桶未配置正确的策略，会出现什么情况？
- 云审计服务是否支持事件文件的完整性校验？
- 为什么查看事件窗口中的有些事件的字段为空？
- 为什么事件列表中的某些操作被记录了两次？
- 为什么在事件列表中按照操作用户进行筛选时，存在user_name和op_service用户？
- 关键操作通知服务支持哪些服务？
- CTS如何长期保存事件文件——转储至OBS桶
- 为什么有些trace_type为systemAction的事件，存在user和source_ip为空的情况？
- 事件级别中的三个字段分别代表什么？
- 如何通过云审计服务确认ECS的创建用户
- 如何查询IAM用户登录的IP地址
- cts_admin_trust委托被误删除怎么办？
- 为什么按需和包周期创建虚拟机的时候会有两个deleteMetadata事件？
- 如果账号被冻结、解除冻结、受限或解除受限，导致访问CTS前台提示系统繁忙，如何处理？
- 如何删除cts_admin_trust委托中Tenant Administrator的权限？
- 查询不到事件怎么办？
- 云审计功能申请打开之后是否可以自助关闭？
- 如何配置CTS审计日志存储180天？
- 在CTS控制台无法创建追踪器
- 使用IAM用户无法开通CTS怎么办？
- 如何给云硬盘添加告警通知？
- 可以接收重复的事件吗？
- 跨租户密钥授权OBS桶转储失败怎么办？
- cts_admin_trust委托是否包含OBS授权？
- CTS会记录云服务器创建失败的事件吗？
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
根据标签过滤资源
功能介绍
根据标签过滤资源
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/{resource_type}/resource-instances/filter
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
|
resource_type |
是 |
String |
资源的类型：cts-tracker。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
每页返回的资源个数。 取值范围：1~1000 参数取值说明： 如果action为filter时，默认为1000。 如果action为count时，无此参数。 |
|
offset |
否 |
String |
分页查询起始偏移量，表示从偏移量的下一个资源开始查询。 取值范围：0~2147483647 默认值为0。 参数取值说明： 查询第一页数据时，不需要传入此参数。 查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数。 如果action为filter时，默认为0，必须为数字，不能为负数。 如果action为count时，无此参数。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
without_any_tag |
否 |
Boolean |
true或false |
|
tags |
否 |
Array of TmsTags objects |
包含标签。 最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 |
|
tags_any |
否 |
Array of TmsTags objects |
最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 |
|
not_tags |
否 |
Array of TmsTags objects |
最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 |
|
not_tags_any |
否 |
Array of TmsTags objects |
最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 |
|
sys_tags |
否 |
Array of TmsTags objects |
最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 |
|
matches |
否 |
Array of Match objects |
key为要匹配的字段，value为匹配的值。 如果value为空字符串则精确匹配，否则模糊匹配。 |
|
action |
否 |
String |
操作标识（区分大小写）。 取值范围： filter：分页过滤查询 count：查询总条数 |
|
limit |
否 |
String |
每页返回的资源个数。 取值范围：1~1000 参数取值说明： 如果action为filter时，默认为1000。 如果action为count时，无此参数。 |
|
offset |
否 |
String |
分页查询起始偏移量，表示从偏移量的下一个资源开始查询。 取值范围：0~2147483647 默认值为0。 参数取值说明： 查询第一页数据时，不需要传入此参数。 查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数。 如果action为filter时，默认为0，必须为数字，不能为负数。 如果action为count时，无此参数。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
请求示例
根据标签过滤资源
https://{endpoint}/v3/{project_id}/{resource_type}/resource-instances/filter
{
"offset" : "100",
"limit" : "100",
"action" : "filter",
"without_any_tag" : true,
"tags" : [ {
"key" : "key1",
"values" : [ "*value1", "value2" ]
} ],
"tags_any" : [ {
"key" : "key1",
"values" : [ "*value1", "value2" ]
} ],
"not_tags" : [ {
"key" : "key1",
"values" : [ "*value1", "value2" ]
} ],
"not_tags_any" : [ {
"key" : "key1",
"values" : [ "*value1", "value2" ]
} ],
"sys_tags" : [ {
"key" : "key1",
"values" : [ "*value1", "value2" ]
} ],
"matches" : [ {
"key" : "resource_name",
"value" : "resource1"
} ]
}响应示例
状态码：200
{
"total_count": 1,
"resources": [{
"resource_id": "",
"resource_detail": null,
"tags": [{
"key": "key1",
"value": "value1"
}, "sys_tags": [{
"key": "key2",
"value": "value2"
}, "resource_name": ""]
}]
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
错误码
请参见错误码。
