**此頁面僅適用於使用 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-vault-get"></a>

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

這個作業會傳回有關保存庫的資訊，包括 Amazon Resource Name (ARN)、保存庫建立日期、保存庫內含的封存數量，以及保存庫中所有封存的大小總計。封存數量及其總大小截至 Amazon Glacier (Amazon Glacier) 產生的最後一個保存庫庫存為止 （請參閱 [在 Amazon Glacier 中使用保存庫](working-with-vaults.md))。Amazon Glacier 大約每天產生保存庫庫存。這表示如果您新增或移除保存庫的封存，然後立即傳送描述保存庫請求、回應可能不會反映變更。

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

若要取得有關保存庫的資訊，請傳送 `GET` 請求至特定保存庫資源的 URI。

### 語法
<a name="api-vault-get-requests-syntax"></a>

```
1. GET /{{AccountId}}/vaults/{{VaultName}} 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 或選擇性指定單一 '`-`' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

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

此操作不使用請求參數。

### 請求標頭
<a name="api-vault-get-requests-headers"></a>

此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 [常見請求標題](api-common-request-headers.md)。

### 請求主體
<a name="api-vault-get-requests-elements"></a>

此操作沒有請求內文。

## 回應
<a name="api-vault-get-responses"></a>

### 語法
<a name="api-vault-get-responses-syntax"></a>

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

{
  "CreationDate" : String,
  "LastInventoryDate" : String,
  "NumberOfArchives" : Number,
  "SizeInBytes" : Number,
  "VaultARN" : String,
  "VaultName" : String
}
```

### 回應標頭
<a name="api-vault-get-responses-headers"></a>

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 [常見回應標頭](api-common-response-headers.md)。

### 回應內文
<a name="api-vault-get-responses-elements"></a>

回應內文包含以下 JSON 欄位。

**CreationDate**  
建立保存庫時的 UTC 日期。  
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**LastInventoryDate**  
Amazon Glacier 完成最後一個保存庫庫存的 UTC 日期。如需有關啟動保存庫之庫存的詳細資訊，請參閱 [啟動任務 (POST 任務)](api-initiate-job-post.md)。  
*類型*：ISO 8601 日期格式的字串表示法，例如，`2013-03-20T17:03:43.221Z`。

**NumberOfArchives**  
根據最後一個保存庫的庫存的保存庫封存數量。如果保存庫尚未執行庫存，此欄位將傳回 Null，例如，您只建立保存庫。  
*類型*：數字

**SizeInBytes**  
保存庫中的封存大小總計以位元組為單位，包括截至最後一個庫存日期的各封存成本。如果保存庫尚未執行庫存，此欄位將傳回 `null`，例如，您只建立保存庫。  
*類型*：數字

**VaultARN**  
保存庫的 Amazon Resource Name (ARN)。  
*類型：*字串

**VaultName**  
在建立時指定的保存庫名稱。保存庫名稱也包含在保存庫的 ARN 中。  
*類型：*字串

### 錯誤
<a name="api-vault-get-responses-errors"></a>

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 [錯誤回應](api-error-responses.md)。

## 範例
<a name="api-vault-get-examples"></a>

### 範例請求
<a name="api-vault-get-example-request"></a>

以下範例示範如何取得有關稱為 `examplevault` 之保存庫的資訊。

```
GET /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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-vault-get-example-response"></a>

```
 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: 260
 6. 
 7. {
 8.   "CreationDate" : "2012-02-20T17:01:45.198Z",
 9.   "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
10.   "NumberOfArchives" : 192,
11.   "SizeInBytes" : 78088912,
12.   "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
13.   "VaultName" : "examplevault"
14. }
```

## 相關章節
<a name="related-sections-vault-get"></a>

 
+ [建立保存庫 (PUT 保存庫)](api-vault-put.md)
+ [「列出保存庫」(GET 保存庫)](api-vaults-get.md)
+ [刪除文件庫 (DELETE 文件庫)](api-vault-delete.md)
+ [啟動任務 (POST 任務)](api-initiate-job-post.md)
+ [Amazon Glacier 的 Identity and Access Management](security-iam.md)

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

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