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

TransferOptions
透過集合功能整理內容你可以依據偏好儲存及分類內容。

TransferOptions 會定義要在轉移作業中對物件執行的動作。

JSON 表示法

JSON 表示法
{ "overwriteObjectsAlreadyExistingInSink": boolean, "deleteObjectsUniqueInSink": boolean, "deleteObjectsFromSourceAfterTransfer": boolean, "overwriteWhen": enum (`OverwriteWhen`), "metadataOptions": { object (`MetadataOptions`) } }

{
  "overwriteObjectsAlreadyExistingInSink": boolean,
  "deleteObjectsUniqueInSink": boolean,
  "deleteObjectsFromSourceAfterTransfer": boolean,
  "overwriteWhen": enum (OverwriteWhen),
  "metadataOptions": {
    object (MetadataOptions)
  }
}

欄位
`overwriteObjectsAlreadyExistingInSink`	`boolean` 覆寫已存在於接收器中的物件時機。根據預設，系統只會覆寫與來源不同的物件。如果為 true，則會將接收器中名稱與來源中物件相符的所有物件，以來源物件覆寫。
`deleteObjectsUniqueInSink`	`boolean` 是否應刪除只存在於接收器中的物件。注意：這個選項和 `deleteObjectsFromSourceAfterTransfer` 互斥。
`deleteObjectsFromSourceAfterTransfer`	`boolean` 是否應在物件轉移至接收端後，從來源刪除這些物件。注意：這個選項和 `deleteObjectsUniqueInSink` 互斥。
`overwriteWhen`	`enum (OverwriteWhen)` 覆寫已存在於接收器中的物件時機。如果未設定，系統會根據 `overwriteObjectsAlreadyExistingInSink` 決定覆寫行為。
`metadataOptions`	`object (MetadataOptions)` 代表轉移工作的所選中繼資料選項。

OverwriteWhen

指定在來源中找到名稱相符的物件時，應在接收器中覆寫物件的時間。

列舉
`OVERWRITE_WHEN_UNSPECIFIED`	未指定覆寫行為。
`DIFFERENT`	只有在物件名稱相同但 HTTP ETag 或總和檢查碼值不同時，才會使用來源物件覆寫目的地物件。
`NEVER`	如果來源物件與目的地物件名稱相同，一律不會覆寫目的地物件。在這種情況下，系統不會轉移來源物件。
`ALWAYS`	一律以來源物件覆寫目的地物件，即使 HTTP ETag 或總和檢查碼值相同亦然。

MetadataOptions

指定執行移轉作業的中繼資料選項。

JSON 表示法

JSON 表示法
{ "symlink": enum (`Symlink`), "mode": enum (`Mode`), "gid": enum (`GID`), "uid": enum (`UID`), "acl": enum (`Acl`), "storageClass": enum (`StorageClass`), "temporaryHold": enum (`TemporaryHold`), "kmsKey": enum (`KmsKey`), "timeCreated": enum (`TimeCreated`) }

{
  "symlink": enum (Symlink),
  "mode": enum (Mode),
  "gid": enum (GID),
  "uid": enum (UID),
  "acl": enum (Acl),
  "storageClass": enum (StorageClass),
  "temporaryHold": enum (TemporaryHold),
  "kmsKey": enum (KmsKey),
  "timeCreated": enum (TimeCreated)
}

欄位
`symlink`	`enum (Symlink)` 指定轉移作業應如何處理符號連結。根據預設，系統不會保留符號連結。僅適用於涉及 POSIX 檔案系統的轉移作業，其他轉移作業會忽略此選項。
`mode`	`enum (Mode)` 指定轉移作業應如何處理每個檔案的模式屬性。根據預設，系統不會保留模式。僅適用於涉及 POSIX 檔案系統的轉移作業，其他轉移作業會忽略此選項。
`gid`	`enum (GID)` 指定系統應如何處理每個檔案的 POSIX 群組 ID (GID) 屬性。根據預設，系統不會保留 GID。僅適用於涉及 POSIX 檔案系統的轉移作業，其他轉移作業會忽略此選項。
`uid`	`enum (UID)` 指定轉移作業應如何處理每個檔案的 POSIX 使用者 ID (UID) 屬性。根據預設，系統不會保留 UID。僅適用於涉及 POSIX 檔案系統的轉移作業，其他轉移作業會忽略此選項。
`acl`	`enum (Acl)` 指定在 Google Cloud Storage 值區之間轉移時，應如何保留每個物件的 ACL。如果未指定，預設行為與 ACL_DESTINATION_BUCKET_DEFAULT 相同。
`storageClass`	`enum (StorageClass)` 指定要為傳輸至 Google Cloud Storage 值區的物件設定的儲存空間級別。如果未指定，則預設行為與 `STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT` 相同。
`temporaryHold`	`enum (TemporaryHold)` 指定在 Google Cloud Storage 值區之間移轉時，應如何保留每個物件的暫時保留狀態。如果未指定，則預設行為與 `TEMPORARY_HOLD_PRESERVE` 相同。
`kmsKey`	`enum (KmsKey)` 指定如何保留每個物件的 Cloud KMS 客戶管理加密金鑰 (CMEK)，以便在 Google Cloud Storage 值區之間進行移轉。如果未指定，則預設行為與 `KMS_KEY_DESTINATION_BUCKET_DEFAULT` 相同。
`timeCreated`	`enum (TimeCreated)` 指定如何保留每個物件的 `timeCreated` 中繼資料，以便進行轉移。如果未指定，則預設行為與 `TIME_CREATED_SKIP` 相同。這項行為適用於從 Cloud Storage、Amazon S3、S3 相容儲存空間和 Azure 來源，將資料移轉至 Cloud Storage 值區的情況。

