TransferOptions

TransferOptions menentukan tindakan yang akan dilakukan pada objek dalam transfer.

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

boolean

Kapan harus menimpa objek yang sudah ada di sink. Secara default, hanya objek yang berbeda dari sumber yang akan ditimpa. Jika benar, semua objek di sink yang namanya cocok dengan objek di sumber akan ditimpa dengan objek sumber.
deleteObjectsUniqueInSink

boolean

Apakah objek yang hanya ada di sink harus dihapus.

Catatan: Opsi ini dan deleteObjectsFromSourceAfterTransfer saling eksklusif.
deleteObjectsFromSourceAfterTransfer

boolean

Apakah objek harus dihapus dari sumber setelah ditransfer ke sink.

Catatan: Opsi ini dan deleteObjectsUniqueInSink saling eksklusif.
overwriteWhen

enum (OverwriteWhen)

Kapan harus menimpa objek yang sudah ada di sink. Jika tidak ditetapkan, perilaku overwrite ditentukan oleh overwriteObjectsAlreadyExistingInSink.
metadataOptions

object (MetadataOptions)

Merepresentasikan opsi metadata yang dipilih untuk tugas transfer.

OverwriteWhen

Menentukan kapan harus menimpa objek di sink saat objek dengan nama yang cocok ditemukan di sumber.

Enum
OVERWRITE_WHEN_UNSPECIFIED Perilaku penggantian tidak ditentukan.
DIFFERENT Menimpa objek tujuan dengan objek sumber, hanya jika objek memiliki nama yang sama, tetapi nilai checksum atau ETag HTTP-nya berbeda.
NEVER Tidak pernah menimpa objek tujuan jika objek sumber memiliki nama yang sama. Dalam hal ini, objek sumber tidak ditransfer.
ALWAYS Selalu timpa objek tujuan dengan objek sumber, meskipun nilai checksum atau Etag HTTP sama.

MetadataOptions

Menentukan opsi metadata untuk menjalankan transfer.

Representasi 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)
}
Kolom
mode

enum (Mode)

Menentukan cara setiap atribut mode file harus ditangani oleh transfer. Secara default, mode tidak dipertahankan. Hanya berlaku untuk transfer yang melibatkan sistem file POSIX, dan diabaikan untuk transfer lainnya.
gid

enum (GID)

Menentukan cara setiap atribut ID grup POSIX (GID) file harus ditangani oleh transfer. Secara default, GID tidak dipertahankan. Hanya berlaku untuk transfer yang melibatkan sistem file POSIX, dan diabaikan untuk transfer lainnya.
uid

enum (UID)

Menentukan cara setiap atribut ID pengguna (UID) POSIX file harus ditangani oleh transfer. Secara default, UID tidak dipertahankan. Hanya berlaku untuk transfer yang melibatkan sistem file POSIX, dan diabaikan untuk transfer lainnya.
acl

enum (Acl)

Menentukan cara setiap ACL objek harus dipertahankan untuk transfer antar-bucket Google Cloud Storage. Jika tidak ditentukan, perilaku defaultnya sama dengan ACL_DESTINATION_BUCKET_DEFAULT.
storageClass

enum (StorageClass)

Menentukan class penyimpanan yang akan ditetapkan pada objek yang ditransfer ke bucket Google Cloud Storage. Jika tidak ditentukan, perilaku default-nya sama dengan STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT.
temporaryHold

enum (TemporaryHold)

Menentukan cara status penangguhan sementara setiap objek harus dipertahankan untuk transfer antar-bucket Google Cloud Storage. Jika tidak ditentukan, perilaku default-nya sama dengan TEMPORARY_HOLD_PRESERVE.
kmsKey

enum (KmsKey)

Menentukan cara kunci enkripsi yang dikelola pelanggan (CMEK) Cloud KMS setiap objek dipertahankan untuk transfer antar-bucket Google Cloud Storage. Jika tidak ditentukan, perilaku default-nya sama dengan KMS_KEY_DESTINATION_BUCKET_DEFAULT.
timeCreated

enum (TimeCreated)

Menentukan cara metadata timeCreated setiap objek dipertahankan untuk transfer. Jika tidak ditentukan, perilaku default-nya sama dengan TIME_CREATED_SKIP. Perilaku ini didukung untuk transfer ke bucket Cloud Storage dari sumber Cloud Storage, Amazon S3, penyimpanan yang kompatibel dengan S3, dan Azure.

