Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # CreateTask Configura un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati. Un'attività include una posizione di origine, una posizione di destinazione e opzioni di trasferimento (come limiti di larghezza di banda, pianificazione e altro). **Importante** Se hai intenzione di trasferire dati da o verso una sede Amazon S3, consulta in che [modo DataSync possono influire sui costi delle richieste S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) e sulla [pagina dei DataSync prezzi](https://aws.amazon.com/datasync/pricing/) prima di iniziare. ## Sintassi della richiesta ``` { "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" } } ``` ## Parametri della richiesta Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md). La richiesta accetta i seguenti dati in formato JSON. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** Speciifica l'Amazon Resource Name (ARN) di un gruppo di log CloudWatch Amazon per il monitoraggio dell'attività. Per le attività in modalità avanzata, non è necessario specificare nulla. DataSyncinvia automaticamente i log a un gruppo di CloudWatch log denominato`/aws/datasync`. Per ulteriori informazioni, vedere [Monitoraggio dei trasferimenti di dati con i CloudWatch registri](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Tipo: String Vincoli di lunghezza: lunghezza massima di 562. Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obbligatorio: no ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Specifica l'ARN della località di destinazione del trasferimento. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^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}$` Obbligatorio: sì ** [Excludes](#API_CreateTask_RequestSyntax) ** Speciifica i filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non si desidera DataSync trasferire. Per ulteriori informazioni ed esempi, consulta [Specificare DataSync i trasferimenti utilizzando i filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matrice di oggetti [FilterRule](API_FilterRule.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento. Obbligatorio: no ** [Includes](#API_CreateTask_RequestSyntax) ** Le specifiche includono i filtri che definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire nella posizione di origine. Per ulteriori informazioni ed esempi, vedere [Specificazione dei DataSync trasferimenti mediante filtri](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matrice di oggetti [FilterRule](API_FilterRule.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento. Obbligatorio: no ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** Configura un manifesto, che è un elenco di file o oggetti che si desidera DataSync trasferire. Per ulteriori informazioni ed esempi di configurazione, vedere [Specificazione degli elementi da DataSync trasferire utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione. Tipo: oggetto [ManifestConfig](API_ManifestConfig.md) Obbligatorio: no ** [Name](#API_CreateTask_RequestSyntax) ** Specificate il nome dell'attività. Tipo: String Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri. Modello: `^[a-zA-Z0-9\s+=._:@/-]+$` Obbligatorio: no ** [Options](#API_CreateTask_RequestSyntax) ** Speciifica le impostazioni dell'attività, come la conservazione dei metadati dei file, la verifica dell'integrità dei dati, tra le altre opzioni. Tipo: oggetto [Options](API_Options.md) Obbligatorio: no ** [Schedule](#API_CreateTask_RequestSyntax) ** Specificate una pianificazione per quando desiderate che l'attività venga eseguita. Per ulteriori informazioni, vedere [Pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Tipo: oggetto [TaskSchedule](API_TaskSchedule.md) Obbligatorio: no ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Specifica l'ARN della posizione di origine del trasferimento. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^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}$` Obbligatorio: sì ** [Tags](#API_CreateTask_RequestSyntax) ** Specificate i tag da applicare all'attività. I *tag* sono coppie chiave-valore che consentono di gestire, filtrare e cercare le risorse. DataSync Tipo: matrice di oggetti [TagListEntry](API_TagListEntry.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item. Obbligatorio: no ** [TaskMode](#API_CreateTask_RequestSyntax) ** Specifica una delle seguenti modalità di attività per il trasferimento dei dati: + `ENHANCED`- Trasferisci un numero virtualmente illimitato di oggetti con prestazioni superiori rispetto alla modalità Basic. Le attività in modalità avanzata ottimizzano il processo di trasferimento dei dati elencando, preparando, trasferendo e verificando i dati in parallelo. La modalità avanzata è attualmente disponibile per i trasferimenti tra sedi Amazon S3, i trasferimenti tra Azure Blob e Amazon S3 senza un agente e i trasferimenti tra altri cloud e Amazon S3 senza agente. **Nota** Per creare un'attività in modalità avanzata, il ruolo IAM utilizzato per chiamare l'`CreateTask`operazione deve disporre dell'autorizzazione. `iam:CreateServiceLinkedRole` + `BASIC`(impostazione predefinita): trasferisci file o oggetti tra l' AWS archiviazione e tutte le altre DataSync posizioni supportate. Le attività in modalità base sono soggette a [quote](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sul numero di file, oggetti e directory in un set di dati. La modalità base prepara, trasferisce e verifica i dati in modo sequenziale, rendendola più lenta della modalità avanzata per la maggior parte dei carichi di lavoro. [Per ulteriori informazioni, vedere Comprensione delle differenze tra le modalità di attività.](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) Tipo: String Valori validi: `BASIC | ENHANCED` Campo obbligatorio: no ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** Specifica come si desidera configurare un rapporto sulle attività, che fornisce informazioni dettagliate sul DataSync trasferimento. Per ulteriori informazioni, consulta [Monitoraggio dei DataSync trasferimenti con i report sulle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Quando si utilizza questo parametro, l'identità del chiamante (il ruolo DataSync con cui si utilizza) deve disporre dell'`iam:PassRole`autorizzazione. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politica include questa autorizzazione. Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md) Obbligatorio: no ## Sintassi della risposta ``` { "TaskArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** L'Amazon Resource Name (ARN) dell'attività. Tipo: String Limitazioni di lunghezza: lunghezza massima di 128. Modello: `^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}$` ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md). ** InternalException ** Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio. Codice di stato HTTP: 500 ** InvalidRequestException ** Questa eccezione viene generata quando il client invia una richiesta non valida. Codice di stato HTTP: 400 ## Esempi ### Esempio di richiesta per un'attività in modalità avanzata L'esempio seguente crea un' DataSync attività che utilizza la modalità avanzata. A differenza di quando si creano attività in modalità Basic, non è necessario specificare un gruppo di CloudWatch log Amazon. Con le attività in modalità avanzata, invia DataSync automaticamente i log delle attività a un gruppo di log denominato`/aws/datasync`. Se quel gruppo di log non esiste nel tuo Regione AWS, DataSync crea il gruppo di log per tuo conto quando crei l'attività. ``` { "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" } } ``` ### Esempio di richiesta per un'attività in modalità Basic L'esempio seguente crea un' DataSync attività che utilizza la modalità Basic. ``` { "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" } ] } ``` ### Risposta di esempio La risposta seguente include l'ARN di un'attività creata. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)