ListBackupVaults - AWS Backup
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

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
      }
   ],
   "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

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：