DescribeTaskExecution - 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.

DescribeTaskExecution

Gibt detaillierte Metadaten über eine Aufgabe zurück, die ausgeführt wird.

Anforderungssyntax

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

TaskExecutionArn

Der Amazon-Ressourcenname (ARN) der Aufgabe, die ausgeführt wird.

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}$

Erforderlich: Ja

Antwortsyntax

{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesTransferred": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "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.

BytesCompressed

Die physische Anzahl der Byte, die nach der Komprimierung über das Netzwerk übertragen wurden. In den meisten Fällen ist diese Zahl geringer als BytesTransferred es sei denn, die Daten sind nicht komprimierbar.

Type: Long

BytesTransferred

Die Gesamtzahl der Bytes, die an der Übertragung beteiligt sind. Die Anzahl der Bytes, die über das Netzwerk gesendet werden, finden Sie unterBytesCompressed.

Type: Long

BytesWritten

Die Anzahl der logischen Byte, die in die AWS Zielspeicherressource geschrieben wurden.

Type: Long

EstimatedBytesToTransfer

Die geschätzte physische Anzahl von Bytes, die über das Netzwerk übertragen werden sollen.

Type: Long

EstimatedFilesToTransfer

Die erwartete Anzahl von Dateien, die über das Netzwerk übertragen werden sollen. Dieser Wert wird in der PREPARING Phase vor der TRANSFERRING Phase der Aufgabenausführung berechnet. Dieser Wert ist die erwartete Anzahl der zu übertragenden Dateien. Es wird berechnet, indem der Inhalt der Quell- und Zielorte verglichen und das Delta ermittelt wird, das übertragen werden muss.

Type: Long

Excludes

Eine Liste von Filterregeln, die bestimmte Daten während Ihrer Übertragung ausschließen. Weitere Informationen und Beispiele finden Sie unter Filtern der übertragenen Daten von DataSync.

Typ: Array von FilterRule-Objekten

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

FilesTransferred

Die tatsächliche Anzahl der Dateien, die über das Netzwerk übertragen wurden. Dieser Wert wird während der TRANSFERRING Phase der Aufgabenausführung kontinuierlich berechnet und aktualisiert. Es wird regelmäßig aktualisiert, wenn jede Datei aus der Quelle gelesen und über das Netzwerk gesendet wird.

Wenn während einer Übertragung Fehler auftreten, kann dieser Wert kleiner als EstimatedFilesToTransfer sein. In einigen Fällen kann dieser Wert auch größer sein alsEstimatedFilesToTransfer. Dieses Element ist für einige Speicherorttypen implementierungsspezifisch, daher sollten Sie es nicht als Indikator für eine korrekte Dateianzahl oder zur Überwachung Ihrer Aufgabenausführung verwenden.

Type: Long

Includes

Eine Liste von Filterregeln, die bestimmte Daten während Ihrer Übertragung einschließen. Weitere Informationen und Beispiele finden Sie unter Filtern der übertragenen Daten von DataSync.

Typ: Array von FilterRule-Objekten

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

Options

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 hat einen Standardwert. Sofern nicht erforderlich, müssen Sie keine dieser Optionen konfigurieren, Options bevor Sie Ihre Aufgabe starten.

Typ: Options Objekt

Result

Das Ergebnis der Aufgabenausführung.

Typ: TaskExecutionResultDetail Objekt

StartTime

Die Uhrzeit, zu der die Aufgabenausführung gestartet wurde.

Typ: Zeitstempel

Status

Der Status der Aufgabenausführung.

Detaillierte Informationen zum Status der Aufgabenausführung finden Sie unter Grundlegendes zu Aufgabenstatus.

Typ: Zeichenfolge

Zulässige Werte: QUEUED | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR

TaskExecutionArn

Der Amazon-Ressourcenname (ARN) der Aufgaben-Aufgabenausführung, die beschrieben wurde. TaskExecutionArnist hierarchisch und beinhaltet TaskArn für die ausgeführte Aufgabe.

Beispielsweise TaskExecution hat ein Wert mit dem ARN die Aufgabe mit dem ARN arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b ausgeführtarn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2.

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

Dieses Beispiel veranschaulicht eine DescribeTaskExecution Anfrage.

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

Beispielantwort

Dieses Beispiel veranschaulicht eine DescribeTaskExecution Antwort.

{
   "BytesCompressed": "3500",
   "BytesTransferred": "5000",
   "BytesWritten": "5000",
   "EstimatedBytesToTransfer": "5000",
   "EstimatedFilesToTransfer": "100",
   "FilesTransferred": "100",
   "Result": { 
      "ErrorCode": "??????",
      "ErrorDetail": "??????",
      "PrepareDuration": "100",
      "PrepareStatus": "SUCCESS",
      "TransferDuration": "60",
      "TransferStatus": "AVAILABLE",
      "VerifyDuration": "30",
      "VerifyStatus": "SUCCESS"
   },
   "StartTime": "1532660733.39",
   "Status": "SUCCESS",
   "OverrideOptions": { 
      "Atime": "BEST_EFFORT",
      "BytesPerSecond": "1000",
      "Gid": "NONE",
      "Mtime": "PRESERVE",
      "PosixPermissions": "PRESERVE",
      "PreserveDevices": "NONE",
      "PreserveDeletedFiles": "PRESERVE",
      "Uid": "NONE",
      "VerifyMode": "POINT_IN_TIME_CONSISTENT"
   },
   "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: