使用標籤分類儲存空間 - Amazon Simple Storage Service
與物件標記相關的 API 操作其他組態

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

使用標籤分類儲存空間

使用物件標記，可讓您分類儲存。每個標籤都是金鑰值對。

您可以在上傳新的物件時，為這些物件新增標籤，也可以對現有的物件新增標籤。

  • 一個物件最多可以與 10 個標籤相關聯。與物件相關聯的標籤，必須具備唯一的標籤金鑰。

  • 標籤金鑰最長可包含 128 個 Unicode 字元，標籤值最長可包含 256 個 Unicode 字元。Amazon S3 物件標籤在內部以 UTF-16 表示。請注意，在 UTF-16 中，字元會耗用 1 或 2 個字元的位置。

  • 金鑰與值皆會區分大小寫。

  • 如需標籤限制的詳細資訊，請參閱 AWS 帳單和成本管理使用者指南中的使用者定義的標籤限制。如需基本標籤限制，請參閱 Amazon EC2 使用者指南中的標籤限制。

範例

請考量下列標記範例：

範例 PHI資訊

假設物件包含受保護的健康資訊 (PHI) 資料。您可以使用下列金鑰/值對標記物件。

PHI=True

或

Classification=PHI
範例 專案檔案

假設您將該專案檔存放在您的 S3 儲存貯體中。您可以使用名稱為 Project 的金鑰與值來標記這些物件。

Project=Blue
範例 多個標籤

您可以為物件新增多個標籤，如下所示。

Project=x
Classification=confidential
金鑰名稱前綴和標籤

物件金鑰的前綴名稱可讓您分類儲存體。不過，以前綴為基礎的分類是單一維度的。請考量下列物件金鑰名稱：

photos/photo1.jpg
project/projectx/document.pdf
project/projecty/document2.pdf

這些金鑰名稱使用下列前綴：photos/、project/projectx/ 及 project/projecty/。您可以將這些前綴應用在特定分類。亦即，某前綴下的所有項目均屬於同一個類別。例如，前綴 project/projectx 即表示所有與專案 x 相關的文件。

有了標記功能之後，現在可有不同的區分方式。若希望將 photo1 歸入專案 x 類別，可以依此將該物件加上標記。

其他優勢

除了資料分類之外，標記功能另有其他優點，如下所示：

  • 物件標籤可以更精細地分級許可存取控制。例如，您可以將許可授權給一位使用者，只允許其讀取具有特定標籤的物件。

  • 除了金鑰名稱前綴之外，物件標籤還可以讓您依據標籤作為篩選條件，在生命週期規則中定義更精細的物件生命週期管理。

  • 使用 Amazon S3 分析時，您可以配置篩選條件，依物件標籤、金鑰名稱前綴，或同時使用前綴與標籤來將物件分組。

  • 您也可以自訂 Amazon CloudWatch 指標，依特定標籤篩選條件顯示資訊。下列各節將詳細說明。

重要

可以使用標籤來標記包含機密資料的物件，例如個人識別資訊 (PII) 或受保護的健康資訊 (PHI)。不過，標籤本身無法包含任何機密資訊。

使用單一請求新增物件標籤集至多個 Amazon S3 物件

若要使用單一請求新增超過一個 Amazon S3 物件的物件標籤，您可以使用 S3 Batch Operations。您可以為 S3 批次操作提供一份要進行操作的物件清單。S3 Batch Operations 會呼叫個別的 API 操作來執行指定的操作。單一批次作業任務可在包含數 EB 資料的數十億個物件上執行指定的操作。

S3 批次操作功能會追蹤進度、傳送通知，並存放所有動作的詳細完成報告，提供完整受管、可稽核、無伺服器的體驗。您可以透過 Amazon S3 主控台、 AWS CLI AWS SDKs 或 REST 使用 S3 批次操作API。 Amazon S3 如需詳細資訊，請參閱S3 批次作業基礎知識。

如需物件標籤的詳細資訊，請參閱 管理物件標籤。

與物件標記相關的 API 操作

Amazon S3 支援下列專門用於物件標記的 API 操作：

Object API 操作

  • PUT 物件標記 – 取代物件上的標籤。請在要求內文中指定標籤。使用此 API 的物件標籤管理有兩種不同的案例。

    • 物件沒有標籤 – 使用此API，您可以將一組標籤新增至物件 （物件沒有先前的標籤）。

    • 物件有一組現有標籤 – 若要修改現有標籤集，您必須先擷取現有標籤集，並在用戶端修改，然後使用此 API 取代標籤集。

      注意

      若傳送此請求時附上空的標籤組，則 Amazon S3 會刪除物件上的現有標籤組。如果您使用此方法，則會向您收取層級 1 請求 (PUT) 的費用。如需詳細資訊，請參閱 Amazon S3 定價。

      首選 DELETE 物件標記請求，因為它達成相同的結果，而不會產生費用。

  • GET 物件標記 – 傳回與物件相關聯的標籤集。Amazon S3 會在回應內文中傳回物件的標籤。

  • DELETE 物件標記 – 刪除與物件相關聯的標籤集。

支援標記的其他 API 操作

  • PUT物件和起始分段上傳 – 您可以在建立物件時指定標籤。使用 x-amz-tagging 要求標頭可指定標籤。

  • GET物件 – Amazon S3 不會傳回標籤集，而是傳回x-amz-tag-count標頭中的物件標籤計數 （只有在請求者具有讀取標籤的許可時），因為標頭回應大小限制為 8 K 位元組。如果您想要檢視標籤，請對 GET 物件標記 API 操作提出另一個請求。

  • POST 物件 – 您可以在 POST 請求中指定標籤。

    只要請求中的標籤不超過 8 K 位元組 HTTP 請求標頭大小限制，您可以使用 PUT Object API 建立具有標籤的物件。如果您指定的標籤超過標頭大小限制，您可以使用此 POST 方法，在內文中包含標籤。

    PUT物件 - 複製 – 您可以在請求x-amz-tagging-directive中指定 ，以指示 Amazon S3 複製 （預設行為） 標籤，或以請求中提供的新標籤集取代標籤。

注意下列事項：

其他組態

本節說明物件標記與其他組態的相關性。

物件標記與生命週期管理

您可以在儲存貯體的生命週期組態中指定篩選條件，從物件中選取要套用規則的一部分物件。您可以使用金鑰名稱字首、物件標籤或同時使用兩者，來指定篩選條件。

假設您將相片 (原始與完稿格式) 存放在您的 Amazon S3 儲存貯體中。您可以標記這些物件，如下所示。

phototype=raw
or
phototype=finished

您可能會想要在建立相片之後，將原始相片封存到 S3 Glacier。您可以使用篩選條件設定生命週期規則，指定一組金鑰名稱字首 (photos/) 包含特定標籤 (phototype=raw) 的物件。

如需詳細資訊，請參閱「管理物件的生命週期」。

物件標記和複製

您的儲存貯體如已配置複寫，且您以授予 Amazon S3 讀取標籤的許可，Amazon S3 即會複寫標籤。如需詳細資訊，請參閱設定即時複寫概觀。

物件標記事件通知

您可以設定在為物件新增物件標籤或刪除物件標籤時收到 Amazon S3 事件通知。當物件上的標籤為 PUT 或更新現有標籤時，s3:ObjectTagging:Put事件類型會通知您。s3:ObjectTagging:Delete 事件類型會在標籤從物件移除時通知您。如需詳細資訊，請參閱啟用事件通知。

如需有關物件標記的詳細資訊，請參閱下列主題：

主題