TransferOptions

TransferOptions definisce le azioni da eseguire sugli oggetti in un trasferimento.

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

boolean

Quando sovrascrivere gli oggetti già esistenti nello sink. Per impostazione predefinita, vengono sovrascritti solo gli oggetti diversi dall'origine. Se il valore è true, tutti gli oggetti nel sink il cui nome corrisponde a un oggetto nell'origine vengono sovrascritti con l'oggetto di origine.

deleteObjectsUniqueInSink

boolean

Indica se gli oggetti esistenti solo nel canale di destinazione devono essere eliminati.

Nota: questa opzione e deleteObjectsFromSourceAfterTransfer sono mutuamente esclusive.

deleteObjectsFromSourceAfterTransfer

boolean

Indica se gli oggetti devono essere eliminati dall'origine dopo il trasferimento all'area di destinazione.

Nota: questa opzione e deleteObjectsUniqueInSink sono mutuamente esclusive.

overwriteWhen

enum (OverwriteWhen)

Quando sovrascrivere gli oggetti già esistenti nello sink. Se non viene impostato, il comportamento di sovrascrittura è determinato da overwriteObjectsAlreadyExistingInSink.

metadataOptions

object (MetadataOptions)

Rappresenta le opzioni di metadati selezionate per un job di trasferimento.

OverwriteWhen

Specifica quando sovrascrivere un oggetto nel sink quando nell'origine viene trovato un oggetto con nome corrispondente.

Enum
OVERWRITE_WHEN_UNSPECIFIED Il comportamento di sovrascrittura non è specificato.
DIFFERENT Sovrascrivi gli oggetti di destinazione con gli oggetti di origine, solo se hanno lo stesso nome, ma valori di checksum o ETag HTTP diversi.
NEVER Non sovrascrive mai un oggetto di destinazione se un oggetto di origine ha lo stesso nome. In questo caso, l'oggetto di origine non viene trasferito.
ALWAYS Sovrascrivi sempre l'oggetto di destinazione con l'oggetto di origine, anche se i valori degli ETag o dei checksum HTTP sono gli stessi.

MetadataOptions

Specifica le opzioni dei metadati per l'esecuzione di un trasferimento.

Rappresentazione 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)
}
Campi
mode

enum (Mode)

Specifica la modalità di gestione dell'attributo mode di ciascun file da parte del trasferimento. Per impostazione predefinita, la modalità non viene conservata. Si applica solo ai trasferimenti che coinvolgono file system POSIX e viene ignorato per gli altri trasferimenti.

gid

enum (GID)

Specifica in che modo l'attributo GID (ID gruppo) POSIX di ogni file deve essere gestito dal trasferimento. Per impostazione predefinita, il GID non viene conservato. Si applica solo ai trasferimenti che coinvolgono file system POSIX e viene ignorato per gli altri trasferimenti.

uid

enum (UID)

Specifica in che modo l'attributo ID utente POSIX (UID) di ogni file deve essere gestito dal trasferimento. Per impostazione predefinita, l'UID non viene conservato. Si applica solo ai trasferimenti che coinvolgono file system POSIX e viene ignorato per gli altri trasferimenti.

acl

enum (Acl)

Specifica in che modo devono essere preservati gli ACL di ogni oggetto per i trasferimenti tra i bucket Google Cloud Storage. Se non specificato, il comportamento predefinito è lo stesso di ACL_DESTINATION_BUCKET_DEFAULT.

storageClass

enum (StorageClass)

Specifica la classe di archiviazione da impostare sugli oggetti trasferiti ai bucket Google Cloud Storage. Se non specificato, il comportamento predefinito è lo stesso di STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT.

temporaryHold

enum (TemporaryHold)

Specifica in che modo lo stato di blocco temporaneo di ciascun oggetto deve essere mantenuto per i trasferimenti tra bucket Google Cloud Storage. Se non specificato, il comportamento predefinito è lo stesso di TEMPORARY_HOLD_PRESERVE.

kmsKey

enum (KmsKey)

Specifica in che modo la chiave di crittografia gestita dal cliente (CMEK) di Cloud KMS di ogni oggetto viene conservata per i trasferimenti tra i bucket Google Cloud Storage. Se non specificato, il comportamento predefinito è lo stesso di KMS_KEY_DESTINATION_BUCKET_DEFAULT.

timeCreated

enum (TimeCreated)

Specifica in che modo i metadati timeCreated di ogni oggetto vengono conservati per i trasferimenti. Se non specificato, il comportamento predefinito è lo stesso di TIME_CREATED_SKIP. Questo comportamento è supportato per i trasferimenti ai bucket Cloud Storage da Cloud Storage, Amazon S3, archiviazione compatibile con S3 e origini Azure.

