Method: folders.assets.list

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

string

必需。包含资源的父级资源的名称。您可以在父级上指定的值取决于您指定父级的方法。您可以指定以下某个值：organizations/[organization_id]、folders/[folder_id] 或 projects/[projectId]。

string

用于定义要应用于所有素材资源的过滤条件的表达式。该表达式是通过逻辑运算符 AND 和 OR 组合而成的零个或多个限制条件的列表。支持括号，并且 OR 的优先级高于 AND。

限制的形式为 <field> <operator> <value>，并且可能在前面带有 - 字符以表示否定。这些字段会映射到 Asset 资源中定义的字段。例如：

• name
• securityCenterProperties.resource_name
• resourceProperties.a_property
• securityMarks.marks.marka

支持的运算符包括：

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

支持的值类型包括：

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

以下是允许的字段和运算符组合：

• 名称：=
• updateTime：=、>、<、>=、<=

用法：此值应为从公元纪年起算的毫秒数，或 RFC3339 字符串。示例：updateTime = "2019-06-10T16:07:18-07:00" updateTime = 1560208038000

• createTime：=、>、<、>=、<=

用法：此值应为从公元纪年起算的毫秒数，或 RFC3339 字符串。示例：createTime = "2019-06-10T16:07:18-07:00" createTime = 1560208038000

• iamPolicy.policy_blob：=、:
• resourceProperties：=、:、>、<、>=、<=
• securityMarks.marks：=、:
• securityCenterProperties.resource_name: =, :
• securityCenterProperties.resource_display_name: =, :
• securityCenterProperties.resource_type: =、:
• securityCenterProperties.resource_parent: =, :
• securityCenterProperties.resource_parent_display_name: =, :
• securityCenterProperties.resource_project: =, :
• securityCenterProperties.resource_project_display_name: =, :
• securityCenterProperties.resource_owners: =, :

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

对空字符串使用部分匹配，以便根据现有属性进行过滤：resourceProperties.my_property : ""

对空字符串使用否定部分匹配，以便根据不存在的属性进行过滤：-resourceProperties.my_property : ""

string

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

支持以下字段：name updateTime resourceProperties securityMarks.marks securityCenterProperties.resource_name securityCenterProperties.resource_display_name securityCenterProperties.resource_parent securityCenterProperties.resource_parent_display_name securityCenterProperties.resource_project securityCenterProperties.resource_project_display_name securityCenterProperties.resource_type

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"。

string (Duration format)

设置 compareDuration 后，ListAssetsResult 的“stateChange”属性会更新，以指示相应资源在 readTime 之前的 compareDuration 时间段内是添加、移除还是保持不变。这是介于 (readTime - compareDuration) 和 readTime 之间的时间。

stateChange 值是根据资产在两个时间点的存在情况派生的。这两次时间点之间的中间状态变化不会影响结果。例如，如果移除资源并重新创建，结果不会受到影响。

指定 compareDuration 时可能的“stateChange”值：

• “ADDED”：表示相应资产在 compareDuration 的开始不存在，但在 readTime 时存在。
• “REMOVED”：表示相应资产在 compareDuration 的开始时存在，但在 readTime 时不存在。
• “ACTIVE”：表示资源在 compareDuration 和 readTime 定义的时间段的开始和结束时都存在。

如果未指定 compareDuration，则唯一可能的 stateChange 是“UNUSED”，系统会为 readTime 时存在的所有素材资源设置该 stateChange。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

string (FieldMask format)

用于指定要在响应中列出的 ListAssetsResult 字段的字段掩码。空字段掩码将列出所有字段。

string

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

integer

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