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

此操作會從附加到文件庫的一組標籤移除一或多個標籤。如需標籤的詳細資訊，請參閱標記 Amazon S3 Glacier 資源。

此為等冪操作。操作將會成功，即使沒有標籤附加到文件庫。

請求語法

若要從文件庫移除標籤，請如以下語法範例所示，將 HTTP POST 請求傳送到標籤 URI。

POST /AccountId/vaults/vaultName/tags?operation=remove HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
{
   "TagKeys": [
      "string",
      "string"
   ]
}

注意

此 AccountId 值是 AWS 帳戶 ID。此值必須符合與用於簽署請求之憑證關聯的 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性使用 '-' (連字號)，在這種情況下，Amazon S3 會使用與用於簽署請求之憑證關聯的 AWS 帳戶 ID。如果您要指定帳戶 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

名稱	描述	必要
operation=remove	單一查詢字串參數 operation 的值為 remove，以將其與 新增標籤至文件庫 (POST 標籤新增) 做區分。	是

請求標頭

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

請求主體

請求內文包含以下 JSON 欄位。

TagKeys

標籤金鑰的清單。每個對應的標籤會從文件庫移除。

類型：字串的陣列

長度限制條件：清單中最少 1 個項目。清單中最多 10 個項目。

必要：是

回應

如果動作成功，則服務會傳回具空的 HTTP 內文的 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=remove 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
			
{
   "TagsKeys": [
      "examplekey1",
      "examplekey2"
   ]        
}

回應範例

如果請求成功，則 Amazon S3 Glacier (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

相關章節

• 新增標籤至文件庫 (POST 標籤新增)

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

另請參閱

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

• AWS Command Line Interface