此頁面僅適用於使用 Vault 和 REST API 2012 年原始版本的 S3 Glacier 服務的現有客戶。
如果您要尋找封存儲存解決方案,建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項,請參閱 Amazon S3
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
建立文件庫 (PUT 文件庫)
描述
此操作將使用指定的名稱建立新的文件庫。 文件庫的名稱在 AWS 帳戶 的 AWS 區域中必須是唯一的。您可以為每個帳戶建立最多 1,000 個文件庫。如需建立更多文件庫的詳細資訊,請前往 Amazon S3 Glacier 產品詳細資訊頁面
命名文件庫時必須使用以下準則。
-
名稱長度可介於 1 到 255 個字元之間。
-
有效字元為 a-z、A-Z、0-9、'_' (底線)、'-' (連字號) 和 '.' (句號)。
這個操作是等冪的,您可以多次傳送相同的請求,並且在 Amazon S3 Glacier (S3 Glacier) 第一次建立指定的文件庫之後,不會再有任何影響。
請求
語法
若要建立文件庫,請將 HTTP PUT 請求傳送到要建立的文件庫 URI 。
PUT /
AccountId
/vaults/VaultName
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
Content-Length:Length
x-amz-glacier-version: 2012-06-01
注意
此 AccountId
值是 AWS 帳戶 ID。此值必須符合與用於簽署請求之憑證關聯的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-
' (連字號),在這種情況下,Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID,請勿在 ID 中包含任何連字號 ('-')。
請求參數
此操作不使用請求參數。
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊,請參閱 常見請求標題。
請求主體
此操作的請求內文必須為空 (0 位元組)。
回應
語法
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location
回應標頭
成功的回應除了所有操作通用的回應標頭之外,還包含下列回應標頭。如需常見回應標頭的詳細資訊,請參閱常見回應標頭。
名稱 | 描述 |
---|---|
|
建立的文件庫的相對 URI 路徑。 類型:字串 |
回應內文
此操作不會傳回任何回應內文。
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊,請參閱錯誤回應。
範例
範例請求
以下範例傳送 HTTP PUT 請求來建立名為 examplevault
的文件庫。
PUT /-/vaults/examplevault HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Content-Length: 0 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
回應範例
S3 Glacier 建立文件庫,並在 Location
標頭中傳回文件庫的相對 URI 路徑。無論帳戶 ID 或連字號 ('Location
') 是否在請求中指定,帳戶 ID 一律會顯示在 -
標頭中。
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT Location: /111122223333/vaults/examplevault
相關章節
另請參閱
如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: