本頁面由 Cloud Translation API 翻譯而成。

建立及管理批次作業工作

本頁說明如何建立、查看、列出、取消及刪除儲存空間批次作業工作。本文也說明如何搭配使用 Cloud 稽核記錄與儲存空間批次作業工作。

事前準備

如要建立及管理儲存空間批次作業工作，請完成下列各節的步驟。

設定 Storage Intelligence

如要建立及管理儲存空間批次作業工作，請在要執行工作的 bucket 上設定 Storage Intelligence。

設定 Google Cloud CLI

您必須使用 Google Cloud CLI 516.0.0 以上版本。

設定預設專案

設定要建立儲存空間批次作業工作的專案。

gcloud config set project PROJECT_ID

其中 PROJECT_ID 是專案 ID。

啟用 API

啟用儲存空間批次作業 API。

gcloud services enable storagebatchoperations.googleapis.com

建立資訊清單

如要使用資訊清單進行物件選取，請建立資訊清單。

建立儲存空間批次作業工作

本節說明如何建立儲存空間批次作業工作。

需要角色

如要取得建立儲存空間批次作業工作所需的權限，請要求管理員授予您專案的儲存空間管理員 (roles/storage.admin) IAM 角色。這個預先定義的角色包含建立儲存空間批次作業工作所需的下列權限：

storagebatchoperations.jobs.create
storage.objects.delete (只有在執行刪除物件儲存空間批次作業工作時才需要)
storage.objects.update (只有在執行更新物件中繼資料、更新物件客戶自行管理的加密金鑰，或更新物件保留儲存空間批次作業工作時才需要)

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs create 指令。
```
gcloud storage batch-operations jobs create JOB_NAME --bucket=BUCKET_NAME OBJECT_SELECTION_FLAG JOB_TYPE_FLAG
```
其中：
- JOB_NAME 是儲存空間批次作業工作的名稱。
- BUCKET_NAME 是包含一或多個要處理物件的值區名稱。
- OBJECT_SELECTION_FLAG 是下列其中一個標記：
  - --included-object-prefixes：指定一或多個物件前置字串。例如：
    - 如要比對單一前置字串，請使用：--included-object-prefixes='prefix1'。
    - 如要比對多個前置字串，請使用以半形逗號分隔的前置字串清單：--included-object-prefixes='prefix1,prefix2'。
    - 如要納入所有物件，請使用空白前置字串：--included-object-prefixes=''。
  - --manifest-location：指定資訊清單位置。例如：gs://bucket_name/path/object_name.csv。
- JOB_TYPE_FLAG 是下列其中一個旗標，視工作類型而定。
  - --delete-object：刪除一或多個物件。
  - --put-metadata：更新物件中繼資料。物件中繼資料會以鍵/值組合的形式儲存。指定要修改的中繼資料的鍵/值組合。您可以將一或多個 key-value 組合指定為清單。
  - --rewrite-object：更新一或多個物件的客戶自行管理的加密金鑰。
  - --put-object-event-based-hold：啟用以事件為準的物件保留。
  - --no-put-object-event-based-hold：停用依據事件的物件保留。
  - --put-object-temporary-hold：啟用暫時物件保留。
  - --no-put-object-temporary-hold：停用暫時物件保留。

REST API

JSON API

安裝並初始化 gcloud CLI，以便為 Authorization 標頭產生存取權杖。

建立 JSON 檔案，其中包含儲存空間批次作業工作的設定。以下是常見的設定：
```
{
    "Description": "JOB_DESCRIPTION",
    "BucketList":
    {
    "Buckets":
    [
     {
       "Bucket": "BUCKET_NAME",
       "Manifest": {
          "manifest_location": "MANIFEST_LOCATION"
           }
       "PrefixList": {
          "include_object_prefixes": "OBJECT_PREFIXES"
           }
     }
    ]
    },
    "DeleteObject":
    {
    "permanent_object_deletion_enabled": OBJECT_DELETION_VALUE
     }
    "RewriteObject": {
      "kms_key":"KMS_KEY_VALUE"
      }
    "PutMetadata": {
      METADATA_KEY= METADATA_VALUE,
      ...,
      }
    "PutObjectHold": {
      "temporary_hold": TEMPORARY_HOLD_VALUE,
      "event_based_hold": EVENT_BASED_HOLD_VALUE
    }
 }
     
```
其中：
- JOB_NAME 是儲存空間批次作業工作的名稱。
- JOB_DESCRIPTION 是儲存空間批次作業工作的說明。
- BUCKET_NAME 是包含一或多個要處理物件的值區名稱。
- 如要指定要處理的物件，請在 JSON 檔案中使用下列任一屬性：
  - MANIFEST_LOCATION 是資訊清單位置。例如：gs://bucket_name/path/object_name.csv。
  - OBJECT_PREFIXES 是以半形逗號分隔的清單，內含一或多個物件前置字元。如要比對所有物件，請使用空白清單。
