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. # CreateTask Konfiguriert eine *Aufgabe*, die definiert, wo und wie Ihre Daten AWS DataSync übertragen werden. Eine Aufgabe umfasst einen Quellstandort, einen Zielort und Übertragungsoptionen (wie Bandbreitenbeschränkungen, Planung und mehr). **Wichtig** Wenn Sie planen, Daten zu oder von einem Amazon S3 S3-Standort zu übertragen, lesen Sie zunächst, [wie sich dies auf Ihre S3-Anforderungsgebühren auswirken DataSync kann](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests), sowie auf der [DataSync Preisseite](https://aws.amazon.com/datasync/pricing/). ## Anforderungssyntax ``` { "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" } } ``` ## 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_CreateTask_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) einer CloudWatch Amazon-Protokollgruppe zur Überwachung Ihrer Aufgabe an. Für Aufgaben im erweiterten Modus müssen Sie nichts angeben. DataSyncsendet automatisch Protokolle an eine CloudWatch Protokollgruppe mit dem Namen`/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 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Gibt den ARN des Zielorts Ihrer Übertragung an. 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}:location/loc-[0-9a-z]{17}$` Erforderlich: Ja ** [Excludes](#API_CreateTask_RequestSyntax) ** Gibt Ausschlussfilter an, die die Dateien, Objekte und Ordner an Ihrem Quellspeicherort 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_CreateTask_RequestSyntax) ** Gibt Inklusivfilter an, die 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_CreateTask_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 Rolle, DataSync mit der Sie ihn 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 Erlaubnis. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt Erforderlich: Nein ** [Name](#API_CreateTask_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_CreateTask_RequestSyntax) ** Gibt die Einstellungen Ihrer Aufgabe an, z. B. die Beibehaltung von Dateimetadaten, die Überprüfung der Datenintegrität und andere Optionen. Typ: [Options](API_Options.md) Objekt Erforderlich: Nein ** [Schedule](#API_CreateTask_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 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Gibt den ARN des Quellorts Ihrer Übertragung an. 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}:location/loc-[0-9a-z]{17}$` Erforderlich: Ja ** [Tags](#API_CreateTask_RequestSyntax) ** Gibt die Tags an, die Sie auf Ihre Aufgabe anwenden möchten. *Stichwörter* sind Schlüssel-Wert-Paare, die Ihnen helfen, Ihre DataSync Ressourcen zu verwalten, zu filtern und nach ihnen zu suchen. Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Nein ** [TaskMode](#API_CreateTask_RequestSyntax) ** Gibt einen der folgenden Aufgabenmodi für Ihre Datenübertragung an: + `ENHANCED`- Übertragen Sie eine praktisch unbegrenzte Anzahl von Objekten mit höherer Leistung als im Basismodus. Aufgaben im erweiterten Modus optimieren den Datenübertragungsprozess, indem sie Daten parallel auflisten, vorbereiten, übertragen und verifizieren. Der erweiterte Modus ist derzeit für Übertragungen zwischen Amazon S3-Standorten, Übertragungen zwischen Azure Blob und Amazon S3 ohne Agenten und Übertragungen zwischen anderen Clouds und Amazon S3 ohne Agenten verfügbar. **Anmerkung** Um eine Aufgabe im erweiterten Modus zu erstellen, muss die IAM-Rolle, mit der Sie den `CreateTask` Vorgang aufrufen, über die entsprechende Berechtigung verfügen. `iam:CreateServiceLinkedRole` + `BASIC`(Standard) — Übertragen Sie Dateien oder Objekte zwischen dem AWS Speicher und allen anderen unterstützten DataSync Speicherorten. Für Aufgaben im Basismodus gelten [Kontingente](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) für die Anzahl der Dateien, Objekte und Verzeichnisse in einem Datensatz. Im Basismodus werden Daten sequenziell vorbereitet, übertragen und überprüft, sodass er für die meisten Workloads langsamer ist als der erweiterte Modus. Weitere Informationen finden Sie unter [Grundlegendes zu Unterschieden im Aufgabenmodus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` Erforderlich: Nein ** [TaskReportConfig](#API_CreateTask_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 Rolle, DataSync mit der Sie ihn 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 Erlaubnis. Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt Erforderlich: Nein ## Antwortsyntax ``` { "TaskArn": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) der Aufgabe. 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}$` ## 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 ## Beispiele ### Beispielanforderung für eine Aufgabe im erweiterten Modus Im folgenden Beispiel wird eine DataSync Aufgabe erstellt, die den erweiterten Modus verwendet. Anders als bei der Erstellung von Aufgaben im Basismodus müssen Sie keine CloudWatch Amazon-Protokollgruppe angeben. Bei Aufgaben im erweiterten Modus werden Aufgabenprotokolle DataSync automatisch an eine Protokollgruppe mit dem Namen gesendet`/aws/datasync`. Wenn diese Protokollgruppe in Ihrer nicht vorhanden ist AWS-Region, DataSync erstellt die Protokollgruppe in Ihrem Namen, wenn Sie die Aufgabe erstellen. ``` { "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" } } ``` ### Beispielanforderung für eine Aufgabe im Basismodus Im folgenden Beispiel wird eine DataSync Aufgabe erstellt, die den Basismodus verwendet. ``` { "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" } ] } ``` ### Beispielantwort Die folgende Antwort enthält den ARN einer erstellten Aufgabe. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)