此頁面僅適用於使用文件庫的 S3 Glacier 服務的現有客戶,並且是 2012 年RESTAPI起的原始客戶。
如果您正在尋找存檔儲存解決方案,我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項,請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
新增標籤至文件庫 (POST 標籤新增)
該操作將指定的標籤新增到文件庫。每個標籤皆包含鍵與值。每個文件庫最多可擁有 50 個標籤。如果您的請求會導致超出文件庫的標籤限制,則該操作會擲出 LimitExceededException
錯誤。
如果標籤已存在於指定金鑰下的文件庫,則現有的索引鍵值將會被覆寫。如需標籤的詳細資訊,請參閱標記 Amazon S3 Glacier 資源。
請求語法
若要將標籤新增到文件庫,請將 HTTP POST 請求傳送到標籤 URI,如以下語法範例所示。
POST /
AccountId
/vaults/vaultName
/tags?operation=add HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
Content-Length:Length
x-amz-glacier-version: 2012-06-01 { "Tags": { "string
": "string
", "string
": "string
" } }
注意
此 AccountId
值是 AWS 帳戶 ID。此值必須符合與用於簽署請求之憑證關聯的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-
' (連字號),在這種情況下,Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID,請勿在 ID 中包含任何連字號 ('-')。
請求參數
名稱 | 描述 | 必要 |
---|---|---|
operation=add
|
單一查詢字串參數 |
是 |
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊,請參閱 常見請求標題。
請求主體
請求內文包含以下 JSON 欄位。
- Tags (標籤)
-
此標籤新增到文件庫。每個標籤皆包含鍵與值。此數值可以是空字串。
類型:字串到字串對應
長度限制:最小長度為 1。長度上限為 10。
必要:是
回應
如果操作請求成功,則服務會傳回 HTTP 204 No
Content
回應。
語法
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date
回應標頭
此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊,請參閱 常見回應標頭。
回應內文
此操作不會傳回任何回應內文。
錯誤
如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊,請參閱錯誤回應。
範例
範例請求
以下範例傳送帶有標籤的 HTTP POST 以新增至文件庫。
POST /-/vaults/examplevault/tags?operation=add HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length:
length
x-amz-glacier-version: 2012-06-01 { "Tags": { "examplekey1": "examplevalue1", "examplekey2": "examplevalue2" } }
回應範例
如果請求成功,則 S3 Glacier 會如以下範例所示傳回 HTTP 204 No Content
。
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
相關章節
另請參閱
如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: