StartTaskExecution - AWS DataSync
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerBeispieleWeitere 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.

StartTaskExecution

Startet eine AWS DataSync Aufgabe. Für jede Aufgabe können Sie nur jeweils eine Ausführung ausführen.

Die Ausführung einer Aufgabe besteht aus mehreren Phasen. Weitere Informationen finden Sie unter Status der Ausführung von Aufgaben.

Wichtig

Wenn Sie planen, Daten an oder von einem Amazon S3 S3-Standort zu übertragen, überprüfen Sie, wie sich dies auf Ihre S3-Anforderungsgebühren und die DataSyncPreisseite auswirken DataSync kann, bevor Sie beginnen.

Anforderungssyntax

{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "OverrideOptions": { 
      "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"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskArn": "string"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

Excludes

Gibt eine Liste von Filterregeln an, die bestimmen, welche Dateien von einer Aufgabe ausgeschlossen werden. Die Liste enthält eine einzelne Filterzeichenfolge, die aus den auszuschließenden Mustern besteht. Die Muster werden durch "|" (also eine Pipe) abgegrenzt. Beispiel: "/folder1|/folder2".

Typ: Array von FilterRule-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element.

Required: No

Includes

Gibt eine Liste von Filterregeln an, die bestimmen, welche Dateien beim Ausführen einer Aufgabe eingeschlossen werden sollen. Das Muster sollte eine einzelne Filterzeichenfolge enthalten, die aus den einzuschließenden Mustern besteht. Die Muster werden durch "|" (also eine Pipe) abgegrenzt. Beispiel: "/folder1|/folder2".

Typ: Array von FilterRule-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element.

Required: No

OverrideOptions

Konfiguriert Ihre AWS DataSync Aufgabeneinstellungen. Zu diesen Optionen gehört, DataSync wie mit Dateien, Objekten und den zugehörigen Metadaten umgegangen wird. Sie können unter anderem angeben, wie DataSync die Datenintegrität überprüft wird, Bandbreitenlimits für Ihre Aufgabe festlegen.

Jede Aufgabeneinstellung besitzt einen Standardwert. Sofern nicht erforderlich, müssen Sie keine dieser Optionen konfigurieren, Options bevor Sie Ihre Aufgabe starten.

Typ: Options Objekt

Required: No

Tags

Gibt die Tags an, die Sie auf den Amazon-Ressourcennamen (ARN) anwenden möchten, der die Ausführung von Aufgaben darstellt.

Tags sind Schlüssel-Wert-Paare, mit denen Sie Ihre DataSync Ressourcen verwalten, filtern und suchen können.

Typ: Array von TagListEntry-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.

Required: No

TaskArn

Gibt den Amazon-Ressourcennamen (ARN) der Aufgabe an, die Sie starten möchten.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 128.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$

Erforderlich: Ja

Antwortsyntax

{
   "TaskExecutionArn": "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.

TaskExecutionArn

Der ARN der ausgeführten Aufgabe.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 128.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

InternalException

Diese Ausnahme wird ausgelöst, wenn ein Fehler im AWS DataSync Dienst auftritt.

HTTP Status Code: 500

InvalidRequestException

Diese Ausnahme wird ausgelöst, wenn der Client eine fehlerhafte Anfrage sendet.

HTTP Status Code: 400

Beispiele

Beispielanforderung

Im folgenden Beispiel wird eine Aufgabenausführung mit den Standardoptionen für die angegebene Aufgabe gestartet.

{
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": 1000,
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}

Beispielantwort

Dieses Beispiel veranschaulicht eine Verwendung vonStartTaskExecution.

{
  "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: