As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configuração de como lidar com arquivos, objetos e metadados
<a name="configure-metadata"></a>

Você pode configurar como AWS DataSync manipula seus arquivos, objetos e seus metadados associados ao transferir entre locais.

Por exemplo, com transferências recorrentes, talvez você queira substituir os arquivos no destino com alterações na origem para manter os locais sincronizados. Você pode copiar propriedades como permissões POSIX para arquivos e pastas, tags associadas a objetos e listas de controle de acesso (ACLs).

## Opções de modos de transferência
<a name="task-option-transfer-mode"></a>

Você pode configurar se DataSync transfere somente os dados (incluindo metadados) que foram alterados após uma cópia inicial ou todos os dados toda vez que você executa a tarefa. Se você estiver planejando transferências recorrentes, convém transferir somente o que mudou desde a execução anterior da tarefa.


| Opção no console | Opção na API | Description | 
| --- | --- | --- | 
|  **Transferir somente dados que foram alterados**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) definido como `CHANGED`  | Após a transferência inicial completa, DataSync copia somente os dados e os metadados que diferem entre o local de origem e o local de destino. | 
|  **Transferir todos os dados**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) definido como `ALL`  |  DataSync copia tudo na origem para o destino sem comparar as diferenças entre os locais.   | 

## Opções de tratamento de arquivos e objetos
<a name="task-option-file-object-handling"></a>

Você pode controlar alguns aspectos de como DataSync trata seus arquivos ou objetos no local de destino. Por exemplo, DataSync pode excluir arquivos no destino que não estão na origem.


| Opção no console | Opção na API | Description | 
| --- | --- | --- | 
|  **Manter arquivos excluídos**  |  [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)  |  Especifica se DataSync mantém arquivos ou objetos no local de destino que não existem na origem. Se você configurar a tarefa para excluir objetos do bucket do Amazon S3, poderá incorrer em taxas de duração mínima de armazenamento para determinadas classes de armazenamento. Para obter informações detalhadas, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes).  Você não pode configurar a tarefa para excluir dados no destino e também [transferir todos os dados](#task-option-transfer-mode). Quando você transfere todos os dados, DataSync não escaneia sua localização de destino e não sabe o que excluir.   | 
|  **Sobrescrever arquivos**  |  [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)  |  Especifica se DataSync modifica os dados no local de destino quando os dados de origem ou os metadados são alterados. Se você não configurar a tarefa para sobrescrever dados, os dados de destino não serão sobrescritos, mesmo que os dados da origem sejam diferentes. Se a tarefa substituir objetos, você poderá estar sujeito a cobranças adicionais para determinadas classes de armazenamento (por exemplo, para recuperação ou exclusão antecipada). Para obter informações detalhadas, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes).  | 

## Opções de tratamento de metadados
<a name="task-option-metadata-handling"></a>

DataSync pode preservar metadados de arquivos e objetos durante uma transferência. Os metadados que DataSync podem ser preservados dependem dos sistemas de armazenamento envolvidos e se esses sistemas usam uma estrutura de metadados semelhante.

Antes de configurar sua tarefa, certifique-se de entender como DataSync manipula [metadados](metadata-copied.md) e [arquivos especiais](special-files-copied.md) ao transferir entre seus locais de origem e destino.

**Importante**  
DataSync suporta transferências de e para determinados sistemas de armazenamento em nuvem de terceiros, como o Google Cloud Storage e o IBM Cloud Object Storage, que manipulam os metadados do sistema de uma forma que não é totalmente compatível com S3. Para essas transferências, DataSync tenta copiar atributos de metadados`ContentType`, como, `ContentEncoding``ContentLanguage`, e com `CacheControl` base no melhor esforço. Se o sistema de armazenamento de destino não aplicar esses atributos, eles serão ignorados durante a verificação da tarefa.


| Opção no console | Opção na API | Description | 
| --- | --- | --- | 
|  **Propriedade da cópia**  | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) e [Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) |  Especifica se DataSync copia a propriedade do arquivo e da pasta POSIX, como o ID do grupo dos proprietários do arquivo e o ID do usuário do proprietário do arquivo.  | 
|  **Copiar permissões**  | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) |  Especifica se DataSync copia as permissões POSIX para arquivos e pastas da origem para o destino.  | 
| Copiar carimbos de data/hora | [Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) e [Mtime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Mtime) |  Especifica se DataSync copia os metadados do timestamp da origem para o destino. Exigido quando você precisa executar a mesma tarefa mais de uma vez.  | 
| Copiar tags de objetos | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) |  Especifica se DataSync preserva as tags associadas aos seus objetos ao transferir entre sistemas de armazenamento de objetos.  | 
| Propriedade da cópia DACLs, e SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) definido como OWNER\$1DACL\$1SACL |  DataSync copia o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/configure-metadata.html)  | 
| Propriedade da cópia e DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) definido como OWNER\$1DACL |  DataSync copia o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/configure-metadata.html) DataSync não copiará SACLs quando você escolher essa opção.  | 
| Não copie a propriedade ou ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) definido como NONE |  DataSync não copia nenhum dado de propriedade ou permissão. Os objetos que DataSync gravam em seu local de destino pertencem ao usuário cujas credenciais são fornecidas DataSync para acessar o destino. As permissões do objeto de destino são determinadas com base nas permissões configuradas no servidor de destino.  | 

## Como configurar opções de tratamento de arquivos, objetos e metadados
<a name="configure-file-metadata-options"></a>

Você pode configurar como DataSync manipula arquivos, objetos e metadados ao criar, editar ou iniciar sua tarefa de transferência.

### Usando o DataSync console
<a name="configure-metadata-console"></a>

As instruções a seguir descrevem como configurar as opções de tratamento de arquivos, objetos e metadados ao criar uma tarefa.

1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**.

1. Configure os locais de origem e destino da sua tarefa.

   Para obter mais informações, consulte [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md).

1. Para **Modo de transferência**, selecione uma das seguintes opções:
   + **Transferir somente dados que foram alterados**
   + **Transferir todos os dados**

   Para saber mais sobre essas opções, consulte [Opções de modos de transferência](#task-option-transfer-mode).

1. Selecione **Manter arquivos excluídos** se DataSync quiser manter arquivos ou objetos no local de destino que não existem na origem.

   Se você não escolher essa opção e sua tarefa excluir objetos de sue bucket Amazon S3, você poderá estar sujeito a cobranças mínimas de duração de armazenamento para determinadas classes de armazenamento. Para obter informações detalhadas, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes).
**Atenção**  
Você não pode desmarcar essa opção e ativar a opção **Transferir todos os dados**. Quando você transfere todos os dados, DataSync não escaneia sua localização de destino e não sabe o que excluir.

1. Selecione **Substituir arquivos** se quiser DataSync modificar os dados no local de destino quando os dados de origem ou os metadados forem alterados.

   Se a tarefa substituir objetos, você poderá estar sujeito a cobranças adicionais para determinadas classes de armazenamento (por exemplo, para recuperação ou exclusão antecipada). Para obter informações detalhadas, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes).

   Se você não escolher essa opção, os dados de destino não serão substituídos, mesmo que os dados de origem sejam diferentes.

1. Em **Opções de transferência**, selecione como você deseja DataSync lidar com os metadados. Para saber mais sobre essas opções, consulte [Opções de tratamento de metadados](#task-option-metadata-handling).
**Importante**  
As opções exibidas no console dependem dos locais de origem e destino da tarefa. Talvez seja necessário expandir **Configurações adicionais** para ver algumas dessas opções.
   + **Propriedade da cópia**
   + **Copiar permissões**
   + **Copiar carimbos de data/hora**
   + **Copiar tags de objetos**
   + **Propriedade da cópia DACLs, e SACLs**
   + **Propriedade da cópia e DACLs**
   + **Não copie a propriedade ou ACLs**

### Usando a DataSync API
<a name="configure-file-metadata-options-api"></a>

Você pode configurar as opções de tratamento de arquivos, objetos e metadados usando o parâmetro `Options` com qualquer uma das seguintes operações:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)