**此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。**

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 [Amazon Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)。

Amazon Glacier （原始獨立保存庫型服務） 不再接受新客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議使用 [Amazon S3 Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 [AWS Amazon Glacier Amazon S3 ](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)

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

# 「列出保存庫」(GET 保存庫)
<a name="api-vaults-get"></a>

## 說明
<a name="api-vaults-get-description"></a>

此作業列出了呼叫使用者帳戶擁有的所有保存庫。回應中傳回的清單是 ASCII 依保存庫名稱排序。

在預設情況下，這個操作會傳回每個請求的最多 10 個項目。如果要列出更多的保存庫，則回應內文中的 `marker` 欄位包含保存庫 Amazon Resource Name (ARN)，以便在該列表中繼續使用新的「列出保存庫」請求，否則 `marker` 欄位是 `null`。在下一個 List Vaults 請求中，您將 `marker` 參數設定為 Amazon Glacier (Amazon Glacier) 在先前 List Vaults 請求的回應中傳回的值。您可以透過在請求中指定 `limit` 參數來限制回應中傳回的文件庫數量。

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

若要取得保存庫清單，請向`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` 值為 AWS 帳戶 ID。此值必須與用來簽署請求的登入資料相關聯的 AWS 帳戶 ID 相符。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID，請勿在 ID 中包含任何連字號 ('-')。

### 請求參數
<a name="api-vaults-get-requests-parameters"></a>

這個作業會傳回以下請求參數。


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
|  limit  | 所要傳回的保存庫數量上限。預設限制為 10。傳回的保存庫數量可能少於指定的限制，但傳回的保存庫數量永遠不會超過限制。<br />類型：字串<br />限制：最小整數值為 1。最大整數值為 10。 |  否  | 
|  marker  | 用於分頁的字串。`marker` 指定保存庫 ARN，之後應該開始保存庫清單。(由 `marker` 指定的保存庫不包括在傳回的清單中。) 從之前的「列出保存庫」回應中取得 `marker` 值。只有在您繼續對之前的「列出保存庫」請求中開始的結果進行分頁時，才需要包含 `marker`。指定標記的空白值 (「」) 會傳回從第一個保存庫開始的保存庫清單。<br />類型：字串<br />限制條件：無 |  否  | 

### 請求標頭
<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) 為準。如果保存庫尚未執行庫存，此欄位可以為 null，例如，您剛剛建立保存庫。如需有關啟動保存庫之庫存的詳細資訊，請參閱 [啟動任務 (POST 任務)](api-initiate-job-post.md)。  
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**Marker**  
`vaultARN` 代表繼續分頁結果。您在另一個「列出保存庫」請求中使用 `marker` 來取得清單中的更多保存庫。如果沒有更多的保存庫，則此值為 `null`。  
*類型：*字串

**NumberOfArchives**  
截至上次庫存日期的保存庫中的封存數量。  
*類型*：數字

**SizeInBytes**  
保存庫中的所有封存大小總計以位元組為單位，包括截至最後一個庫存日期的各封存成本。  
*類型*：數字

**VaultARN**  
保存庫的 Amazon Resource Name (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` 和d `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 保存庫)](api-vault-put.md)
+ [刪除文件庫 (DELETE 文件庫)](api-vault-delete.md)
+ [啟動任務 (POST 任務)](api-initiate-job-post.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

## 另請參閱
<a name="api-vaults-get_SeeAlso"></a>

如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)