Modalità

Opzioni per la gestione dell'attributo della modalità file.

Enum
MODE_UNSPECIFIED Il comportamento della modalità non è specificato.
MODE_SKIP Non utilizzare la modalità di conservazione durante un job di trasferimento.
MODE_PRESERVE Modalità di conservazione durante un job di trasferimento.

GID

Opzioni per la gestione dell'attributo GID del file.

Enum
GID_UNSPECIFIED Il comportamento del gruppo di utenti non è specificato.
GID_SKIP Non conservare il GID durante un job di trasferimento.
GID_NUMBER Mantieni il GID durante un job di trasferimento.

UID

Opzioni per la gestione dell'attributo UID del file.

Enum
UID_UNSPECIFIED Il comportamento dell'UID non è specificato.
UID_SKIP Non conservare l'UID durante un job di trasferimento.
UID_NUMBER Mantieni l'UID durante un job di trasferimento.

Acl

Opzioni per la gestione degli ACL degli oggetti Cloud Storage.

Enum
ACL_UNSPECIFIED Il comportamento delle ACL non è specificato.
ACL_DESTINATION_BUCKET_DEFAULT Utilizza gli ACL degli oggetti predefiniti del bucket di destinazione, se applicabili.
ACL_PRESERVE Conserva gli ACL originali dell'oggetto. È necessario che l'account di servizio disponga dell'autorizzazione storage.objects.getIamPolicy per l'oggetto di origine. L'accesso uniforme a livello di bucket non deve essere abilitato nei bucket di origine o di destinazione.

StorageClass

Opzioni per la gestione della classe di archiviazione di oggetti di Google Cloud Storage.

Enum
STORAGE_CLASS_UNSPECIFIED Il comportamento della classe di archiviazione non è specificato.
STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT Utilizza la classe di archiviazione predefinita del bucket di destinazione.
STORAGE_CLASS_PRESERVE Mantieni la classe di archiviazione originale dell'oggetto. Questa operazione è supportata solo per i trasferimenti dai bucket Google Cloud Storage. Le classi di archiviazione REGIONAL e MULTI_REGIONAL verranno mappate a STANDARD per garantire che possano essere scritte nel bucket di destinazione.
STORAGE_CLASS_STANDARD Imposta la classe di archiviazione su STANDARD.
STORAGE_CLASS_NEARLINE Imposta la classe di archiviazione su NEARLINE.
STORAGE_CLASS_COLDLINE Imposta la classe di archiviazione su COLDLINE.
STORAGE_CLASS_ARCHIVE Imposta la classe di archiviazione su ARCHIVE.

TemporaryHold

Opzioni per la gestione delle sospensioni temporanee per gli oggetti Google Cloud Storage.

Enum
TEMPORARY_HOLD_UNSPECIFIED Il comportamento della preautorizzazione temporanea non è specificato.
TEMPORARY_HOLD_SKIP Non impostare un blocco temporaneo sull'oggetto di destinazione.
TEMPORARY_HOLD_PRESERVE Mantieni lo stato di blocco temporaneo originale dell'oggetto.

KmsKey

Opzioni per la gestione dell'impostazione KmsKey per gli oggetti Google Cloud Storage.

Enum
KMS_KEY_UNSPECIFIED Il comportamento di KmsKey non è specificato.
KMS_KEY_DESTINATION_BUCKET_DEFAULT Utilizza le impostazioni di crittografia predefinite del bucket di destinazione.
KMS_KEY_PRESERVE Mantieni la chiave di crittografia gestita dal cliente (CMEK) Cloud KMS originale dell'oggetto, se presente. Gli oggetti che non utilizzano una chiave di crittografia Cloud KMS verranno criptati utilizzando le impostazioni di crittografia del bucket di destinazione.

TimeCreated

Opzioni per la gestione dei metadati timeCreated per gli oggetti Google Cloud Storage.

Enum
TIME_CREATED_UNSPECIFIED Il comportamento di TimeCreated non è specificato.
TIME_CREATED_SKIP Non conservare i metadati timeCreated dell'oggetto di origine.
TIME_CREATED_PRESERVE_AS_CUSTOM_TIME Conserva i metadati timeCreated o lastModified dell'oggetto di origine nel campo customTime dell'oggetto di destinazione. Tieni presente che qualsiasi valore memorizzato nel campo customTime dell'oggetto di origine non verrà propagato all'oggetto di destinazione.