TransferOptions definisce le azioni da eseguire sugli oggetti in un trasferimento.
Rappresentazione JSON |
---|
{ "overwriteObjectsAlreadyExistingInSink": boolean, "deleteObjectsUniqueInSink": boolean, "deleteObjectsFromSourceAfterTransfer": boolean, "overwriteWhen": enum ( |
Campi | |
---|---|
overwriteObjectsAlreadyExistingInSink |
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 |
Indica se gli oggetti esistenti solo nel canale di destinazione devono essere eliminati. Nota: questa opzione e |
deleteObjectsFromSourceAfterTransfer |
Indica se gli oggetti devono essere eliminati dall'origine dopo il trasferimento all'area di destinazione. Nota: questa opzione e |
overwriteWhen |
Quando sovrascrivere gli oggetti già esistenti nello sink. Se non viene impostato, il comportamento di sovrascrittura è determinato da |
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 ( |
Campi | |
---|---|
symlink |
Specifica in che modo i link simbolici devono essere gestiti dal trasferimento. Per impostazione predefinita, i link simbolici non vengono conservati. Si applica solo ai trasferimenti che coinvolgono file system POSIX e viene ignorato per gli altri trasferimenti. |
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 |
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 |
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 |
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 |
Specifica la classe di archiviazione da impostare sugli oggetti trasferiti ai bucket Google Cloud Storage. Se non specificato, il comportamento predefinito è lo stesso di |
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 |
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 |
timeCreated |
Specifica in che modo i metadati |
Symlink
Indica se i link simbolici devono essere ignorati o conservati durante un job di trasferimento.
Enum | |
---|---|
SYMLINK_UNSPECIFIED |
Il comportamento del link simbolico non è specificato. |
SYMLINK_SKIP |
Non conservare i link simbolici durante un job di trasferimento. |
SYMLINK_PRESERVE |
Mantieni i link simbolici durante un job di trasferimento. |
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. |