新增標籤至文件庫 (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	單一查詢字串參數 operation 的值為 add，以將其與 從文件庫移除標籤 (POST tags remove) 做區分。	是

請求標頭

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

請求主體

請求內文包含以下 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

相關章節

• 列出文件庫的標籤 (GET 標籤)

• 從文件庫移除標籤 (POST tags remove)

另請參閱

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

• AWS Command Line Interface