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

DescribeTask

Gibt Metadaten über eine Aufgabe zurück.

Anforderungssyntax

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

TaskArn

Der Amazon-Ressourcenname (ARN) der zu beschreibenden 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}$

Erforderlich: Ja

Antwortsyntax

{
   "CloudWatchLogGroupArn": "string",
   "CreationTime": number,
   "CurrentTaskExecutionArn": "string",
   "DestinationLocationArn": "string",
   "DestinationNetworkInterfaceArns": [ "string" ],
   "ErrorCode": "string",
   "ErrorDetail": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
   },
   "SourceLocationArn": "string",
   "SourceNetworkInterfaceArns": [ "string" ],
   "Status": "string",
   "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.

CloudWatchLogGroupArn

Der Amazon-Ressourcenname (ARN) der CloudWatch Amazon-Protokollgruppe, die zur Überwachung und Protokollierung von Ereignissen in der Aufgabe verwendet wurde.

Weitere Informationen zu diesen Gruppen finden Sie unter Arbeiten mit Protokollgruppen und Protokollstreams im CloudWatchAmazon-Benutzerhandbuch.

Typ: Zeichenfolge

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

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$

CreationTime

Die Uhrzeit, an denen die Aufgabe angelegt wurde.

Typ: Zeitstempel

CurrentTaskExecutionArn

Der Amazon-Ressourcenname (ARN) der Aufgaben-Ausführung, die Dateien überträgt.

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

DestinationLocationArn

Der Amazon-Ressourcenname (ARN) des Standorts der AWS -Speicherressource.

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}:location/loc-[0-9a-z]{17}$

DestinationNetworkInterfaceArns

Die Amazon-Ressourcennamen (ARNs) der Netzwerkschnittstellen, die für Ihren Zielstandort angelegt wurden. Weitere Informationen finden Sie unter Anforderungen an die Netzwerkschnittstelle.

Typ: Zeichenfolge-Array

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

Pattern: ^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$

ErrorCode

Fehler, die während der Ausführung der Aufgabe AWS DataSync aufgetreten sind. Sie können diesen Fehlercode verwenden, um Probleme zu beheben.

Typ: Zeichenfolge

ErrorDetail

Detaillierte Beschreibung eines Fehlers, der während der Aufgabenausführung aufgetreten ist. Sie können diese Informationen verwenden, um Probleme zu beheben.

Typ: Zeichenfolge

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.

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.

Name

Der Name der beschriebenen Aufgabe.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 256 Zeichen.

Pattern: ^[a-zA-Z0-9\s+=._:@/-]+$

Options

Die Konfigurationsoptionen, die das Verhalten des StartTaskExecution Vorgangs steuern. Einige Optionen umfassen das Beibehalten von Datei- oder Objektmetadaten und das Überprüfen der Datenintegrität.

Sie können diese Optionen für jede Aufgabenausführung überschreiben. Weitere Informationen finden Sie unter StartTaskExecution.

Typ: Options Objekt

Schedule

Der Zeitplan, der verwendet wird, um Dateien regelmäßig von einem Quell- an einen Zielspeicherort zu übertragen.

Typ: TaskSchedule Objekt

SourceLocationArn

Der Amazon-Ressourcenname (ARN) des Speicherorts des Quelldateisystems.

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}:location/loc-[0-9a-z]{17}$

SourceNetworkInterfaceArns

Die Amazon-Ressourcennamen (ARNs) der Netzwerkschnittstellen, die für Ihren Quellstandort angelegt wurden. Weitere Informationen finden Sie unter Anforderungen an die Netzwerkschnittstelle.

Typ: Zeichenfolge-Array

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

Pattern: ^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$

Status

Der Status der beschriebenen Aufgabe.

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

Typ: Zeichenfolge

Zulässige Werte: AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE

TaskArn

Der Amazon-Ressourcenname (ARN) der beschriebenen 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}$

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

Beispiel

Das folgende Beispiel gibt Informationen zu der in der Beispielanforderung angegebenen Aufgabe zurück.

Beispielanforderung

{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}

Beispiel

Dieses Beispiel veranschaulicht eine Verwendung vonDescribeTask.

Beispielantwort

{
   "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group"
   "CreationTime": 1532660733.39,
   "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f",
   "Options": { 
      "Atime": "BEST_EFFORT",
      "BytesPerSecond": 1000,
      "Gid": "NONE",
      "Mtime": "PRESERVE",
      "PosixPermissions": "PRESERVE",
      "PreserveDevices": "NONE",
      "PreserveDeletedFiles": "PRESERVE",
      "Uid": "NONE",
      "VerifyMode": "POINT_IN_TIME_CONSISTENT"
   },
   "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50fb",
   "ErrorCode": "???????",
   "ErrorDetail": "??????",
   "Name": "MyTask",
   "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa",
   "Status": "CREATING",
   "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}

Weitere Informationen finden Sie unter:

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