Options - AWS DataSync
InhaltWeitere Informationen finden Sie unter:

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.

Options

Zeigt 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 Anruf keine Option konfigurieren StartTaskExecution.

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.

Inhalt

Atime

Gibt an, ob Metadaten beibehalten werden sollen, die angeben, wann eine Datei zuletzt gelesen oder geschrieben wurde.

Anmerkung

Das Verhalten von Atime ist plattformübergreifend nicht vollständig standardisiert und DataSync kann daher nur nach bestem Wissen und Gewissen durchgeführt werden.

  • BEST_EFFORT(Standard) — DataSync versucht, das ursprüngliche Atime Attribut für alle Quelldateien beizubehalten (d. h. die Version vor den PREPARING Schritten der Aufgabenausführung). Diese Option wird empfohlen.

  • NONE- Ignoriert. Atime

Anmerkung

Wenn Atime auf BEST_EFFORT festgelegt ist, muss Mtime auf PRESERVE festgelegt werden.

Wenn Atime auf NONE festgelegt ist, muss Mtime auch NONE sein.

Typ: Zeichenfolge

Zulässige Werte: NONE | BEST_EFFORT

Erforderlich: Nein

BytesPerSecond

Schränkt die von einer DataSync Aufgabe verwendete Bandbreite ein. Wenn Sie beispielsweise maximal 1 MB verwenden DataSync möchten, setzen Sie diesen Wert auf 1048576 (=1024*1024).

Anmerkung

Gilt nicht für Aufgaben im erweiterten Modus.

Type: Long

Gültiger Bereich: Mindestwert -1.

Erforderlich: Nein

Gid

Gibt die POSIX-Gruppen-ID (GID) der Eigentümer der Datei an.

  • INT_VALUE(Standard) — Behält den ganzzahligen Wert von Benutzer-ID (UID) und GID bei, was empfohlen wird.

  • NONE- Ignoriert UID und GID.

Weitere Informationen finden Sie unter Grundlegendes zum DataSync Umgang mit Datei- und Objektmetadaten.

Typ: Zeichenfolge

Zulässige Werte: NONE | INT_VALUE | NAME | BOTH

Erforderlich: Nein

LogLevel

Gibt den Typ der Protokolle an, die in einer Amazon CloudWatch Logs-Protokollgruppe DataSync veröffentlicht werden. Informationen zur Angabe der Protokollgruppe finden Sie unter CloudWatchLogGroupArn.

  • BASIC- Veröffentlicht Protokolle, die nur grundlegende Informationen enthalten (z. B. Übertragungsfehler).

  • TRANSFER- Veröffentlicht Protokolle für alle Dateien oder Objekte, die Ihre DataSync Aufgabe überträgt, und führt Datenintegritätsprüfungen durch.

  • OFF- Es werden keine Protokolle veröffentlicht.

Typ: Zeichenfolge

Zulässige Werte: OFF | BASIC | TRANSFER

Erforderlich: Nein

Mtime

Gibt an, ob Metadaten beibehalten werden sollen, die angeben, wann vor dem PREPARING Schritt Ihrer Aufgabenausführung das letzte Mal in eine Datei geschrieben wurde. Diese Option ist erforderlich, wenn Sie eine Aufgabe mehr als einmal ausführen müssen.

  • PRESERVE(Standard) — Behält das Original beiMtime, was empfohlen wird.

  • NONE- IgnoriertMtime.

Anmerkung

Wenn Mtime auf PRESERVE festgelegt ist, muss Atime auf BEST_EFFORT festgelegt werden.

Wenn Mtime auf NONE festgelegt ist, muss Atime auch auf NONE festgelegt werden.

Typ: Zeichenfolge

Zulässige Werte: NONE | PRESERVE

Erforderlich: Nein

ObjectTags

Gibt an, ob Sie bei der Übertragung zwischen PRESERVE Objektspeichersystemen Objekt-Tags verwenden möchten DataSync (Standardverhalten). Wenn Sie möchten, dass Ihre DataSync Aufgabe Objekt-Tags ignoriert, geben Sie den NONE Wert an.

Typ: Zeichenfolge

Zulässige Werte: PRESERVE | NONE

Erforderlich: Nein

OverwriteMode

