描述文件庫 (GET 文件庫)

描述

這個操作會傳回有關文件庫的資訊，包括 Amazon Resource Name (ARN)、文件庫建立日期、文件庫內含的封存數量，以及文件庫中所有封存的大小總計。封存的數量，以及截至所產生最後文件庫庫存 Amazon S3 Glacier (S3 Glacier) 的大小總計 (請參閱 在 Amazon S3 Glacier 中使用文件庫)。S3 Glacier 幾乎每天產生文件庫庫存。這表示如果您新增或移除文件庫的封存，然後立即傳送描述文件庫請求、回應可能不會反映變更。

請求

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

語法

GET /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注意

此 AccountId 值是擁有該文件庫之帳戶的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-' (連字號)，在這種情況下，Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

此操作不使用請求參數。

請求標頭

此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 常見請求標題。

請求主體

此操作沒有請求內文。

回應

語法

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
}

回應標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。

回應內文

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

CreationDate

建立文件庫時的 UTC 日期。

類型：ISO 8601 日期格式的字串表示法，例如，2013-03-20T17:03:43.221Z。

LastInventoryDate

當 S3 Glacier 完成最後一個文件庫庫存時的 UTC 日期。如需有關啟動文件庫之庫存的詳細資訊，請參閱 啟動 Job (POST工作)。

類型：ISO 8601 日期格式的字串表示法，例如，2013-03-20T17:03:43.221Z。

NumberOfArchives

根據最後一個文件庫的庫存的文件庫封存數量。如果文件庫尚未執行庫存，此欄位將傳回 Null，例如，您只建立文件庫。

類型：數字

SizeInBytes

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

類型：數字

VaultARN

文件庫的 Amazon Resource Name (ARN)。

類型：字串

VaultName

在建立時指定的文件庫名稱。文件庫名稱也包含在文件庫的 ARN 中。

類型：字串

錯誤

如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。

範例

範例請求

以下範例示範如何取得有關稱為 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

回應範例

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

相關章節

• 建立文件庫 (PUT 文件庫)

• 「列出文件庫」(GET 文件庫)

• 刪除文件庫 (DELETE 文件庫)

• 啟動 Job (POST工作)

• Amazon S3 Glacier 的 Identity and Access Management

另請參閱

如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：

• AWS Command Line Interface