Esta página foi traduzida pela API Cloud Translation.

TransferOptions
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

As TransferOptions definem as ações a serem realizadas em objetos em uma transferência.

Representação JSON

Representação 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` Quando substituir objetos que já existem no sink. Por padrão, apenas os objetos diferentes da origem são substituídos. Se verdadeiro, todos os objetos no sink cujo nome corresponde a um objeto na origem são substituídos pelo objeto de origem.
`deleteObjectsUniqueInSink`	`boolean` Se os objetos que existem apenas no sink precisam ser excluídos. Observação:essa opção e `deleteObjectsFromSourceAfterTransfer` são mutuamente exclusivas.
`deleteObjectsFromSourceAfterTransfer`	`boolean` Se os objetos precisam ser excluídos da origem depois de transferidos para o sink. Observação:essa opção e `deleteObjectsUniqueInSink` são mutuamente exclusivas.
`overwriteWhen`	`enum (OverwriteWhen)` Quando substituir objetos que já existem no sink. Se não for definido, o comportamento de substituição será determinado por `overwriteObjectsAlreadyExistingInSink`.
`metadataOptions`	`object (MetadataOptions)` Representa as opções de metadados selecionadas para um job de transferência.

OverwriteWhen

Especifica quando substituir um objeto no sink quando um objeto com nome correspondente for encontrado na origem.

Enums
`OVERWRITE_WHEN_UNSPECIFIED`	O comportamento de substituição não foi especificado.
`DIFFERENT`	Substitui os objetos de destino pelos de origem, somente se eles tiverem o mesmo nome, mas valores de ETags ou de soma de verificação diferentes.
`NEVER`	Nunca substitui um objeto de destino se um objeto de origem tiver o mesmo nome. Nesse caso, o objeto de origem não é transferido.
`ALWAYS`	Sempre substitua o objeto de destino pelo de origem, mesmo que os valores de ETags ou de soma de verificação do HTTP sejam iguais.

MetadataOptions

Especifica as opções de metadados para executar uma transferência.

Representação JSON

Representação 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 como os links simbólicos devem ser processados pela transferência. Por padrão, os links simbólicos não são preservados. Aplicável apenas a transferências que envolvem sistemas de arquivos POSIX e ignorado para outras transferências.
`mode`	`enum (Mode)` Especifica como o atributo de modo de cada arquivo deve ser processado pela transferência. Por padrão, o modo não é preservado. Aplicável apenas a transferências que envolvem sistemas de arquivos POSIX e ignorado para outras transferências.
`gid`	`enum (GID)` Especifica como o atributo ID de grupo POSIX (GID) de cada arquivo precisa ser processado pela transferência. Por padrão, o GID não é preservado. Aplicável apenas a transferências que envolvem sistemas de arquivos POSIX e ignorado para outras transferências.
`uid`	`enum (UID)` Especifica como o atributo de ID de usuário (UID) POSIX de cada arquivo precisa ser processado pela transferência. Por padrão, o UID não é preservado. Aplicável apenas a transferências que envolvem sistemas de arquivos POSIX e ignorado para outras transferências.
`acl`	`enum (Acl)` Especifica como as ACLs de cada objeto devem ser preservadas para transferências entre buckets do Google Cloud Storage. Se não for especificado, o comportamento padrão será o mesmo de ACL_DESTINATION_BUCKET_DEFAULT.
`storageClass`	`enum (StorageClass)` Especifica a classe de armazenamento a ser definida nos objetos transferidos para buckets do Google Cloud Storage. Se não for especificado, o comportamento padrão será o mesmo que `STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`.
`temporaryHold`	`enum (TemporaryHold)` Especifica como o status de retenção temporária de cada objeto deve ser preservado para transferências entre buckets do Google Cloud Storage. Se não for especificado, o comportamento padrão será o mesmo que `TEMPORARY_HOLD_PRESERVE`.
`kmsKey`	`enum (KmsKey)` Especifica como a chave de criptografia gerenciada pelo cliente (CMEK) do Cloud KMS de cada objeto é preservada para transferências entre buckets do Google Cloud Storage. Se não for especificado, o comportamento padrão será o mesmo que `KMS_KEY_DESTINATION_BUCKET_DEFAULT`.
`timeCreated`	`enum (TimeCreated)` Especifica como os metadados `timeCreated` de cada objeto são preservados para transferências. Se não for especificado, o comportamento padrão será o mesmo que `TIME_CREATED_SKIP`. Esse comportamento é compatível com transferências para buckets do Cloud Storage do Cloud Storage, Amazon S3, armazenamento compatível com S3 e origens do Azure.

Symlink

Se os links simbólicos precisam ser ignorados ou preservados durante um job de transferência.

Enums
`SYMLINK_UNSPECIFIED`	O comportamento do link simbólico não foi especificado.
`SYMLINK_SKIP`	Não preserve links simbólicos durante um job de transferência.
`SYMLINK_PRESERVE`	Preserve links simbólicos durante um job de transferência.

Modo

Opções para processar o atributo de modo de arquivo.

Enums
`MODE_UNSPECIFIED`	O comportamento do modo não foi especificado.
`MODE_SKIP`	Não preservar o modo durante um job de transferência.
`MODE_PRESERVE`	Preservar o modo durante um job de transferência.

GID

Opções para processar o atributo GID do arquivo.

Enums
`GID_UNSPECIFIED`	O comportamento do GID não foi especificado.
`GID_SKIP`	Não preserve o GID durante um job de transferência.
`GID_NUMBER`	Preserve o GID durante um job de transferência.

UID

Opções para processar o atributo UID do arquivo.

Enums
`UID_UNSPECIFIED`	O comportamento do UID não é especificado.
`UID_SKIP`	Não preserve o UID durante um job de transferência.
`UID_NUMBER`	Preserve o UID durante um job de transferência.

Acl

Opções para processar ACLs de objetos do Cloud Storage.

Enums
`ACL_UNSPECIFIED`	O comportamento da ACL não foi especificado.
`ACL_DESTINATION_BUCKET_DEFAULT`	Use as ACLs de objeto padrão do bucket de destino, se aplicável.
`ACL_PRESERVE`	Preservar as ACLs originais do objeto. Para isso, a conta de serviço precisa ter a permissão `storage.objects.getIamPolicy` para o objeto de origem. O acesso uniforme no nível do bucket não pode estar ativado nos buckets de origem ou de destino.

StorageClass

Opções para processar a classe de armazenamento de objetos do Google Cloud Storage.

Enums
`STORAGE_CLASS_UNSPECIFIED`	O comportamento da classe de armazenamento não foi especificado.
`STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`	Use a classe de armazenamento padrão do bucket de destino.
`STORAGE_CLASS_PRESERVE`	Preservar a classe de armazenamento original do objeto. Isso só é possível para transferências de buckets do Google Cloud Storage. As classes de armazenamento REGIONAL e MULTI_REGIONAL serão mapeadas para STANDARD para garantir que possam ser gravadas no bucket de destino.
`STORAGE_CLASS_STANDARD`	Defina a classe de armazenamento como "STANDARD".
`STORAGE_CLASS_NEARLINE`	Defina a classe de armazenamento como NEARLINE.
`STORAGE_CLASS_COLDLINE`	Defina a classe de armazenamento como COLDLINE.
`STORAGE_CLASS_ARCHIVE`	Defina a classe de armazenamento como ARCHIVE.

Retenção temporária

Opções para processar retenções temporárias de objetos do Google Cloud Storage.

Enums
`TEMPORARY_HOLD_UNSPECIFIED`	O comportamento de retenção temporária não foi especificado.
`TEMPORARY_HOLD_SKIP`	Não defina uma retenção temporária no objeto de destino.
`TEMPORARY_HOLD_PRESERVE`	Preservar o status de retenção temporária original do objeto.

KmsKey

Opções para processar a configuração KmsKey para objetos do Google Cloud Storage.

Enums
`KMS_KEY_UNSPECIFIED`	O comportamento da KmsKey não foi especificado.
`KMS_KEY_DESTINATION_BUCKET_DEFAULT`	Use as configurações de criptografia padrão do bucket de destino.
`KMS_KEY_PRESERVE`	Preserve a chave de criptografia gerenciada pelo cliente (CMEK) do Cloud KMS original do objeto, se houver. Os objetos que não usam uma chave de criptografia do Cloud KMS serão criptografados usando as configurações de criptografia do bucket de destino.

TimeCreated

Opções para processar metadados timeCreated de objetos do Google Cloud Storage.

Enums
`TIME_CREATED_UNSPECIFIED`	O comportamento de TimeCreated não foi especificado.
`TIME_CREATED_SKIP`	Não preservar os metadados `timeCreated` do objeto de origem.
`TIME_CREATED_PRESERVE_AS_CUSTOM_TIME`	Preserva os metadados `timeCreated` ou `lastModified` do objeto de origem no campo `customTime` do objeto de destino. Qualquer valor armazenado no campo `customTime` do objeto de origem não será propagado para o objeto de destino.

TransferOptions Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.