**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**

如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)。

Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， Amazon 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 Amazon Web Services 区域 可用性、更低的成本和 Amazon 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [Amazon 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://www.amazonaws.cn/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 列出文件库（GET vaults）
<a name="api-vaults-get"></a>

## 描述
<a name="api-vaults-get-description"></a>

此操作会列出调用用户的账户拥有的所有文件库。响应中返回的列表按文件库名称的 ASCII 顺序排序。

默认情况下，每次请求时此操作最多返回 10 个项目。如果有更多文件库要列出，则响应正文中的 `marker` 字段会包含文件库的 Amazon 资源名称（ARN），新的列出文件库请求会从该名称处继续列表；否则，`marker` 字段为 `null`。在下一个列出文件库请求中，您可以将 `marker` 参数设置为 Amazon Glacier（Amazon Glacier）为上一个列出文件库请求所回复的值。您也可以通过在请求中指定 `limit` 参数来限制响应中返回的文件库数。

## 请求
<a name="api-vaults-get-requests"></a>

要获取文件库列表，您需要向 *vaults* 资源发送 `GET` 请求。

### 语法
<a name="api-vaults-get-requests-syntax"></a>

```
1. GET /AccountId/vaults HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**注意**  
`AccountId` 值为 Amazon Web Services 账户 ID。此值必须与用来对请求进行签名的凭证相关联的 Amazon Web Services 账户 ID 相匹配。您可以指定 Amazon Web Services 账户 ID，也可以选择指定“`-`”（连字符），在这种情况下，Amazon Glacier 使用与用来对请求进行签名的凭证相关联的 Amazon Web Services 账户 ID。如果您指定账户 ID，请勿在 ID 中包含任何连字符（-）。

### 请求参数
<a name="api-vaults-get-requests-parameters"></a>

此操作接受以下请求参数。


|  名称  |  描述  |  是否必需  | 
| --- | --- | --- | 
|  limit  |  指定要返回的文件库最大数目。默认限制为 10。返回的文件库数可能少于指定的限制值，但永远不会超过限制值。 类型：字符串 约束：最小整数值为 1。最大整数值为 10。  |  否  | 
|  marker  |  用于分页的字符串。`marker` 指定应从其开始列出文件库的文件库 ARN。（`marker` 指定的文件库不包括在返回的列表中。） 从之前的列出文件库响应获取 `marker` 值。只有在您要继续对之前的列出文件库请求中开始的结果进行分页，您才需要包括 `marker`。如果为标记指定空值（""），则系统会返回从第一个文件库开始的文件库列表。 类型：字符串 约束：无  |  否  | 

### 请求标头
<a name="api-vaults-get-requests-headers"></a>

此操作仅使用所有操作通用的请求标头。有关通用请求标头的信息，请参阅[通用请求标头](api-common-request-headers.md)。

### 请求正文
<a name="api-vaults-get-requests-elements"></a>

此操作没有请求正文。

## 响应
<a name="api-vaults-get-responses"></a>

### 语法
<a name="api-vaults-get-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "Marker": String
  "VaultList": [ 
   {
    "CreationDate": String,
    "LastInventoryDate": String,
    "NumberOfArchives": Number,
    "SizeInBytes": Number,
    "VaultARN": String,
    "VaultName": String
   }, 
   ...
  ]
}
```

### 响应标头
<a name="api-vaults-get-responses-headers"></a>

此操作仅使用大多数响应通用的响应标头。有关通用响应标头的信息，请参阅[通用响应标头](api-common-response-headers.md)。

### 响应正文
<a name="api-vaults-get-response-body"></a>

响应正文包含以下 JSON 字段。

 

**CreationDate**  
以协调世界时（UTC）来表示的文件库创建日期。  
*类型*：字符串。以 ISO 8601 日期格式表示的字符串，例如 `2013-03-20T17:03:43.221Z`。

**LastInventoryDate**  
以协调世界时（UTC）来表示的上次文件库库存盘点日期。如果文件库中尚未运行清单操作（例如，您刚刚创建了文件库），则此字段可能为空。有关启动文件库清单的信息，请参阅[启动任务（POST jobs）](api-initiate-job-post.md)。  
*类型*：以 ISO 8601 日期格式表示的字符串，例如 `2013-03-20T17:03:43.221Z`。

**Marker**  
表示从何处继续对结果进行分页的 `vaultARN`。您可以在另一个列出文件库请求中使用 `marker` 来获取列表中的更多文件库。如果没有更多文件库，则此值为 `null`。  
*类型*：字符串

**NumberOfArchives**  
截止到上次编制清单日期，文件库中的档案数。  
*类型*：数字

**SizeInBytes**  
截止到上次编制清单日期，文件库中所有档案的总大小（以字节为单位），包括每个档案所具有的任何开销。  
*类型*：数字

**VaultARN**  
文件库的 Amazon 资源名称（ARN）。  
*类型*：字符串

**VaultList**  
数据元数组，其中的每个数据元均提供了文件库描述。  
*类型*：数组

**VaultName**  
文件库名称。  
*类型*：字符串

### 错误
<a name="api-vaults-get-responses-errors"></a>

有关 Amazon Glacier 异常和错误消息的信息，请参阅[错误响应](api-error-responses.md)。

## 示例
<a name="api-vaults-get-examples"></a>

### 示例：列出所有文件库
<a name="api-vaults-get-example1"></a>

以下示例列出了文件库。由于请求中没有指定 `marker` 和 `limit` 参数，因此，系统最多会返回 10 个文件库。

#### 请求示例
<a name="api-vaults-get-example1-request"></a>

```
1. GET /-/vaults HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 响应示例
<a name="api-vaults-get-example1-response"></a>

`Marker` 为 `null`，表示没有更多文件库要列出。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 497	
 6. 
 7. {
 8.   "Marker": null,
 9.   "VaultList": [ 
10.    {
11.     "CreationDate": "2012-03-16T22:22:47.214Z",
12.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13.     "NumberOfArchives": 2,
14.     "SizeInBytes": 12334,
15.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16.     "VaultName": "examplevault1"
17.    }, 
18.    {
19.     "CreationDate": "2012-03-19T22:06:51.218Z",
20.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21.     "NumberOfArchives": 0,
22.     "SizeInBytes": 0,
23.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24.     "VaultName": "examplevault2"
25.    },
26.    {
27.     "CreationDate": "2012-03-19T22:06:51.218Z",
28.     "LastInventoryDate": "2012-03-25T12:14:31.121Z",
29.     "NumberOfArchives": 0,
30.     "SizeInBytes": 0,
31.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
32.     "VaultName": "examplevault3"
33.    } 
34.   ]
35. }
```

### 示例：文件库的部分列表
<a name="api-vaults-get-example2"></a>

以下示例会返回从 `marker` 指定的文件库开始的两个文件库。

#### 请求示例
<a name="api-vaults-get-example2-request"></a>

```
1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

#### 响应示例
<a name="api-vaults-get-example2-response"></a>

列表中返回了两个文件库。`Marker` 包含文件库 ARN，以便在另一个列出文件库请求中继续分页。

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 497	
 6. 
 7. {
 8.   "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
 9.   "VaultList": [ 
10.    {
11.     "CreationDate": "2012-03-16T22:22:47.214Z",
12.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13.     "NumberOfArchives": 2,
14.     "SizeInBytes": 12334,
15.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16.     "VaultName": "examplevault1"
17.    }, 
18.    {
19.     "CreationDate": "2012-03-19T22:06:51.218Z",
20.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21.     "NumberOfArchives": 0,
22.     "SizeInBytes": 0,
23.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24.     "VaultName": "examplevault2"
25.    }
26.   ]
27. }
```

## 相关部分
<a name="related-sections-vaults-get"></a>

 
+ [创建文件库（PUT vault）](api-vault-put.md)
+ [删除文件库（DELETE vault）](api-vault-delete.md)
+ [启动任务（POST jobs）](api-initiate-job-post.md)
+ [适用于 Amazon Glacier 的 Identity and Access Management](security-iam.md)

## 另请参阅
<a name="api-vaults-get_SeeAlso"></a>

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [Amazon Command Line Interface](https://docs.amazonaws.cn/cli/latest/reference/glacier/list-vaults.html)