符號連結

在轉移工作期間，是否應略過或保留符號連結。

列舉
`SYMLINK_UNSPECIFIED`	未指定符號連結行為。
`SYMLINK_SKIP`	在轉移作業期間，請勿保留符號連結。
`SYMLINK_PRESERVE`	在轉移作業期間保留符號連結。

模式

處理檔案模式屬性的選項。

列舉
`MODE_UNSPECIFIED`	未指定模式行為。
`MODE_SKIP`	在轉移作業期間，請勿保留模式。
`MODE_PRESERVE`	在轉移工作期間保留模式。

GID

處理檔案 GID 屬性的選項。

列舉
`GID_UNSPECIFIED`	未指定 GID 行為。
`GID_SKIP`	在轉移作業期間，請勿保留 GID。
`GID_NUMBER`	在轉移工作期間保留 GID。

UID

處理檔案 UID 屬性的選項。

列舉
`UID_UNSPECIFIED`	未指定 UID 行為。
`UID_SKIP`	在轉移作業期間，請勿保留 UID。
`UID_NUMBER`	在轉移工作期間保留 UID。

Acl

處理 Cloud Storage 物件 ACL 的選項。

列舉
`ACL_UNSPECIFIED`	未指定 ACL 行為。
`ACL_DESTINATION_BUCKET_DEFAULT`	使用目標值區的預設物件 ACL (如適用)。
`ACL_PRESERVE`	保留物件的原始 ACL。這需要服務帳戶具備來源物件的 `storage.objects.getIamPolicy` 權限。來源或目的地值區不得啟用統一值區層級存取權。

StorageClass

處理 Google Cloud Storage 物件儲存空間類別的選項。

列舉
`STORAGE_CLASS_UNSPECIFIED`	未指定儲存空間級別行為。
`STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`	使用目標值區的預設儲存空間級別。
`STORAGE_CLASS_PRESERVE`	保留物件的原始儲存空間級別。這項功能僅支援從 Google Cloud Storage 值區進行的轉移作業。REGIONAL 和 MULTI_REGIONAL 儲存空間級別會對應至 STANDARD，確保可寫入目的地值區。
`STORAGE_CLASS_STANDARD`	將儲存空間級別設為 STANDARD。
`STORAGE_CLASS_NEARLINE`	將儲存空間級別設為 NEARLINE。
`STORAGE_CLASS_COLDLINE`	將儲存空間級別設為 COLDLINE。
`STORAGE_CLASS_ARCHIVE`	將儲存空間級別設為 ARCHIVE。

TemporaryHold

處理 Google Cloud Storage 物件暫時保留狀態的選項。

列舉
`TEMPORARY_HOLD_UNSPECIFIED`	未指定暫時保留的行為。
`TEMPORARY_HOLD_SKIP`	不要對目標物件設定暫時性保留。
`TEMPORARY_HOLD_PRESERVE`	保留物件的原始暫時性訴訟保留狀態。

KmsKey

處理 Google Cloud Storage 物件 KmsKey 設定的選項。

列舉
`KMS_KEY_UNSPECIFIED`	未指定 KmsKey 行為。
`KMS_KEY_DESTINATION_BUCKET_DEFAULT`	使用目標值區的預設加密設定。
`KMS_KEY_PRESERVE`	保留物件的原始 Cloud KMS 客戶管理加密金鑰 (CMEK) (如有)。不使用 Cloud KMS 加密金鑰的物件，會使用目的地儲存格中的加密設定進行加密。

TimeCreated

處理 Google Cloud Storage 物件 timeCreated 中繼資料的選項。

列舉
`TIME_CREATED_UNSPECIFIED`	未指定 TimeCreated 行為。
`TIME_CREATED_SKIP`	不要保留來源物件的 `timeCreated` 中繼資料。
`TIME_CREATED_PRESERVE_AS_CUSTOM_TIME`	在目標物件的 `customTime` 欄位中，保留來源物件的 `timeCreated` 或 `lastModified` 中繼資料。請注意，儲存在來源物件 `customTime` 欄位中的任何值都不會傳播至目的地物件。

TransferOptions 透過集合功能整理內容 你可以依據偏好儲存及分類內容。