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á. # Criando seus relatórios de DataSync tarefas AWS DataSync os relatórios de tarefas podem ser apenas um resumo da execução da tarefa ou um conjunto de relatórios detalhados sobre quais DataSync tentativas transferir, ignorar, verificar e excluir. ## Pré-requisitos Antes de poder criar um relatório de tarefas, é necessário fazer o seguinte. **Topics** + [Criar um bucket do S3 para os relatórios de tarefa](#setting-up-task-report-create-bucket) + [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access) ### Criar um bucket do S3 para os relatórios de tarefa Se você ainda não tiver um, [crie um bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) para DataSync fazer o upload do seu relatório de tarefas. Os relatórios são armazenados na classe de armazenamento S3 Standard. Recomendamos o seguinte para esse bucket: + Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + Para evitar uma configuração complexa de permissões de acesso, verifique se o bucket do relatório de tarefas está na mesma Conta da AWS região da tarefa DataSync de transferência. ### Permita DataSync o upload de relatórios de tarefas para seu bucket do S3 Você deve configurar uma função AWS Identity and Access Management (IAM) que permita DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. No DataSync console, você pode criar uma função do IAM que, na maioria dos casos, inclui automaticamente as permissões para carregar um relatório de tarefas no seu bucket. Lembre-se de que essa função gerada automaticamente pode não atender às suas necessidades do ponto de vista de privilégios mínimos. Essa função também não funcionará se seu bucket for criptografado com uma chave gerenciada pelo cliente AWS Key Management Service (AWS KMS) (SSE-KMS). Nesses casos, você pode criar a função manualmente, desde que ela faça pelo menos o seguinte: + [Prevenção do problema de adjunto confuso](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) na entidade confiável da função. O exemplo completo a seguir mostra como você pode usar as chaves de contexto de condição `aws:SourceAccount` global `aws:SourceArn` e as chaves de contexto para evitar o problema confuso do substituto com DataSync. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*" } } } ] } ``` ------ + Permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. O exemplo a seguir faz isso incluindo a ação `s3:PutObject` somente para um prefixo específico (`reports/`) em seu bucket. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action": [ "s3:PutObject" ], "Effect": "Allow", "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*" }] } ``` ------ + Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a [política da chave](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). ## Criar um relatório de tarefas somente resumido Você pode configurar um relatório de tarefas que inclua um [resumo somente](task-reports.md#task-report-types-summary) ao criar sua DataSync tarefa, iniciá-la ou atualizá-la. As etapas a seguir mostram como configurar um relatório de tarefas somente resumido 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, 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. Role para baixo até a seção **Relatório de tarefa**. Em **Tipo de relatório**, escolha **Resumo somente**. 1. Para o **bucket do S3 para relatórios**, escolha um bucket do S3 no qual você deseja DataSync fazer o upload do seu relatório de tarefas. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. 1. Em **Pasta**, insira um prefixo para usar no seu relatório de tarefas ao DataSync carregar o relatório no seu bucket do S3 (por exemplo,). **reports/** Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. 1. Em **Perfil do IAM**, siga um destes procedimentos: + Escolha **Autogenerate** para criar DataSync automaticamente uma função do IAM com as permissões necessárias para acessar o bucket do S3. Se uma função do IAM foi criada DataSync anteriormente para esse bucket do S3, essa função é escolhida por padrão. + Escolha um perfil do IAM personalizado que você criou. Em alguns casos, talvez seja necessário criar o perfil por conta própria. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). 1. Conclua a criação da tarefa e, em seguida, [inicie a tarefa](run-task.md) para começar a transferir seus dados. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ### Usando o AWS CLI 1. Copie o seguinte comando `create-task` AWS Command Line Interface (AWS CLI): ``` 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 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"SUMMARY_ONLY" }' ``` 1. Para o parâmetro `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de origem na transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `12345678abcdefgh` substitua pelo ID do local de origem apropriado. 1. No parâmetro `--destination-location-arn`, especifique o ARN do local de destino em sua transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `abcdefgh12345678` substitua pelo ID do local de destino apropriado. 1. No parâmetro `--task-report-config` faça o seguinte: + `Subdirectory`— `reports/` Substitua pelo prefixo no bucket do S3 em que você deseja DataSync fazer o upload dos relatórios de tarefas. Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. + `S3BucketArn`: especifique o ARN do bucket do S3 no qual deseja fazer upload do relatório de tarefa. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefas se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique `SUMMARY_ONLY`. Para obter mais informações, consulte [Relatórios de tarefas somente resumidos](task-reports.md#task-report-types-summary). 1. Execute o comando `create-task` para criar sua tarefa. Você recebe uma resposta como a seguinte, que mostra o ARN da tarefa que você criou. Você precisará desse ARN para executar o comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie o seguinte comando `start-task-execution`: ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para o parâmetro `--task-arn`, especifique o ARN da tarefa que você está iniciando. Use o ARN que você recebeu ao executar o comando `create-task`. 1. Execute o comando `start-task-execution`. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ## Criar um relatório de tarefas padrão Você pode configurar um [relatório de tarefas padrão](task-reports.md#task-report-types-standard) ao criar sua DataSync tarefa, iniciá-la ou atualizá-la. As etapas a seguir mostram como configurar um relatório de tarefas padrão 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, 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. Role para baixo até a seção **Relatório de tarefa**. Em **Relatório de tarefa**, escolha **Relatório padrão**. 1. Em **Nível de relatório**, escolha uma das seguintes opções: + **Somente erros** — Seu relatório de tarefas inclui apenas problemas com o que você DataSync tentou transferir, ignorar, verificar e excluir. + **Sucessos e erros** — Seu relatório de tarefas inclui o que foi transferido, ignorado, verificado e excluído DataSync com sucesso e o que não foi. + **Personalizado**: permite que você escolha se deseja ver somente erros ou sucessos e erros em aspectos específicos do seu relatório de tarefas. Por exemplo, você pode escolher **Sucessos e erros** para a lista de arquivos transferidos, mas **Somente erros** para o restante do relatório. 1. Se você estiver transferindo para um bucket do S3 que usa controle de versão de objetos, mantenha a opção ** Incluir versões de objetos do Amazon S3** selecionada se quiser que seu relatório inclua a nova versão para cada objeto transferido. 1. Para o **bucket do S3 para relatórios**, escolha um bucket do S3 no qual você deseja DataSync fazer o upload do seu relatório de tarefas. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefa se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. 1. Em **Pasta**, insira um prefixo para usar no seu relatório de tarefas ao DataSync carregar o relatório no seu bucket do S3 (por exemplo,). **reports/** Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. 1. Em **Perfil do IAM**, siga um destes procedimentos: + Escolha **Autogenerate** para criar DataSync automaticamente uma função do IAM com as permissões necessárias para acessar o bucket do S3. Se uma função do IAM foi criada DataSync anteriormente para esse bucket do S3, essa função é escolhida por padrão. + Escolha um perfil do IAM personalizado que você criou. Em alguns casos, talvez seja necessário criar o perfil por conta própria. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). 1. Conclua a criação da tarefa e [inicie a tarefa](run-task.md) para começar a transferir seus dados. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md). ### 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 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"STANDARD", "ReportLevel":"level-of-detail", "ObjectVersionIds":"include-or-not" }' ``` 1. Para o parâmetro `--source-location-arn`, especifique o ARN do local de origem na transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `12345678abcdefgh` substitua pelo ID do local de origem apropriado. 1. No parâmetro `--destination-location-arn`, especifique o ARN do local de destino em sua transferência. `us-east-1`Substitua pelo apropriado Região da AWS, `123456789012` substitua pelo Conta da AWS número apropriado e `abcdefgh12345678` substitua pelo ID do local de destino apropriado. 1. No parâmetro `--task-report-config` faça o seguinte: + `Subdirectory`— `reports/` Substitua pelo prefixo no bucket do S3 em que você deseja DataSync fazer o upload dos relatórios de tarefas. Certifique-se de incluir o caractere delimitador apropriado no final do prefixo. Esse caractere geralmente é uma barra para frente (`/`). Para obter mais informações, consulte [Organizando objetos usando prefixos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) no *Guia de usuário do Amazon S3*. + `S3BucketArn`: especifique o ARN do bucket do S3 no qual deseja fazer upload do relatório de tarefa. **dica** Se você planeja transferir dados para um bucket do S3, não use o mesmo bucket para seu relatório de tarefas se você [desativar a opção **Manter arquivos excluídos**](configure-metadata.md). Caso contrário, DataSync excluirá todos os relatórios de tarefas anteriores sempre que você executar uma tarefa, pois esses relatórios não existem no seu local de origem. + `BucketAccessRoleArn`— Especifique a função do IAM que permite DataSync fazer o upload de um relatório de tarefas para seu bucket do S3. Para obter mais informações, consulte [Permita DataSync o upload de relatórios de tarefas para seu bucket do S3](#task-report-access). **Importante** Se seu bucket do S3 for criptografado com uma chave SSE-KMS gerenciada pelo cliente, a política da chave deverá incluir a função do IAM DataSync usada para acessar o bucket. Para obter mais informações, consulte [Acessar buckets do S3 usando criptografia no lado do servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique o relatório `STANDARD`. Para obter mais informações sobre tipos de dados, consulte [Relatórios de tarefas padrão](task-reports.md#task-report-types-standard)Tipos de relatórios de tarefas. + (Opcional) `ReportLevel`: especifique se você deseja `ERRORS_ONLY` (o padrão) ou `SUCCESSES_AND_ERRORS` em seu relatório. + (Opcional) `ObjectVersionIds`: se você estiver fazendo uma transferência para um bucket do S3 que usa controle de versionamento de objetos, especifique `NONE` se não deseja incluir a nova versão de cada objeto transferido no relatório. Essa opção é definida como `INCLUDE` por padrão. + (Opcional) `Overrides`: personalize o `ReportLevel` de um aspecto específico do seu relatório. Por exemplo, talvez você queira ver `SUCCESSES_AND_ERRORS` a lista do que é DataSync excluído em seu local de destino, mas quer ver todo `ERRORS_ONLY` o resto. Neste exemplo, você adicionaria a seguinte opção `Overrides` ao parâmetro `--task-report-config`: ``` "Overrides":{ "Deleted":{ "ReportLevel":"SUCCESSES_AND_ERRORS" } } ``` Se você não usar `Overrides`, todo o relatório usará o `ReportLevel` que você especificar. 1. Execute o comando `create-task` para criar sua tarefa. Você recebe uma resposta como a seguinte, que mostra o ARN da tarefa que você criou. Você precisará desse ARN para executar o comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie o seguinte comando `start-task-execution`: ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para o parâmetro `--task-arn`, especifique o ARN da tarefa que você está executando. Use o ARN que você recebeu ao executar o comando `create-task`. 1. Execute o comando `start-task-execution`. Quando sua transferência estiver concluída, você poderá [visualizar seu relatório de tarefa](task-report-viewing.md).