列出组织或来源的发现结果。
如需列出所有来源,请将 -
作为来源 ID 提供。示例:/v1/organizations/{organization_id}/sources/-/findings
HTTP 请求
:
网址使用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。相应发现所属的来源的名称。其格式为 |
查询参数
参数 | |
---|---|
filter |
用于定义要应用于发现结果的过滤条件的表达式。该表达式是通过逻辑运算符 限制的形式为
支持的运算符包括:
支持的值类型包括:
支持以下字段和运算符组合:
用法:此值应为从公元纪年起算的毫秒数,或 RFC3339 字符串。示例:
例如, 对空字符串使用部分匹配,以便根据属性“existing”进行过滤: 对空字符串使用否定部分匹配,以便根据不存在的属性进行过滤:
|
orderBy |
用于定义要用于排序的字段和顺序的表达式。字符串值应遵循 SQL 语法:逗号分隔的字段列表。例如:“name,resourceProperties.a_property”。默认排序顺序为升序。如需将字段指定为降序,应将后缀“desc”附加到字段名称中。例如:“name desc,sourceProperties.a_property”。语法中的冗余空格字符是无关紧要的。“name desc,sourceProperties.a_property”和“name desc , sourceProperties.a_property”是等效的。 支持以下字段:name、parent、state、category、resourceName、eventTime、sourceProperties、securityMarks.marks |
readTime |
过滤发现结果时用作参考点的时间。此过滤条件仅限于在所提供时间存在的发现结果,其值为该特定时间的值。如果未指定此字段,则默认使用 API 的 NOW 版本。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
compareDuration |
设置 compareDuration 后,ListFindingsResult 的“stateChange”属性会更新,以指明相应发现的状态是否发生了变化、相应发现的状态是否保持不变,或者相应发现是在 readTime 之前的 compareDuration 时间段内以任何状态添加的。这是介于 (readTime - compareDuration) 和 readTime 之间的时间。 stateChange 值是根据相应发现结果在这两个时间点的存在性和状态派生得出的。这两次时间点之间的中间状态变化不会影响结果。例如,如果发现结果先设为非活跃状态,然后再设为活跃状态,则结果不会受到影响。 指定 compareDuration 时可能的“stateChange”值:
如果未指定 compareDuration,则唯一可能的 stateChange 是“UNUSED”,系统会将该 stateChange 设置为 readTime 时存在的所有发现。 该时长以秒为单位,最多包含九个小数位,以“ |
fieldMask |
用于指定要在响应中列出的发现结果字段的字段掩码。空字段掩码将列出所有字段。 |
pageToken |
最后一个 |
pageSize |
单个响应中返回的结果数上限。默认值为 10,最小值为 1,最大值为 1000。 |
请求正文
请求正文必须为空。
响应正文
如果成功,则响应正文包含一个 ListFindingsResponse
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅 Authentication Overview。