建立文件庫 (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

回應標頭

成功的回應除了所有操作通用的回應標頭之外，還包含下列回應標頭。如需常見回應標頭的詳細資訊，請參閱常見回應標頭。

名稱	描述
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

相關章節

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

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

• Amazon S3 Glacier 的 Identity and Access Management

另請參閱

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

• AWS Command Line Interface