# 標記您的 AWS WA Tool 資源
<a name="tagging"></a>

為協助您管理 AWS WA Tool 資源，您可以用*標籤*形式將您自己的中繼資料指派給每個資源。本主題說明標籤並示範如何建立它們。

**Topics**
+ [標籤基本概念](#tag-basics)
+ [標記您的資源](#tag-resources)
+ [標籤限制](#tag-restrictions)
+ [透過主控台使用標籤](#tag-resources-console)
+ [利用 API 使用標籤](#tag-resources-api-sdk)

## 標籤基本概念
<a name="tag-basics"></a>

標籤是您指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個*金鑰*與一個選用*值*。

標籤可讓您分類 AWS 資源，例如依用途、擁有者或環境。當您有許多相同類型的資源時，您可以依據先前指派的標籤，快速識別特定的資源。例如，您可以為 AWS WA Tool 服務定義一組標籤，協助您追蹤每個服務的擁有者和堆疊層級。建議您為每個資源類型設計一組一致的標籤金鑰。

標籤不會自動指派給您的資源。新增標籤後，您可以隨時編輯標籤索引鍵和值，或從資源移除標籤。如果您刪除資源，也會刪除任何該資源的標籤。

標籤對 AWS WA Tool 來說不具有任何語意意義，並會嚴格解譯為字元字串。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。

您可以使用 AWS 管理主控台、AWS CLI 和 AWS WA Tool API 來使用標籤。

若您使用 AWS Identity and Access Management (IAM)，您可以控制您的 AWS 帳戶 帳戶中的哪些使用者具有建立、編輯和刪除標籤的權限。

## 標記您的資源
<a name="tag-resources"></a>

您可以標記新的或現有的 AWS WA Tool 資源。

如果您使用 AWS WA Tool 主控台，您可以在建立新資源時將標籤套用到新資源，或隨時可套用到現有的資源。對於現有的工作負載，您可以透過**屬性**索引標籤套用標籤。對於現有的自訂焦點、設定檔和檢閱範本，您可以透過**概觀**索引標籤套用標籤。

如果您使用的是 AWS WA Tool API、AWS CLI 或 AWS 開發套件，您可以在相關 API 動作上使用 `tags` 參數，將標籤套用到新資源，或使用 `TagResource` API 動作，將標籤套用到現有的資源。如需詳細資訊，請參閱 [TagResource](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html)。

有些資源建立動作可讓您在建立資源時指定資源的標籤。如果無法在資源建立時套用標籤，則資源建立程序會失敗。這可確保您要在建立時標記的資源是以指定的標籤建立，不然就根本不會建立。如果您在建立時標記資源，則不需要在建立資源之後執行自訂標記指令碼。

下表說明可標記的 AWS WA Tool 資源，以及可在建立時標記的資源。


**AWS WA Tool 資源的標記支援**  

| 資源 | 支援標籤 | 支援標籤傳播 | 支援在建立時標記 (AWS WA Tool API、AWS CLI、AWS 開發套件) | 
| --- | --- | --- | --- | 
| AWS WA Tool 工作負載 | 是 | 否 | 是 | 
| AWS WA Tool 自訂焦點 | 是 | 否 | 是 | 
| AWS WA Tool 設定檔 | 是 | 否 | 是 | 
| AWS WA Tool 檢閱範本 | 是 | 否 | 是 | 

## 標籤限制
<a name="tag-restrictions"></a>

以下基本限制適用於標籤：
+ 每一資源最多標籤數 – 50
+ 對於每一個資源，每個標籤金鑰必須是唯一的，且每個標籤金鑰只能有一個值。
+ 索引鍵長度上限 - 128 個 UTF-8 Unicode 字元
+ 值的長度上限 - 256 個 UTF-8 Unicode 字元
+ 如果您的標記結構描述用於多個 AWS 服務和資源，請記得，其他服務可能限制允許的字元。通常允許的字元包括：可用 UTF-8 表示的英文字母、數字和空格，還有以下字元：\+ - = . \_ : / @。
+ 標籤鍵與值皆區分大小寫。
+ 請勿使用 `aws:`、`AWS:` 或其任何大小寫組合做為索引鍵或值的字首，因為這已預留給 AWS 使用。您不可編輯或刪除具此字首的標籤金鑰或值。具此字首的標籤不算在每一資源的標籤數限制內。

## 透過主控台使用標籤
<a name="tag-resources-console"></a>

您可以使用 AWS WA Tool 主控台，管理與新的或現有的資源相關聯的標籤。

### 在建立個別資源時新增標籤
<a name="adding-tags-creation"></a>

您可以在建立 AWS WA Tool 資源時為其新增標籤。

### 在個別資源上新增和刪除標籤
<a name="adding-or-deleting-tags"></a>

AWS WA Tool 可讓您直接從工作負載的**屬性**索引標籤，以及從自訂焦點、設定檔和檢閱範本的**概觀**索引標籤，新增或刪除與資源相關聯的標籤。

**在工作負載上新增或刪除標籤**

1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) 開啟 AWS Well-Architected Tool 主控台。

1. 從導覽列中選擇要使用的「區域」。

1. 在左側導覽窗格中，選擇**工作負載**。

1. 選取要修改的工作負載，然後選擇**屬性**。

1. 在**標籤**區段中，選擇**管理標籤**。

1. 視需要新增或刪除標籤。
   + 若要新增標籤，請選擇**新增標籤**，然後輸入**鍵**和**值**欄位。
   + 若要刪除標籤，請選擇 **Remove** (移除)。

1. 針對您要新增、修改或刪除的每個標籤重複此程序。選擇**儲存**，以儲存變更。

**在自訂焦點上新增或刪除標籤**

1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) 開啟 AWS Well-Architected Tool 主控台。

1. 從導覽列中選擇要使用的「區域」。

1. 在左側導覽窗格中，選擇**自訂焦點**。

1. 選取要修改的自訂焦點名稱。

1. 在**概觀**索引標籤的**標籤**區段中，選擇**管理標籤**。

1. 視需要新增或刪除標籤。
   + 若要新增標籤，請選擇**新增標籤**，然後輸入**鍵**和**值**欄位。
   + 若要刪除標籤，請選擇 **Remove** (移除)。

1. 針對您要新增、修改或刪除的每個標籤重複此程序。選擇**儲存**，以儲存變更。

**在設定檔上新增或刪除標籤**

1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) 開啟 AWS Well-Architected Tool 主控台。

1. 從導覽列中選擇要使用的「區域」。

1. 在導覽窗格中，選擇**設定檔**。

1. 選擇要修改的設定檔名稱。

1. 在**概觀**索引標籤的**標籤**區段中，選擇**管理標籤**。

1. 視需要新增或刪除標籤。
   + 若要新增標籤，請選擇**新增標籤**，然後輸入**鍵**和**值**欄位。
   + 若要刪除標籤，請選擇 **Remove** (移除)。

1. 針對您要新增、修改或刪除的每個標籤重複此程序。選擇**儲存**，以儲存變更。

**在檢閱範本上新增或刪除標籤**

1. 登入 AWS 管理主控台，然後前往 [https://console.aws.amazon.com/wellarchitected/](https://console.aws.amazon.com/wellarchitected/) 開啟 AWS Well-Architected Tool 主控台。

1. 從導覽列中選擇要使用的「區域」。

1. 在導覽窗格中，選擇**啟動範本**。

1. 選取要修改的檢閱範本名稱。

1. 在**概觀**索引標籤的**標籤**區段中，選擇**管理標籤**。

1. 視需要新增或刪除標籤。
   + 若要新增標籤，請選擇**新增標籤**，然後輸入**鍵**和**值**欄位。
   + 若要刪除標籤，請選擇 **Remove** (移除)。

1. 針對您要新增、修改或刪除的每個標籤重複此程序。選擇**儲存**，以儲存變更。

## 利用 API 使用標籤
<a name="tag-resources-api-sdk"></a>

使用下列 AWS WA Tool API 操作來新增、更新、列出及刪除資源的標籤。


**AWS WA Tool 資源的標記支援**  

| 任務 | API 動作 | 
| --- | --- | 
| 新增或覆寫一或多個標籤。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_TagResource.html) | 
| 刪除一或多個標籤。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_UntagResource.html) | 
| 列出資源的標籤。 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ListTagsForResource.html) | 

有些資源建立動作可讓您在建立資源時指定標籤。下列動作支援在建立時新增標籤。


| 任務 | API 動作 | 
| --- | --- | 
| 建立工作負載 | [https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateWorkload.html) | 
| 匯入新的焦點 | [ImportLens](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_ImportLens.html) | 
| 建立設定檔 | [CreateProfile](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateProfile.html) | 
| 建立檢閱範本 | [CreateReviewTemplate](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/API_CreateReviewTemplate.html) |