ListBackupVaults - AWS Backup

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ListBackupVaults

傳回復原點儲存體容器的清單及其相關資訊。

請求語法

GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1

URI 請求參數

請求使用以下URI參數。

ByShared

此參數將依共用保存庫,對保存庫清單進行排序。

ByVaultType

此參數將依保存庫類型,對保存庫清單進行排序。

有效值:BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT

MaxResults

所要傳回的項目數量上限。

有效範圍:最小值為 1。最大值為 1000。

NextToken

傳回項目之部分列表後的下一個項目。例如,如果請求傳回 MaxResults 個數量的項目,則 NextToken 允許您從下一個字符指向的位置開始傳回列表中的更多項目。

請求主體

請求沒有請求主體。

回應語法

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, "VaultState": "string", "VaultType": "string" } ], "NextToken": "string" }

回應元素

如果動作成功,服務會傳回 HTTP 200 個回應。

服務會以 JSON 格式傳回下列資料。

BackupVaultList

包含保存庫中繼資料的備份保存庫清單成員陣列,包括 Amazon Resource Name (ARN)、顯示名稱、建立日期、儲存的復原點數量,以及如果儲存在備份保存庫中的資源已加密,則加密資訊。

類型:BackupVaultListMember 物件陣列

NextToken

傳回項目之部分列表後的下一個項目。例如,如果請求傳回 MaxResults 個數量的項目,則 NextToken 允許您從下一個字符指向的位置開始傳回列表中的更多項目。

類型:字串

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidParameterValueException

表示參數的值出現問題。例如,值超出範圍。

HTTP 狀態碼:400

MissingParameterValueException

表示缺少必要的參數。

HTTP 狀態碼:400

ResourceNotFoundException

動作所需的資源不存在。

HTTP 狀態碼:400

ServiceUnavailableException

由於伺服器發生臨時故障,請求失敗。

HTTP 狀態碼:500

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: