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.
ListBackupVaults
Gibt eine Liste von Wiederherstellungspunkt-Speichercontainern zusammen mit Informationen zu ihnen zurück.
Anforderungssyntax
GET /backup-vaults/?maxResults=MaxResults
&nextToken=NextToken
&shared=ByShared
&vaultType=ByVaultType
HTTP/1.1
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
-
Dieser Parameter sortiert die Liste der Tresore nach gemeinsam genutzten Tresoren.
- ByVaultType
-
Dieser Parameter sortiert die Liste der Tresore nach Tresortyp.
Zulässige Werte:
BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT
- 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
{
"BackupVaultList": [
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"EncryptionKeyArn": "string",
"LockDate": number,
"Locked": boolean,
"MaxRetentionDays": number,
"MinRetentionDays": number,
"NumberOfRecoveryPoints": number
}
],
"NextToken": "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.
- BackupVaultList
-
Eine Reihe von Elementen der Backup-Tresor-Liste mit Tresor-Metadaten, darunter Amazon-Ressourcenname (ARN), Anzeigename, Erstellungsdatum, Anzahl der gespeicherten Wiederherstellungspunkte und Verschlüsselungsinformationen, falls die im Backup-Tresor gespeicherten Ressourcen verschlüsselt sind.
Typ: Array von BackupVaultListMember-Objekten
- 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
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: