**此頁面僅適用於使用 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/)

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

# 刪除文件庫 (DELETE 文件庫)
<a name="api-vault-delete"></a>

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

這個作業會刪除保存庫。Amazon Glacier (Amazon Glacier) 只有在保存庫中沒有根據上次清查的封存，且自上次清查以來沒有寫入保存庫時，才會刪除保存庫。如果未滿足上述任一條件，則保存庫刪除會失敗 （即不會移除保存庫），Amazon Glacier 會傳回錯誤。

您可以使用提供保存庫資訊[描述保存庫 (GET 保存庫)](api-vault-get.md)的操作，包括保存庫中的封存數量；不過，資訊是以 Amazon Glacier 上次產生的保存庫庫存為基礎。

此為等冪操作。

**注意**  
當您刪除文件庫，附加到文件庫的文件庫存取政策也會被刪除。如需保存庫存取政策的詳細資訊，請參閱「[保存庫存取政策](vault-access-policy.md)」。

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

若要刪除文件庫，請將 `DELETE` 請求傳送至文件庫資源 URI。

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

```
1. DELETE /{{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-delete-requests-parameters"></a>

此操作不使用請求參數。

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

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

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

此操作沒有請求內文。

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

### 語法
<a name="api-vault-delete-response-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

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

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

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

此作業不會傳回任何回應內文。

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

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

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

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

以下範例刪除名為「`examplevault`」的文件庫。此範例請求是對於要刪除的資源 (文件庫) 的 URI 之 `DELETE` 請求。

```
1. DELETE /-/vaults/examplevault 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-vault-delete-example-response"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

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

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

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

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