本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 標記 X-Ray 取樣規則和群組
標籤是您可以用來識別和組織 AWS 資源的單字或片語。您可以在每個資源中加入多個標籤。每個標籤都包含您定義的索引鍵和選用值。例如，標籤索引鍵可能是 **domain**，而標籤值可能是 **example.com**。您可以根據您新增的標籤來搜尋和篩選資源。如需如何使用標籤的詳細資訊，請參閱《 *AWS 一般參考*》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。
您可以使用標籤來強制執行 CloudFront 分佈上的標籤型許可。如需詳細資訊，請參閱[使用資源標籤控制對資源的存取 AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
**注意**
[標籤編輯器](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)和資源[AWS 群組](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html)目前不支援 X-Ray 資源。您可以使用 AWS X-Ray 主控台或 API 新增和管理標籤。
您可以使用 X-Ray 主控台、API AWS CLI、 SDKs 和 將標籤套用至資源 AWS Tools for Windows PowerShell。如需詳細資訊，請參閱下列 文件：
+ X-Ray API – 請參閱 *AWS X-Ray API 參考*中的下列操作：
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [CreateSamplingRule](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html)
+ [CreateGroup](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)
+ AWS CLI – 請參閱《 *AWS CLI 命令參考*》中的 [Xray](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html)
+ 開發套件 – 請參閱 [AWS 說明文件](https://docs.aws.amazon.com/)頁面上適用的開發套件說明文件
**注意**
如果您無法在 X-Ray 資源上新增或變更標籤，或無法新增具有特定標籤的資源，您可能沒有執行此操作的許可。若要請求存取，請聯絡您企業中具有 X-Ray 管理員****許可 AWS 的使用者。
**Topics**
+ [標籤限制](#xray-tagging-restrictions)
+ [在 主控台中管理標籤](#xray-tagging-manage)
+ [在 中管理標籤 AWS CLI](#xray-tagging-manage-cli)
+ [根據標籤控制對 X-Ray 資源的存取](#xray-tagging-policy)
## 標籤限制
下列限制適用於標籤。
+ 每一資源最多標籤數：50
+ 金鑰長度上限 - 128 個 Unicode 字元
+ 數值長度上限 - 256 個 Unicode 字元
+ 金鑰與值的有效值 – a-z、A-Z、0-9、空格和下列字元：\$1 . : / = \$1 - 及 @
+ 標籤鍵與值皆區分大小寫。
+ 不要使用 `aws:`做為金鑰的字首；它保留供 AWS 使用。
**注意**
您無法編輯或刪除系統標籤。
## 在 主控台中管理標籤
您可以在建立 X-Ray 群組或取樣規則時新增選用標籤。稍後也可以在主控台中變更或刪除標籤。
下列程序說明如何在 X-Ray 主控台中新增、編輯和刪除群組的標籤和取樣規則。
**Topics**
+ [將標籤新增至新群組 （主控台）](#xray-tagging-add-group-console)
+ [將標籤新增至新的取樣規則 （主控台）](#xray-tagging-add-rule-console)
+ [編輯或刪除群組的標籤 （主控台）](#xray-tagging-change-group-console)
+ [編輯或刪除取樣規則的標籤 （主控台）](#xray-tagging-change-rule-console)
### 將標籤新增至新群組 （主控台）
當您建立新的 X-Ray 群組時，您可以在**建立群組**頁面上新增選用標籤。
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 的 X-Ray 主控台。
1. 在導覽窗格中，展開**組態**，然後選擇**群組**。
1. 選擇**建立群組**。
1. 在**建立群組**頁面上，指定群組的名稱和篩選條件表達式。如需這些屬性的相關資訊，請參閱[設定 群組](xray-console-groups.md)。
1. 在**標籤**中，輸入標籤索引鍵，並選擇性地輸入標籤值。例如，您可以輸入 的標籤索引鍵**Stage**，以及 的標籤值**Production**，以表示此群組用於生產用途。當您新增標籤時，會視需要顯示新行，供您新增另一個標籤。如需標籤的限制，請參閱本主題[標籤限制](#xray-tagging-restrictions)中的 。
1. 新增標籤完成後，請選擇**建立群組**。
### 將標籤新增至新的取樣規則 （主控台）
當您建立新的 X-Ray 取樣規則時，您可以在**建立取樣規則**頁面上新增標籤。
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 的 X-Ray 主控台。
1. 在導覽窗格中，展開**組態**，然後選擇**取樣**。
1. 選擇**建立取樣規則**。
1. 在**建立取樣規則**頁面上，指定名稱、優先順序、限制、相符條件和相符屬性。如需這些屬性的相關資訊，請參閱[設定 取樣規則](xray-console-sampling.md)。
1. 在**標籤**中，輸入標籤索引鍵，並選擇性地輸入標籤值。例如，您可以輸入 的標籤索引鍵**Stage**，以及 的標籤值**Production**，以表示此取樣規則是供生產使用。當您新增標籤時，會視需要顯示新行，供您新增另一個標籤。如需標籤的限制，請參閱本主題[標籤限制](#xray-tagging-restrictions)中的 。
1. 完成新增標籤後，請選擇**建立取樣規則**。
### 編輯或刪除群組的標籤 （主控台）
您可以在**編輯群組**頁面上變更或刪除 X-Ray 群組上的標籤。
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 的 X-Ray 主控台。
1. 在導覽窗格中，展開**組態**，然後選擇**群組**。
1. 在**群組**表格中，選擇群組的名稱。
1. 在**編輯群組**頁面上的**標籤**中，編輯標籤索引鍵和值。您無法有重複的標籤索引鍵。標籤值為選用；您可以視需要刪除值。如需**編輯群組**頁面上其他屬性的詳細資訊，請參閱 [設定 群組](xray-console-groups.md)。如需標籤的限制，請參閱本主題[標籤限制](#xray-tagging-restrictions)中的 。
1. 若要刪除標籤，請選擇標籤右側的 **X**。
1. 當您完成編輯或刪除標籤時，請選擇**更新群組**。
### 編輯或刪除取樣規則的標籤 （主控台）
您可以在編輯取樣規則頁面上變更或刪除 X-Ray **取樣規則**上的標籤。
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 的 X-Ray 主控台。
1. 在導覽窗格中，展開**組態**，然後選擇**取樣**。
1. 在**取樣規則**表格中，選擇取樣規則的名稱。
1. 在**標籤**中，編輯標籤索引鍵和值。您無法有重複的標籤索引鍵。標籤值為選用；您可以視需要刪除值。如需**編輯取樣規則**頁面上其他屬性的詳細資訊，請參閱 [設定 取樣規則](xray-console-sampling.md)。如需標籤的限制，請參閱本主題[標籤限制](#xray-tagging-restrictions)中的 。
1. 若要刪除標籤，請選擇標籤右側的 **X**。
1. 當您完成編輯或刪除標籤時，請選擇**更新取樣規則**。
## 在 中管理標籤 AWS CLI
您可以在建立 X-Ray 群組或取樣規則時新增標籤。您也可以使用 AWS CLI 來建立和管理標籤。若要更新現有群組或取樣規則上的標籤，請使用 AWS X-Ray 主控台或 [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html) 或 [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) APIs。
**Topics**
+ [將標籤新增至新的 X-Ray 群組或取樣規則 (CLI)](#xray-tagging-cli-create)
+ [將標籤新增至現有資源 (CLI)](#xray-tagging-cli-add)
+ [列出資源上的標籤 (CLI)](#xray-tagging-cli-list)
+ [刪除資源上的標籤 (CLI)](#xray-tagging-cli-delete)
### 將標籤新增至新的 X-Ray 群組或取樣規則 (CLI)
若要在建立新的 X-Ray 群組或取樣規則時新增選用標籤，請使用下列其中一個命令。
+ 若要將標籤新增至新群組，請執行下列命令，將 *group\$1name* 取代為您的群組名稱、將 *mydomain.com* 取代為您的服務端點、將 *key\$1name* 取代為標籤索引鍵，以及選擇性地將*值*取代為標籤值。如需如何建立群組的詳細資訊，請參閱 [Groups (群組)](xray-api-configuration.md#xray-api-configuration-groups)。
```
aws xray create-group \
--group-name "group_name" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]
```
下列是 範例。
```
aws xray create-group \
--group-name "AdminGroup" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
+ 若要將標籤新增至新的取樣規則，請執行下列命令，將 *key\$1name* 取代為標籤索引鍵，並選擇性地將*值*取代為標籤值。此命令會將 `--sampling-rule` 參數中的值指定為 JSON 檔案。如需如何建立取樣規則的詳細資訊，請參閱 [抽樣規則](xray-api-configuration.md#xray-api-configuration-sampling)。
```
aws xray create-sampling-rule \
--cli-input-json file://file_name.json
```
以下是 `--cli-input-json` 參數指定的 JSON *file\$1name.json* 內容。
```
{
"SamplingRule": {
"RuleName": "rule_name",
"RuleARN": "string",
"ResourceARN": "string",
"Priority": integer,
"FixedRate": double,
"ReservoirSize": integer,
"ServiceName": "string",
"ServiceType": "string",
"Host": "string",
"HTTPMethod": "string",
"URLPath": "string",
"Version": integer,
"Attributes": {"attribute_name": "value","attribute_name": "value"...}
}
"Tags": [
{
"Key":"key_name",
"Value":"value"
},
{
"Key":"key_name",
"Value":"value"
}
]
}
```
下列是範例命令。
```
aws xray create-sampling-rule \
--cli-input-json file://9000-base-scorekeep.json
```
以下是 `--cli-input-json` 參數所指定範例`9000-base-scorekeep.json`檔案的內容。
```
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1
}
"Tags": [
{
"Key":"Stage",
"Value":"Prod"
},
{
"Key":"Department",
"Value":"QA"
}
]
}
```
### 將標籤新增至現有資源 (CLI)
您可以執行 `tag-resource`命令，將標籤新增至現有的 X-Ray 群組或取樣規則。此方法可能比執行 `update-group`或 新增標籤更簡單`update-sampling-rule`。
若要將標籤新增至群組或抽樣規則，請執行下列命令，以資源的 ARN 取代 ARN，並指定您要新增的標籤索引鍵和選用值。
```
aws xray tag-resource \
--resource-arn "ARN" \
--tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]
```
下列是 範例。
```
aws xray tag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
--tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
### 列出資源上的標籤 (CLI)
您可以執行 `list-tags-for-resource`命令來列出 X-Ray 群組或取樣規則的標籤。
若要列出與群組或取樣規則相關聯的標籤，請執行下列命令，以資源的 ARN 取代 ARN。
```
aws xray list-tags-for-resource \
--resource-arn "ARN"
```
下列是 範例。
```
aws xray list-tags-for-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
```
### 刪除資源上的標籤 (CLI)
您可以執行 `untag-resource`命令，從 X-Ray 群組或取樣規則中移除標籤。
若要從群組或抽樣規則移除標籤，請執行下列命令，以資源的 ARN 取代 ARN，並指定您要移除的標籤索引鍵。
您只能使用 `untag-resource`命令移除整個標籤。若要移除標籤值，請使用 X-Ray 主控台，或刪除標籤，並新增具有相同索引鍵但不同或空白值的新標籤。
```
aws xray untag-resource \
--resource-arn "ARN" \
--tag-keys ["key_name","key_name"]
```
下列是 範例。
```
aws xray untag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
--tag-keys ["Stage","Department"]
```
## 根據標籤控制對 X-Ray 資源的存取
您可以將標籤連接至 X-Ray 群組或取樣規則，或在請求中將標籤傳遞至 X-Ray。如需根據標籤控制存取，請使用 `xray:ResourceTag/key-name`、`aws:RequestTag/key-name` 或 `aws:TagKeys` 條件索引鍵，在政策的[條件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中，提供標籤資訊。若要進一步了解這些條件索引鍵，請參閱[使用 AWS 資源標籤控制資源的存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
若要檢視身分型政策範例，以根據該資源上的標籤來限制存取資源，請參閱 [根據標籤管理對 X-Ray 群組和抽樣規則的存取](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags)。