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à. # UpdateTask Aggiorna la configurazione di un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati. ## Sintassi della richiesta ``` { "CloudWatchLogGroupArn": "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" }, "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. ** [CloudWatchLogGroupArn](#API_UpdateTask_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, devi utilizzare `/aws/datasync` come nome del gruppo di log. Esempio: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Per ulteriori informazioni, vedere [Monitoraggio dei trasferimenti di dati con CloudWatch i 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 ** [Excludes](#API_UpdateTask_RequestSyntax) ** Speciifica i filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non si desidera trasferire. DataSync 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_UpdateTask_RequestSyntax) ** I filtri di inclusione specificano 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 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 ** [ManifestConfig](#API_UpdateTask_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 IAM 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 come vuoto. Tipo: oggetto [ManifestConfig](API_ManifestConfig.md) Obbligatorio: no ** [Name](#API_UpdateTask_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_UpdateTask_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 ** [Schedule](#API_UpdateTask_RequestSyntax) ** Specificate una pianificazione in base alla quale 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 ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Specificare l'ARN dell'attività che si desidera aggiornare. 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_UpdateTask_RequestSyntax) ** Specifica come si desidera configurare un rapporto 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 utilizzi questo parametro, l'identità del chiamante (il ruolo IAM DataSync con cui stai utilizzando) 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 ## Elementi di risposta Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto. ## 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 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)