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

响应元素

如果操作成功，服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

BackupVaultList

一组包含文件库元数据的备份库列表成员，包括亚马逊资源名称 (ARN)、显示名称、创建日期、保存的恢复点数量以及加密信息（如果备份库中保存的资源已加密）。

类型：BackupVaultListMember 对象数组

NextToken

所返回项目的部分列表的后续下一个项目。例如，如果请求返回 MaxResults 数量的项目，则 NextToken 允许您从下一个令牌指向的位置开始返回列表中的更多项目。

类型：字符串

错误

有关所有操作返回的常见错误的信息，请参阅常见错误。

InvalidParameterValueException

表示参数的值有问题。例如，该值超出了范围。

HTTP状态码：400

MissingParameterValueException

表示缺少必需的参数。

HTTP状态码：400

ResourceNotFoundException

该操作所需的资源不存在。

HTTP状态码：400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

HTTP状态码：500

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：