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à. # StartTaskExecution Avvia un'operazione AWS DataSync di trasferimento. Per ogni attività, è possibile eseguire una sola operazione alla volta. L'esecuzione di un'attività prevede diversi passaggi. Per ulteriori informazioni, vedere [Stati di esecuzione delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses) **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 ``` { "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" } } }, "OverrideOptions": { "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" }, "Tags": [ { "Key": "string", "Value": "string" } ], "TaskArn": "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. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** Specifica un elenco di regole di filtro che determina quali file escludere da un'attività. L'elenco contiene una singola stringa di filtro costituita dai modelli da escludere. I modelli sono delimitati da "\$1" (cioè una barra verticale), ad esempio: `"/folder1|/folder2"`. 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_StartTaskExecution_RequestSyntax) ** Specifica un elenco di regole di filtro che determina quali file includere durante l'esecuzione di un'attività. Il modello deve contenere una singola stringa di filtro costituita dai modelli da includere. I modelli sono delimitati da "\$1" (cioè una barra verticale), ad esempio: `"/folder1|/folder2"`. 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_StartTaskExecution_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. Per rimuovere una configurazione del manifesto, specificate questo parametro con un valore vuoto. Tipo: oggetto [ManifestConfig](API_ManifestConfig.md) Obbligatorio: no ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni. Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore `LogLevel` per una singola esecuzione. Tipo: oggetto [Options](API_Options.md) Obbligatorio: no ** [Tags](#API_StartTaskExecution_RequestSyntax) ** Speciifica i tag da applicare all'Amazon Resource Name (ARN) che rappresenta l'esecuzione dell'attività. I *tag* sono coppie chiave-valore che ti aiutano a gestire, filtrare e cercare le tue 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 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** Specifica l'Amazon Resource Name (ARN) dell'attività che desideri avviare. 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}$` Obbligatorio: sì ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) ** Specifica come desideri configurare un report sulle attività, che fornisce informazioni dettagliate sul trasferimento. DataSync 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. Per rimuovere la configurazione di un report di attività, specificate questo parametro come vuoto. Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md) Obbligatorio: no ## Sintassi della risposta ``` { "TaskExecutionArn": "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. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** L'ARN dell'esecuzione dell'attività in esecuzione. 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}/execution/exec-[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 ### Richiesta di esempio L'esempio seguente avvia l'esecuzione di un'attività utilizzando le opzioni predefinite per l'attività specificata. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Risposta di esempio Questo esempio illustra un utilizzo di. StartTaskExecution ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 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/StartTaskExecution) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution)