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á. # DescribeTaskExecution Fornece informações sobre a execução de sua AWS DataSync tarefa. Você pode usar essa operação para ajudar a monitorar o progresso de uma transferência de dados em andamento ou verificar os resultados da transferência. **nota** Alguns elementos da resposta `DescribeTaskExecution` são relevantes somente para um modo de tarefa específico. Para obter informações, consulte [Como entender as diferenças do modo de tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) e [Como entender os contadores de desempenho da transferência de dados](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html). ## Sintaxe da solicitação ``` { "TaskExecutionArn": "string" } ``` ## Parâmetros da solicitação Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) ** Especifica o nome do recurso da Amazon (ARN) da execução da tarefa sobre a qual você deseja informações. Tipo: string Restrições de tamanho: tamanho máximo de 128. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` Obrigatório: sim ## Sintaxe da resposta ``` { "BytesCompressed": number, "BytesTransferred": number, "BytesWritten": number, "EndTime": number, "EstimatedBytesToTransfer": number, "EstimatedFilesToDelete": number, "EstimatedFilesToTransfer": number, "EstimatedFoldersToDelete": number, "EstimatedFoldersToTransfer": number, "Excludes": [ { "FilterType": "string", "Value": "string" } ], "FilesDeleted": number, "FilesFailed": { "Delete": number, "Prepare": number, "Transfer": number, "Verify": number }, "FilesListed": { "AtDestinationForDelete": number, "AtSource": number }, "FilesPrepared": number, "FilesSkipped": number, "FilesTransferred": number, "FilesVerified": number, "FoldersDeleted": number, "FoldersFailed": { "Delete": number, "List": number, "Prepare": number, "Transfer": number, "Verify": number }, "FoldersListed": { "AtDestinationForDelete": number, "AtSource": number }, "FoldersPrepared": number, "FoldersSkipped": number, "FoldersTransferred": number, "FoldersVerified": number, "Includes": [ { "FilterType": "string", "Value": "string" } ], "LaunchTime": number, "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "ReportResult": { "ErrorCode": "string", "ErrorDetail": "string", "Status": "string" }, "Result": { "ErrorCode": "string", "ErrorDetail": "string", "PrepareDuration": number, "PrepareStatus": "string", "TotalDuration": number, "TransferDuration": number, "TransferStatus": "string", "VerifyDuration": number, "VerifyStatus": "string" }, "StartTime": number, "Status": "string", "TaskExecutionArn": "string", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) ** O número de bytes físicos que são DataSync transferidos pela rede após a compactação (se a compactação for possível). Tipicamente, esse número é menor do que [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred), a menos que os dados não sejam compactáveis. Tipo: longo ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** O número de bytes DataSync enviados para a rede antes da compactação (se a compactação for possível). Para saber o número de bytes transferidos pela rede, consulte [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed). Tipo: longo ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** O número de bytes lógicos que DataSync realmente gravam no local de destino. Tipo: longo ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** A hora em que a tarefa de transferência termina. Tipo: Timestamp ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** O número de bytes lógicos que DataSync esperam gravar no local de destino. Tipo: longo ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que você DataSync espera excluir no local de destino. Se você não [configurar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). Tipo: longo ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que DataSync esperam ser transferidos pela rede. Esse valor é calculado enquanto DataSync [prepara](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) a transferência. Como isso é calculado depende principalmente da configuração de [modo de transferência](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) da tarefa: + Se `TranserMode` estiver definido como `CHANGED`: o cálculo será baseado na comparação do conteúdo dos locais de origem e na diferença e na determinação da diferença que precisa ser transferida. A diferença pode incluir: + Tudo o que for adicionado ou modificado no local de origem. + Qualquer coisa que esteja nos dois locais e modificada no destino após uma transferência inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esteja configurada como`NEVER`). + **(Somente no modo de tarefa básica)** O número de itens que DataSync espera excluir (se [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)estiver definido como`REMOVE`). + Se `TranserMode` estiver definido como `ALL` - O cálculo é baseado somente nos itens DataSync encontrados no local de origem. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). Tipo: longo ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que você DataSync espera excluir em seu local de destino. Se você não [configurar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que DataSync esperam ser transferidos pela rede. Esse valor é calculado à medida que DataSync [prepara os](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) diretórios para transferência. Como isso é calculado depende principalmente da configuração de [modo de transferência](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) da tarefa: + Se `TranserMode` estiver definido como `CHANGED`: o cálculo será baseado na comparação do conteúdo dos locais de origem e na diferença e na determinação da diferença que precisa ser transferida. A diferença pode incluir: + Tudo o que for adicionado ou modificado no local de origem. + Qualquer coisa que esteja nos dois locais e modificada no destino após uma transferência inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esteja configurada como`NEVER`). + Se `TranserMode` estiver definido como `ALL` - O cálculo é baseado somente nos itens DataSync encontrados no local de origem. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** Uma lista de regras de filtro que excluem dados específicos durante a transferência. Para obter mais informações e exemplos, consulte [Filtragem de dados transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que DataSync realmente são excluídos em seu local de destino. Se você não [configurar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). Tipo: longo ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos ou objetos que DataSync falham na preparação, transferência, verificação e exclusão durante a execução da tarefa. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: objeto [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos ou objetos DataSync encontrados em seus locais. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: objeto [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos ou objetos que DataSync tentarão ser transferidos depois de comparar seus locais de origem e destino. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Esse contador não é aplicável se você configurar a tarefa para [transferir todos os dados](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Nesse cenário, DataSync copia tudo da origem ao destino sem comparar as diferenças entre os locais. Tipo: longo ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que são DataSync ignorados durante a transferência. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). Tipo: longo ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que DataSync realmente são transferidos pela rede. Esse valor é atualizado periodicamente durante a fase de execução da tarefa, quando algo é lido na fonte e enviado pela rede. Se DataSync não conseguir transferir algo, esse valor pode ser menor que`EstimatedFilesToTransfer`. Em alguns casos, esse valor também pode ser maior que `EstimatedFilesToTransfer`. Esse elemento é específico da implementação para alguns tipos de local e, portanto, não o use como uma indicação exata do que está sendo transferido nem para monitorar a execução da tarefa. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). Tipo: longo ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** O número de arquivos, objetos e diretórios que são DataSync verificados durante a transferência. Quando você configura sua tarefa para [verificar somente os dados transferidos](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync não verifica diretórios em algumas situações ou arquivos que falham na transferência. Para [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), esse contador inclui somente arquivos ou objetos. Os diretórios são contados [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). Tipo: longo ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que DataSync realmente são excluídos em seu local de destino. Se você não [configurar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para excluir os dados no destino que não estão na origem, o valor sempre será `0`. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que DataSync não conseguem listar, preparar, transferir, verificar e excluir durante a execução da tarefa. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: objeto [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios DataSync encontrados em seus locais. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: objeto [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que DataSync tentarão transferir depois de comparar seus locais de origem e destino. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Esse contador não é aplicável se você configurar a tarefa para [transferir todos os dados](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Nesse cenário, DataSync copia tudo da origem ao destino sem comparar as diferenças entre os locais. Tipo: longo ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que são DataSync ignorados durante sua transferência. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que DataSync realmente são transferidos pela rede. Esse valor é atualizado periodicamente durante a fase de execução da tarefa, quando algo é lido na fonte e enviado pela rede. Se DataSync não conseguir transferir algo, esse valor pode ser menor que`EstimatedFoldersToTransfer`. Em alguns casos, esse valor também pode ser maior que `EstimatedFoldersToTransfer`. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** O número de diretórios que são DataSync verificados durante sua transferência. Aplica-se somente às [tarefas do modo Avançado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: longo ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** Uma lista de regras de filtro que incluem dados específicos durante a transferência. Para obter mais informações e exemplos, consulte [Filtragem de dados transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** A hora em que a execução da tarefa realmente começa. Para tarefas que não estão em fila, `LaunchTime` e `StartTime` geralmente são as mesmas. Para tarefas em fila, geralmente `LaunchTime` é mais tarde do que `StartTime` porque as tarefas anteriormente na fila devem terminar de ser executadas antes que as mais recentes possam começar. Tipo: Timestamp ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** A configuração do manifesto que lista os arquivos ou os objetos que você deseja transferir. Para obter mais informações, consulte [Especificando quais DataSync transferências usando um manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Tipo: objeto [ManifestConfig](API_ManifestConfig.md) ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** Indica como sua tarefa de transferência está configurada. Essas opções incluem como DataSync manipula arquivos, objetos e seus metadados associados durante a transferência. Você também pode especificar como verificar a integridade dos dados, definir limites de largura de banda para sua tarefa, entre outras opções. Cada opção tem um valor padrão. A menos que seja necessário, você não precisa configurar nenhuma opção antes de ligar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Você também pode substituir suas opções de tarefa para cada execução de tarefa. Por exemplo, pode ser bom ajustar o `LogLevel` para uma execução individual. Tipo: objeto [Options](API_Options.md) ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** Indica se DataSync gerou um [relatório de tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) completo para sua transferência. Tipo: objeto [ReportResult](API_ReportResult.md) ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** O resultado da execução da tarefa. Tipo: objeto [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** A hora em que a solicitação é DataSync enviada para iniciar a execução da tarefa. Para tarefas que não estão em fila, `LaunchTime` e `StartTime` geralmente são as mesmas. Para tarefas em fila, geralmente `LaunchTime` é mais tarde do que `StartTime` porque as tarefas anteriormente na fila devem terminar de ser executadas antes que as mais recentes possam começar. Tipo: Timestamp ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** O status da execução da tarefa. Para obter informações detalhadas sobre os status de execução de tarefas, consulte [Status de execução de tarefas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Tipo: string Valores válidos: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** O ARN da execução da tarefa sobre a qual deseja obter informações. O `TaskExecutionArn` é hierárquico e inclui `TaskArn` para a tarefa que foi executada. Por exemplo, um valor `TaskExecution` com o ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` executou a tarefa com o ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`. Tipo: string Restrições de tamanho: tamanho máximo de 128. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) ** O modo de tarefa que você está usando. Para obter mais informações, consulte [Como escolher um modo de tarefa para a transferência de dados](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Tipo: string Valores válidos: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** A configuração do seu relatório de tarefas, que fornece informações detalhadas sobre sua DataSync transferência. Para obter mais informações, consulte [Criar uma relatório de tarefas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md) ## Erros Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Erros comuns](CommonErrors.md). ** InternalException ** Essa exceção é lançada quando ocorre um erro no serviço AWS DataSync . Código de status HTTP: 500 ** InvalidRequestException ** Essa exceção é lançada quando o cliente envia uma solicitação malformada. Código de status HTTP: 400 ## Exemplos ### Exemplo de solicitação Este exemplo ilustra uma solicitação `DescribeTaskExecution`. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### Exemplo de resposta 1 para uma execução de tarefa no modo Avançado O exemplo a seguir descreve a execução de uma DataSync tarefa que usa o modo Avançado. A execução também transfere dados específicos usando filtros de exclusão e inclusão. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "BASIC", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/archive-files" }], "Includes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/files" }], "StartTime": "2024-10-16T11:19:56.844000-04:00", "EstimatedFilesToTransfer": 7, "EstimatedFoldersToTransfer": 2, "EstimatedBytesToTransfer": 30, "FilesTransferred": 7, "FoldersTransferred": 2, "BytesWritten": 30, "BytesTransferred": 30, "BytesCompressed": 30, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3310, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 7, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 7, "FilesListed": { "AtSource": 7, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 2, "FoldersPrepared": 2, "FoldersListed": { "AtSource": 2, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Exemplo de resposta 2 para uma execução de tarefa no modo Avançado O exemplo a seguir descreve outra execução de DataSync tarefa que usa o modo Avançado. Nessa situação, a execução está transferindo dados específicos usando um manifesto em vez de filtros. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "TRANSFER", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [], "Includes": [], "ManifestConfig": { "Action": "TRANSFER", "Format": "CSV", "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess", "S3Bucket": "arn:aws:s3:::manifests-datasync", "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG", "Source": { "S3": { "ManifestObjectPath": "manifest-folder/manifest-versioned-files", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess", "S3BucketArn": "arn:aws:s3:::manifests-datasync", "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG" } } }, "StartTime": "2024-10-16T09:29:56.757000-04:00", "EstimatedFilesToTransfer": 1, "EstimatedFoldersToTransfer": 0, "EstimatedBytesToTransfer": 6, "FilesTransferred": 1, "FoldersTransferred": 1, "BytesWritten": 6, "BytesTransferred": 6, "BytesCompressed": 6, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3089, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "TaskReportConfig": { "Destination": { "S3": { "Subdirectory": "reports/", "S3BucketArn": "arn:aws:s3:::my-task-report", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess" } }, "OutputType": "STANDARD", "ReportLevel": "SUCCESSES_AND_ERRORS", "ObjectVersionIds": "INCLUDE" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 1, "ReportResult": { "Status": "SUCCESS" }, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 1, "FilesListed": { "AtSource": 1, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 0, "FoldersPrepared": 0, "FoldersListed": { "AtSource": 0, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Exemplo de resposta para a execução de uma tarefa no modo Básico O exemplo a seguir descreve a execução de uma DataSync tarefa que usa o modo Básico. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "SUCCESS", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": "2024-10-16T11:19:56.844000-04:00", "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)