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á. # CreateTask Configura uma *tarefa* de transferência, que define onde e como o AWS DataSync transfere os dados. Uma tarefa inclui um local de origem, um local de destino e opções de transferência (como limites de largura de banda, agendamento etc.). **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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) e a [página de DataSync preços](https://aws.amazon.com/datasync/pricing/) antes de começar. ## Sintaxe da solicitação ``` { "CloudWatchLogGroupArn": "string", "DestinationLocationArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "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" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "SourceLocationArn": "string", "Tags": [ { "Key": "string", "Value": "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" } } ``` ## 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. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** Especifica o Amazon Resource Name (ARN) de um grupo de logs da CloudWatch Amazon para monitorar sua tarefa. Para tarefas do modo Avançado, você não precisa especificar nada. DataSyncenvia automaticamente os registros para um grupo de CloudWatch registros chamado`/aws/datasync`. Para obter mais informações, consulte [Monitoramento de transferências de dados com o CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Tipo: string Restrições de tamanho: tamanho máximo de 562. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obrigatório: não ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Especifica o ARN do local de destino da transferência. 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}:location/loc-[0-9a-z]{17}$` Obrigatório: Sim ** [Excludes](#API_CreateTask_RequestSyntax) ** Especifica filtros de exclusão que definem os arquivos, objetos e pastas em seu local de origem que você não deseja DataSync transferir. Para obter mais informações e exemplos, consulte [Especificação do que é DataSync transferido usando filtros](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. Obrigatório: não ** [Includes](#API_CreateTask_RequestSyntax) ** Especifica a inclusão de filtros que definem os arquivos, objetos e pastas no local de origem que você deseja DataSync transferir. Para obter mais informações e exemplos, consulte [Especificação do que é DataSync transferido usando filtros](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. Obrigatório: não ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** Configura um manifesto, que é uma lista de arquivos ou objetos que você deseja DataSync transferir. Para obter mais informações e exemplos de configuração, consulte [Especificação do que é DataSync transferido usando um manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Ao usar esse parâmetro, sua identidade de chamador (a função DataSync com a qual você está usando) deve ter a `iam:PassRole` permissão. A [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política inclui essa permissão. Tipo: objeto [ManifestConfig](API_ManifestConfig.md) Obrigatório: não ** [Name](#API_CreateTask_RequestSyntax) ** Especifica o nome da tarefa. Tipo: string Restrições de tamanho: o tamanho mínimo é 0. O tamanho máximo é 256. Padrão: `^[a-zA-Z0-9\s+=._:@/-]+$` Obrigatório: não ** [Options](#API_CreateTask_RequestSyntax) ** Especifica as configurações da tarefa, como preservar os metadados do arquivo, verificar a integridade dos dados, entre outras opções. Tipo: objeto [Options](API_Options.md) Obrigatório: não ** [Schedule](#API_CreateTask_RequestSyntax) ** Especifica um agendamento de quando você deseja que a tarefa seja executada. Para obter mais informações, consulte [Programar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Tipo: objeto [TaskSchedule](API_TaskSchedule.md) Obrigatório: não ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Especifica o ARN do local de origem da transferência. 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}:location/loc-[0-9a-z]{17}$` Obrigatório: Sim ** [Tags](#API_CreateTask_RequestSyntax) ** Especifica as tags que você deseja aplicar à tarefa. As *tags* são pares de valores-chave que ajudam você a gerenciar, filtrar e pesquisar seus DataSync recursos. Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens. Obrigatório: não ** [TaskMode](#API_CreateTask_RequestSyntax) ** Especifica um dos seguintes modos de tarefa para a transferência de dados: + `ENHANCED`: transfira um número praticamente ilimitado de 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 avançado está disponível para transferências entre locais do Amazon S3, transferências entre Azure Blob e o Amazon S3 sem um atendente e transferências entre outras nuvens e o Amazon S3 sem um atendente. **nota** Para criar uma tarefa no modo Avançado, o perfil do IAM que você usa para chamar a operação `CreateTask` precisa ter a permissão `iam:CreateServiceLinkedRole`. + `BASIC`(padrão) - 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](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) 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. Para obter mais 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). Tipo: string Valores válidos: `BASIC | ENHANCED` Obrigatório: não ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** Especifica como você deseja configurar um relatório de tarefas, que fornece informações detalhadas sobre sua DataSync transferência. Para obter mais informações, consulte [Monitorando suas DataSync transferências com relatórios de tarefas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Ao usar esse parâmetro, sua identidade de chamador (a função DataSync com a qual você está usando) deve ter a `iam:PassRole` permissão. A [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política inclui essa permissão. Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md) Obrigatório: não ## Sintaxe da resposta ``` { "TaskArn": "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. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** O nome do recurso da Amazon (ARN) da tarefa. 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}$` ## 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 ### Solicitação de amostra para uma tarefa no modo Avançado O exemplo a seguir cria uma DataSync tarefa que usa o modo Avançado. Ao contrário da criação de tarefas no modo Básico, você não precisa especificar um grupo de CloudWatch registros da Amazon. Com as tarefas do modo Avançado, envia DataSync automaticamente os registros de tarefas para um grupo de registros chamado`/aws/datasync`. Se esse grupo de registros não existir no seu Região da AWS, DataSync criará o grupo de registros em seu nome ao criar a tarefa. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2", "Name": "My Enhanced mode task", "TaskMode": "ENHANCED", "Options": { "TransferMode": "CHANGED", "VerifyMode": "ONLY_FILES_TRANSFERRED", "ObjectTags": "PRESERVE", "LogLevel": "TRANSFER" } } ``` ### Solicitação de amostra para uma tarefa do modo Básico O exemplo a seguir cria uma DataSync tarefa que usa o modo Básico. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "Name": "My Basic mode task", "TaskMode": "BASIC", "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "ONLY_FILES_TRANSFERRED" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*", "Tags": [ { "Key": "Name", "Value": "Migration-wave-1" } ] } ``` ### Resposta da amostra A resposta a seguir inclui o ARN de uma tarefa criada. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## 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/CreateTask) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)