此頁面僅適用於使用保管庫和 2012 年起原始 REST API 的 S3 冰川服務的現有客戶。

如果您正在尋找存檔儲存解決方案，我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取、S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項，請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。這些儲存類別使用 Amazon S3 API，可在所有區域使用，並且可以在 Amazon S3 主控台中管理。它們提供了諸如存儲成本分析，存儲鏡頭，包括多種加密選項的安全功能等功能。

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

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

此操作列出了附加到文件庫的所有標籤。如果沒有標籤，該操作傳回空的對應。如需標籤的詳細資訊，請參閱標記 Amazon S3 Glacier 資源。

請求語法

要列出文件庫的標籤，請將 HTTP GET 請求傳送到標籤 URI，如以下語法範例所示。


GET /AccountId/vaults/vaultName/tags HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注意

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

請求參數

此操作不使用請求參數。

請求標頭

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

請求主體

此操作沒有請求內文。

回應

如果操作成功，則服務傳回 HTTP 200 OK 回應。

回應語法


HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "Tags": 
      {
         "string" : "string",
         "string" : "string"
      }
}

回應標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱常見回應標頭。

回應內文

回應內文包含以下 JSON 欄位。

Tags (標籤)

此標籤附加到文件庫。每個標籤皆包含鍵與值。

類型：字串到字串對應

必要：是

錯誤

如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。

範例

範例：列出文件庫的標籤

以下範例列出文件庫的標籤。

範例請求

在這個範例中，傳送 GET 請求以從指定的文件庫中擷取標籤清單。


GET /-/vaults/examplevault/tags HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

回應範例

如果請求成功，則 Amazon S3 Glacier (S3 Glacier) 會如以下範例所示，傳回帶有文件庫標籤清單的 HTTP 200 OK。


HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: length

{
   "Tags",
      {
         "examplekey1": "examplevalue1",
         "examplekey2": "examplevalue2"
      }  
}