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

# Tags (標籤)
<a name="tagging"></a>

**重要**  
 AWS OpsWorks Stacks 此服務已於 2024 年 5 月 26 日終止，並已針對新客戶和現有客戶停用。我們強烈建議客戶盡快將其工作負載遷移至其他解決方案。如果您對遷移有任何疑問，請透過 [AWS re：Post](https://repost.aws/) 或透過 [AWS Premium Support](https://aws.amazon.com/support) 聯絡 AWS 支援 團隊。

標籤可以協助您對 Chef 11.10、Chef 12 和 Chef 12.2 堆疊中的資源進行分組，並追蹤在 [AWS 帳單與成本管理](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) 中使用這些資源的成本。

您可以在堆疊和 layer 層級套用標籤。建立標籤時，您會將標籤套用於已加上標籤的結構中每項資源。例如，如果您將標籤套用至 layer，您要將標籤套用至 layer 中的每個執行個體、Amazon EBS 磁碟區 （根除外） 或 Elastic Load Balancing 負載平衡器。標籤目前無法套用至執行個體根或預設的 EBS 磁碟區。

標籤是您指派給 Stacks OpsWorks 中堆疊或層的鍵/值對。建立標籤後，請開啟 Billing and Cost Management 主控台以啟用使用者定義的標籤。如需如何啟用標籤並使用它們來追蹤和管理 OpsWorks Stacks 資源成本的詳細資訊，請參閱 帳單與成本管理使用者指南中的[使用成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)和[啟用使用者定義的成本分配標籤](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html)。 **

標籤的運作方式類似於 Stacks OpsWorks 中的自訂屬性。您套用到堆疊的標籤，會由該堆疊中的每個 layer 繼承。在圖層層級，您可以覆寫繼承標籤的值 （而非金鑰名稱），並新增新的圖層特定標籤。 會將產生的標籤集 OpsWorks 套用至圖層中的所有資源。當您建立新資源或將現有資源指派到某個 layer 時，該 layer 中的新資源將使用相同的標籤集進行標記。

**Topics**
+ [在堆疊層級設定標籤](#w2ab1c14c63c15)
+ [在 Layer 層級設定標籤](#w2ab1c14c63c17)
+ [使用 管理標籤 AWS CLI](#w2ab1c14c63c19)
+ [標籤限制](#w2ab1c14c63c21)

## 在堆疊層級設定標籤
<a name="w2ab1c14c63c15"></a>

在堆疊層級，您可以在堆疊的首頁上選擇 **Tags (標籤)** 來新增和管理標籤。

![\[Tags section with icon and description for applying tags to stack resources.\]](http://docs.aws.amazon.com/zh_tw/opsworks/latest/userguide/images/stack_tags.png)


在 **Tags (標籤)** 頁面上，將標籤新增為鍵/值對。下列螢幕擷取畫面示範一些範例標籤。您可以選擇鍵/值對右邊的紅色 **X** 來刪除標籤。

![\[Tags interface showing key-value pairs for Organization and Staging, with options to add or delete tags.\]](http://docs.aws.amazon.com/zh_tw/opsworks/latest/userguide/images/stack_tags_add.png)


## 在 Layer 層級設定標籤
<a name="w2ab1c14c63c17"></a>

在 layer 層級，選擇 **Tags (標籤)** 標籤來設定標籤。您可以在 **Layers (Layer)** 首頁以及每個 layer 的首頁上找到此標籤。

![\[List of layers including ELB, HAProxy, Rails, PHP, Node.js, and MySQL with configuration options.\]](http://docs.aws.amazon.com/zh_tw/opsworks/latest/userguide/images/layers_tags.png)


當您在 layer 層級變更或新增標籤時，請注意，已在父堆疊層級新增的標籤將由該 layer 及其資源繼承。雖然您可以變更繼承標籤的值，但無法變更鍵名稱或刪除繼承標籤。請在堆疊設定中變更鍵名稱或刪除從父堆疊繼承的標籤。下列螢幕擷取畫面示範從堆疊層級繼承的標籤。繼承的標籤呈現灰色。

![\[Tags interface showing inherited and editable fields for Organization and Staging keys.\]](http://docs.aws.amazon.com/zh_tw/opsworks/latest/userguide/images/layer_inherited_tags.png)


如需將標籤新增至堆疊的詳細資訊，請參閱[建立新的堆疊](workingstacks-creating.md)。如需如何將標籤新增至 layer 的詳細資訊，請參閱[編輯 OpsWorks Layer 的組態](workinglayers-basics-edit.md)。

## 使用 管理標籤 AWS CLI
<a name="w2ab1c14c63c19"></a>

您也可以使用 AWS CLI 命令在堆疊和 layer 層級新增和移除標籤。如需下載和安裝 的詳細資訊 AWS CLI，請參閱[安裝 AWS 命令列界面](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。如果要標記的堆疊不在您的預設區域內，請記得將 `--region` 參數新增到您的命令中。Layer ARNs目前不會顯示在 中 AWS 管理主控台。若要取得 layer 的 ARN，請執行 [describe-layers](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-layers.html) 命令。

**使用 新增標籤 AWS CLI**
+ 在 AWS CLI 命令提示字元中輸入下列命令，取代 *stack\$1or\$1layer\$1ARN* 並指定您的鍵值對標籤，然後按 **Enter** 鍵。雙引號會以反斜線逸出。

  ```
  aws opsworks tag-resource --resource-arn stack_or_layer_ARN --tags "{\"key\":\"value\",\"key\":\"value\"}"
  ```

  下列是 範例。

  ```
  aws opsworks tag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tags "{\"Stage\":\"Production\",\"Organization\":\"Mobile\"}"
  ```

**使用 移除標籤 AWS CLI**
+ 在 AWS CLI 命令提示字元中輸入以下內容，然後按 **Enter**。

  ```
  aws opsworks untag-resource --resource-arn stack_or_layer_ARN --tag-keys "[\"key\",\"key\"]"
  ```

  若要移除標籤，您只需指定您想要移除的標籤鍵即可。下列是 範例。

  ```
  aws opsworks untag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tag-keys "[\"Stage\",\"Organization\"]"
  ```
**注意**  
您無法從 layer 中移除繼承的標籤 (在父堆疊層級中新增的標籤)。請從堆疊移除繼承的標籤。

## 標籤限制
<a name="w2ab1c14c63c21"></a>

建立標籤時，請謹記下列限制：
+ OpsWorks Stacks 會將堆疊和 layer 層級的使用者定義標籤數量限制為 40，包括繼承自父層級的使用者定義標籤。這將保留 10 個可用插槽，用於以 開頭的預設標籤`opsworks:`，以及由其他 AWS 程序設定的標籤。資源最多允許 50 個標籤，包括由 建立的使用者定義和預設標籤 AWS。
+ 標籤鍵不能以 **aws:**、**opsworks:** 或 **rds:** 起始。請勿使用 **name**或 **Name**做為標籤索引鍵，因為 **Name** 是由 Stacks OpsWorks 保留。
+ 一個鍵最多可包含 127 個字元，並且只能包含 Unicode 字母、數字或分隔符號，或是下列特殊字元：`+ - = . _ : / `。
+ 一個值最多可包含 255 個字元，並且只能包含 Unicode 字母、數字或分隔符號，或是下列特殊字元：`+ - = . _ : / `。