翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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、 SDKs AWS CLI、および を使用して、リソースにタグを適用できます AWS Tools for Windows PowerShell。詳細については、次のドキュメントを参照してください。
+ X-Ray API — *AWS X-Ray API リファレンス*の以下の操作を参照してください。
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [サンプリングルールの作成](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)」を参照してください。
+ SDK – [AWS ドキュメント](https://docs.aws.amazon.com/)ページの該当する SDK ドキュメントを参照
**注記**
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://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) で X-Ray コンソールを開きます。
1. ナビゲーションペインで、**設定**を展開し、**Groups**を選択します。
1. **[グループの作成]** を選択してください。
1. **グループの作成**ページで、グループの名前とフィルタ式を指定します。これらのプロパティの詳細については、「[グループの設定](xray-console-groups.md)」を参照してください。
1. **タグ**で、タグキー、およびオプションでタグ値を入力します。たとえば、**Stage**のタグキー、および**Production**のタグ値を入力して、このグループが生産用途であることを示します。タグを追加すると、必要に応じて別のタグを追加するための新しい行が表示されます。タグの制限については、このトピックで [タグの制限](#xray-tagging-restrictions) を参照してください。
1. タグの追加が完了したら、[**Create group (グループの作成)**] を選択します。
### 新しいサンプリングルールにタグを追加する (コンソール)
新しい X-Ray のサンプリングルールを作成する際、**サンプリングルールの作成**ページでタグを追加することができます。
1. にサインイン AWS マネジメントコンソール し、[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://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) で X-Ray コンソールを開きます。
1. ナビゲーションペインで、**設定**を展開し、**Groups**を選択します。
1. **Groups** テーブルで、グループの名前を選択します。
1. **グループの編集**ページ、**タグ**で、タグキーと値を編集します。重複するタグキーを使用することはできません。タグ値はオプションです。必要に応じて値を削除できます。**グループの編集**ページでの他のプロパティの詳細については、「[グループの設定](xray-console-groups.md)」を参照してください。タグの制限については、このトピックで [タグの制限](#xray-tagging-restrictions) を参照してください。
1. タグを削除するには、タグの右側にある**X**を選択します。
1. タグの編集または削除を完了したら、[**グループの更新**] を選択します。
### サンプリングルールのタグを編集または削除する (コンソール)
X-Ray サンプリングルールのタグを**サンプリングルールの編集**ページで変更または削除できます。
1. にサインイン AWS マネジメントコンソール し、[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* をタグキーに、さらにオプションで、*値*をタグ値に置き換えてください。グループの作成方法の詳細については、「[グループ](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)」を参照してください。