- 視要處理的工作而定，指定下列任一選項：
  - 刪除物件：
```
"DeleteObject":
{
"permanent_object_deletion_enabled": OBJECT_DELETION_VALUE
}
```
    其中 OBJECT_DELETION_VALUE 是TRUE，用於刪除物件。
  - 更新物件的客戶自行管理加密金鑰：
```
"RewriteObject":
{
"kms_key": KMS_KEY_VALUE
}
```
    其中 KMS_KEY_VALUE 是要更新的物件 KMS 金鑰值。
  - 更新物件中繼資料：
```
"PutMetadata": {
METADATA_KEY= METADATA_VALUE,
...,
}
```
    其中 METADATA_VALUE 是物件的中繼資料鍵值。您可以將一或多個 key-value 組合指定為清單。
  - 更新物件保留：
```
"PutObjectHold": {
"temporary_hold": TEMPORARY_HOLD_VALUE,
"event_based_hold": EVENT_BASED_HOLD_VALUE
}
```
    其中：
    - TEMPORARY_HOLD_VALUE 用於啟用或停用暫時物件保留。值為 1 時，系統會啟用保留功能；值為 2 時，系統會停用保留功能。
    - EVENT_BASED_HOLD_VALUE 用於啟用或停用事件型物件保留。值為 1 時，系統會啟用保留功能；值為 2 時，系統會停用保留功能。

使用 cURL 來透過 POST 儲存空間批次作業工作要求呼叫 JSON API：

curl -X POST --data-binary @JSON_FILE_NAME \
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json" \
 "https://storagebatchoperations.googleapis.com/v1/project=PROJECT_ID/locations/global/jobs?job_id=JOB_ID"

其中：

JSON_FILE_NAME 是 JSON 檔案的名稱。
PROJECT_ID 是專案的 ID 或編號。例如：my-project。
JOB_ID 是儲存空間批次作業工作的名稱。

取得儲存空間批次作業工作的詳細資料

本節說明如何取得儲存空間批次作業工作的詳細資料。

需要角色

如要取得查看儲存空間批次作業工作所需的權限，請要求管理員授予您專案的儲存空間管理員 (roles/storage.admin) IAM 角色。這個預先定義的角色包含下列權限，可查看儲存空間批次作業工作：

storagebatchoperations.jobs.get
storagebatchoperations.operations.get

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs describe 指令。
```
gcloud storage batch-operations jobs describe JOB_ID
```
其中：

JOB_ID 是儲存空間批次作業工作的名稱。

REST API

JSON API

安裝並初始化 gcloud CLI，以便為 Authorization 標頭產生存取權杖。

使用 cURL 透過 GET 儲存空間批次作業工作要求呼叫 JSON API：
```
curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs?JOB_ID"
```
其中：
- PROJECT_ID 是專案的 ID 或編號。例如：my-project。
- JOB_ID 是儲存空間批次作業工作的名稱。

列出 Storage 批次作業工作

本節說明如何列出專案中的儲存空間批次作業工作。

需要角色

如要取得列出所有儲存空間批次作業工作的必要權限，請要求管理員授予您專案的儲存空間管理員 (roles/storage.admin) IAM 角色。這個預先定義的角色包含下列權限，可列出儲存空間批次作業工作：

storagebatchoperations.jobs.list
storagebatchoperations.operations.list

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs list 指令。
```
gcloud storage batch-operations jobs list
```

REST API

JSON API

安裝並初始化 gcloud CLI，以便為 Authorization 標頭產生存取權杖。

