翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon EMR on EKS リソースのタグ付け
Amazon EMR on EKS リソースを管理しやすくするために、タグを使用して各リソースに独自のメタデータを割り当てることができます。このトピックでは、タグ機能の概要とタグの作成方法について説明します。
**Topics**
+ [タグの基本](#tag-resources-tag-basics)
+ [リソースのタグ付け](#tag-resources-add-tags)
+ [タグの制限](#tag-resources-restrictions)
+ [AWS CLI と Amazon EMR on EKS API を使用してタグを操作する](#tag-resources-work-with-tags)
## タグの基本
タグは、 AWS リソースに割り当てるラベルです。各タグはキーとオプションの値で構成され、どちらもお客様側が定義します。
タグを使用すると、目的、所有者、環境などの属性別に AWS リソースを分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。例えば、Amazon EMR on EKS クラスターに一連のタグを定義して、各クラスターの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。追加したタグに基づいてリソースを検索およびフィルタリングできます。
タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグもすべて削除されます。
タグには Amazon EMR on EKS に関する意味論的な意味はなく、完全に文字列として解釈されます。
タグの値を空の文字列にすることはできますが、null にすることはできません。タグキーを空の文字列にすることはできません。そのリソースの既存のタグと同じキーを持つタグを追加した場合、古い値は新しい値によって上書きされます。
AWS Identity and Access Management (IAM) を使用する場合は、 AWS アカウントのどのユーザーがタグを管理するアクセス許可を持っているかを制御できます。
タグベースのアクセスコントロールポリシーの例については、「[タグベースのアクセスコントロールのポリシー](security_iam_TBAC.md)」を参照してください。
## リソースのタグ付け
新規または既存の仮想クラスター、およびアクティブな状態のジョブ実行にタグ付けできます。ジョブ実行のアクティブな状態は、`PENDING`、`SUBMITTED`、`RUNNING`、`CANCEL_PENDING` などです。仮想クラスターのアクティブな状態は、`RUNNING`、`TERMINATING`、`ARRESTED` などです。詳細については、「[ジョブ実行状態](emr-eks-jobs-states.md)」および「[仮想クラスターの状態](virtual-cluster.md#virtual-cluster-states)」を参照してください。
仮想クラスターが終了すると、タグは消去され、アクセスできなくなります。
Amazon EMR on EKS API、、 AWS CLIまたは AWS SDK を使用している場合は、関連する API アクションの tags パラメータを使用して、新しいリソースにタグを適用できます。`TagResource` API アクションを使用して既存のリソースにタグを適用することもできます。
リソースの作成時に、リソースのタグを指定するためのいくつかのリソース作成アクションを使用できます。その場合、リソースの作成中にタグを適用できないときは、リソースの作成は失敗します。これにより、作成時にタグ付けしたリソースが、指定したタグで作成されているか、まったく作成されていないかが確認できます。作成時にリソースにタグ付けを行う場合、リソースの作成後にカスタムタグ付けスクリプトを実行する必要はありません。
次の表には、タグ付け可能な Amazon EMR on EKS リソースが示されています。
****
| [リソース] | タグをサポート | タグの伝播をサポート | 作成時のタグ付けをサポート (Amazon EMR on EKS API、 AWS CLIおよび AWS SDK) | 作成時の API (作成時にタグを追加可能) |
| --- | --- | --- | --- | --- |
| 仮想クラスター | はい | いいえ。仮想クラスターに関連付けられたタグは、その仮想クラスターに送信されたジョブ実行には反映されません。 | はい | CreateVirtualCluster |
| ジョブ実行 | はい | なし | はい | StartJobRun |
## タグの制限
タグには以下のような基本制限があります。
+ リソースあたりのタグの最大数 - 50 件
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ タグ付けスキーマが複数の AWS サービスやリソースで使用されている場合は、他のサービスで許可される文字に制限がある場合があることに注意してください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および \+、-、=、.、\_、:、/、@。
+ タグのキーと値では、大文字と小文字が区別されます。
+ タグの値を空の文字列にすることはできますが、null にすることはできません。タグキーを空の文字列にすることはできません。
+ キーまたは値のプレフィックスとして、`aws:`、`AWS:`、またはその大文字と小文字の組み合わせを変えたものは使用しないでください。これらは AWS 使用のためにのみ予約されています。
## AWS CLI と Amazon EMR on EKS API を使用してタグを操作する
次の AWS CLI コマンドまたは Amazon EMR on EKS API オペレーションを使用して、リソースのタグを追加、更新、一覧表示、削除します。
****
| タスク | AWS CLI | API アクション |
| --- | --- | --- |
| 1 つ以上のタグを追加、または上書きします | [タグリソース](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_TagResource.html) |
| リソースのタグの一覧表示 | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_ListTagsForResource.html) |
| 1 つ以上のタグを削除します | [タグなしリソース](https://docs.aws.amazon.com/cli/latest/reference/emr-containers/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/emr-on-eks/latest/APIReference/API_UntagResource.html) |
以下の例では、 AWS CLIを使用して、リソースに対してタグ付けまたはタグ削除する方法を示しています。
**例 1: 既存仮想クラスターへのタグ付け**
次のコマンドは既存の仮想クラスターにタグ付けします。
```
aws emr-containers tag-resource --resource-arn {{resource_ARN}} --tags {{team}}={{devs}}
```
**例 2: 既存仮想クラスターでのタグ削除**
次のコマンドは既存の仮想クラスターからタグを削除します。
```
aws emr-containers untag-resource --resource-arn {{resource_ARN}} --tag-keys {{tag_key}}
```
**例 3: リソースのタグのリスト取得**
次のコマンドは、既存のリソースに関連付けられているタグのリストを取得します。
```
aws emr-containers list-tags-for-resource --resource-arn {{resource_ARN}}
```