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)

省略可。変換するオブジェクトを含むバケットを特定するためにバケットに適用する Common Expression Language（CEL）で表現されたフィルタ。
objectFilters

object (Expr)

省略可。変換するオブジェクトを特定するためにオブジェクトに適用する Common Expression Language（CEL）で表現されたフィルタ。
dryRunJobId

string

省略可。現在のジョブのベースラインとして使用するドライラン ジョブの固有識別子。

この ID を指定すると、ドライラン中に検証された同じオブジェクトのセットに対してジョブが実行されます。値は、リソース名の {jobId} セグメント projects/{projectId}/locations/{location}/jobs/{jobId} に対応します。
targetLocations

object (TargetLocations)

省略可。ジョブに含める Cloud Storage のロケーションを指定します。指定した場合、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

Common Expression Language（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

Common Expression Language 構文による式のテキスト表現。
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 の両方で正常に設定された最新のスナップショット タイムスタンプに自動的にデフォルト設定されます。

Storage Insights データセットのスナップショットとビューの詳細については、Storage Insights データセットのテーブルとスキーマをご覧ください。
snapshotTime

string (Timestamp format)

省略可。RFC 3339 形式（2024-01-02T03:04:05Z など）と互換性のあるジョブに使用する正確な Storage Insights データセット スナップショットのタイムスタンプ。

指定した場合、このスナップショットは、locations にリストされているすべてのロケーションの object_attributes_view と bucket_attributes_view の両方に存在する必要があります。いずれかのロケーションのいずれかのビューにスナップショットがない場合、ジョブは失敗します。

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