ListRestoreJobs

Gibt eine Liste der Jobs zurück, die zur Wiederherstellung einer gespeicherten Ressource AWS Backup initiiert wurden, einschließlich Details zum Wiederherstellungsprozess.

Anforderungssyntax

GET /restore-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&resourceType=ByResourceType&restoreTestingPlanArn=ByRestoreTestingPlanArn&status=ByStatus HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

ByAccountId

Die Konto-ID, von der die Aufträge aufgelistet werden sollen. Gibt nur Wiederherstellungsaufträge zurück, die der angegebenen Konto-ID zugeordnet sind.

Pattern: ^[0-9]{12}$

ByCompleteAfter

Gibt nur Kopieraufträge zurück, die nach einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

ByCompleteBefore

Gibt nur Kopieraufträge zurück, die vor einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

ByCreatedAfter

Gibt nur Wiederherstellungsaufträge zurück, die nach dem angegebenen Datum erstellt wurden.

ByCreatedBefore

Gibt nur Wiederherstellungsaufträge zurück, die vor dem angegebenen Datum erstellt wurden.

ByResourceType

Fügen Sie diesen Parameter ein, um nur Wiederherstellungsaufträge für die angegebenen Ressourcen zurückzugeben:

• Aurora für Amazon Aurora

• CloudFormationfür AWS CloudFormation

• DocumentDB für Amazon DocumentDB (mit MongoDB-Kompatibilität)

• DynamoDB für Amazon DynamoDB

• EBS für Amazon Elastic Block Store

• EC2 für Amazon Elastic Compute Cloud

• EFS für Amazon Elastic File System

• FSxfür Amazon FSx

• Neptune für Amazon Neptune

• RDS für Amazon Relational Database Service

• Redshift für Amazon Redshift

• S3für Amazon Simple Storage Service (Amazon S3)

• SAP HANA on Amazon EC2für SAP HANA-Datenbanken auf Amazon Elastic Compute Cloud-Instances

• Storage Gatewayfür AWS Storage Gateway

• Timestream für Amazon Timestream

• VirtualMachinefür VMware virtuelle Maschinen

Pattern: ^[a-zA-Z0-9\-\_\.]{1,50}$

ByRestoreTestingPlanArn

Gibt nur Wiederherstellungstestaufträge zurück, die mit dem Amazon-Ressourcennamen (ARN) der angegebenen Ressource übereinstimmen.

ByStatus

Gibt nur Wiederherstellungsaufträge zurück, die dem angegebenen Auftragsstatus zugeordnet sind.

Zulässige Werte: PENDING | RUNNING | COMPLETED | ABORTED | FAILED

MaxResults

Die maximale Anzahl der zurückzugebenden Elemente.

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "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.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

Typ: Zeichenfolge

RestoreJobs

Eine Reihe von Objekten, die detaillierte Informationen zu Aufträgen zur Wiederherstellung gespeicherter Ressourcen enthalten.

Typ: Array von RestoreJobsListMember-Objekten

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InvalidParameterValueException

Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.

HTTP Status Code: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

HTTP Status Code: 400

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

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

• AWS -Befehlszeilenschnittstelle

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK für JavaScript V3

• AWS SDK for PHP V3

• AWS SDK für Python

• AWS SDK for Ruby V3