Gibt an, ob Daten am Zielort geändert oder beibehalten werden DataSync sollen.

  • ALWAYS(Standard) — DataSync ändert Daten am Zielspeicherort, wenn sich Quelldaten (einschließlich Metadaten) geändert haben.

    Wenn Objekte DataSync überschrieben werden, können zusätzliche Gebühren für bestimmte Amazon S3 S3-Speicherklassen anfallen (z. B. für das Abrufen oder vorzeitiges Löschen). Weitere Informationen finden Sie unter Überlegungen zur Speicherklasse bei Amazon S3 S3-Übertragungen.

  • NEVER- überschreibt DataSync keine Daten am Zielort, selbst wenn sich die Quelldaten geändert haben. Sie können diese Option verwenden, um vor dem Überschreiben von Änderungen zu schützen, die an Dateien oder Objekten im Ziel vorgenommen wurden.

Typ: Zeichenfolge

Zulässige Werte: ALWAYS | NEVER

Erforderlich: Nein

PosixPermissions

Gibt an, welche Benutzer oder Gruppen für einen bestimmten Zweck auf eine Datei zugreifen können, z. B. zum Lesen, Schreiben oder Ausführen der Datei.

Weitere Informationen finden Sie unter Grundlegendes zum DataSync Umgang mit Datei- und Objektmetadaten.

  • PRESERVE(Standard) — Behält Berechtigungen im POSIX-Stil bei, was empfohlen wird.

  • NONE- Ignoriert Berechtigungen im POSIX-Stil.

Anmerkung

DataSync kann bestehende Berechtigungen eines Quellverzeichnisses beibehalten.

Typ: Zeichenfolge

Zulässige Werte: NONE | PRESERVE

Erforderlich: Nein

PreserveDeletedFiles

Gibt an, ob Dateien im Zielverzeichnis, die in der Quelle nicht existieren, beibehalten werden sollen. Diese Option kann sich auf Ihre Amazon S3 S3-Speicherkosten auswirken. Wenn Ihre Aufgabe Objekte löscht, fallen für bestimmte Speicherklassen möglicherweise Mindestspeicherdauergebühren an. Ausführliche Informationen finden Sie unter Überlegungen bei der Arbeit mit Amazon S3 S3-Speicherklassen in DataSync.

  • PRESERVE(Standard) — Ignoriert solche Zieldateien, was empfohlen wird.

  • REMOVE- Löscht Zieldateien, die in der Quelle nicht vorhanden sind.

Anmerkung

Wenn Sie diesen Parameter auf setzenREMOVE, können Sie nicht TransferMode auf ALL setzen. Wenn Sie alle Daten übertragen, wird Ihr Zielort DataSync nicht gescannt und Sie wissen nicht, was gelöscht werden soll.

Typ: Zeichenfolge

Zulässige Werte: PRESERVE | REMOVE

Erforderlich: Nein

PreserveDevices

Gibt an, ob die Metadaten von Block- und Zeichengeräten am Quellspeicherort beibehalten und die Dateien mit diesem Gerätenamen und den Metadaten am Ziel neu erstellt werden DataSync sollen. DataSync kopiert nur den Namen und die Metadaten solcher Geräte.

Anmerkung

DataSync kann den tatsächlichen Inhalt dieser Geräte nicht kopieren, da sie keine Endgeräte sind und keine end-of-file (EOF-) Markierung zurückgeben.

  • NONE(Standard) — Ignoriert spezielle Geräte (empfohlen).

  • PRESERVE- Behält die Zeichen- und Blockgeräte-Metadaten bei. Diese Option wird derzeit für Amazon EFS nicht unterstützt.

Typ: Zeichenfolge

Zulässige Werte: NONE | PRESERVE

Erforderlich: Nein

SecurityDescriptorCopyFlags

Gibt an, welche Komponenten der SMB-Sicherheitsbeschreibung von Quell- in Zielobjekte kopiert werden.

Dieser Wert wird nur für Übertragungen zwischen SMB- und FSx Amazon-Dateiserverstandorten oder zwischen zwei Speicherorten FSx für Windows-Dateiserver verwendet. Weitere Informationen finden Sie unter Grundlegendes zum DataSync Umgang mit Datei- und Objektmetadaten.

  • OWNER_DACL(Standard) — Kopiert für jedes DataSync kopierte Objekt die folgenden Metadaten:

    • Der Objekteigentümer.

    • Diskretionäre NTFS-Zugriffskontrolllisten (DACLs), die festlegen, ob Zugriff auf ein Objekt gewährt wird.

      DataSync kopiert mit dieser Option keine NTFS-Systemzugriffskontrolllisten (SACLs).

  • OWNER_DACL_SACL- Kopiert für jedes DataSync kopierte Objekt die folgenden Metadaten:

    • Der Besitzer des Objekts.

    • Diskretionäre NTFS-Zugriffskontrolllisten (DACLs), die festlegen, ob Zugriff auf ein Objekt gewährt wird.

    • SACLs, die von Administratoren verwendet werden, um Zugriffsversuche auf ein geschütztes Objekt zu protokollieren.

      Zum Kopieren SACLs müssen dem Windows-Benutzer, der für den Zugriff auf Ihren SMB-Standort DataSync verwendet wird, zusätzliche Berechtigungen erteilt werden. Informationen zur Auswahl eines Benutzers mit den richtigen Berechtigungen finden Sie unter Erforderliche Berechtigungen für SMB, FSx für Windows File Server oder FSx für ONTAP (je nach Art des Speicherorts in Ihrer Übertragung).

  • NONE- Keine der Komponenten der SMB-Sicherheitsbeschreibung wird kopiert. Zielobjekte gehören dem Benutzer, der für den Zugriff auf den Zielort angegeben wurde. DACLs und SACLs werden auf der Grundlage der Konfiguration des Zielservers festgelegt.

