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á.
# Como criar uma tarefa para transferir os dados
Uma *tarefa* descreve onde e como os dados são AWS DataSync transferidos. Uma tarefa consiste no seguinte:
+ [**Local de origem**](working-with-locations.md) — O sistema ou serviço de armazenamento de onde os dados são DataSync transferidos.
+ [**Local de destino**](working-with-locations.md) — O sistema ou serviço de armazenamento para o qual os dados são DataSync transferidos.
+ [**Opções de tarefa**](task-options.md): configurações como quais arquivos transferir, como os dados são verificados, quando a tarefa é executada etc.
+ [**Execuções de tarefas**](run-task.md): quando você executa uma tarefa, ela é chamada de *execução de tarefa*.
## Criação da tarefa do
Ao criar uma DataSync tarefa, você especifica seus locais de origem e destino. Você também pode personalizar a tarefa escolhendo quais arquivos transferir, como os metadados são tratados, configurando um agendamento etc.
Antes de criar sua tarefa, certifique-se de entender [como as DataSync transferências funcionam](how-datasync-transfer-works.md#transferring-files) e revise as [cotas da tarefa](datasync-limits.md#task-hard-limits).
**Importante**
Se você planeja transferir dados de ou para um local do Amazon S3, analise [como isso DataSync pode afetar as cobranças de suas solicitações do S3](create-s3-location.md#create-s3-location-s3-requests) e a [página de DataSync preços](https://aws.amazon.com/datasync/pricing/) antes de começar.
### Usando o DataSync console
1. Abra o AWS DataSync console em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Verifique se você está em um dos Regiões da AWS locais onde planeja transferir dados.
1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**.
1. Na página **Configurar local de origem**, [crie](transferring-data-datasync.md) ou escolha um local de origem e depois escolha **Avançar**.
1. Na página **Configurar local de destino**, [crie](transferring-data-datasync.md) ou escolha um local de destino e depois escolha **Avançar**.
1. (Recomendado) Na página **Definir configurações**, dê à sua tarefa um nome de que você possa se lembrar.
1. Ainda na página **Definir configurações**, escolha as opções de tarefa ou use as configurações padrão.
Talvez você se interesse por algumas das seguintes opções:
+ Especifique o [modo de tarefa](choosing-task-mode.md) que você deseja usar.
+ Especifique quais dados transferir usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md).
+ Configure como [lidar com metadados de arquivos](configure-metadata.md) e [verificar a integridade dos dados](configure-data-verification-options.md).
+ Monitore sua transferência com [relatórios de tarefas](task-reports.md) ou com a [Amazon CloudWatch](monitor-datasync.md). Recomendamos configurar algum tipo de monitoramento para a tarefa.
Quando concluir, selecione **Próximo**.
1. Revise a configuração da tarefa e escolha **Criar tarefa**.
Você está pronto para [iniciar a tarefa](run-task.md).
### Usando o AWS CLI
Depois de [criar seus locais de DataSync origem e destino](transferring-data-datasync.md), você pode criar sua tarefa.
1. Nas suas AWS CLI configurações, verifique se você está usando um dos Regiões da AWS locais para onde planeja transferir dados.
1. Copie o seguinte comando `create-task`:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name"
```
1. Em `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de origem na transferência.
1. Em `--destination-location-arn`, especifique o ARN do local de destino.
Se você estiver transferindo entre Regiões da AWS nossas contas, verifique se o ARN inclui a outra ID de região ou conta.
1. (Recomendado) Em `--name`, especifique um nome para a tarefa de que você possa se lembrar.
1. Especifique outras opções de tarefa conforme necessário. Talvez você esteja interessado em algumas das seguintes opções:
+ Especifique quais dados transferir usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md).
+ Configure como [lidar com metadados de arquivos](configure-metadata.md) e [verificar a integridade dos dados](configure-data-verification-options.md).
+ Monitore sua transferência com [relatórios de tarefas](task-reports.md) ou com a [Amazon CloudWatch](monitor-datasync.md). Recomendamos configurar algum tipo de monitoramento para a tarefa.
Para obter mais opções, consulte [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Aqui está um exemplo do comando `create-task` que especifica várias opções:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--cloud-watch-log-group-arn "arn:aws:logs:region:account-id" \
--name "task-name" \
--options VerifyMode=NONE,OverwriteMode=NEVER,Atime=BEST_EFFORT,Mtime=PRESERVE,Uid=INT_VALUE,Gid=INT_VALUE,PreserveDevices=PRESERVE,PosixPermissions=PRESERVE,PreserveDeletedFiles=PRESERVE,TaskQueueing=ENABLED,LogLevel=TRANSFER
```
1. Execute o comando `create-task`.
Se o comando for bem-sucedido, você receberá uma resposta que mostra o ARN da tarefa que você criou. Por exemplo:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Você está pronto para [iniciar a tarefa](run-task.md).
## Status da tarefa
Ao criar uma DataSync tarefa, você pode verificar seu status para ver se ela está pronta para ser executada.
| Status do console | Status da API | Description |
| --- | --- | --- |
| Available (Disponível) | `AVAILABLE` | A tarefa está pronta para começar a transferir dados. |
| Em execução | `RUNNING` | A execução de uma tarefa está em andamento. Para obter mais informações, consulte [Status de execução de tarefa](run-task.md#understand-task-execution-statuses). |
| Unavailable (Indisponível) | `UNAVAILABLE` | Um DataSync agente usado pela tarefa está off-line. Para obter mais informações, consulte [O que eu faço se meu agente estiver off-line?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline). |
| Enfileirado | `QUEUED` | Outra execução de tarefa que usa o mesmo DataSync agente está em andamento. Para obter mais informações, consulte [Como saber quando a tarefa está na fila](run-task.md#queue-task-execution). |
## Como particionar grandes conjuntos de dados com várias tarefas
Se você estiver transferindo um grande conjunto de dados, como a [migração](datasync-large-migration.md) de milhões de arquivos ou objetos, recomendamos usar o modo DataSync Avançado para sua transferência, que pode transferir conjuntos de dados com números praticamente ilimitados de arquivos. Para conjuntos de dados muito grandes, com bilhões de arquivos, você deve considerar particionar seu conjunto de dados com várias tarefas. DataSync Particionar seus dados em várias tarefas (e possivelmente em [agentes](do-i-need-datasync-agent.md#multiple-agents), dependendo de suas localizações) ajuda a reduzir o tempo necessário DataSync para preparar e transferir seus dados.
Considere algumas maneiras de particionar um grande conjunto de dados em várias DataSync tarefas:
+ Crie tarefas que transfiram pastas separadas. Por exemplo, você pode criar duas tarefas que tenham como destino `/FolderA` e `/FolderB`, respectivamente, no armazenamento de origem.
+ Crie tarefas que transfiram subconjuntos de arquivos, objetos e pastas usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md).
Lembre-se de que essa abordagem pode aumentar I/O as operações no armazenamento e afetar a largura de banda da rede. Para obter mais informações, consulte o blog sobre [Como acelerar suas transferências de dados com arquiteturas DataSync escaláveis](https://aws.amazon.com/blogs/storage/how-to-accelerate-your-data-transfers-with-aws-datasync-scale-out-architectures/).
## Como segmentar dados transferidos com várias tarefas
Se estiver transferindo conjuntos diferentes de dados para o mesmo destino, você poderá criar várias tarefas para ajudar a segmentar os dados que serão transferidos.
Por exemplo, se você estiver transferindo para o mesmo bucket do S3 denominado `MyBucket`, poderá criar prefixos diferentes no bucket que correspondam a cada tarefa. Essa abordagem evita conflitos de nomes de arquivos nos conjuntos de dados e permite que você defina permissões diferentes para cada prefixo. Veja como você pode configurar isso:
1. Crie três prefixos no destino `MyBucket` denominados `task1`, `task2` e `task3`:
+ `s3://MyBucket/task1`
+ `s3://MyBucket/task2`
+ `s3://MyBucket/task3`
1. Crie três DataSync tarefas chamadas`task1`,`task2`, e `task3` que sejam transferidas para o prefixo correspondente em`MyBucket`.
# Como escolher um modo de tarefa para a transferência de dados
Sua AWS DataSync tarefa pode ser executada em um dos seguintes modos:
+ **Modo aprimorado** — transfira números praticamente ilimitados de arquivos ou objetos com desempenho superior ao do modo Básico. As tarefas do modo Avançado otimizam o processo de transferência de dados listando, preparando, transferindo e verificando os dados em paralelo. Atualmente, o modo aprimorado está disponível para transferências entre locais do Amazon S3, transferências entre Azure Blob e o Amazon S3 sem um agente, transferências entre outras nuvens e o Amazon S3 sem um agente e transferências entre servidores de arquivos NFS ou SMB e o Amazon S3 usando um agente do modo aprimorado.
+ **Modo básico** — Transfira arquivos ou objetos entre o AWS armazenamento e todos os outros DataSync locais compatíveis. As tarefas do modo Básico estão sujeitas a [cotas](datasync-limits.md) no número de arquivos, objetos e diretórios em um conjunto de dados. O modo Básico prepara, transfere e verifica os dados sequencialmente, tornando-se mais lento do que o modo Avançado para a maioria das workloads.
## Como entender as diferenças do modo de tarefa
As informações a seguir podem ajudar você a determinar qual modo de tarefa usar.
| Recurso | Comportamento do modo Avançado | Comportamento do modo Básico |
| --- | --- | --- |
| [Desempenho](how-datasync-transfer-works.md#transferring-files) | DataSync lista, prepara, transfere e verifica seus dados paralelamente. Proporciona melhor desempenho do que o modo Básico para a maioria das workloads (como a transferência de objetos grandes) | DataSync prepara, transfere e verifica seus dados sequencialmente. Desempenho mais lento do que no modo Avançado para a maioria das workloads |
| Número de itens em um conjunto de dados com os quais DataSync você pode trabalhar por execução de tarefa | Número praticamente ilimitado de objetos | [Cotas](datasync-limits.md#task-hard-limits) se aplicam |
| [Contadores](transfer-performance-counters.md) e [métricas](monitor-datasync.md) de transferência de dados | Mais contadores e métricas do que o modo Básico, como o número de objetos DataSync encontrados no local de origem, quantos objetos são preparados durante a execução de cada tarefa e contadores de pastas semelhantes aos contadores de arquivos e objetos | Menos contadores e métricas do que o modo Avançado |
| [Registro em log](configure-logging.md) | Registros estruturados (formato JSON) | Registros não estruturados |
| [Locais compatíveis](working-with-locations.md) | Atualmente, para transferências entre locais do Amazon S3, transferências entre Azure Blob e o Amazon S3 sem um agente, transferências entre outras nuvens e o Amazon S3 sem um agente e transferências entre servidores de arquivos NFS ou SMB e o Amazon S3 usando um agente do modo Avançado. | Para transferências entre todos os locais que oferecem DataSync suporte |
| [Opções de verificação de dados](configure-data-verification-options.md) | DataSync verifica somente os dados transferidos | DataSync verifica todos os dados por padrão |
| Custo | Para obter mais informações, consulte a página [DataSync de preços](https://aws.amazon.com/datasync/pricing) | Para obter mais informações, consulte a página [DataSync de preços](https://aws.amazon.com/datasync/pricing) |
| Tratamento de falhas para tags de objeto não suportadas | Em relação a transferências de armazenamento em nuvem de ou para locais que não oferecem suporte à marcação de objetos, a execução da tarefa falhará imediatamente se a opção ObjectTags não for especificada ou definida como PRESERVE. | Em relação a transferências de armazenamento em nuvem de ou para locais que não oferecem suporte à marcação de objetos, a execução da tarefa será executada normalmente, mas relatará falhas por objeto para objetos marcados se a opção ObjectTags não for especificada ou definida como PRESERVE. |
## Como escolher um modo de tarefa
Você pode escolher o modo Avançado somente para transferências entre locais do Amazon S3, transferências entre Azure Blob e o Amazon S3 sem um agente, transferências entre outras nuvens e o Amazon S3 sem um agente e transferências entre servidores de arquivos NFS ou SMB e o Amazon S3 usando um agente do modo Avançado. Caso contrário, você deve usar o modo Básico. Por exemplo, uma transferência de um local [HDFS local para um local](create-hdfs-location.md) do S3 requer o modo Básico.
As opções de tarefas e o desempenho podem variar dependendo do modo de tarefa escolhido. Depois de criar a tarefa, não é possível alterar o modo de tarefa.
**Permissões obrigatórias**
Para criar uma tarefa no modo Avançado, a função do IAM DataSync com a qual você está usando precisa ter a `iam:CreateServiceLinkedRole` permissão.
Para obter suas permissões de DataSync usuário, considere usar [AWSDataSyncFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-awsdatasyncfullaccess). Essa é uma política AWS gerenciada que fornece ao usuário acesso total DataSync e acesso mínimo às suas dependências.
### Usando o DataSync console
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 tarefa**, selecione uma das seguintes opções:
+ **Aprimorado**
+ **Básico**
Para obter mais informações, consulte [Como entender as diferenças do modo de tarefa](#task-mode-differences).
1. Ainda na página **Definir configurações**, escolha outras opções de tarefa ou use as configurações padrão.
Talvez você esteja interessado em algumas das seguintes opções:
+ Especifique quais dados transferir usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md).
+ Configure como [lidar com metadados de arquivos](configure-metadata.md) e [verificar a integridade dos dados](configure-data-verification-options.md).
+ Monitore sua transferência com [relatórios de tarefas](task-reports.md) ou [Amazon CloudWatch Logs](monitor-datasync.md).
Quando concluir, selecione **Próximo**.
1. Revise a configuração da tarefa e escolha **Criar tarefa**.
### Usando o AWS CLI
1. Nas suas AWS CLI configurações, verifique se você está usando um dos Regiões da AWS locais para onde planeja transferir dados.
1. Copie o seguinte comando `create-task`:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--task-mode "ENHANCED-or-BASIC"
```
1. Em `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de origem na transferência.
1. Em `--destination-location-arn`, especifique o ARN do local de destino.
Se você estiver transferindo entre Regiões da AWS nossas contas, certifique-se de que o ARN inclua a outra ID de região ou conta.
1. Para `--task-mode`, especifique `ENHANCED` ou `BASIC`.
Para obter mais informações, consulte [Como entender as diferenças do modo de tarefa](#task-mode-differences).
1. Especifique outras opções de tarefa conforme necessário. Talvez você esteja interessado em algumas das seguintes opções:
+ Especifique quais dados transferir usando um [manifesto](transferring-with-manifest.md) ou [filtros](filtering.md).
+ Configure como [lidar com metadados de arquivos](configure-metadata.md) e [verificar a integridade dos dados](configure-data-verification-options.md).
+ Monitore sua transferência com [relatórios de tarefas](task-reports.md) ou [Amazon CloudWatch Logs](monitor-datasync.md).
Para obter mais opções, consulte [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Aqui está um exemplo do comando `create-task` que especifica o modo Avançado e várias outras opções:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name" \
--task-mode "ENHANCED" \
--options TransferMode=CHANGED,VerifyMode=ONLY_FILES_TRANSFERRED,ObjectTags=PRESERVE,LogLevel=TRANSFER
```
1. Execute o comando `create-task`.
Se o comando for bem-sucedido, você receberá uma resposta que mostra o ARN da tarefa que você criou. Por exemplo:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
### Usando a DataSync API
Você pode especificar o modo de DataSync tarefa configurando o `TaskMode` parâmetro na [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)operação.
# Escolhendo quais AWS DataSync transferências
AWS DataSync permite que você escolha o que transferir e como deseja que seus dados sejam tratados. Algumas opções incluem:
+ Transferir uma lista exata dos arquivos ou objetos usando um manifesto.
+ Incluir ou excluir certos tipos de dados na transferência usando um filtro.
+ Para transferências recorrentes, mova apenas os dados que foram alterados desde a última transferência
+ Substituir os dados no local de destino para correspondam ao que existe no local de origem.
+ Escolher quais metadados de arquivo ou objeto preservar entre seus locais de armazenamento.
**Topics**
+ [Transferência de arquivos ou objetos específicos usando um manifesto](transferring-with-manifest.md)
+ [Transferência de arquivos, objetos e pastas específicos usando filtros](filtering.md)
+ [Entendendo como DataSync manipula metadados de arquivos e objetos](metadata-copied.md)
+ [Links e diretórios copiados por AWS DataSync](special-files-copied.md)
+ [Configuração de como lidar com arquivos, objetos e metadados](configure-metadata.md)
# Transferência de arquivos ou objetos específicos usando um manifesto
Um *manifesto* é uma lista de arquivos ou objetos que você AWS DataSync deseja transferir. Por exemplo, em vez de precisar transferir tudo em um bucket do S3 com potencialmente milhões de objetos, DataSync transfere somente os objetos que você lista em seu manifesto.
Os manifestos são semelhantes aos [filtros](filtering.md), mas permitem identificar exatamente quais arquivos ou objetos transferir em vez de dados que correspondem a um padrão de filtro.
**nota**
O tamanho máximo permitido para o arquivo de manifesto com tarefas do modo Avançado é 20 GB.
## Criação do manifesto
Um manifesto é um arquivo formatado em valores separados por vírgula (CSV) que lista os arquivos ou objetos no local de origem que você deseja transferir. DataSync Se a origem for um bucket do S3, você também poderá incluir qual versão de um objeto transferir.
**Topics**
+ [Diretrizes](#transferring-with-manifest-guidelines)
+ [Exemplos de manifesto](#manifest-examples)
### Diretrizes
Use essas diretrizes para ajudá-lo a criar um manifesto que funcione com DataSync.
------
#### [ Do ]
+ Especifique o caminho completo de cada arquivo ou objeto que você deseja transferir.
Você não pode especificar apenas um diretório ou uma pasta com a intenção de transferir todo o seu conteúdo. Para essas situações, considere usar um [filtro de inclusão](filtering.md) em vez de um manifesto.
+ Certifique-se de que cada caminho de arquivo ou objeto seja relativo ao caminho de montagem, pasta, diretório ou prefixo que você especificou ao configurar seu local de DataSync origem.
Por exemplo, digamos que você [configure um local do S3](create-s3-location.md#create-s3-location-how-to) com um prefixo denominado `photos`. Esse prefixo inclui um objeto `my-picture.png` que você deseja transferir. No manifesto, você só precisa especificar o objeto (`my-picture.png`) em vez de especificar o prefixo e o objeto (`photos/my-picture.png`).
+ Para especificar a versão do objeto Amazon S3 IDs, separe o caminho do objeto e o ID da versão usando uma vírgula.
O exemplo a seguir mostra uma entrada de manifesto com dois campos. O primeiro campo inclui um objeto denominado `picture1.png`. O segundo campo é separado por vírgula e inclui um ID de versão de `111111`:
```
picture1.png,111111
```
+ Use aspas nas seguintes situações:
+ Quando um caminho contiver caracteres especiais (vírgulas, aspas e fins de linha):
`"filename,with,commas.txt"`
+ Quando um caminho se estender por várias linhas:
```
"this
is
a
filename.txt"
```
+ Quando um caminho incluir aspas:
`filename""with""quotes.txt`
Isso representa um caminho denominado `filename"with"quotes.txt`.
Essas regras de aspas também se aplicam aos campos de ID de versão. Em geral, se um campo de manifesto tiver aspas, você deverá usar outras aspas como caractere de escape.
+ Separe cada entrada de arquivo ou objeto com uma nova linha.
Você pode separar as linhas usando quebras de linha no estilo do Linux (alimentação de linha ou retorno de carro) ou do Windows (retorno de carro seguido por uma alimentação de linha).
+ Salve o manifesto (por exemplo, `my-manifest.csv` ou `my-manifest.txt`).
+ Faça upload do manifesto em um bucket do S3 que [DataSync possa ser acessado](#transferring-with-manifest-access).
Esse bucket não precisa estar na mesma conta Região da AWS ou na qual você está usando DataSync.
------
#### [ Don't ]
+ Especifique apenas um diretório ou uma pasta com a intenção de transferir todo o seu conteúdo.
Um manifesto pode incluir somente caminhos completos para os arquivos ou os objetos que você deseja transferir. Se você configurar o local de origem para usar um caminho de montagem, pasta, diretório ou prefixo específico, não precisará incluí-lo em seu manifesto.
+ Especifique um caminho de arquivo ou objeto que exceda 4.096 caracteres.
+ Especifique um caminho de arquivo, caminho de objeto ou ID de versão de objeto Amazon S3 que exceda 1.024 bytes.
+ Especifique caminhos duplicados de arquivos ou objetos.
+ Inclua um ID de versão do objeto se o local de origem não for um bucket do S3.
+ Inclua mais de dois campos em uma entrada de manifesto.
Uma entrada só pode incluir um caminho de arquivo ou objeto e (se aplicável) um ID de versão de objeto Amazon S3.
+ Inclua caracteres que não estejam em conformidade com a codificação UTF-8.
+ Inclua espaços não intencionais em seus campos de entrada fora das aspas.
------
### Exemplos de manifesto
Use esses exemplos para ajudá-lo a criar um manifesto que funcione com DataSync o.
**Manifesto com caminhos completos de arquivos ou objetos**
O exemplo a seguir mostra um manifesto com caminhos completos dos arquivos ou objetos para transferir.
```
photos/picture1.png
photos/picture2.png
photos/picture3.png
```
**Manifesto somente com chaves de objeto**
O exemplo a seguir mostra um manifesto com objetos para transferir de um local de origem do Amazon S3. Como o [local é configurado](create-s3-location.md#create-s3-location-how-to) com o prefixo `photos`, apenas as chaves do objeto são especificadas.
```
picture1.png
picture2.png
picture3.png
```
**Manifesto com caminhos e versão do objeto IDs**
As duas primeiras entradas no exemplo de manifesto a seguir incluem as versões específicas de objetos do Amazon S3 a serem transferidas.
```
photos/picture1.png,111111
photos/picture2.png,121212
photos/picture3.png
```
**Manifesto com caracteres UTF-8**
O exemplo a seguir mostra um manifesto com arquivos que incluem caracteres UTF-8.
```
documents/résumé1.pdf
documents/résumé2.pdf
documents/résumé3.pdf
```
## Fornecendo DataSync acesso ao seu manifesto
Você precisa de uma função AWS Identity and Access Management (IAM) que dê DataSync acesso ao seu manifesto em seu bucket do S3. Esse perfil inclui as seguintes permissões:
+ `s3:GetObject`
+ `s3:GetObjectVersion`
Você pode gerar essa função automaticamente no DataSync console ou criar a função você mesmo.
**nota**
Se seu manifesto estiver em um outro Conta da AWS, você deverá criar essa função manualmente.
### Criação automática de um perfil do IAM
Ao criar ou iniciar uma tarefa de transferência no console, DataSync pode criar uma função do IAM para você com `s3:GetObject` as `s3:GetObjectVersion` permissões necessárias para acessar seu manifesto.
**Permissões necessárias para criar automaticamente o perfil**
Para criar automaticamente a função, certifique-se de que a função que você está usando para acessar o DataSync console tenha as seguintes permissões:
+ `iam:CreateRole`
+ `iam:CreatePolicy`
+ `iam:AttachRolePolicy`
### Criação do perfil do IAM (mesma conta)
Você pode criar manualmente a função do IAM que DataSync precisa acessar seu manifesto. As instruções a seguir pressupõem que você esteja no mesmo Conta da AWS local em que usa DataSync e que o bucket S3 do seu manifesto esteja localizado.
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação esquerdo, em **Gerenciamento de acesso**, escolha **Perfis** e, em seguida, escolha **Criar perfil**.
1. Na página **Selecionar entidade confiável**, para **Tipo de entidade confiável**, escolha **AWS service (Serviço da AWS)**.
1. **Em Caso de uso**, escolha **DataSync**na lista suspensa e selecione. **DataSync** Escolha **Próximo**.
1. Na página **Adicionar permissões**, escolha **Próximo**. Forneça um nome ao perfil e escolha **Criar perfil**.
1. Na página **Perfis**, procure o perfil que você acabou de criar e escolha seu nome.
1. Na página do perfil, escolha a guia **Permissões**. Selecione **Adicionar permissões** e, em seguida, **Criar política em linha**.
1. Escolha a guia **JSON** e cole o seguinte exemplo de política no editor de políticas:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. No exemplo de política que você acabou de colar, substitua os seguintes valores pelos seus:
1. Substitua `amzn-s3-demo-bucket` pelo nome do bucket do S3 que está hospedando o manifesto.
1. Substitua `my-manifest.csv` pelo nome do arquivo do manifesto.
1. Escolha **Próximo**. Digite um nome para a política e escolha **Criar política**.
1. (Recomendado) Para evitar o [problema “confused deputy” entre serviços](cross-service-confused-deputy-prevention.md), faça o seguinte:
1. Na página Detalhes do perfil, escolha a guia **Relações de confiança**. Escolha **Editar política de confiança**.
1. Atualize a política de confiança usando o exemplo a seguir, que inclui as chaves de contexto de condição global `aws:SourceArn` e `aws:SourceAccount`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "555555555555"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*"
}
}
}
]
}
```
------
+ Substitua cada instância `account-id` pelo Conta da AWS ID em que você está usando DataSync.
+ `region`Substitua pelo Região da AWS local em que você está usando DataSync.
1. Escolha **Atualizar política**.
Você criou uma função do IAM que permite DataSync acessar seu manifesto. Especifique esse perfil ao [criar](#manifest-creating-task) ou [iniciar](#manifest-starting-task) a tarefa.
### Criação do perfil do IAM (outra conta)
Se seu manifesto estiver em um bucket do S3 que pertença a outro Conta da AWS, você deverá criar manualmente a função do IAM DataSync usada para acessar o manifesto. Em seguida, no Conta da AWS local em que seu manifesto está localizado, você precisa incluir a função na política de bucket do S3.
#### Criar a função
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação esquerdo, em **Gerenciamento de acesso**, escolha **Perfis** e, em seguida, escolha **Criar perfil**.
1. Na página **Selecionar entidade confiável**, para **Tipo de entidade confiável**, escolha **AWS service (Serviço da AWS)**.
1. **Em Caso de uso**, escolha **DataSync**na lista suspensa e selecione. **DataSync** Escolha **Próximo**.
1. Na página **Adicionar permissões**, escolha **Próximo**. Forneça um nome ao perfil e escolha **Criar perfil**.
1. Na página **Perfis**, procure o perfil que você acabou de criar e escolha seu nome.
1. Na página do perfil, escolha a guia **Permissões**. Selecione **Adicionar permissões** e, em seguida, **Criar política em linha**.
1. Escolha a guia **JSON** e cole o seguinte exemplo de política no editor de políticas:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. No exemplo de política que você acabou de colar, substitua os seguintes valores pelos seus:
1. Substitua `amzn-s3-demo-bucket` pelo nome do bucket do S3 que está hospedando o manifesto.
1. Substitua `my-manifest.csv` pelo nome do arquivo do manifesto.
1. Escolha **Próximo**. Digite um nome para a política e escolha **Criar política**.
1. (Recomendado) Para evitar o [problema “confused deputy” entre serviços](cross-service-confused-deputy-prevention.md), faça o seguinte:
1. Na página Detalhes do perfil, escolha a guia **Relações de confiança**. Escolha **Editar política de confiança**.
1. Atualize a política de confiança usando o exemplo a seguir, que inclui as chaves de contexto de condição global `aws:SourceArn` e `aws:SourceAccount`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "000000000000"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*"
}
}
}
]
}
```
------
+ Substitua cada instância do `account-id` pelo Conta da AWS ID em que você está usando DataSync.
+ `region`Substitua pelo Região da AWS local em que você está usando DataSync.
1. Escolha **Atualizar política**.
Você criou o perfil do IAM que pode incluir na política de bucket do S3.
#### Atualização da política de bucket do S3 com o perfil
Depois de criar a função do IAM, você deve adicioná-la à política de bucket do S3 no outro Conta da AWS local em que seu manifesto está localizado.
1. No Console de gerenciamento da AWS, mude para a conta com o bucket S3 do seu manifesto.
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na página do perfil, escolha a guia **Permissões**.
1. Em **Política de bucket**, escolha **Editar** e faça o seguinte para modificar sua política de bucket do S3:
1. Atualize o que está no editor para incluir as seguintes declarações de política:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DataSyncAccessManifestBucket",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
}
]
}
```
------
1. `account-id`Substitua pelo Conta da AWS ID da conta DataSync com a qual você está usando.
1. `datasync-role`Substitua pela função do IAM que você acabou de criar e que DataSync permite acessar seu manifesto.
1. Substitua `amzn-s3-demo-bucket` pelo nome do bucket do S3 que está hospedando o manifesto na outra Conta da AWS.
1. Escolha **Salvar alterações**.
Você criou uma função do IAM que permite DataSync acessar seu manifesto na outra conta. Especifique esse perfil ao [criar](#manifest-creating-task) ou [iniciar](#manifest-starting-task) a tarefa.
## Especificação do manifesto ao criar uma tarefa
Você pode especificar o manifesto que DataSync deseja usar ao criar uma tarefa.
### Usando o DataSync console
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, escolha **Tarefas** e depois 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. Em **Conteúdo a ser varrido**, escolha **Arquivos, objetos e pastas específicos** e selecione **Usando um manifesto**.
1. Em **URI do S3**, escolha seu manifesto hospedado em um bucket do S3.
Outra opção é inserir o URI (por exemplo, `s3://bucket/prefix/my-manifest.csv`).
1. Em **Versão do objeto**, escolha a versão do manifesto que você DataSync deseja usar.
Por padrão, DataSync usa a versão mais recente do objeto.
1. Em **Perfil de acesso ao manifesto**, faça uma das seguintes alternativas:
+ Escolha **Autogenerate** DataSync para criar automaticamente uma função do IAM com as permissões necessárias para acessar seu manifesto em seu bucket do S3.
+ Escolha um perfil do IAM existente que possa acessar o manifesto.
Para obter mais informações, consulte [Fornecendo DataSync acesso ao seu manifesto](#transferring-with-manifest-access).
1. Defina todas as outras configurações de tarefa necessárias e escolha **Avançar**.
1. Escolha **Criar tarefa**.
### Usando o AWS CLI
1. Copie o seguinte comando `create-task`:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. No parâmetro `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de onde você está transferindo os dados.
1. No parâmetro `--destination-location-arn`, especifique o ARN do local para onde você está transferindo os dados.
1. No parâmetro `--manifest-config` faça o seguinte:
+ `ManifestObjectPath`: especifique a chave de objeto do S3 do manifesto.
+ `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync acessar seu manifesto em seu bucket do S3.
Para obter mais informações, consulte [Fornecendo DataSync acesso ao seu manifesto](#transferring-with-manifest-access).
+ `S3BucketArn`: especifique o ARN do bucket do S3 que está hospedando o manifesto.
+ `ManifestObjectVersionId`— Especifique a versão do manifesto que você DataSync deseja usar.
Por padrão, DataSync usa a versão mais recente do objeto.
1. Execute o comando `create-task` para criar sua tarefa.
Quando tudo estiver pronto, você poderá [iniciar a tarefa de transferência](run-task.md).
## Especificação do manifesto ao iniciar uma tarefa
Você pode especificar o manifesto que DataSync deseja usar ao executar uma tarefa.
### Usando o DataSync console
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 da esquerda, escolha **Tarefas** e depois a tarefa que você deseja iniciar.
1. Na página de visão geral da tarefa, escolha **Iniciar** e depois **Iniciar com opções de substituição**.
1. Em **Conteúdo a ser varrido**, escolha **Arquivos, objetos e pastas específicas** e selecione **Usando um manifesto**.
1. Em **URI do S3**, escolha seu manifesto hospedado em um bucket do S3.
Outra opção é inserir o URI (por exemplo, `s3://bucket/prefix/my-manifest.csv`).
1. Em **Versão do objeto**, escolha a versão do manifesto que você DataSync deseja usar.
Por padrão, DataSync usa a versão mais recente do objeto.
1. Em **Perfil de acesso ao manifesto**, faça uma das seguintes alternativas:
+ Escolha **Autogenerate** DataSync para criar automaticamente uma função do IAM para acessar seu manifesto em seu bucket do S3.
+ Escolha um perfil do IAM existente que possa acessar o manifesto.
Para obter mais informações, consulte [Fornecendo DataSync acesso ao seu manifesto](#transferring-with-manifest-access).
1. Escolha **Iniciar** para começar a transferência.
### Usando o AWS CLI
1. Copie o seguinte comando `start-task-execution`:
```
aws datasync start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. No parâmetro `--task-arn`, especifique o nome do recurso da Amazon (ARN) da tarefa que você está iniciando.
1. No parâmetro `--manifest-config` faça o seguinte:
+ `ManifestObjectPath`: especifique a chave de objeto do S3 do manifesto.
+ `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync acessar seu manifesto em seu bucket do S3.
Para obter mais informações, consulte [Fornecendo DataSync acesso ao seu manifesto](#transferring-with-manifest-access).
+ `S3BucketArn`: especifique o ARN do bucket do S3 que está hospedando o manifesto.
+ `ManifestObjectVersionId`— Especifique a versão do manifesto que você DataSync deseja usar.
Por padrão, DataSync usa a versão mais recente do objeto.
1. Execute o comando `start-task-execution` para iniciar a transferência.
## Limitações
+ Você não pode usar um manifesto junto com [filtros](filtering.md).
+ Você não pode especificar apenas um diretório ou uma pasta com a intenção de transferir todo o seu conteúdo. Para essas situações, considere usar um [filtro de inclusão](filtering.md) em vez de um manifesto.
+ Você não pode usar a opção de tarefa **Manter arquivos excluídos** (`PreserveDeletedFiles`na [API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) para [manter arquivos ou objetos no destino que não estejam na origem](configure-metadata.md). DataSync transfere apenas o que está listado no seu manifesto e não exclui nada no destino.
## Solução de problemas
**Erros relacionados a `HeadObject` ou `GetObjectTagging`**
Se você estiver transferindo objetos com uma versão específica IDs de um bucket do S3, talvez veja um erro relacionado a `HeadObject` ou. `GetObjectTagging` Por exemplo, aqui está um erro relacionado a `GetObjectTagging`:
```
[WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed
[ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied,
msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml,
date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked,
x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723
```
Se você ver algum desses erros, valide se a função do IAM DataSync usada para acessar seu local de origem do S3 tem as seguintes permissões:
+ `s3:GetObjectVersion`
+ `s3:GetObjectVersionTagging`
Se você precisar atualizar o perfil com essas permissões, consulte [Criação de uma função do IAM DataSync para acessar sua localização no Amazon S3](create-s3-location.md#create-role-manually).
**Erro: `ManifestFileDoesNotExist`**
Esse erro indica que um arquivo no manifesto não foi encontrado na origem. Analise as [diretrizes](#transferring-with-manifest-guidelines) para criar um manifesto.
## Próximas etapas
Se ainda não o fez, [inicie a tarefa](run-task.md). Do contrário, [monitore as atividades da tarefa](monitoring-overview.md).
# Transferência de arquivos, objetos e pastas específicos usando filtros
AWS DataSync permite aplicar filtros para incluir ou excluir dados do local de origem em uma transferência. Por exemplo, se você não quiser transferir arquivos temporários que terminem com `.tmp`, poderá criar um filtro de exclusão para que esses arquivos não vão para ao local de destino.
Você pode usar uma combinação de filtros de exclusão e inclusão na mesma tarefa de transferência. Se você modificar os filtros de uma tarefa, essas alterações serão aplicadas a próxima vez que você executar a tarefa.
## Filtrar termos, definições e sintaxe
Familiarize-se com os conceitos relacionados à DataSync filtragem:
**Filtro **
A string completa que representa um filtro específico (por exemplo, `*.tmp``|``*.temp` ou `/folderA|/folderB`).
Filtros são compostos por padrões delimitados por uma barra vertical (\$1). Você não precisa de um delimitador ao adicionar padrões no DataSync console porque adiciona cada padrão separadamente.
Os filtros diferenciam maiúsculas de minúsculas. Por exemplo, o filtro `/folderA` não corresponderá a `/FolderA`.
**Padrão**
Um padrão dentro de um filtro. Por exemplo, `*.tmp` é um padrão que faz parte do filtro `*.tmp``|``*.temp`. Se o filtro tiver vários padrões, você delimitará cada padrão usando uma barra vertical (\$1).
**Pastas**
+ Todos os filtros se referem ao caminho do local de origem. Por exemplo, suponha que você especifica `/my_source/` como o caminho de origem ao criar a tarefa e o local de origem e especifica o filtro de inclusão `/transfer_this/`. Nesse caso, DataSync transfere somente o diretório `/my_source/transfer_this/` e seu conteúdo.
+ Para especificar uma pasta diretamente sob o local de origem, inclua uma barra (/) na frente do nome da pasta. No exemplo anterior, o padrão usa `/transfer_this`, e não `transfer_this`.
+ DataSync interpreta os padrões a seguir da mesma forma e combina a pasta e seu conteúdo.
`/dir`
`/dir/`
+ Quando você está transferindo dados de ou para um bucket do Amazon S3 DataSync, trata `/` o caractere na chave do objeto como o equivalente a uma pasta em um sistema de arquivos.
**Caracteres especiais**
Veja a seguir caracteres especiais para usar com a filtragem.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/filtering.html)
## Exemplo de filtros
Os exemplos a seguir mostram filtros comuns com os quais você pode usar DataSync.
**nota**
Há limites para o número de caracteres que você pode usar em um filtro. Para obter mais informações, consulte [Cotas do DataSync](datasync-limits.md#task-hard-limits).
**Excluir algumas pastas do local de origem**
Em alguns casos, você poderá querer a exclusão de pastas no seu local de origem para não copiá-las para o seu local de destino. Por exemplo, se você tiver work-in-progress pastas temporárias, poderá usar algo como o filtro a seguir:
`*/.temp`
Para excluir pastas com conteúdo semelhante (como `/reports2021` e `/reports2022)`), você pode usar um filtro de exclusão como o seguinte:
`/reports*`
Para excluir pastas em qualquer nível da hierarquia de arquivos, você pode usar um filtro de exclusão, como o que segue.
`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`
Para excluir pastas no nível superior do local de origem, você pode usar um filtro de exclusão, como o que segue.
`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`
**Inclua apenas um subconjunto das pastas do local de origem**
Em alguns casos, seu local de origem pode ser um grande compartilhamento e você deseja transferir um subconjunto das pastas da raiz. Para incluir pastas específicas, inicie uma execução de tarefa com um filtro de inclusão, como o seguinte.
`/folder-to-transfer/*`
**Excluir tipos de arquivo específicos**
Para excluir determinados tipos de arquivo da transferência, crie uma execução de tarefa com um filtro de exclusão, como `*.temp`.
**Transferir arquivos individuais especificados**
Para transferir uma lista de arquivos individuais, inicie uma execução de tarefa com um filtro de inclusão, como o seguinte: “`/folder/subfolder/file1.txt`\$1`/folder/subfolder/file2.txt`\$1`/folder/subfolder/file2.txt`”
## Criação de filtros de inclusão
Os filtros de inclusão definem os arquivos, objetos e pastas que você DataSync deseja transferir. Você pode configurar filtros de inclusão ao criar, editar ou iniciar uma tarefa.
DataSync verifica e transfere somente arquivos e pastas que correspondam aos filtros de inclusão. Por exemplo, para incluir um subconjunto das suas pastas de origem, você pode especificar `/important_folder_1`\$1`/important_folder_2`.
**nota**
Atualmente, os filtros de inclusão oferecem suporte ao caractere (\$1) apenas como o caractere mais à direita em um padrão. Por exemplo, `/documents*`\$1`/code*` é aceito, mas `*.txt` não.
### Usando o DataSync console
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, escolha **Tarefas** e depois 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. Em **Conteúdo a ser varrido**, escolha **Arquivos, objetos e pastas específicos** e selecione **Usando filtros**.
1. Em **Inclui**, insira seu filtro (por exemplo, `/important_folders` para incluir um diretório importante) e escolha **Adicionar padrão**.
1. Adicione outros filtros de inclusão conforme necessário.
### Usando o AWS CLI
Ao usar o AWS CLI, você deve usar aspas simples (`'`) ao redor do filtro e um \$1 (pipe) como delimitador se você tiver mais de um filtro.
O exemplo a seguir especifica dois filtros de inclusão `/important_folder1` e `/important_folder2` ao executar o comando `create-task`.
```
aws datasync create-task
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
```
## Criação de filtros de exclusão
Os filtros de exclusão definem os arquivos, objetos e pastas em seu local de origem que você não DataSync deseja transferir. Você pode configurar estes filtros ao criar, editar ou iniciar uma tarefa.
**Topics**
+ [Dados excluídos por padrão](#directories-ignored-during-transfers)
### Dados excluídos por padrão
DataSync exclui automaticamente alguns dados da transferência:
+ `.snapshot`— DataSync ignora qualquer caminho que termine com`.snapshot`, que normalmente é usado para point-in-time capturas instantâneas dos arquivos ou diretórios de um sistema de armazenamento.
+ `/.aws-datasync`e `/.awssync` — DataSync cria essas pastas em sua localização para ajudar a facilitar sua transferência.
+ `/.zfs`— Você pode ver essa pasta com os locais da Amazon FSx for OpenZFS.
### Usando o DataSync console
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, escolha **Tarefas** e depois 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. Em **Exclusões**, insira seu filtro (por exemplo, `*/temp` para excluir pastas temporárias) e escolha **Adicionar padrão**.
1. Adicione outros filtros de exclusão conforme necessário.
1. Se necessário, adicione [filtros de inclusão](#include-filters).
### Usando o AWS CLI
Ao usar o AWS CLI, você deve usar aspas simples (`'`) ao redor do filtro e um \$1 (pipe) como delimitador se você tiver mais de um filtro.
O exemplo a seguir especifica dois filtros de exclusão `*/temp` e `*/tmp` ao executar o comando `create-task`.
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
```
# Entendendo como DataSync manipula metadados de arquivos e objetos
AWS DataSync pode preservar seus metadados de arquivo ou objeto durante uma transferência de dados. A forma como seus metadados são copiados depende dos locais de transferência e se esses locais usam tipos semelhantes de metadados.
## Metadados no nível de sistema
Em geral, DataSync não copia metadados no nível do sistema. Por exemplo, ao transferir a partir de um servidor de arquivos SMB, as permissões que você configurou no nível do sistema de arquivos não são copiadas para o sistema de armazenamento de destino.
Há exceções. Ao transferir entre o Amazon S3 e outro armazenamento de objetos DataSync , copia [alguns metadados de objetos definidos pelo sistema](#metadata-copied-between-object-s3).
## Metadados copiados nas transferências do Amazon S3
As tabelas a seguir descrevem quais metadados DataSync podem ser copiados quando uma transferência envolve uma localização do Amazon S3.
**Topics**
+ [Para o Amazon S3](#metadata-copied-to-s3)
+ [Entre o Amazon S3 e outros armazenamentos de objetos](#metadata-copied-between-object-s3)
+ [Entre o Amazon S3 e o HDFS](#metadata-copied-between-hdfs-s3)
### Para o Amazon S3
| Ao copiar a partir de um desses locais | Para este local | DataSync pode copiar |
| --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | O seguinte como metadados do usuário do Amazon S3: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) Os metadados de arquivo armazenados nos metadados do usuário do Amazon S3 são interoperáveis com compartilhamentos NFS nos gateways de arquivo usando AWS Storage Gateway. Um gateway de arquivos permite o acesso de baixa latência das redes locais aos dados que foram copiados para o Amazon S3 pelo. DataSync Esses metadados também são interoperáveis com FSx o for Lustre. Quando DataSync copia objetos que contêm esses metadados de volta para um servidor NFS, os metadados do arquivo são restaurados. Restaurar metadados exige conceder permissões elevadas para o servidor NFS. Para obter mais informações, consulte [Configurando AWS DataSync transferências com um servidor de arquivos NFS](create-nfs-location.md). |
### Entre o Amazon S3 e outros armazenamentos de objetos
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html)
### Entre o Amazon S3 e o HDFS
| Ao copiar entre esses locais | DataSync pode copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | O seguinte como metadados do usuário do Amazon S3:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html)O HDFS usa cadeias de caracteres para armazenar a propriedade de usuários e grupos de arquivos e pastas, em vez de identificadores numéricos, como e. UIDs GIDs |
## Metadados copiados em transferências de NFS
A tabela a seguir descreve quais metadados DataSync podem ser copiados entre locais que usam o Network File System (NFS).
| Ao copiar entre esses locais | DataSync pode copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) |
## Metadados copiados em transferências de SMB
A tabela a seguir descreve quais metadados DataSync podem ser copiados entre locais que usam o Server Message Block (SMB).
| Ao copiar entre esses locais | DataSync pode copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) |
## Metadados copiados em outros cenários de transferência
DataSync trata os metadados das seguintes maneiras ao copiar entre esses sistemas de armazenamento (a maioria dos quais tem estruturas de metadados diferentes).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html)
## Compreender quando e como DataSync aplica os metadados POSIX padrão
DataSync aplica metadados POSIX padrão nas seguintes situações:
+ Quando os locais de origem e destino da sua transferência não têm estruturas de metadados semelhantes
+ Quando não há metadados no local de origem
A tabela a seguir descreve como os metadados POSIX padrão são DataSync aplicados durante esses tipos de transferências:
| Fonte | Destination (Destino) | Permissões de arquivo | Permissões da pasta | UID | GID |
| --- | --- | --- | --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | 0755 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
1 Nos casos em que os objetos não têm metadados que foram aplicados anteriormente por DataSync.
# Links e diretórios copiados por AWS DataSync
AWS DataSync trata links físicos, links simbólicos e diretórios de forma diferente, dependendo dos locais de armazenamento envolvidos na transferência.
## Links rígidos
Veja como DataSync lidar com links físicos em alguns cenários comuns de transferência:
+ **Ao transferir entre um servidor de arquivos NFS, FSx para Lustre, para OpenZFS, FSx FSx para ONTAP (usando NFS) e Amazon EFS,** os links físicos são preservados.
+ **Ao transferir para o Amazon S3**, cada arquivo subjacente referenciado por um link fixo é transferido apenas uma vez. Durante as transferências incrementais, objetos separados são criados no bucket do S3. Se um link físico não for alterado no Amazon S3, ele será restaurado corretamente quando transferido para um servidor de arquivos NFS, para Lustre FSx , para OpenZFS FSx FSx , para ONTAP (usando NFS) ou sistema de arquivos Amazon EFS.
+ **Ao transferir para o Microsoft Azure Blob Storage**, cada arquivo subjacente referenciado por um link fixo é transferido apenas uma vez. Durante as transferências incrementais, objetos separados são criados no armazenamento de blobs se houver novas referências na origem. Ao transferir deAzure Blob Storage, DataSync transfere links físicos como se fossem arquivos individuais.
+ **Ao transferir entre um servidor de arquivos SMB, FSx para o Windows File Server e FSx para o ONTAP (usando SMB)**, os links físicos não são suportados. Se DataSync encontrar links físicos nessas situações, a tarefa de transferência será concluída com um erro. Para saber mais, verifique seus CloudWatch registros.
+ **Ao transferir para o HDFS, os** links físicos não são suportados. CloudWatch os registros mostram esses links como ignorados.
## Links simbólicos
Veja como DataSync lidar com links simbólicos em alguns cenários comuns de transferência:
+ **Ao transferir entre um servidor de arquivos NFS, FSx para Lustre, para OpenZFS, FSx FSx para ONTAP (usando NFS) e Amazon EFS,** os links simbólicos são preservados.
+ **Ao transferir para o Amazon S3**, o caminho de destino do link é armazenado no objeto do Amazon S3. O link é restaurado corretamente quando transferido para um servidor de arquivos NFS, FSx para Lustre, para OpenZFS, FSx FSx para ONTAP ou sistema de arquivos Amazon EFS.
+ **Ao transferir para Azure Blob Storage**, links simbólicos não são suportados. CloudWatch os registros mostram esses links como ignorados.
+ **Ao transferir entre um servidor de arquivos SMB, FSx para o Windows File Server e FSx para o ONTAP (usando SMB)**, links simbólicos não são suportados. DataSync não transfere um link simbólico em si, mas sim um arquivo referenciado pelo link simbólico. Para reconhecer arquivos duplicados e desduplicá-los com links simbólicos, você deve configurar a desduplicação no sistema de arquivos de destino.
+ **Ao transferir para o HDFS, os** links simbólicos não são suportados. CloudWatch os registros mostram esses links como ignorados.
## Diretórios
Em geral, DataSync preserva os diretórios ao transferir entre sistemas de armazenamento. Esse não é o caso nas seguintes situações:
+ **Ao transferir para o Amazon S3**, os diretórios são representados como objetos vazios que têm prefixos e terminam com uma barra (`/`).
+ **Ao transferir para o Azure Blob Storage sem um namespace hierárquico**, não existem diretórios. O que parece ser um diretório é apenas parte do nome de um objeto.
# Configuração de como lidar com arquivos, objetos e metadados
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
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
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
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
Você pode configurar como DataSync manipula arquivos, objetos e metadados ao criar, editar ou iniciar sua tarefa de transferência.
### Usando o DataSync console
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
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)
# Configurando como AWS DataSync verifica a integridade dos dados
Durante uma transferência, AWS DataSync usa a verificação de soma de verificação para verificar a integridade dos dados que você copia entre locais. Você também pode configurar DataSync para realizar uma verificação adicional ao final da transferência.
## Opções de verificação de dados
Use as informações a seguir para ajudá-lo a decidir se e como você DataSync deseja realizar essas verificações adicionais.
| Opção do console | Opção de API | Description |
| --- | --- | --- |
| **Verificar somente os dados transferidos** (recomendado) | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) definido como `ONLY_FILES_TRANSFERRED` | DataSync calcula a soma de verificação dos dados transferidos (incluindo metadados) no local de origem. Ao final da transferência, DataSync compara essa soma de verificação com a soma de verificação calculada com base nos mesmos dados no destino. Recomendamos essa opção ao transferir para o S3 Glacier Flexible Retrieval ou para classes de armazenamento do S3 Glacier Deep Archive. Para obter mais informações, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes). |
| **Verificar todos os dados** | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) definido como `POINT_IN_TIME_CONSISTENT` | Ao final da transferência, DataSync verifique toda a origem e o destino para verificar se os dois locais estão totalmente sincronizados. Não é compatível quando a tarefa usa o [modo Avançado](choosing-task-mode.md). Se você usa um [manifesto](transferring-with-manifest.md), DataSync apenas digitaliza e verifica o que está listado no manifesto. Você não usa essa opção ao transferir para o S3 Glacier Flexible Retrieval ou para classes de armazenamento do S3 Glacier Deep Archive. Para obter mais informações, consulte [Considerações sobre a classes de armazenamento com transferências do Amazon S3](create-s3-location.md#using-storage-classes). |
| Não verificar os dados após a transferência | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) definido como `NONE` | DataSync realiza verificações de integridade de dados somente durante sua transferência. Ao contrário de outras opções, não há verificação adicional no fim da transferência. |
## Como configurar a verificação de dados
Você pode configurar as opções de verificação de dados ao criar uma tarefa, atualizar uma tarefa ou iniciar a execução de uma tarefa.
### Usando o DataSync console
As instruções a seguir descrevem como configurar as opções de verificação dos dados ao criar uma tarefa.
**Para configurar a verificação de dados usando o console**
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. Em **Verificação**, escolha uma das seguintes opções:
+ **Verificar somente os dados transferidos** (recomendado)
+ **Verificar todos os dados**
+ **Não verificar os dados após a transferência**
### Usando a DataSync API
Você pode configurar como DataSync verifica os dados usando o `VerifyMode` parâmetro com qualquer uma das seguintes operações:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
# Definindo limites de largura de banda para sua tarefa AWS DataSync
Você pode configurar limites de largura de banda de rede para sua AWS DataSync tarefa e cada uma de suas execuções.
## Limitar a largura de banda para uma tarefa
Defina um limite de largura de banda ao criar, editar ou iniciar uma tarefa.
### Usando o DataSync console
As instruções a seguir descrevem como configurar um limite de largura de banda para a tarefa ao criá-la.
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. Em **Limite de largura de banda**, escolha uma das seguintes opções:
+ Selecione **Usar disponível** para usar toda a largura de banda da rede disponível para cada execução de tarefa.
+ Selecione **Definir limite de largura de banda (MiB/s)** e insira a largura de banda máxima que você deseja usar DataSync para cada execução de tarefa.
### Usando a DataSync API
Você pode configurar o limite de largura de banda de uma tarefa usando o parâmetro `BytesPerSecond` com qualquer uma das seguintes operações:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
## Controle de utilização da largura de banda para a execução de uma tarefa
Você pode modificar o limite de largura de banda para a execução de uma tarefa em execução ou em fila.
### Usando o DataSync console
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, expanda **Transferência de dados** e, em seguida, escolha **Tarefas**.
1. Escolha a tarefa e, em seguida, selecione **Histórico** para ver as execuções da tarefa.
1. Escolha a execução da tarefa que você deseja modificar e, em seguida, escolha **Editar**.
1. Na caixa de diálogo Fazer upload, escolha uma das seguintes:
+ Selecione **Usar disponível** para usar toda a largura de banda da rede disponível para a execução da tarefa.
+ Selecione **Definir limite de largura de banda (MiB/s)** e insira a largura de banda máxima que você deseja usar DataSync para a execução da tarefa.
1. Escolha **Salvar alterações**.
O novo limite de largura de banda entra em vigor em 60 segundos.
### Usando a DataSync API
Você pode modificar o limite de largura de banda para a execução de uma tarefa em execução ou em fila usando o `BytesPerSecond` parâmetro com a operação. [UpdateTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTaskExecution.html)
# Agendamento de quando a tarefa do AWS DataSync será executada
Você pode configurar um agendamento de tarefa do AWS DataSync para transferir dados entre locais periodicamente.
## Como funciona o agendamento de tarefa do DataSync
Uma tarefa agendada do DataSync é executada com a frequência que você configura, com intervalo mínimo de 1 hora. Você pode criar um agendamento de tarefas usando as expressões cron ou rate.
**Importante**
Você não pode agendar uma tarefa para ser executada a intervalos de menos de 1 hora.
**Usar expressões cron**
Use expressões cron para agendamentos de tarefas executadas em hora e dia específicos. Por exemplo, veja como você pode configurar o agendamento de uma tarefa na AWS CLI para ser executada todo domingo e toda quarta-feira às 12h UTC.
```
cron(0 12 ? * SUN,WED *)
```
**Uso de expressões rate**
Use expressões rate para agendamentos de tarefas que são executadas a intervalos regulares, como a cada 12 horas. Por exemplo, aqui está como você pode configurar o agendamento de uma tarefa na AWS CLI para ser executada a cada 12 horas:
```
rate(12 hours)
```
**dica**
Para obter mais informações sobre a sintaxe das expressões cron e rate, consulte o [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).
## Criação de um agendamento de tarefa do DataSync
Você pode agendar com que frequência a tarefa é executada usando o console do DataSync, a AWS CLI ou a API do DataSync.
### Utilizar o console do DataSync
As instruções a seguir descrevem como configurar um agendamento ao criar uma tarefa. Você pode modificar o agendamento posteriormente quando editar a tarefa.
No console, algumas opções de agendamento permitem que você especifique a hora exata que a tarefa é executada (como diariamente às 22h30). Se você não incluir um horário para essas opções, a tarefa será executada no momento que você a criar (ou atualizar).
1. Abra o console do AWS DataSync 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. Em **Frequência**, escolha uma das seguintes opções:
+ Escolha **Não agendada** se não quiser agendar a execução periódica da tarefa.
+ Escolha **A cada hora** e depois escolha a quantos minutos da hora você deseja que a tarefa seja executada.
+ Escolha **Diariamente** e insira a hora UTC que você deseja que a tarefa seja executada.
+ Escolha **Semanalmente** e o dia da semana, e insira a hora UTC que você deseja que a tarefa seja executada.
+ Escolha **Dias da semana**, escolha um dia ou dias específicos e insira a hora UTC que a tarefa deve ser executada no formato HH:MM.
+ Escolha **Personalizado** e selecione **Expressão Cron** ou **Expressão rate**. Insira o agendamento da tarefa com um intervalo mínimo de 1 hora.
### Como usar o AWS CLI
Você pode criar um agendamento para a tarefa do DataSync usando o parâmetro `--schedule` com o comando `create-task`, `update-task` ou `start-task-execution`.
As instruções a seguir descrevem como fazer isso com o comando `create-task`.
1. Copie o seguinte comando `create-task`:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
}'
```
1. No parâmetro `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de onde você está transferindo os dados.
1. No parâmetro `--destination-location-arn`, especifique o ARN do local para onde você está transferindo os dados.
1. No parâmetro `--schedule`, especifique uma expressão cron ou rate para o agendamento.
No exemplo, a expressão cron `cron(0 12 ? * SUN,WED *)` define um agendamento de tarefa para execução todo domingo e toda quarta-feira às 12h UTC.
1. Execute o comando `create-task` para criar a tarefa com o agendamento.
## Pausa de um agendamento de tarefa do DataSync
Pode haver situações em que você precise pausar o agendamento de tarefas do DataSync. Por exemplo, pode ser necessário desabilitar temporariamente uma transferência recorrente para corrigir um problema com a tarefa ou realizar a manutenção do sistema de armazenamento.
O DataSync pode desabilitar o agendamento da tarefa automaticamente pelos seguintes motivos:
+ Falhas recorrentes na tarefa com o mesmo erro.
+ Você [desabilita uma Região da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) que a tarefa está usando.
### Utilizar o console do DataSync
1. Abra o console do AWS DataSync 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** e selecione **Tarefas**.
1. Escolha a tarefa cujo agendamento você deseja pausar e escolha **Editar**.
1. Em **Agendamento**, desative **Habilitar agendamento**. Escolha **Salvar alterações**.
### Como usar o AWS CLI
1. Copie o seguinte comando `update-task`:
```
aws datasync update-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED"
}'
```
1. No parâmetro `--task-arn`, especifique o ARN da tarefa cujo agendamento você deseja pausar.
1. No parâmetro `--schedule` faça o seguinte:
+ Em `ScheduleExpression`, especifique uma expressão cron ou rate para o agendamento.
No exemplo, a expressão `cron(0 12 ? * SUN,WED *)` define o agendamento de uma tarefa para execução todo domingo e toda quarta-feira às 12h UTC.
+ Em `Status`, especifique `DISABLED` para pausar o agendamento da tarefa.
1. Execute o comando `update-task`.
1. Para retomar o agendamento, execute o mesmo comando `update-task` com `Status` definido como `ENABLED`.
## Verificação do status do agendamento de uma tarefa do DataSync
Você pode ver se o agendamento da tarefa do DataSync está habilitado.
### Utilizar o console do DataSync
1. Abra o console do AWS DataSync 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** e selecione **Tarefas**.
1. Na coluna **Agendamento**, verifique se o agendamento da tarefa está habilitado ou desabilitado.
### Como usar o AWS CLI
1. Copie o seguinte comando `describe-task`:
```
aws datasync describe-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. No parâmetro `--task-arn`, especifique o ARN da tarefa sobre a qual você deseja informações.
1. Execute o comando `describe-task`.
Você recebe uma resposta que fornece detalhes sobre a tarefa, incluindo seu agendamento. (O foco do exemplo a seguir é principalmente na configuração do agendamento de tarefa e não mostra uma resposta completa a `describe-task`.)
O exemplo mostra que o agendamento da tarefa foi desabilitado manualmente. Se o agendamento foi desabilitado pelo `SERVICE` DataSync, você verá uma mensagem de erro para `DisabledReason` para ajudar a entender por que a tarefa continua apresentando falhas. Para obter mais informações, consulte [Solução de AWS DataSync problemas](troubleshooting-datasync.md).
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
"Status": "AVAILABLE",
"Schedule": {
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED",
"StatusUpdateTime": 1697736000,
"DisabledBy": "USER",
"DisabledReason": "Manually disabled by user."
},
...
}
```
# Marcando suas tarefas AWS DataSync
As *tags* são pares de valores-chave que ajudam você a gerenciar, filtrar e pesquisar seus AWS DataSync recursos. Você pode adicionar até 50 tags a cada DataSync tarefa e execução de tarefas.
Por exemplo, você pode criar uma tarefa para uma grande migração de dados e marcar a tarefa com a chave **Project** e o valor **Large Migration**. Para organizar ainda mais a migração, você pode marcar uma execução da tarefa com a chave **Transfer Date** e o valor **May 2021** (as execuções de tarefas subsequentes podem ser marcadas **June 2021**, **July 2021** e assim por diante).
## Marcando sua tarefa DataSync
Você pode marcar sua DataSync tarefa somente ao criar a tarefa.
### Usando o DataSync console
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. Na página **Definir configurações**, escolha **Adicionar tag** para marcar a tarefa.
### Usando o AWS CLI
1. Copie o seguinte comando `create-task`:
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
--tags Key=tag-key,Value=tag-value
```
1. Especifique os seguintes parâmetros no comando:
+ `--source-location-arn`: especifique o nome do recurso da Amazon (ARN) do local de origem na transferência.
+ `--destination-location-arn`: especifique o ARN do local de destino na transferência.
+ `--tags`: especifique as tags que você deseja aplicar à tarefa.
Para mais de uma tag, separe cada par de valores-chave com um espaço.
1. (Opcional) Especifique outros parâmetros que façam sentido para o cenário de transferência.
Para obter uma lista de `--options`, consulte o comando [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).
1. Execute o comando `create-task`.
Você recebe uma resposta que mostra a tarefa que você acabou de criar.
```
{
"TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Para ver as tags que você adicionou a essa tarefa, você pode usar o [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.
## Marcando sua execução de DataSync tarefas
Você pode marcar cada execução da sua DataSync tarefa.
Se sua tarefa já tiver tags, lembre-se do seguinte sobre o uso de tags com execuções de tarefas:
+ Se você iniciar sua tarefa com o console, as tags criadas pelo usuário serão aplicadas automaticamente à execução da tarefa. No entanto, as tags criadas pelo sistema que começam com `aws:` não são aplicadas.
+ Se você iniciar sua tarefa com a DataSync API ou AWS CLI, suas tags não serão aplicadas automaticamente à execução da tarefa.
### Usando o DataSync console
Para adicionar, editar ou remover tags da execução de uma tarefa, você deve iniciar a tarefa com opções de substituição.
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** e selecione **Tarefas**.
1. Escolha a tarefa.
1. Escolha **Iniciar** e, em seguida, uma das seguintes opções:
+ **Iniciar com padrões**: aplica todas as tags associadas à tarefa.
+ **Iniciar com opções de substituição**: permite adicionar, editar ou remover tags para a execução dessa tarefa específica.
### Usando o AWS CLI
1. Copie o seguinte comando `start-task-execution`:
```
aws datasync start-task-execution \
--task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
--tags Key=tag-key,Value=tag-value
```
1. Especifique os seguintes parâmetros no comando:
+ `--task-arn`: especifique o ARN da tarefa que você deseja iniciar.
+ `--tags`: especifique as tags que você deseja aplicar a essa execução específica da tarefa.
Para mais de uma tag, separe cada par de valores-chave com um espaço.
1. (Opcional) Especifique outros parâmetros que façam sentido para a sua situação.
Para obter mais informações, consulte o comando [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).
1. Execute o comando `start-task-execution`.
Você recebe uma resposta que mostra a execução da tarefa que você acabou de iniciar.
```
{
"TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Para ver as tags que você adicionou a essa tarefa, você pode usar o [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.