使用 cURL 透過 LIST 儲存空間批次作業工作要求呼叫 JSON API：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs"

其中：

PROJECT_ID 是專案的 ID 或編號。例如：my-project。

取消儲存空間批次作業工作

本節說明如何取消專案中的儲存空間批次作業工作。

需要角色

如要取得取消儲存空間批次作業工作所需的權限，請要求管理員授予您專案的儲存空間管理員 (roles/storage.admin) IAM 角色。這個預先定義的角色包含取消儲存空間批次作業工作所需的下列權限：

storagebatchoperations.jobs.cancel
storagebatchoperations.operations.cancel

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs cancel 指令。
```
gcloud storage batch-operations jobs cancel JOB_ID
```
其中：

JOB_ID 是儲存空間批次作業工作的名稱。

REST API

JSON API

安裝並初始化 gcloud CLI，以便為 Authorization 標頭產生存取權杖。

使用 cURL 透過 CANCEL 儲存空間批次作業工作要求呼叫 JSON API：
```
curl -X CANCEL \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs/JOB_ID"
```
其中：
- PROJECT_ID 是專案的 ID 或編號。例如：my-project。
- JOB_ID 是儲存空間批次作業工作的名稱。

刪除儲存空間批次作業工作

本節說明如何刪除儲存空間批次作業工作。

需要角色

如要取得刪除儲存空間批次作業工作所需的權限，請要求管理員授予您專案的儲存空間管理員 (roles/storage.admin) IAM 角色。這個預先定義的角色具備刪除儲存空間批次作業工作所需的 storagebatchoperations.jobs.delete 權限。

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs delete 指令。
```
gcloud storage batch-operations jobs delete JOB_ID
```
其中：

JOB_ID 是儲存空間批次作業工作的名稱。

REST API

JSON API

安裝並初始化 gcloud CLI，以便為 Authorization 標頭產生存取權杖。

使用 cURL 透過 DELETE 儲存空間批次作業工作要求呼叫 JSON API：
```
curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagebatchoperations.googleapis.com/v1/projects/PROJECT_ID/locations/global/jobs/JOB_ID"
```
其中：
- PROJECT_ID 是專案的 ID 或編號。例如：my-project。
- JOB_ID 是儲存空間批次作業工作的名稱。

使用儲存空間分析資料集建立儲存空間批次作業工作

如要使用 Storage Insights 資料集建立儲存空間批次作業工作，請完成下列各節的步驟。

需要角色

如要取得建立儲存空間批次作業工作所需的權限，請要求管理員授予您專案的「儲存空間管理員」身分與存取權管理角色 (roles/storage.admin)。這個預先定義的角色具備下列權限，可建立儲存空間批次作業工作：

storagebatchoperations.jobs.create
storage.objects.delete (只有在執行刪除物件儲存空間批次作業工作時才需要)
storage.objects.update (只有在執行更新物件中繼資料、更新物件客戶自行管理的加密金鑰，或更新物件保留儲存空間批次作業工作時才需要)

使用儲存空間分析資料集建立資訊清單

您可以從 BigQuery 擷取資料，為儲存空間批次作業工作建立資訊清單。如要執行這項操作，您需要查詢連結的資料集，將產生的資料匯出為 CSV 檔案，然後儲存至 Cloud Storage 值區。儲存空間批次作業工作隨後可將這個 CSV 檔案做為資訊清單。

在 BigQuery 中對 Storage Insights 資料集檢視畫面執行下列 SQL 查詢，即可擷取名稱為 Temp_Training 的物件，且這些物件的大小超過 1 KiB：

  EXPORT DATA OPTIONS(
   uri=`URI`,
   format=`CSV`,
   overwrite=OVERWRITE_VALUE,
   field_delimiter=',') AS
  SELECT bucket, name, generation
  FROM DATASET_VIEW_NAME
  WHERE bucket = BUCKET_NAME
  AND name LIKE (`Temp_Training%`)
  AND size > 1024 * 1024
  AND snapshotTime = SNAPSHOT_TIME

其中：