Typ: Zeichenfolge

Zulässige Werte: NONE | OWNER_DACL | OWNER_DACL_SACL

Erforderlich: Nein

TaskQueueing

Gibt an, ob Ihre Übertragungsaufgaben in bestimmten Szenarien, wenn mehrere Aufgaben ausgeführt werden, in eine Warteschlange gestellt werden sollen. Dies ist ENABLED die Standardeinstellung.

Typ: Zeichenfolge

Zulässige Werte: ENABLED | DISABLED

Erforderlich: Nein

TransferMode

Gibt an, ob nach einer ersten Kopie nur die Daten (einschließlich Metadaten) DataSync übertragen werden, die sich zwischen den Speicherorten unterscheiden, oder ob bei jeder Ausführung der Aufgabe alle Daten übertragen werden. Wenn Sie wiederkehrende Übertragungen planen, möchten Sie möglicherweise nur die Änderungen übertragen, die sich seit der letzten Ausführung der Aufgabe geändert haben.

  • CHANGED(Standard) — DataSync Kopiert nach der ersten vollständigen Übertragung nur die Daten und Metadaten, die sich zwischen Quell- und Zielort unterscheiden.

  • ALL- DataSync kopiert alles in der Quelle an das Ziel, ohne die Unterschiede zwischen den Speicherorten zu vergleichen.

Typ: Zeichenfolge

Zulässige Werte: CHANGED | ALL

Erforderlich: Nein

Uid

Gibt die POSIX-Benutzer-ID (UID) des Besitzers der Datei an.

  • INT_VALUE(Standard) — Behält den ganzzahligen Wert von UID und Gruppen-ID (GID) bei, was empfohlen wird.

  • NONE- Ignoriert UID und GID.

Weitere Informationen finden Sie unter Metadaten kopiert von. DataSync

Typ: Zeichenfolge

Zulässige Werte: NONE | INT_VALUE | NAME | BOTH

Erforderlich: Nein

VerifyMode

Gibt an, ob und wie die Integrität Ihrer Daten am Ende der Übertragung DataSync überprüft wird.

  • ONLY_FILES_TRANSFERRED(empfohlen) — DataSync berechnet die Prüfsumme der übertragenen Daten (einschließlich Metadaten) am Quellspeicherort. Am Ende der Übertragung DataSync wird dann diese Prüfsumme mit der Prüfsumme verglichen, die anhand dieser Daten am Ziel berechnet wurde.

    Anmerkung

    Dies ist die Standardoption für Aufgaben im erweiterten Modus.

    Wir empfehlen diese Option bei der Übertragung in die Speicherklassen S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive. Weitere Informationen finden Sie unter Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten.

  • POINT_IN_TIME_CONSISTENT— DataSync Überprüft am Ende der Übertragung die gesamte Quelle und das Ziel, um sicherzustellen, dass beide Standorte vollständig synchronisiert sind.

    Anmerkung

    Dies ist die Standardoption für Aufgaben im Basismodus und wird derzeit nicht für Aufgaben im erweiterten Modus unterstützt.

    Wenn Sie ein Manifest verwenden, wird DataSync nur gescannt und verifiziert, was im Manifest aufgeführt ist.

    Sie können diese Option nicht verwenden, wenn Sie zu den Speicherklassen S3 Glacier Flexible Retrieval oder S3 Glacier Deep Archive übertragen. Weitere Informationen finden Sie unter Überlegungen zur Speicherklasse bei Amazon S3 S3-Standorten.

  • NONE- DataSync führt Datenintegritätsprüfungen nur während Ihrer Übertragung durch. Im Gegensatz zu anderen Optionen erfolgt am Ende Ihrer Übertragung keine zusätzliche Überprüfung.

Typ: Zeichenfolge

Zulässige Werte: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Erforderlich: Nein

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: