Se usó la API de Cloud Translation para traducir esta página.

TransferOptions
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

TransferOptions define las acciones que se deben realizar en los objetos de una transferencia.

Representación JSON

Representación 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)
  }
}

Campos
`overwriteObjectsAlreadyExistingInSink`	`boolean` Cuándo reemplazar los objetos que ya existen en el sink La configuración predeterminada es que solo se reemplacen los objetos que sean diferentes de la fuente. Si es verdadero, todos los objetos del destino cuyo nombre coincida con un objeto de la fuente se reemplazarán por el objeto de la fuente.
`deleteObjectsUniqueInSink`	`boolean` Indica si se deben borrar los objetos que solo existen en el sumidero. Nota: Esta opción y `deleteObjectsFromSourceAfterTransfer` son mutuamente excluyentes.
`deleteObjectsFromSourceAfterTransfer`	`boolean` Indica si los objetos se deben borrar de la fuente después de transferirlos al destino. Nota: Esta opción y `deleteObjectsUniqueInSink` son mutuamente excluyentes.
`overwriteWhen`	`enum (OverwriteWhen)` Cuándo reemplazar los objetos que ya existen en el sink Si no se establece, `overwriteObjectsAlreadyExistingInSink` determina el comportamiento de reemplazo.
`metadataOptions`	`object (MetadataOptions)` Representa las opciones de metadatos seleccionadas para un trabajo de transferencia.

OverwriteWhen

Especifica cuándo reemplazar un objeto en el destino cuando se encuentra un objeto con el mismo nombre en la fuente.

Enums
`OVERWRITE_WHEN_UNSPECIFIED`	No se especifica el comportamiento de reemplazo.
`DIFFERENT`	Reemplaza los objetos de destino por los de origen, solo si los objetos tienen el mismo nombre, pero diferentes ETags HTTP o valores de suma de verificación.
`NEVER`	Nunca reemplaza un objeto de destino si un objeto de origen tiene el mismo nombre. En este caso, no se transfiere el objeto de origen.
`ALWAYS`	Siempre reemplaza el objeto de destino con el objeto de origen, incluso si los valores de las ETags o la suma de verificación de HTTP son los mismos.

MetadataOptions

Especifica las opciones de metadatos para ejecutar una transferencia.

Representación JSON

Representación 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)
}

Campos
`symlink`	`enum (Symlink)` Especifica cómo la transferencia debe controlar los symlinks. De forma predeterminada, no se conservan los symlinks. Solo se aplica a las transferencias que involucran sistemas de archivos POSIX y se ignora para otras transferencias.
`mode`	`enum (Mode)` Especifica cómo la transferencia debe controlar el atributo de modo de cada archivo. De forma predeterminada, no se conserva el modo. Solo se aplica a las transferencias que involucran sistemas de archivos POSIX y se ignora para otras transferencias.
`gid`	`enum (GID)` Especifica cómo la transferencia debe controlar el atributo de ID de grupo POSIX (GID) de cada archivo. De forma predeterminada, no se conserva el GID. Solo se aplica a las transferencias que involucran sistemas de archivos POSIX y se ignora para otras transferencias.
`uid`	`enum (UID)` Especifica cómo la transferencia debe controlar el atributo de ID de usuario (UID) POSIX de cada archivo. De forma predeterminada, no se conserva el UID. Solo se aplica a las transferencias que involucran sistemas de archivos POSIX y se ignora para otras transferencias.
`acl`	`enum (Acl)` Especifica cómo se deben conservar las LCA de cada objeto para las transferencias entre buckets de Google Cloud Storage. Si no se especifica, el comportamiento predeterminado es el mismo que ACL_DESTINATION_BUCKET_DEFAULT.
`storageClass`	`enum (StorageClass)` Especifica la clase de almacenamiento que se establecerá en los objetos que se transfieren a los buckets de Google Cloud Storage. Si no se especifica, el comportamiento predeterminado es el mismo que `STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`.
`temporaryHold`	`enum (TemporaryHold)` Especifica cómo se debe conservar el estado de retención temporal de cada objeto para las transferencias entre buckets de Google Cloud Storage. Si no se especifica, el comportamiento predeterminado es el mismo que `TEMPORARY_HOLD_PRESERVE`.
`kmsKey`	`enum (KmsKey)` Especifica cómo se conserva la clave de encriptación administrada por el cliente (CMEK) de Cloud KMS de cada objeto para las transferencias entre buckets de Google Cloud Storage. Si no se especifica, el comportamiento predeterminado es el mismo que `KMS_KEY_DESTINATION_BUCKET_DEFAULT`.
`timeCreated`	`enum (TimeCreated)` Especifica cómo se conservan los metadatos `timeCreated` de cada objeto para las transferencias. Si no se especifica, el comportamiento predeterminado es el mismo que `TIME_CREATED_SKIP`. Este comportamiento es compatible con las transferencias a buckets de Cloud Storage desde Cloud Storage, Amazon S3, almacenamiento compatible con S3 y fuentes de Azure.

Symlink

Indica si se deben omitir o preservar los symlinks durante una tarea de transferencia.

Enums
`SYMLINK_UNSPECIFIED`	El comportamiento del symlink no está especificado.
`SYMLINK_SKIP`	No preserves los symlinks durante una tarea de transferencia.
`SYMLINK_PRESERVE`	Conserva los symlinks durante una tarea de transferencia.

Modo

Son opciones para controlar el atributo de modo de archivo.

Enums
`MODE_UNSPECIFIED`	No se especificó el comportamiento del modo.
`MODE_SKIP`	No preserves el modo durante una tarea de transferencia.
`MODE_PRESERVE`	Modo de preservación durante una tarea de transferencia

GID

Opciones para controlar el atributo GID del archivo

Enums
`GID_UNSPECIFIED`	No se especifica el comportamiento del GID.
`GID_SKIP`	No conserves el GID durante una tarea de transferencia.
`GID_NUMBER`	Conserva el GID durante una tarea de transferencia.

UID

Son opciones para controlar el atributo UID del archivo.

Enums
`UID_UNSPECIFIED`	El comportamiento del UID no está especificado.
`UID_SKIP`	No preserves el UID durante una tarea de transferencia.
`UID_NUMBER`	Conserva el UID durante una tarea de transferencia.

LCA

Opciones para controlar las LCA de los objetos de Cloud Storage

Enums
`ACL_UNSPECIFIED`	No se especifica el comportamiento de la LCA.
`ACL_DESTINATION_BUCKET_DEFAULT`	Usa las LCA de objetos predeterminadas del bucket de destino, si corresponde.
`ACL_PRESERVE`	Conserva las LCA originales del objeto. Esto requiere que la cuenta de servicio tenga permiso `storage.objects.getIamPolicy` para el objeto de origen. No se debe habilitar el acceso uniforme a nivel de bucket en los buckets de origen ni de destino.

StorageClass

Son opciones para controlar la clase de almacenamiento de objetos de Google Cloud Storage.

Enums
`STORAGE_CLASS_UNSPECIFIED`	No se especifica el comportamiento de la clase de almacenamiento.
`STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`	Usa la clase de almacenamiento predeterminada del bucket de destino.
`STORAGE_CLASS_PRESERVE`	Conserva la clase de almacenamiento original del objeto. Esto solo es compatible con las transferencias desde buckets de Google Cloud Storage. Las clases de almacenamiento REGIONAL y MULTI_REGIONAL se asignarán a STANDARD para garantizar que se puedan escribir en el bucket de destino.
`STORAGE_CLASS_STANDARD`	Establece la clase de almacenamiento en STANDARD.
`STORAGE_CLASS_NEARLINE`	Establece la clase de almacenamiento en NEARLINE.
`STORAGE_CLASS_COLDLINE`	Establece la clase de almacenamiento en COLDLINE.
`STORAGE_CLASS_ARCHIVE`	Establece la clase de almacenamiento en ARCHIVE.

TemporaryHold

Opciones para controlar las retenciones temporales de objetos de Google Cloud Storage.

Enums
`TEMPORARY_HOLD_UNSPECIFIED`	No se especificó el comportamiento de la retención temporal.
`TEMPORARY_HOLD_SKIP`	No configures una conservación temporal en el objeto de destino.
`TEMPORARY_HOLD_PRESERVE`	Conserva el estado de conservación temporal original del objeto.

KmsKey

Son opciones para controlar la configuración de KmsKey para los objetos de Google Cloud Storage.

Enums
`KMS_KEY_UNSPECIFIED`	No se especifica el comportamiento de KmsKey.
`KMS_KEY_DESTINATION_BUCKET_DEFAULT`	Usa la configuración de encriptación predeterminada del bucket de destino.
`KMS_KEY_PRESERVE`	Si está presente, conserva la clave de encriptación administrada por el cliente (CMEK) original de Cloud KMS del objeto. Los objetos que no usen una clave de encriptación de Cloud KMS se encriptarán con la configuración de encriptación del bucket de destino.

TimeCreated

Opciones para controlar los metadatos timeCreated de los objetos de Google Cloud Storage.

Enums
`TIME_CREATED_UNSPECIFIED`	No se especificó el comportamiento de TimeCreated.
`TIME_CREATED_SKIP`	No conserves los metadatos `timeCreated` del objeto de origen.
`TIME_CREATED_PRESERVE_AS_CUSTOM_TIME`	Conserva los metadatos `timeCreated` o `lastModified` del objeto de origen en el campo `customTime` del objeto de destino. Ten en cuenta que cualquier valor almacenado en el campo `customTime` del objeto de origen no se propagará al objeto de destino.

TransferOptions Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.