Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # UpdateTask Aktualisiert die Konfiguration einer *Aufgabe*, die definiert, wo und wie Ihre Daten AWS DataSync übertragen werden. ## Anforderungssyntax ``` { "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" } } ``` ## Anforderungsparameter Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) einer CloudWatch Amazon-Protokollgruppe zur Überwachung Ihrer Aufgabe an. Für Aufgaben im erweiterten Modus müssen Sie den Namen Ihrer Protokollgruppe verwenden`/aws/datasync`. Beispiel: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Weitere Informationen finden Sie unter [Überwachen von Datenübertragungen mit CloudWatch Protokollen](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Typ: Zeichenfolge Längenbeschränkungen: Die maximale Länge beträgt 562. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Erforderlich: Nein ** [Excludes](#API_UpdateTask_RequestSyntax) ** Gibt Ausschlussfilter an, die die Dateien, Objekte und Ordner in Ihrem Quellverzeichnis definieren, die Sie nicht übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [Includes](#API_UpdateTask_RequestSyntax) ** Gibt an, dass Include-Filter die Dateien, Objekte und Ordner an Ihrem Quellspeicherort definieren, die Sie übertragen DataSync möchten. Weitere Informationen und Beispiele finden Sie unter [Mithilfe von Filtern angeben, welche DataSync Übertragungen übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. Erforderlich: Nein ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** Konfiguriert ein Manifest, bei dem es sich um eine Liste von Dateien oder Objekten handelt, die Sie übertragen DataSync möchten. Weitere Informationen und Konfigurationsbeispiele finden Sie unter [Mithilfe eines Manifests angeben, was DataSync übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) soll. Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die IAM-Rolle, die Sie DataSync mit verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Berechtigung. Um eine Manifestkonfiguration zu entfernen, geben Sie diesen Parameter als leer an. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt Erforderlich: Nein ** [Name](#API_UpdateTask_RequestSyntax) ** Gibt den Namen Ihrer Aufgabe an. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$` Erforderlich: Nein ** [Options](#API_UpdateTask_RequestSyntax) ** Gibt an, wie Ihre Übertragungsaufgabe konfiguriert ist. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten während der Übertragung umgegangen wird. Sie können unter anderem auch angeben, wie die Datenintegrität überprüft werden soll, Bandbreitenlimits für Ihre Aufgabe festlegen. Jede Option hat einen Standardwert. Sofern Sie dies nicht möchten, müssen Sie vor dem Aufrufen keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Sie können Ihre Aufgabenoptionen auch für jede Aufgabenausführung überschreiben. Möglicherweise möchten Sie die `LogLevel` für eine einzelne Ausführung anpassen. Typ: [Options](API_Options.md) Objekt Erforderlich: Nein ** [Schedule](#API_UpdateTask_RequestSyntax) ** Gibt einen Zeitplan an, zu dem Ihre Aufgabe ausgeführt werden soll. Weitere Informationen finden Sie unter [Aufgabenplanung](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Typ: [TaskSchedule](API_TaskSchedule.md) Objekt Erforderlich: Nein ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Gibt den ARN der Aufgabe an, die Sie aktualisieren möchten. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^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}$` Erforderlich: Ja ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** Gibt an, wie Sie einen Aufgabenbericht konfigurieren möchten, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Überwachen Ihrer DataSync Übertragungen mit Aufgabenberichten](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Wenn Sie diesen Parameter verwenden, muss Ihre Anruferidentität (die IAM-Rolle, die Sie DataSync mit verwenden) über die `iam:PassRole` entsprechende Berechtigung verfügen. Die [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Richtlinie beinhaltet diese Berechtigung. Um eine Task-Berichtskonfiguration zu entfernen, geben Sie diesen Parameter als leer an. Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt Erforderlich: Nein ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md). ** InternalException ** Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)