Cette page a été traduite par l'API Cloud Translation.

TransferOptions
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

TransferOptions définit les actions à effectuer sur les objets lors d'un transfert.

Représentation JSON

Représentation 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)
  }
}

Champs
`overwriteObjectsAlreadyExistingInSink`	`boolean` Quand écraser les objets qui existent déjà dans le sink Par défaut, seuls les objets différents de la source sont écrasés. Si la valeur est "true", tous les objets du collecteur dont le nom correspond à un objet de la source sont remplacés par l'objet source.
`deleteObjectsUniqueInSink`	`boolean` Indique si les objets qui n'existent que dans le sink doivent être supprimés. Remarque:Cette option et `deleteObjectsFromSourceAfterTransfer` s'excluent mutuellement.
`deleteObjectsFromSourceAfterTransfer`	`boolean` Indique si les objets doivent être supprimés de la source après leur transfert vers le collecteur. Remarque:Cette option et `deleteObjectsUniqueInSink` s'excluent mutuellement.
`overwriteWhen`	`enum (OverwriteWhen)` Quand écraser les objets qui existent déjà dans le sink Si ce champ n'est pas défini, le comportement d'écrasement est déterminé par `overwriteObjectsAlreadyExistingInSink`.
`metadataOptions`	`object (MetadataOptions)` Représente les options de métadonnées sélectionnées pour une tâche de transfert.

OverwriteWhen

Indique quand écraser un objet dans le sink lorsqu'un objet portant le même nom est détecté dans la source.

Enums
`OVERWRITE_WHEN_UNSPECIFIED`	Le comportement d'écrasement n'est pas spécifié.
`DIFFERENT`	Écrase les objets de destination par les objets sources, uniquement si les objets portent le même nom, mais ont des ETags HTTP ou des valeurs de somme de contrôle différents.
`NEVER`	N'écrase jamais un objet de destination si un objet source porte le même nom. Dans ce cas, l'objet source n'est pas transféré.
`ALWAYS`	Écrase toujours l'objet de destination par l'objet source, même si les valeurs de somme de contrôle ou les ETags HTTP sont identiques.

MetadataOptions

Spécifie les options de métadonnées pour exécuter un transfert.

Représentation JSON

Représentation 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)
}

Champs
`symlink`	`enum (Symlink)` Indique comment les liens symboliques doivent être gérés par le transfert. Par défaut, les liens symboliques ne sont pas conservés. Applicable uniquement aux transferts impliquant des systèmes de fichiers POSIX, et ignoré pour les autres transferts.
`mode`	`enum (Mode)` Indique comment l'attribut de mode de chaque fichier doit être géré par le transfert. Par défaut, le mode n'est pas conservé. Applicable uniquement aux transferts impliquant des systèmes de fichiers POSIX, et ignoré pour les autres transferts.
`gid`	`enum (GID)` Indique comment l'attribut POSIX group ID (GID) de chaque fichier doit être géré par le transfert. Par défaut, le GID n'est pas conservé. Applicable uniquement aux transferts impliquant des systèmes de fichiers POSIX, et ignoré pour les autres transferts.
`uid`	`enum (UID)` Spécifie comment l'attribut UID (identifiant utilisateur POSIX) de chaque fichier doit être géré par le transfert. Par défaut, l'UID n'est pas conservé. Applicable uniquement aux transferts impliquant des systèmes de fichiers POSIX, et ignoré pour les autres transferts.
`acl`	`enum (Acl)` Indique comment les ACL de chaque objet doivent être conservées pour les transferts entre des buckets Google Cloud Storage. Si aucune valeur n'est spécifiée, le comportement par défaut est le même que celui de ACL_DESTINATION_BUCKET_DEFAULT.
`storageClass`	`enum (StorageClass)` Indique la classe de stockage à définir sur les objets transférés vers des buckets Google Cloud Storage. Si aucune valeur n'est spécifiée, le comportement par défaut est le même que celui de `STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`.
`temporaryHold`	`enum (TemporaryHold)` Indique comment l'état de retenue temporaire de chaque objet doit être conservé pour les transferts entre des buckets Google Cloud Storage. Si aucune valeur n'est spécifiée, le comportement par défaut est le même que celui de `TEMPORARY_HOLD_PRESERVE`.
`kmsKey`	`enum (KmsKey)` Spécifie comment la clé de chiffrement gérée par le client (CMEK) Cloud KMS de chaque objet est conservée pour les transferts entre des buckets Google Cloud Storage. Si aucune valeur n'est spécifiée, le comportement par défaut est le même que celui de `KMS_KEY_DESTINATION_BUCKET_DEFAULT`.
`timeCreated`	`enum (TimeCreated)` Indique comment les métadonnées `timeCreated` de chaque objet sont conservées pour les transferts. Si aucune valeur n'est spécifiée, le comportement par défaut est le même que celui de `TIME_CREATED_SKIP`. Ce comportement est compatible avec les transferts vers des buckets Cloud Storage à partir de Cloud Storage, Amazon S3, d'un stockage compatible avec S3 et de sources Azure.

