Method: organizations.sources.findings.list

列出组织或来源的发现结果。

如需列出所有来源，请将 - 作为来源 ID 提供。示例：/v1beta1/organizations/{organization_id}/sources/-/findings

HTTP 请求

：


网址使用 gRPC 转码语法。

路径参数

参数
parent

string

必需。相应发现所属的来源的名称。其格式为“organizations/[organization_id]/sources/[source_id]”。如需列出所有来源，请提供 - 作为 source_id。例如：organizations/{organization_id}/sources/-

查询参数

参数
filter

string

用于定义要应用于发现结果的过滤条件的表达式。该表达式是通过逻辑运算符 AND 和 OR 组合的一个或多个限制条件的列表。不支持圆括号，并且 OR 的优先级高于 AND。

限制的形式为 <field> <operator> <value>，并且可能在前面带有 - 字符以表示否定。例如：

  • name
  • sourceProperties.a_property
  • securityMarks.marks.marka

支持的运算符包括：

  • =（适用于所有值类型）。
  • >、<、>=、<=，表示整数值。
  • :，表示字符串的子字符串匹配。

支持的值类型包括：

  • 字符串字面量用引号括起来。
  • 不带引号的整数字面量。
  • 不带引号的布尔值字面量 true 和 false。

例如，sourceProperties.size = 100 是一个有效的过滤器字符串。
orderBy

string

用于定义要用于排序的字段和顺序的表达式。字符串值应遵循 SQL 语法：逗号分隔的字段列表。例如：“name,resourceProperties.a_property”。默认排序顺序为升序。如需将字段指定为降序，应将后缀“desc”附加到字段名称中。例如：“name desc,sourceProperties.a_property”。语法中的冗余空格字符是无关紧要的。“name desc,sourceProperties.a_property”和“name desc , sourceProperties.a_property”是等效的。
readTime

string (Timestamp format)

过滤发现结果时用作参考点的时间。此过滤条件仅限于在所提供时间存在的发现结果，其值为该特定时间的值。如果未指定此字段，则默认使用 API 的 NOW 版本。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
fieldMask

string (FieldMask format)

可选。用于指定要在响应中列出的发现结果字段的字段掩码。空字段掩码将列出所有字段。
pageToken

string

最后一个 ListFindingsResponse 返回的值；该参数表示这是之前的 findings.list 调用的延续，并且系统应返回下一页的数据。
pageSize

integer

单个响应中返回的结果数上限。默认值为 10，最小值为 1，最大值为 1000。

请求正文

请求正文必须为空。

响应正文

用于列出发现结果的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "findings": [
    {
      object (Finding)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
字段
findings[]

object (Finding)

与列表请求匹配的发现结果。
readTime

string (Timestamp format)

执行列表请求所用的时间。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
nextPageToken

string

用于检索下一页结果的令牌。如果没有更多结果，则为空。
totalSize

integer

与查询匹配的发现总数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。