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. # Übertragung bestimmter Dateien oder Objekte mithilfe eines Manifests Ein *Manifest* ist eine Liste von Dateien oder Objekten, die Sie übertragen AWS DataSync möchten. Anstatt beispielsweise alles in einem S3-Bucket mit potenziell Millionen von Objekten übertragen zu müssen, werden nur die Objekte DataSync übertragen, die Sie in Ihrem Manifest auflisten. Manifeste ähneln [Filtern](filtering.md), ermöglichen es Ihnen aber, anstelle von Daten, die einem Filtermuster entsprechen, genau zu identifizieren, welche Dateien oder Objekte übertragen werden sollen. **Anmerkung** Die maximal zulässige Größe für eine Manifestdatei mit Aufgaben im erweiterten Modus beträgt 20 GB. ## Erstellen Sie Ihr Manifest Ein Manifest ist eine Datei im CSV-Format (Comma-Separated Values), in der die Dateien oder Objekte an Ihrem Quellspeicherort aufgeführt sind, die Sie übertragen möchten. DataSync Wenn es sich bei Ihrer Quelle um einen S3-Bucket handelt, können Sie auch angeben, welche Version eines Objekts übertragen werden soll. **Topics** + [Richtlinien](#transferring-with-manifest-guidelines) + [Beispielmanifeste](#manifest-examples) ### Richtlinien Verwenden Sie diese Richtlinien, um ein Manifest zu erstellen, mit dem Sie arbeiten können DataSync. ------ #### [ Do ] + Geben Sie den vollständigen Pfad jeder Datei oder jedes Objekts an, das Sie übertragen möchten. Sie können nicht nur ein Verzeichnis oder einen Ordner angeben, um den gesamten Inhalt zu übertragen. In diesen Situationen sollten Sie einen [Include-Filter](filtering.md) anstelle eines Manifests verwenden. + Stellen Sie sicher, dass jeder Datei- oder Objektpfad relativ zu dem Bereitstellungspfad, Ordner, Verzeichnis oder Präfix ist, das Sie bei der Konfiguration Ihres DataSync Quellverzeichnisses angegeben haben. Nehmen wir zum Beispiel an, Sie [konfigurieren einen S3-Standort](create-s3-location.md#create-s3-location-how-to) mit einem Präfix namens`photos`. Dieses Präfix enthält ein Objekt`my-picture.png`, das Sie übertragen möchten. Im Manifest müssen Sie dann nur das Objekt (`my-picture.png`) anstelle des Präfixes und des Objekts (`photos/my-picture.png`) angeben. + Um die Amazon S3 S3-Objektversion anzugeben IDs, trennen Sie den Pfad und die Versions-ID des Objekts durch ein Komma. Das folgende Beispiel zeigt einen Manifesteintrag mit zwei Feldern. Das erste Feld enthält ein Objekt mit dem Namen`picture1.png`. Das zweite Feld ist durch ein Komma getrennt und enthält die Versions-ID: `111111` ``` picture1.png,111111 ``` + Verwenden Sie Anführungszeichen in den folgenden Situationen: + Wenn ein Pfad Sonderzeichen (Kommas, Anführungszeichen und Zeilenenden) enthält: `"filename,with,commas.txt"` + Wenn sich ein Pfad über mehrere Zeilen erstreckt: ``` "this is a filename.txt" ``` + Wenn ein Pfad Anführungszeichen enthält: `filename""with""quotes.txt` Dies stellt einen Pfad mit dem Namen dar`filename"with"quotes.txt`. Diese Regeln für Anführungszeichen gelten auch für Versions-ID-Felder. Wenn ein Manifestfeld ein Anführungszeichen enthält, müssen Sie es im Allgemeinen mit einem anderen Anführungszeichen versehen. + Trennen Sie jeden Datei- oder Objekteintrag durch eine neue Zeile. Sie können Zeilen trennen, indem Sie Zeilenumbrüche im Linux-Stil (Zeilenvorschub oder Zeilenumbruch) oder Windows (Zeilenumbruch gefolgt von einem Zeilenvorschub) verwenden. + Speichern Sie Ihr Manifest (zum Beispiel `my-manifest.csv` oder`my-manifest.txt`). + Laden Sie das Manifest in einen S3-Bucket hoch, der [darauf zugreifen DataSync kann](#transferring-with-manifest-access). Dieser Bucket muss sich nicht in demselben AWS-Region PR-Konto befinden, das Sie verwenden DataSync. ------ #### [ Don't ] + Geben Sie nur ein Verzeichnis oder einen Ordner an, um den gesamten Inhalt zu übertragen. Ein Manifest kann nur vollständige Pfade zu den Dateien oder Objekten enthalten, die Sie übertragen möchten. Wenn Sie Ihren Quellpfad so konfigurieren, dass er einen bestimmten Bereitstellungspfad, Ordner, Verzeichnis oder Präfix verwendet, müssen Sie dies nicht in Ihr Manifest aufnehmen. + Geben Sie einen Datei- oder Objektpfad mit mehr als 4.096 Zeichen an. + Geben Sie einen Dateipfad, einen Objektpfad oder eine Amazon S3 S3-Objektversions-ID an, die 1.024 Byte überschreitet. + Geben Sie doppelte Datei- oder Objektpfade an. + Geben Sie eine Objekt-Versions-ID an, wenn es sich bei Ihrem Quellspeicherort nicht um einen S3-Bucket handelt. + Fügen Sie mehr als zwei Felder in einen Manifesteintrag ein. Ein Eintrag kann nur einen Datei- oder Objektpfad und (falls zutreffend) eine Amazon S3 S3-Objektversions-ID enthalten. + Schließt Zeichen ein, die nicht der UTF-8-Kodierung entsprechen. + Fügen Sie unbeabsichtigte Leerzeichen in Ihre Eingabefelder außerhalb von Anführungszeichen ein. ------ ### Beispielmanifeste Verwenden Sie diese Beispiele, um ein Manifest zu erstellen, das mit funktioniert DataSync. **Manifest mit vollständigen Datei- oder Objektpfaden** Das folgende Beispiel zeigt ein Manifest mit vollständigen Datei- oder Objektpfaden für die Übertragung. ``` photos/picture1.png photos/picture2.png photos/picture3.png ``` **Manifest nur mit Objektschlüsseln** Das folgende Beispiel zeigt ein Manifest mit Objekten, die von einem Amazon S3 S3-Quellspeicherort übertragen werden sollen. Da der [Standort mit dem Präfix konfiguriert ist](create-s3-location.md#create-s3-location-how-to)`photos`, werden nur die Objektschlüssel angegeben. ``` picture1.png picture2.png picture3.png ``` **Manifest mit Objektpfaden und Version IDs** Die ersten beiden Einträge im folgenden Manifestbeispiel enthalten spezifische Amazon S3 S3-Objektversionen, die übertragen werden sollen. ``` photos/picture1.png,111111 photos/picture2.png,121212 photos/picture3.png ``` **Manifest mit UTF-8-Zeichen** Das folgende Beispiel zeigt ein Manifest mit Dateien, die UTF-8-Zeichen enthalten. ``` documents/résumé1.pdf documents/résumé2.pdf documents/résumé3.pdf ``` ## Bereitstellung des DataSync Zugriffs auf Ihr Manifest Sie benötigen eine AWS Identity and Access Management (IAM-) Rolle, die DataSync Zugriff auf Ihr Manifest in seinem S3-Bucket gewährt. Diese Rolle muss die folgenden Berechtigungen beinhalten: + `s3:GetObject` + `s3:GetObjectVersion` Sie können diese Rolle automatisch in der DataSync Konsole generieren oder sie selbst erstellen. **Anmerkung** Wenn sich Ihr Manifest in einem anderen befindet AWS-Konto, müssen Sie diese Rolle manuell erstellen. ### Automatisches Erstellen der IAM-Rolle Wenn Sie eine Übertragungsaufgabe in der Konsole erstellen oder starten, DataSync kann für Sie eine IAM-Rolle mit den `s3:GetObjectVersion` Berechtigungen `s3:GetObject` und Berechtigungen erstellt werden, die Sie für den Zugriff auf Ihr Manifest benötigen. **Erforderliche Berechtigungen, um die Rolle automatisch zu erstellen** Um die Rolle automatisch zu erstellen, stellen Sie sicher, dass die Rolle, die Sie für den Zugriff auf die DataSync Konsole verwenden, über die folgenden Berechtigungen verfügt: + `iam:CreateRole` + `iam:CreatePolicy` + `iam:AttachRolePolicy` ### Die IAM-Rolle erstellen (gleiches Konto) Sie können die IAM-Rolle, die auf Ihr Manifest zugreifen DataSync muss, manuell erstellen. In den folgenden Anweisungen wird davon ausgegangen, dass Sie sich dort befinden, AWS-Konto wo Sie es verwenden, DataSync und dass sich der S3-Bucket Ihres Manifests befindet. 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie im linken Navigationsbereich unter **Zugriffsverwaltung** die Option **Rollen** und dann **Rolle erstellen** aus. 1. **Wählen Sie auf der Seite Vertrauenswürdige Entität** auswählen für **Vertrauenswürdigen Entitätstyp** die Option **AWS-Service**. 1. Wählen Sie **DataSync**in der Dropdownliste für **Anwendungsfall** die Option aus und wählen Sie aus **DataSync**. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Add permissions** (Berechtigungen hinzufügen) die Option **Next** (Weiter) aus. Geben Sie Ihrer Rolle einen Namen und wählen Sie **Rolle erstellen**. 1. Suchen Sie auf der Seite **Rollen** nach der Rolle, die Sie gerade erstellt haben, und wählen Sie ihren Namen aus. 1. Wählen Sie auf der Detailseite der Rolle den Tab **Berechtigungen** aus. Wählen Sie **Berechtigungen hinzufügen** und dann **Inline-Richtlinie erstellen** aus. 1. Wählen Sie die Registerkarte **JSON** und fügen Sie die folgende Beispielrichtlinie in den Richtlinieneditor ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Sid": "DataSyncAccessManifest", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv" }] } ``` ------ 1. Ersetzen Sie in der Beispielrichtlinie, die Sie gerade eingefügt haben, die folgenden Werte durch Ihre eigenen: 1. `amzn-s3-demo-bucket`Ersetzen Sie es durch den Namen des S3-Buckets, der Ihr Manifest hostet. 1. `my-manifest.csv`Ersetzen Sie es durch den Dateinamen Ihres Manifests. 1. Wählen Sie **Weiter** aus. Geben Sie Ihrer Richtlinie einen Namen und wählen Sie **Richtlinie erstellen**. 1. (Empfohlen) Gehen Sie wie folgt vor, um das [dienstübergreifende Problem mit verwirrten Stellvertretern](cross-service-confused-deputy-prevention.md) zu vermeiden: 1. Wählen Sie auf der Detailseite der Rolle die Registerkarte **Vertrauensbeziehungen** aus. Wählen Sie **Vertrauensrichtlinie bearbeiten** aus. 1. Aktualisieren Sie die Vertrauensrichtlinie anhand des folgenden Beispiels, das die Kontextschlüssel `aws:SourceArn` und die `aws:SourceAccount` globalen Bedingungsschlüssel enthält: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "555555555555" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*" } } } ] } ``` ------ + Ersetzen Sie jede Instanz `account-id` durch die AWS-Konto ID, die Sie verwenden DataSync. + Ersetze es `region` durch das AWS-Region , wo du es verwendest DataSync. 1. Wählen Sie **Richtlinie aktualisieren**. Sie haben eine IAM-Rolle erstellt, die den Zugriff DataSync auf Ihr Manifest ermöglicht. Geben Sie diese Rolle an, wenn Sie Ihre Aufgabe [erstellen](#manifest-creating-task) oder [starten](#manifest-starting-task). ### Die IAM-Rolle erstellen (anderes Konto) Wenn sich Ihr Manifest in einem S3-Bucket befindet, der zu einem anderen gehört AWS-Konto, müssen Sie die IAM-Rolle, die für den Zugriff auf das Manifest DataSync verwendet wird, manuell erstellen. Anschließend müssen Sie dort, AWS-Konto wo sich Ihr Manifest befindet, die Rolle in die S3-Bucket-Richtlinie aufnehmen. #### Erstellen der -Rolle 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie im linken Navigationsbereich unter **Zugriffsverwaltung** die Option **Rollen** und dann **Rolle erstellen** aus. 1. **Wählen Sie auf der Seite Vertrauenswürdige Entität** auswählen für **Vertrauenswürdigen Entitätstyp** die Option **AWS-Service**. 1. Wählen Sie **DataSync**in der Dropdownliste für **Anwendungsfall** die Option aus und wählen Sie aus **DataSync**. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Add permissions** (Berechtigungen hinzufügen) die Option **Next** (Weiter) aus. Geben Sie Ihrer Rolle einen Namen und wählen Sie **Rolle erstellen**. 1. Suchen Sie auf der Seite **Rollen** nach der Rolle, die Sie gerade erstellt haben, und wählen Sie ihren Namen aus. 1. Wählen Sie auf der Detailseite der Rolle den Tab **Berechtigungen** aus. Wählen Sie **Berechtigungen hinzufügen** und dann **Inline-Richtlinie erstellen** aus. 1. Wählen Sie die Registerkarte **JSON** und fügen Sie die folgende Beispielrichtlinie in den Richtlinieneditor ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Sid": "DataSyncAccessManifest", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv" }] } ``` ------ 1. Ersetzen Sie in der Beispielrichtlinie, die Sie gerade eingefügt haben, die folgenden Werte durch Ihre eigenen: 1. `amzn-s3-demo-bucket`Ersetzen Sie es durch den Namen des S3-Buckets, der Ihr Manifest hostet. 1. `my-manifest.csv`Ersetzen Sie es durch den Dateinamen Ihres Manifests. 1. Wählen Sie **Weiter** aus. Geben Sie Ihrer Richtlinie einen Namen und wählen Sie **Richtlinie erstellen**. 1. (Empfohlen) Gehen Sie wie folgt vor, um das [dienstübergreifende Problem mit verwirrten Stellvertretern](cross-service-confused-deputy-prevention.md) zu vermeiden: 1. Wählen Sie auf der Detailseite der Rolle die Registerkarte **Vertrauensbeziehungen** aus. Wählen Sie **Vertrauensrichtlinie bearbeiten** aus. 1. Aktualisieren Sie die Vertrauensrichtlinie anhand des folgenden Beispiels, das die Kontextschlüssel `aws:SourceArn` und die `aws:SourceAccount` globalen Bedingungsschlüssel enthält: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "000000000000" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*" } } } ] } ``` ------ + Ersetzen Sie jede Instanz von `account-id` durch die AWS-Konto ID, die Sie verwenden DataSync. + Ersetze es `region` durch die AWS-Region Stelle, die du verwendest DataSync. 1. Wählen Sie **Richtlinie aktualisieren**. Sie haben die IAM-Rolle erstellt, die Sie in Ihre S3-Bucket-Richtlinie aufnehmen können. #### Aktualisierung Ihrer S3-Bucket-Richtlinie mit der Rolle Nachdem Sie die IAM-Rolle erstellt haben, müssen Sie sie der S3-Bucket-Richtlinie in der anderen Rolle hinzufügen, in der AWS-Konto sich Ihr Manifest befindet. 1. Wechseln Sie im AWS-Managementkonsole zu dem Konto mit dem S3-Bucket Ihres Manifests. 1. Öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Wählen Sie auf der Detailseite des Buckets den Tab **Permissions** aus. 1. Wählen Sie unter **Bucket-Richtlinie** die Option **Bearbeiten** aus und gehen Sie wie folgt vor, um Ihre S3-Bucket-Richtlinie zu ändern: 1. Aktualisieren Sie den Inhalt des Editors, sodass er die folgenden Richtlinienerklärungen enthält: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DataSyncAccessManifestBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket" } ] } ``` ------ 1. `account-id`Ersetzen Sie es durch die AWS-Konto ID für das Konto, das Sie DataSync mit verwenden. 1. `datasync-role`Ersetzen Sie es durch die IAM-Rolle, die Sie gerade erstellt haben und die DataSync den Zugriff auf Ihr Manifest ermöglicht. 1. `amzn-s3-demo-bucket`Ersetzen Sie es im anderen AWS-Konto durch den Namen des S3-Buckets, der Ihr Manifest hostet. 1. Wählen Sie **Änderungen speichern ** aus. Sie haben eine IAM-Rolle erstellt, die DataSync den Zugriff auf Ihr Manifest im anderen Konto ermöglicht. Geben Sie diese Rolle an, wenn Sie Ihre Aufgabe [erstellen](#manifest-creating-task) oder [starten](#manifest-starting-task). ## Geben Sie Ihr Manifest an, wenn Sie eine Aufgabe erstellen Sie können das Manifest angeben, das Sie beim Erstellen einer Aufgabe verwenden möchten DataSync . ### Verwenden der DataSync Konsole 1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. Wählen Sie im linken Navigationsbereich **Aufgaben** und dann **Aufgabe erstellen** aus. 1. Konfigurieren Sie die Quell- und Zielorte Ihrer Aufgabe. Weitere Informationen finden Sie unter [Mit wem kann ich meine Daten übertragen AWS DataSync?](working-with-locations.md). 1. Wählen Sie unter **Zu scannende Inhalte** die Option **Bestimmte Dateien, Objekte und Ordner und** anschließend **Manifest verwenden** aus. 1. Wählen Sie für **S3-URI** Ihr Manifest aus, das auf einem S3-Bucket gehostet wird. Alternativ können Sie den URI eingeben (z. B.`s3://bucket/prefix/my-manifest.csv`). 1. Wählen Sie **unter Objektversion** die Version des Manifests aus, die Sie verwenden DataSync möchten. DataSync Verwendet standardmäßig die neueste Version des Objekts. 1. Führen Sie für die **Zugriffsrolle Manifest** einen der folgenden Schritte aus: + Wählen Sie **Autogenerate** für DataSync , um automatisch eine IAM-Rolle mit den erforderlichen Berechtigungen für den Zugriff auf Ihr Manifest in ihrem S3-Bucket zu erstellen. + Wählen Sie eine bestehende IAM-Rolle aus, die auf Ihr Manifest zugreifen kann. Weitere Informationen finden Sie unter [Bereitstellung des DataSync Zugriffs auf Ihr Manifest](#transferring-with-manifest-access). 1. Konfigurieren Sie alle anderen Aufgabeneinstellungen, die Sie benötigen, und wählen Sie dann **Weiter**. 1. Wählen Sie **Create task** aus. ### Verwenden Sie den AWS CLI 1. Kopieren Sie den folgenden `create-task` Befehl: ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --manifest-config { "Source": { "S3": { "ManifestObjectPath": "s3-object-key-of-manifest", "BucketAccessRoleArn": "bucket-iam-role", "S3BucketArn": "amzn-s3-demo-bucket-arn", "ManifestObjectVersionId": "manifest-version-to-use" } } } ``` 1. Geben Sie für den `--source-location-arn` Parameter den Amazon-Ressourcennamen (ARN) des Standorts an, von dem Sie Daten übertragen. 1. Geben Sie für den `--destination-location-arn` Parameter den ARN des Standorts an, an den Sie Daten übertragen. 1. Gehen Sie für den `--manifest-config` Parameter wie folgt vor: + `ManifestObjectPath`— Geben Sie den S3-Objektschlüssel Ihres Manifests an. + `BucketAccessRoleArn`— Geben Sie die IAM-Rolle an, die den DataSync Zugriff auf Ihr Manifest in ihrem S3-Bucket ermöglicht. Weitere Informationen finden Sie unter [Bereitstellung des DataSync Zugriffs auf Ihr Manifest](#transferring-with-manifest-access). + `S3BucketArn`— Geben Sie den ARN des S3-Buckets an, der Ihr Manifest hostet. + `ManifestObjectVersionId`— Geben Sie die Version des Manifests an, die Sie verwenden DataSync möchten. DataSync Verwendet standardmäßig die neueste Version des Objekts. 1. Führen Sie den `create-task` Befehl aus, um Ihre Aufgabe zu erstellen. Wenn Sie bereit sind, können Sie [Ihre Übertragungsaufgabe starten](run-task.md). ## Geben Sie Ihr Manifest an, wenn Sie eine Aufgabe starten Sie können das Manifest angeben, das Sie beim Ausführen einer Aufgabe verwenden möchten DataSync . ### Verwenden der DataSync Konsole 1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. Wählen Sie im linken Navigationsbereich **Aufgaben** und dann die Aufgabe aus, die Sie starten möchten. 1. Wählen Sie auf der Seite mit der Aufgabenübersicht die Option **Start** und dann **Mit überschreibenden Optionen beginnen** aus. 1. Wählen Sie unter **Zu scannende Inhalte** die Option **Bestimmte Dateien, Objekte und Ordner und** anschließend **Manifest verwenden** aus. 1. Wählen Sie für **S3-URI** Ihr Manifest aus, das auf einem S3-Bucket gehostet wird. Alternativ können Sie den URI eingeben (z. B.`s3://bucket/prefix/my-manifest.csv`). 1. Wählen Sie **unter Objektversion** die Version des Manifests aus, die Sie verwenden DataSync möchten. DataSync Verwendet standardmäßig die neueste Version des Objekts. 1. Führen Sie für die **Zugriffsrolle Manifest** einen der folgenden Schritte aus: + Wählen Sie **Autogenerate** für DataSync , um automatisch eine IAM-Rolle für den Zugriff auf Ihr Manifest in ihrem S3-Bucket zu erstellen. + Wählen Sie eine bestehende IAM-Rolle aus, die auf Ihr Manifest zugreifen kann. Weitere Informationen finden Sie unter [Bereitstellung des DataSync Zugriffs auf Ihr Manifest](#transferring-with-manifest-access). 1. Wählen Sie **Start**, um mit der Übertragung zu beginnen. ### Mit dem AWS CLI 1. Kopieren Sie den folgenden `start-task-execution` Befehl: ``` aws datasync start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \ --manifest-config { "Source": { "S3": { "ManifestObjectPath": "s3-object-key-of-manifest", "BucketAccessRoleArn": "bucket-iam-role", "S3BucketArn": "amzn-s3-demo-bucket-arn", "ManifestObjectVersionId": "manifest-version-to-use" } } } ``` 1. Geben Sie für den `--task-arn` Parameter den Amazon-Ressourcennamen (ARN) der Aufgabe an, die Sie starten. 1. Gehen Sie für den `--manifest-config` Parameter wie folgt vor: + `ManifestObjectPath`— Geben Sie den S3-Objektschlüssel Ihres Manifests an. + `BucketAccessRoleArn`— Geben Sie die IAM-Rolle an, die den DataSync Zugriff auf Ihr Manifest in ihrem S3-Bucket ermöglicht. Weitere Informationen finden Sie unter [Bereitstellung des DataSync Zugriffs auf Ihr Manifest](#transferring-with-manifest-access). + `S3BucketArn`— Geben Sie den ARN des S3-Buckets an, der Ihr Manifest hostet. + `ManifestObjectVersionId`— Geben Sie die Version des Manifests an, die Sie verwenden DataSync möchten. DataSync Verwendet standardmäßig die neueste Version des Objekts. 1. Führen Sie den `start-task-execution` Befehl aus, um mit der Übertragung zu beginnen. ## Einschränkungen + Sie können ein Manifest nicht zusammen mit [Filtern](filtering.md) verwenden. + Sie können nicht nur ein Verzeichnis oder einen Ordner angeben, um dessen gesamten Inhalt zu übertragen. In diesen Situationen sollten Sie einen [Include-Filter](filtering.md) anstelle eines Manifests verwenden. + Sie können die Aufgabenoption **Gelöschte Dateien behalten** (`PreserveDeletedFiles`in der [API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) nicht verwenden, um [Dateien oder Objekte im Ziel zu verwalten, die sich nicht in der Quelle befinden](configure-metadata.md). DataSync überträgt nur das, was in Ihrem Manifest aufgeführt ist, und löscht nichts im Ziel. ## Fehlerbehebung **Fehler im Zusammenhang mit `HeadObject` oder `GetObjectTagging`** Wenn Sie Objekte mit einer bestimmten Version IDs aus einem S3-Bucket übertragen, wird möglicherweise ein Fehler im Zusammenhang mit `HeadObject` oder angezeigt`GetObjectTagging`. Hier ist zum Beispiel ein Fehler im Zusammenhang mit`GetObjectTagging`: ``` [WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed [ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied, msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml, date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked, x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723 ``` Wenn Sie einen dieser Fehler sehen, überprüfen Sie, ob die IAM-Rolle, die für den Zugriff auf Ihren S3-Quellspeicherort DataSync verwendet wird, über die folgenden Berechtigungen verfügt: + `s3:GetObjectVersion` + `s3:GetObjectVersionTagging` Wenn Sie Ihre Rolle mit diesen Berechtigungen aktualisieren müssen, finden Sie weitere Informationen unter[Erstellen einer IAM-Rolle für den Zugriff DataSync auf Ihren Amazon S3 S3-Standort](create-s3-location.md#create-role-manually). **Fehler: `ManifestFileDoesNotExist`** Dieser Fehler weist darauf hin, dass eine Datei im Manifest nicht an der Quelle gefunden wurde. Lesen Sie die [Richtlinien](#transferring-with-manifest-guidelines) für die Erstellung eines Manifests. ## Nächste Schritte Falls Sie es noch nicht getan haben, [beginnen Sie mit Ihrer Aufgabe](run-task.md). [Überwachen Sie andernfalls die Aktivität Ihrer Aufgabe](monitoring-overview.md).