Symlink

Indique si les liens symboliques doivent être ignorés ou conservés lors d'une tâche de transfert.

Enums
`SYMLINK_UNSPECIFIED`	Le comportement des liens symboliques n'est pas spécifié.
`SYMLINK_SKIP`	Ne conservez pas les liens symboliques lors d'une tâche de transfert.
`SYMLINK_PRESERVE`	Conservez les liens symboliques lors d'une tâche de transfert.

Mode

Options de gestion de l'attribut de mode de fichier.

Enums
`MODE_UNSPECIFIED`	Le comportement du mode n'est pas spécifié.
`MODE_SKIP`	Ne pas conserver le mode lors d'une tâche de transfert.
`MODE_PRESERVE`	Mode de conservation pendant une tâche de transfert.

GID

Options de gestion de l'attribut GID de fichier.

Enums
`GID_UNSPECIFIED`	Le comportement du GID n'est pas spécifié.
`GID_SKIP`	Ne conservez pas le GID lors d'une tâche de transfert.
`GID_NUMBER`	Conservez le GID pendant une tâche de transfert.

UID

Options de gestion de l'attribut UID de fichier.

Enums
`UID_UNSPECIFIED`	Le comportement du UID n'est pas spécifié.
`UID_SKIP`	Ne conservez pas l'UID lors d'une tâche de transfert.
`UID_NUMBER`	Conservez l'UID lors d'une tâche de transfert.

Acl

Options de gestion des LCA d'objets Cloud Storage.

Enums
`ACL_UNSPECIFIED`	Le comportement des LCA n'est pas spécifié.
`ACL_DESTINATION_BUCKET_DEFAULT`	Utilisez les LCA d'objet par défaut du bucket de destination, le cas échéant.
`ACL_PRESERVE`	Conservez les LCA d'origine de l'objet. Pour cela, le compte de service doit disposer de l'autorisation `storage.objects.getIamPolicy` pour l'objet source. L'accès uniforme au niveau du bucket ne doit pas être activé sur les buckets source ni de destination.

StorageClass

Options de gestion de la classe de stockage d'objets Google Cloud Storage.

Enums
`STORAGE_CLASS_UNSPECIFIED`	Le comportement de la classe de stockage n'est pas spécifié.
`STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`	Utilisez la classe de stockage par défaut du bucket de destination.
`STORAGE_CLASS_PRESERVE`	Conservez la classe de stockage d'origine de l'objet. Cette option n'est disponible que pour les transferts depuis des buckets Google Cloud Storage. Les classes de stockage REGIONAL et MULTI_REGIONAL seront mappées sur STANDARD pour s'assurer qu'elles peuvent être écrites dans le bucket de destination.
`STORAGE_CLASS_STANDARD`	Définissez la classe de stockage sur STANDARD.
`STORAGE_CLASS_NEARLINE`	Définissez la classe de stockage sur NEARLINE.
`STORAGE_CLASS_COLDLINE`	Définissez la classe de stockage sur COLDLINE.
`STORAGE_CLASS_ARCHIVE`	Définissez la classe de stockage sur ARCHIVE.

TemporaryHold

Options permettant de gérer les retenues temporaires pour les objets Google Cloud Storage.

Enums
`TEMPORARY_HOLD_UNSPECIFIED`	Le comportement de la préservation temporaire n'est pas spécifié.
`TEMPORARY_HOLD_SKIP`	Ne définissez pas de préservation temporaire sur l'objet de destination.
`TEMPORARY_HOLD_PRESERVE`	Conservez l'état de préservation temporaire d'origine de l'objet.

KmsKey

Options permettant de gérer le paramètre KmsKey pour les objets Google Cloud Storage.

Enums
`KMS_KEY_UNSPECIFIED`	Le comportement de KmsKey n'est pas spécifié.
`KMS_KEY_DESTINATION_BUCKET_DEFAULT`	Utilisez les paramètres de chiffrement par défaut du bucket de destination.
`KMS_KEY_PRESERVE`	Conservez la clé de chiffrement gérée par le client (CMEK) Cloud KMS d'origine de l'objet, le cas échéant. Les objets qui n'utilisent pas de clé de chiffrement Cloud KMS seront chiffrés à l'aide des paramètres de chiffrement du bucket de destination.

TimeCreated

Options de gestion des métadonnées timeCreated pour les objets Google Cloud Storage.

Enums
`TIME_CREATED_UNSPECIFIED`	Le comportement de TimeCreated n'est pas spécifié.
`TIME_CREATED_SKIP`	Ne pas conserver les métadonnées `timeCreated` de l'objet source.
`TIME_CREATED_PRESERVE_AS_CUSTOM_TIME`	Conserve les métadonnées `timeCreated` ou `lastModified` de l'objet source dans le champ `customTime` de l'objet de destination. Notez que toute valeur stockée dans le champ `customTime` de l'objet source ne sera pas propagée vers l'objet de destination.

TransferOptions Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.