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

# 標記 Amazon QLDB 資源
<a name="tagging"></a>

**重要**  
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

*標籤*是您指派或 AWS 指派給 AWS 資源的自訂屬性標籤。每個標籤有兩個部分：
+ *標籤鍵* (例如，`CostCenter`、`Environment` 或 `Project`)。標籤鍵會區分大小寫。
+ 選用欄位，稱為*標籤值* (例如 `111122223333` 或 `Production`)。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。

標籤可協助您執行以下操作：
+ 識別和組織您的 AWS 資源。許多 AWS 服務 支援標記，因此您可以將相同的標籤指派給來自不同 服務的資源，以指出資源相關。例如，您可以將相同的標籤指派給指派給 Amazon S3 儲存貯體的 Amazon QLDB 分類帳。
+ 追蹤您的 AWS 成本。您可以在 AWS 帳單與成本管理 儀表板上啟用這些標籤。 AWS 使用標籤來分類您的成本，並為您提供每月成本分配報告。如需詳細資訊，請參閱《[AWS Billing 使用者指南](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/)》中的[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
+ 使用 AWS Identity and Access Management (IAM) 控制對 AWS 資源的存取。如需詳細資訊，請參閱《IAM 使用者指南[使用 QLDB 的屬性型存取控制 (ABAC)](security_iam_service-with-iam.md#security_iam_service-with-iam-tags)》中的本開發人員指南》中的 和[使用 IAM 標籤控制存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_iam-tags.html)。 **

如需使用標籤的提示，請參閱 *AWS 答案部落格*上的 [AWS 標記策略](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/)文章。

下列各節提供 Amazon QLDB 標籤的詳細資訊。

**Topics**
+ [Amazon QLDB 中支援的資源](#supported-resources)
+ [標籤命名和使用慣例](#tagging-conventions)
+ [管理標籤](#tagging-add-edit-delete)
+ [在建立期間標記資源](#tagging-on-creation)

## Amazon QLDB 中支援的資源
<a name="supported-resources"></a>

Amazon QLDB 中的下列資源支援標記：
+ 分類帳
+ table
+ 日誌串流

如需新增和管理標籤的詳細資訊，請參閱[管理標籤](#tagging-add-edit-delete)。

## 標籤命名和使用慣例
<a name="tagging-conventions"></a>

下列基本命名和使用慣例適用於搭配 Amazon QLDB 資源使用標籤的 ：
+ 每個資源的上限為 50 個標籤。
+ 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。
+ 最大標籤索引鍵長度為 128 個 UTF-8 形式的 Unicode 字元。
+ 最大標籤值長度為 256 個 UTF-8 形式的 Unicode 字元。
+ 允許的字元包括可用 UTF-8 表示的英文字母、數字、空格，還有以下特殊字元：***. : \$1 = @ \$1 / -*** (連字號)。
+ 標籤鍵與值皆區分大小寫。做為最佳實務，請決定大寫標籤的策略，並一致地在所有資源類型中實作該策略。例如，決定要使用 `Costcenter`、`costcenter` 還是 `CostCenter`，並針對所有標籤使用相同的慣例。避免針對相似的標籤使用不一致的大小寫處理。
+ 字`aws:`首會保留以供 AWS 使用。如果標籤具有字首為 `aws:` 的標籤金鑰時，您無法編輯或刪除標籤的金鑰或值。具此字首的標籤，不算在受資源限制的標籤計數內。

## 管理標籤
<a name="tagging-add-edit-delete"></a>

標籤是由資源上的 `Key` 和 `Value` 屬性組成。您可以使用 Amazon QLDB 主控台 AWS CLI、 或 QLDB API 來新增、編輯或刪除這些屬性的值。您也可以使用 AWS Resource Groups [標籤編輯器](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)來管理標籤。

如需有關使用標籤的資訊，請參閱下列 API 操作：
+ *Amazon QLDB API 參考*中的 [ListTagsForResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_ListTagsForResource.html) 
+ *Amazon QLDB API 參考*中的 [TagResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_TagResource.html) 
+ *Amazon QLDB API 參考*中的 [UntagResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_UntagResource.html) 

**使用 QLDB 標記面板 （主控台）**

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/qldb](https://console.aws.amazon.com/qldb)：// 開啟 Amazon QLDB 主控台。

1. 在導覽窗格中，選擇 **Ledgers**。

1. 在 **Ledgers** 清單中，選擇您要管理其標籤的分類帳名稱。

1. 在分類帳詳細資訊頁面上，找到**標籤**卡，然後選擇**管理標籤**。

1. 在**管理標籤**頁面上，您可以視需要新增、編輯或移除任何標籤。當標籤索引鍵和值如您希望，請選擇**儲存**。

## 在建立期間標記資源
<a name="tagging-on-creation"></a>

對於支援標記的 QLDB 資源，您可以在建立資源時使用 AWS CLI AWS 管理主控台、 或 QLDB API 定義標籤。藉由在建立時為資源建立標籤，您可以消除在資源建立後執行自訂標籤指令碼的必要。

標記資源後，您可以根據這些標籤控制對資源的存取。例如，您只能授予具有特定標籤之資料表資源的完整存取權。如需 JSON 政策範例，請參閱 [根據資料表標籤完整存取所有動作](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-full-tags)。

**注意**  
資料表和串流資源不會繼承其根分類帳資源的標籤。

您也可以在 `CREATE TABLE` PartiQL 陳述式中指定資料表標籤來定義資料表標籤。如需進一步了解，請參閱[標記資料表](getting-started-standard-mode.md#security_iam_partiql-ref.table-tags)。