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.
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 -
CloudFormation
fü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 -
FSx
für Amazon FSx -
Neptune
für Amazon Neptune -
RDS
für Amazon Relational Database Service -
Redshift
für Amazon Redshift -
S3
für Amazon Simple Storage Service (Amazon S3) -
SAP HANA on Amazon EC2
für SAP HANA-Datenbanken auf Amazon Elastic Compute Cloud-Instances -
Storage Gateway
für AWS Storage Gateway -
Timestream
für Amazon Timestream -
VirtualMachine
für virtuelle VMware-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 IhnenNextToken
, 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 IhnenNextToken
, 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 einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: