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

這是必要旗標，Storage Insights 資料集配置的資源識別碼。儲存批次作業使用此資料集中的最新快照作為來源來列出和篩選目標物件。格式：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)

選用。指定作業中要包含的雲端儲存位置。如果提供，則只會從 insightsDatasetConfig 中配置的 Storage Insights 資料集中發現這些位置內的儲存桶和物件。如果省略，則作業將從 insightsDatasetConfig 中配置的所有位置發現儲存桶和物件。
snapshotTime

string (Timestamp format)

僅供輸出。作業讀取 Storage Insights 資料集以進行儲存桶和物件發現所使用的快照時間。此欄位由服務自動填充，反映所用資料集快照的確切時間戳記。

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

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

選用。運算式的標題，即說明其用途的簡短字串。這可用在允許輸入運算式的 UI 中。
description

string

選用。運算式的說明。這是一段較長的文字，用於說明運算式。例如，使用者在 UI 中將游標懸停在運算式上方時，即可顯示說明文字。
location

string

選用。指出要提報錯誤的運算式所在位置，例如檔案名稱及檔案內的位置。

TargetLocations

說明要納入 ProjectSource 工作中的 Cloud Storage 位置。

JSON 表示法 
{
  "locations": [
    string
  ],
  "snapshotTime": string
}
欄位
locations[]

string

這是必要旗標，要納入工作中的 Cloud Storage 位置清單 (例如 us-central1)。

如果省略 snapshotTime，系統會自動將工作預設為最近一次成功填入所有指定位置 object_attributes_view 和 bucket_attributes_view 的快照時間戳記。

如要進一步瞭解儲存空間分析資料集快照和檢視畫面，請參閱「儲存空間分析資料集資料表和結構定義」。
snapshotTime

string (Timestamp format)

選用。與 RFC 3339 格式相容的確切儲存空間洞察資料集快照時間戳記，可用於這項工作 (例如 2024-01-02T03:04:05Z)。

如果指定了這項屬性，object_attributes_view 和 bucket_attributes_view 中列出的每個地點都必須有這個確切的快照。locations如果任何位置的任一檢視畫面缺少快照，工作就會失敗。

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