Mode

Opsi untuk menangani atribut mode file.

Enum
MODE_UNSPECIFIED Perilaku mode tidak ditentukan.
MODE_SKIP Jangan pertahankan mode selama tugas transfer.
MODE_PRESERVE Mempertahankan mode selama tugas transfer.

GID

Opsi untuk menangani atribut GID file.

Enum
GID_UNSPECIFIED Perilaku GID tidak ditentukan.
GID_SKIP Jangan pertahankan GID selama tugas transfer.
GID_NUMBER Mempertahankan GID selama tugas transfer.

UID

Opsi untuk menangani atribut UID file.

Enum
UID_UNSPECIFIED Perilaku UID tidak ditentukan.
UID_SKIP Jangan pertahankan UID selama tugas transfer.
UID_NUMBER Mempertahankan UID selama tugas transfer.

Acl

Opsi untuk menangani ACL objek Cloud Storage.

Enum
ACL_UNSPECIFIED Perilaku ACL tidak ditentukan.
ACL_DESTINATION_BUCKET_DEFAULT Gunakan ACL objek default bucket tujuan, jika berlaku.
ACL_PRESERVE Mempertahankan ACL asli objek. Hal ini mengharuskan akun layanan memiliki izin storage.objects.getIamPolicy untuk objek sumber. Akses level bucket yang seragam tidak boleh diaktifkan di bucket sumber atau tujuan.

StorageClass

Opsi untuk menangani class penyimpanan objek Google Cloud Storage.

Enum
STORAGE_CLASS_UNSPECIFIED Perilaku class penyimpanan tidak ditentukan.
STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT Gunakan kelas penyimpanan default bucket tujuan.
STORAGE_CLASS_PRESERVE Mempertahankan kelas penyimpanan asli objek. Hal ini hanya didukung untuk transfer dari bucket Google Cloud Storage. Class penyimpanan REGIONAL dan MULTI_REGIONAL akan dipetakan ke STANDARD untuk memastikan class tersebut dapat ditulis ke bucket tujuan.
STORAGE_CLASS_STANDARD Tetapkan kelas penyimpanan ke STANDARD.
STORAGE_CLASS_NEARLINE Tetapkan class penyimpanan ke NEARLINE.
STORAGE_CLASS_COLDLINE Tetapkan class penyimpanan ke COLDLINE.
STORAGE_CLASS_ARCHIVE Tetapkan class penyimpanan ke ARCHIVE.

TemporaryHold

Opsi untuk menangani penangguhan sementara untuk objek Google Cloud Storage.

Enum
TEMPORARY_HOLD_UNSPECIFIED Perilaku penangguhan sementara tidak ditentukan.
TEMPORARY_HOLD_SKIP Jangan tetapkan penangguhan sementara pada objek tujuan.
TEMPORARY_HOLD_PRESERVE Mempertahankan status penangguhan sementara asli objek.

KmsKey

Opsi untuk menangani setelan KmsKey untuk objek Google Cloud Storage.

Enum
KMS_KEY_UNSPECIFIED Perilaku KmsKey tidak ditentukan.
KMS_KEY_DESTINATION_BUCKET_DEFAULT Gunakan setelan enkripsi default bucket tujuan.
KMS_KEY_PRESERVE Mempertahankan kunci enkripsi yang dikelola pelanggan (CMEK) Cloud KMS asli objek jika ada. Objek yang tidak menggunakan kunci enkripsi Cloud KMS akan dienkripsi menggunakan setelan enkripsi bucket tujuan.

TimeCreated

Opsi untuk menangani metadata timeCreated untuk objek Google Cloud Storage.

Enum
TIME_CREATED_UNSPECIFIED Perilaku TimeCreated tidak ditentukan.
TIME_CREATED_SKIP Jangan pertahankan metadata timeCreated dari objek sumber.
TIME_CREATED_PRESERVE_AS_CUSTOM_TIME Mempertahankan metadata timeCreated atau lastModified objek sumber di kolom customTime dalam objek tujuan. Perhatikan bahwa nilai apa pun yang disimpan di kolom customTime objek sumber tidak akan disebarkan ke objek tujuan.