從保存庫移除標籤 (POST tags remove) - Amazon S3 Glacier
請求語法請求參數回應範例相關章節另請參閱

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 S3 Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier S3 Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱《Amazon S3 使用者指南》中的使用 S3 Glacier 儲存類別的 S3 Glacier 儲存類別和長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，可在所有區域使用，並且可在 Amazon S3 主控台中管理。它們提供 Storage Cost Analysis、Storage Lens、進階選用加密功能等功能。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

從保存庫移除標籤 (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 Glacier 會使用與用來簽署請求之登入資料相關聯的 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

另請參閱

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