ProjectSource

描述了将转换满足过滤条件的对象的目标项目来源。

JSON 表示法 
{
  "project": string,
  "insightsDatasetConfig": string,
  "bucketFilters": {
    object (Expr)
  },
  "objectFilters": {
    object (Expr)
  },
  "dryRunJobId": string,
  "targetLocations": {
    object (TargetLocations)
  },
  "snapshotTime": string
}
字段
project

string

必需。要转换的对象的项目名称，例如 projects/my-project 或 projects/123456。
insightsDatasetConfig

string

必需。存储空间分析数据集配置的资源标识符。存储空间批量操作使用此数据集中的最新快照作为来源，以列出和过滤目标对象。格式：projects/{projectId}/locations/{location}/datasetConfigs/{dataset_config}。
bucketFilters

object (Expr)

可选。以通用表达式语言 (CEL) 表示的过滤器，用于应用于存储分区以识别包含要转换的对象的存储分区。
objectFilters

object (Expr)

可选。以通用表达式语言 (CEL) 表示的过滤器，用于应用于对象以识别要转换的对象。
dryRunJobId

string

可选。试运行作业的唯一标识符，用作当前作业的基准。

指定此 ID 可确保作业针对在试运行期间验证的同一组对象执行。该值对应于资源名称的 {jobId} 部分：projects/{projectId}/locations/{location}/jobs/{jobId}。
targetLocations

object (TargetLocations)

可选。指定要包含在作业中的 Cloud Storage 位置。如果提供，则仅会从存储空间分析数据集中发现这些位置内的存储分区和对象，如 insightsDatasetConfig 中所配置。如果省略，作业将从 insightsDatasetConfig 中配置的所有位置发现存储分区和对象。
snapshotTime

string (Timestamp format)

仅限输出。作业用于读取存储空间分析数据集以进行存储桶和对象发现的快照时间。此字段由服务填充，反映了所用数据集快照的确切时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

Expr

表示采用通用表达式语言 (CEL) 语法的文本表达式。CEL 是一种类似于 C 的表达式语言。有关 CEL 的语法和语义，请参见https://github.com/google/cel-spec。

示例（比较）：

title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"

示例（相等）：

title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"

示例（逻辑）：

title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"

示例（数据操纵）：

title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"

可以在表达式内引用的确切变量和函数由计算该表达式的服务决定。如需了解详情，请参阅服务文档。

JSON 表示法 
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
字段
expression

string

采用通用表达式语言语法的表达式的文本表示法。
title

string

可选。表达式的标题，即说明表达式用途的短字符串。该标题可用于允许输入表达式的内容（例如界面）中。
description

string

可选。表达式的说明。该说明是描述表达式的较长文本，例如在界面中将鼠标悬停在表达式上时显示的文本。
location

string

可选。此字符串指示用于错误报告的表达式的位置，例如文件名和文件中的位置。

TargetLocations

描述了要包含在 ProjectSource 作业中的 Cloud Storage 位置。

JSON 表示法 
{
  "locations": [
    string
  ],
  "snapshotTime": string
}
字段
locations[]

string

必需。要包含在作业中的 Cloud Storage 位置列表（例如 us-central1）。

如果省略 snapshotTime，作业会自动默认使用在所有指定位置的 object_attributes_view 和 bucket_attributes_view 中成功填充的最新快照时间戳。

如需详细了解存储空间分析数据集快照和视图，请参阅 Storage Insights 数据集表和架构。
snapshotTime

string (Timestamp format)

可选。要用于作业的确切存储空间分析数据集快照时间戳，与 RFC 3339 格式兼容（例如 2024-01-02T03:04:05Z）。

如果指定，则对于 locations 中列出的每个位置，object_attributes_view 和 bucket_attributes_view 中都必须存在此确切快照。如果任何位置的任一视图中缺少快照，作业都会失败。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。