URI 是包含資訊清單的值區 URI。例如，gs://bucket_name/path_to_csv_file/*.csv。使用 *.csv 萬用字元時，BigQuery 會將結果匯出至多個 CSV 檔案。
OVERWRITE_VALUE 是布林值。如果設為 true，匯出作業會覆寫指定位置的現有檔案。
DATASET_VIEW_NAME 是儲存空間分析資料集檢視區的完整名稱，格式為 PROJECT_ID.DATASET_ID.VIEW_NAME。如要找出資料集名稱，請查看連結的資料集。

其中：
- PROJECT_ID 是專案的 ID 或編號。例如：my-project。
- DATASET_ID 是資料集名稱。例如：objects-deletion-dataset。
- VIEW_NAME 是資料集檢視區塊的名稱。例如：bucket_attributes_view。
BUCKET_NAME 是值區名稱。例如：my-bucket。
SNAPSHOT_TIME 是儲存空間分析資料集檢視畫面的快照時間。例如：2024-09-10T00:00:00Z。

建立儲存空間批次作業工作

如要建立儲存空間批次作業工作，處理資訊清單中包含的物件，請完成下列步驟：

指令列

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
在開發環境中執行 gcloud storage batch-operations jobs create 指令：
```
gcloud storage batch-operations jobs create \
JOB_ID \
--bucket=SOURCE_BUCKET_NAME \
--manifest-location=URI \
--JOB_TYPE_FLAG
```
其中：
- JOB_ID 是儲存空間批次作業工作的名稱。
- SOURCE_BUCKET_NAME 是包含一或多個要處理物件的值區。例如：my-bucket。
- URI 是包含資訊清單的值區 URI。例如，gs://bucket_name/path_to_csv_file/*.csv。使用 *.csv 萬用字元時，BigQuery 會將結果匯出至多個 CSV 檔案。
- JOB_TYPE_FLAG 是下列其中一個旗標，視工作類型而定。
  - --delete-object：刪除一或多個物件。
  - --put-metadata：更新物件中繼資料。物件中繼資料會以鍵/值組合的形式儲存。指定要修改的中繼資料的鍵/值組合。您可以將一或多個 key-value 組合指定為清單。
  - --rewrite-object：更新一或多個物件的客戶自行管理的加密金鑰。
  - --put-object-event-based-hold：啟用以事件為準的物件保留。
  - --no-put-object-event-based-hold：停用依據事件的物件保留。
  - --put-object-temporary-hold：啟用暫時物件保留。
  - --no-put-object-temporary-hold：停用暫時物件保留。

與 VPC Service Controls 整合

您可以使用 VPC Service Controls，為儲存空間批次作業資源提供額外的安全防護。使用 VPC Service Controls 時，您可以將專案加入服務範圍，如此一來，源自服務範圍外的要求就無法存取相關資源及服務。如要進一步瞭解儲存空間批次作業的 VPC Service Controls 服務範圍詳細資料，請參閱「支援的產品和限制」。

使用 Cloud 稽核記錄查看儲存空間批次作業工作

儲存空間批次作業工作會記錄 Cloud Storage 物件的轉換作業，並將記錄寫入 Cloud Storage Cloud 稽核記錄。您可以搭配 Cloud Storage 使用 Cloud 稽核記錄，追蹤儲存空間批次作業工作執行的物件轉換。如要瞭解如何啟用稽核記錄，請參閱「啟用稽核記錄」一文。在稽核記錄項目中，值為 StorageBatchOperations 的 callUserAgent 中繼資料欄位表示儲存空間批次作業轉換。

後續步驟

瞭解儲存空間分析資料集

建立及管理批次作業工作 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

設定 Storage Intelligence

設定 Google Cloud CLI

設定預設專案

啟用 API

建立資訊清單

建立儲存空間批次作業工作

需要角色

指令列

REST API

JSON API

取得儲存空間批次作業工作的詳細資料

需要角色

指令列

REST API

JSON API

列出 Storage 批次作業工作

需要角色

指令列

REST API

JSON API

取消儲存空間批次作業工作

需要角色

指令列

REST API

JSON API

刪除儲存空間批次作業工作

需要角色

指令列

REST API

JSON API

使用儲存空間分析資料集建立儲存空間批次作業工作

需要角色

使用儲存空間分析資料集建立資訊清單

建立儲存空間批次作業工作

指令列

與 VPC Service Controls 整合

使用 Cloud 稽核記錄查看儲存空間批次作業工作

後續步驟

建立及管理批次作業工作