此頁面僅適用於使用文件庫的 S3 Glacier 服務的現有客戶,並且是 2012 年RESTAPI起的原始客戶。
如果您正在尋找存檔儲存解決方案,我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項,請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
描述文件庫 (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" }
相關章節
另請參閱
如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: