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 Stellt Informationen über die Ausführung Ihrer AWS DataSync Aufgabe bereit. Sie können diesen Vorgang verwenden, um den Fortschritt einer laufenden Datenübertragung zu überwachen oder die Ergebnisse der Übertragung zu überprüfen. **Anmerkung** Einige `DescribeTaskExecution` Antwortelemente sind nur für einen bestimmten Aufgabenmodus relevant. Weitere Informationen finden Sie unter [Grundlegendes zu Unterschieden im Aufgabenmodus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) und [Grundlegendes zu Leistungsindikatoren bei der Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html). ## Anforderungssyntax ``` { "TaskExecutionArn": "string" } ``` ## Anforderungsparameter Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) ** Gibt den Amazon-Ressourcennamen (ARN) der Aufgabenausführung an, über die Sie Informationen benötigen. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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, "EndTime": number, "EstimatedBytesToTransfer": number, "EstimatedFilesToDelete": number, "EstimatedFilesToTransfer": number, "EstimatedFoldersToDelete": number, "EstimatedFoldersToTransfer": number, "Excludes": [ { "FilterType": "string", "Value": "string" } ], "FilesDeleted": number, "FilesFailed": { "Delete": number, "Prepare": number, "Transfer": number, "Verify": number }, "FilesListed": { "AtDestinationForDelete": number, "AtSource": number }, "FilesPrepared": number, "FilesSkipped": number, "FilesTransferred": number, "FilesVerified": number, "FoldersDeleted": number, "FoldersFailed": { "Delete": number, "List": number, "Prepare": number, "Transfer": number, "Verify": number }, "FoldersListed": { "AtDestinationForDelete": number, "AtSource": number }, "FoldersPrepared": number, "FoldersSkipped": number, "FoldersTransferred": number, "FoldersVerified": number, "Includes": [ { "FilterType": "string", "Value": "string" } ], "LaunchTime": number, "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "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" }, "ReportResult": { "ErrorCode": "string", "ErrorDetail": "string", "Status": "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", "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "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](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der physischen Byte, die nach der Komprimierung über das Netzwerk DataSync übertragen werden (sofern eine Komprimierung möglich ist). Diese Zahl ist in der Regel geringer als, [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)sofern die Daten nicht komprimierbar sind. Type: Long ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Byte, die vor der Komprimierung an das Netzwerk DataSync gesendet werden (sofern eine Komprimierung möglich ist). Informationen zur Anzahl der über das Netzwerk übertragenen Byte finden Sie unter [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed). Type: Long ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der logischen Byte, die DataSync tatsächlich an den Zielspeicherort schreiben. Type: Long ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** Der Zeitpunkt, zu dem die Übertragungsaufgabe endet. Typ: Zeitstempel ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der logischen Byte, die DataSync voraussichtlich an den Zielspeicherort geschrieben werden. Type: Long ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) befinden, ist der Wert immer`0`. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete). Type: Long ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird während der DataSync [Vorbereitung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) der Übertragung berechnet. Wie dieser Wert berechnet wird, hängt in erster Linie von der Konfiguration des [Übertragungsmodus](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) Ihrer Aufgabe ab: + Wenn auf gesetzt `TranserMode` ist `CHANGED` — Die Berechnung basiert auf dem Vergleich des Inhalts der Quell- und Zielspeicherorte und der Bestimmung der Differenz, die übertragen werden muss. Der Unterschied kann Folgendes beinhalten: + Alles, was am Quellspeicherort hinzugefügt oder geändert wurde. + Alles, was sich an beiden Speicherorten [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)befindet und nach einer ersten Übertragung am Ziel geändert wurde (sofern nicht auf eingestellt`NEVER`). + **(Nur einfacher Aufgabenmodus)** Die Anzahl der Elemente, die DataSync voraussichtlich gelöscht werden (falls [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)auf gesetzt`REMOVE`). + Wenn auf gesetzt `TranserMode` ist `ALL` — Die Berechnung basiert nur auf den Elementen, die am DataSync Quellspeicherort gefunden wurden. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Leistungsindikator nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer). Type: Long ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync voraussichtlich an Ihrem Zielort gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) befinden, ist der Wert immer`0`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync voraussichtlich über das Netzwerk übertragen werden. Dieser Wert wird berechnet, während die Verzeichnisse für die Übertragung DataSync [vorbereitet](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) werden. Wie dieser Wert berechnet wird, hängt in erster Linie von der Konfiguration des [Übertragungsmodus](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) Ihrer Aufgabe ab: + Wenn auf gesetzt `TranserMode` ist `CHANGED` — Die Berechnung basiert auf dem Vergleich des Inhalts der Quell- und Zielspeicherorte und der Bestimmung der Differenz, die übertragen werden muss. Der Unterschied kann Folgendes beinhalten: + Alles, was am Quellspeicherort hinzugefügt oder geändert wurde. + Alles, was sich an beiden Speicherorten [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)befindet und nach einer ersten Übertragung am Ziel geändert wurde (sofern nicht auf eingestellt`NEVER`). + Wenn auf gesetzt `TranserMode` ist `ALL` — Die Berechnung basiert nur auf den Elementen, die am DataSync Quellspeicherort gefunden wurden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** Eine Liste von Filterregeln, die bestimmte Daten während Ihrer Übertragung ausschließen. Weitere Informationen und Beispiele finden Sie unter [Filtern von Daten, die übertragen wurden DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), ist der Wert immer`0`. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted). Type: Long ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, die DataSync während der Ausführung der Aufgabe nicht vorbereitet, übertragen, überprüft und gelöscht werden konnten. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) Objekt ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, die DataSync an Ihren Standorten gefunden wurden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) Objekt ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien oder Objekte, DataSync die nach dem Vergleich Ihrer Quell- und Zielspeicherorte zu übertragen versuchen. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Dieser Zähler gilt nicht, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Type: Long ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped). Type: Long ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die DataSync tatsächlich über das Netzwerk übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als sein`EstimatedFilesToTransfer`. In einigen Fällen kann dieser Wert auch größer als sein`EstimatedFilesToTransfer`. Dieses Element ist für einige Standorttypen implementierungsspezifisch. Verwenden Sie es also nicht, um genau anzugeben, was übertragen wird, oder um die Ausführung Ihrer Aufgabe zu überwachen. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Zähler nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred). Type: Long ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Dateien, Objekte und Verzeichnisse, die während der Übertragung DataSync überprüft werden. Wenn Sie Ihre Aufgabe so konfigurieren, [dass nur die übertragenen Daten überprüft](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html) werden. In manchen Situationen werden Verzeichnisse oder Dateien, die DataSync nicht übertragen werden können, nicht überprüft. Bei [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) umfasst dieser Leistungsindikator nur Dateien oder Objekte. Verzeichnisse werden mitgezählt [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified). Type: Long ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die an Ihrem Zielort DataSync tatsächlich gelöscht werden. Wenn Sie Ihre Aufgabe nicht so konfigurieren, [dass Daten im Ziel gelöscht werden, die sich nicht in der Quelle befinden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), ist der Wert immer`0`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, DataSync die während der Ausführung der Aufgabe nicht aufgelistet, vorbereitet, übertragen, überprüft und gelöscht werden können. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) Objekt ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync an Ihren Standorten gefunden werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) Objekt ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, DataSync die nach dem Vergleich Ihrer Quell- und Zielverzeichnisse zu übertragen versuchen. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Dieser Zähler gilt nicht, wenn Sie Ihre Aufgabe so konfigurieren, dass [alle Daten übertragen werden](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). In diesem Szenario wird alles von der Quelle zum Ziel DataSync kopiert, ohne die Unterschiede zwischen den Speicherorten zu vergleichen. Type: Long ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die bei der Übertragung DataSync übersprungen werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die DataSync tatsächlich über das Netzwerk übertragen werden. Dieser Wert wird während der Ausführung der Aufgabe regelmäßig aktualisiert, wenn etwas aus der Quelle gelesen und über das Netzwerk gesendet wird. Wenn DataSync etwas nicht übertragen werden kann, kann dieser Wert kleiner als sein`EstimatedFoldersToTransfer`. In einigen Fällen kann dieser Wert auch größer als sein`EstimatedFoldersToTransfer`. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** Die Anzahl der Verzeichnisse, die während der Übertragung DataSync überprüft werden. Gilt nur für [Aufgaben im erweiterten Modus](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Type: Long ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** Eine Liste von Filterregeln, die während der Übertragung bestimmte Daten enthalten. Weitere Informationen und Beispiele finden Sie unter [Filtern von Daten, die übertragen wurden DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Typ: Array von [FilterRule](API_FilterRule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** Der Zeitpunkt, zu dem die Ausführung der Aufgabe tatsächlich beginnt. Für Aufgaben, die sich nicht in der Warteschlange befinden, `LaunchTime` `StartTime` sind sie in der Regel identisch. Bei Aufgaben in der Warteschlange `LaunchTime` erfolgt dies in der Regel später, als `StartTime` weil Aufgaben, die zuvor in der Warteschlange standen, erst abgeschlossen werden müssen, bevor neuere Aufgaben beginnen können. Typ: Zeitstempel ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** Die Konfiguration des Manifests, das die zu übertragenden Dateien oder Objekte auflistet. Weitere Informationen finden Sie unter [Mithilfe eines Manifests angeben, welche DataSync Übertragungen übertragen](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) werden. Typ: [ManifestConfig](API_ManifestConfig.md) Objekt ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** Gibt 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 Aufrufen keine Option konfigurieren [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). 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. Typ: [Options](API_Options.md) Objekt ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** Gibt an, ob ein vollständiger [Aufgabenbericht](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) für Ihre Übertragung DataSync generiert wurde. Typ: [ReportResult](API_ReportResult.md) Objekt ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** Das Ergebnis der Aufgabenausführung. Typ: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) Objekt ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** Die Uhrzeit, zu der die Anforderung zum Starten der Aufgabenausführung DataSync gesendet wird. Für Aufgaben, die sich nicht in der Warteschlange befinden, `LaunchTime` `StartTime` sind sie in der Regel identisch. Bei Aufgaben in der Warteschlange `LaunchTime` erfolgt dies in der Regel später, als `StartTime` weil Aufgaben, die zuvor in der Warteschlange standen, erst abgeschlossen werden müssen, bevor neuere Aufgaben beginnen können. Typ: Zeitstempel ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** Der Status der Aufgabenausführung. Ausführliche Informationen zum Status der Aufgabenausführung finden Sie unter Status der [Aufgabenausführung](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses). Typ: Zeichenfolge Zulässige Werte: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** Der ARN der Aufgabenausführung, über die Sie Informationen benötigen. `TaskExecutionArn`ist hierarchisch und bezieht sich auf `TaskArn` die Aufgabe, die ausgeführt wurde. Beispielsweise `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` führte ein `TaskExecution` Wert mit dem ARN die Aufgabe mit dem ARN aus`arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen. Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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}$` ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) ** Der Aufgabenmodus, den Sie verwenden. Weitere Informationen finden Sie unter [Auswählen eines Aufgabenmodus für Ihre Datenübertragung](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). Typ: Zeichenfolge Zulässige Werte: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** Die Konfiguration Ihres Aufgabenberichts, der detaillierte Informationen zu Ihrer DataSync Übertragung enthält. Weitere Informationen finden Sie unter [Aufgabenbericht erstellen](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Typ: [TaskReportConfig](API_TaskReportConfig.md) Objekt ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md). ** InternalException ** Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt. HTTP Status Code: 500 ** InvalidRequestException ** Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet. HTTP-Statuscode: 400 ## Beispiele ### Beispielanforderung Dieses Beispiel veranschaulicht eine `DescribeTaskExecution` Anfrage. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### Beispielantwort 1 für die Ausführung einer Aufgabe im erweiterten Modus Das folgende Beispiel beschreibt eine DataSync Aufgabenausführung, die den erweiterten Modus verwendet. Bei der Ausführung werden auch bestimmte Daten mithilfe von Ausschluss- und Include-Filtern übertragen. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "BASIC", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/archive-files" }], "Includes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/files" }], "StartTime": "2024-10-16T11:19:56.844000-04:00", "EstimatedFilesToTransfer": 7, "EstimatedFoldersToTransfer": 2, "EstimatedBytesToTransfer": 30, "FilesTransferred": 7, "FoldersTransferred": 2, "BytesWritten": 30, "BytesTransferred": 30, "BytesCompressed": 30, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3310, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 7, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 7, "FilesListed": { "AtSource": 7, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 2, "FoldersPrepared": 2, "FoldersListed": { "AtSource": 2, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Beispielantwort 2 für die Ausführung einer Aufgabe im erweiterten Modus Das folgende Beispiel beschreibt eine weitere DataSync Aufgabenausführung, die den erweiterten Modus verwendet. In dieser Situation überträgt die Ausführung bestimmte Daten mithilfe eines Manifests anstelle von Filtern. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "TRANSFER", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [], "Includes": [], "ManifestConfig": { "Action": "TRANSFER", "Format": "CSV", "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess", "S3Bucket": "arn:aws:s3:::manifests-datasync", "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG", "Source": { "S3": { "ManifestObjectPath": "manifest-folder/manifest-versioned-files", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess", "S3BucketArn": "arn:aws:s3:::manifests-datasync", "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG" } } }, "StartTime": "2024-10-16T09:29:56.757000-04:00", "EstimatedFilesToTransfer": 1, "EstimatedFoldersToTransfer": 0, "EstimatedBytesToTransfer": 6, "FilesTransferred": 1, "FoldersTransferred": 1, "BytesWritten": 6, "BytesTransferred": 6, "BytesCompressed": 6, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3089, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "TaskReportConfig": { "Destination": { "S3": { "Subdirectory": "reports/", "S3BucketArn": "arn:aws:s3:::my-task-report", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess" } }, "OutputType": "STANDARD", "ReportLevel": "SUCCESSES_AND_ERRORS", "ObjectVersionIds": "INCLUDE" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 1, "ReportResult": { "Status": "SUCCESS" }, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 1, "FilesListed": { "AtSource": 1, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 0, "FoldersPrepared": 0, "FoldersListed": { "AtSource": 0, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### Beispielantwort für die Ausführung einer Aufgabe im Basismodus Das folgende Beispiel beschreibt eine DataSync Aufgabenausführung, die den Basismodus verwendet. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "SUCCESS", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": "2024-10-16T11:19:56.844000-04:00", "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)