本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListBackupVaults
傳回復原點儲存體容器的清單及其相關資訊。
請求語法
GET /backup-vaults/?maxResults=MaxResults
&nextToken=NextToken
&shared=ByShared
&vaultType=ByVaultType
HTTP/1.1
URI 請求參數
請求使用以下URI參數。
-
此參數將依共用保存庫,對保存庫清單進行排序。
- 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,請參閱下列內容: