Amazon EMR on EKS リソースのタグ付け

Amazon EMR on EKS リソースを管理しやすくするために、タグを使用して各リソースに独自のメタデータを割り当てることができます。このトピックでは、タグ機能の概要とタグの作成方法について説明します。

タグの基本

タグとは、AWS リソースに付けるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。

タグを使用すると、AWS リソースを目的、所有者、環境などで分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。例えば、Amazon EMR on EKS クラスターに一連のタグを定義して、各クラスターの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。追加したタグに基づいてリソースを検索およびフィルタリングできます。

タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグも削除されます。

タグには Amazon EMR on EKS に関する意味論的な意味はなく、完全に文字列として解釈されます。

タグの値を空の文字列にすることはできますが、null にすることはできません。タグキーを空の文字列にすることはできません。そのリソースの既存のタグと同じキーを持つタグを追加した場合、古い値は新しい値によって上書きされます。

AWS Identity and Access Management (IAM) を使用すると、AWS アカウント内のどのユーザーがタグを管理するアクセス許可を持っているかを制御できます。

タグベースのアクセスコントロールポリシーの例については、「タグベースのアクセスコントロールのポリシー」を参照してください。

リソースのタグ付け

新規または既存の仮想クラスター、およびアクティブな状態のジョブ実行にタグ付けできます。ジョブ実行のアクティブな状態は、PENDING、SUBMITTED、RUNNING、CANCEL_PENDING などです。仮想クラスターのアクティブな状態は、RUNNING、TERMINATING、ARRESTED などです。詳細については、ジョブ実行状態 および 仮想クラスターの状態 を参照してください。

仮想クラスターが終了すると、タグは消去され、アクセスできなくなります。

Amazon EMR on EKS API、AWS CLI、または AWS SDK を使用している場合、関連する API アクションのタグパラメータを使用して、新しいリソースにタグを適用できます。TagResource API アクションを使用して既存のリソースにタグを適用することもできます。

リソースの作成時に、リソースのタグを指定するためのいくつかのリソース作成アクションを使用できます。その場合、リソースの作成中にタグを適用できないときは、リソースの作成は失敗します。これにより、作成時にタグ付けしたリソースが、指定したタグで作成されているか、まったく作成されていないかが確認できます。作成時にリソースにタグ付けを行う場合、リソースの作成後にカスタムタグ付けスクリプトを実行する必要はありません。

次の表には、タグ付け可能な Amazon EMR on EKS リソースが示されています。

リソース	タグをサポート	タグの伝播をサポート	作成時のタグ付けのサポート (Amazon EMR on EKS API、AWS CLI、AWS SDK)	作成時の API (作成時にタグを追加可能)
仮想クラスター	Yes	いいえ。仮想クラスターに関連付けられたタグは、その仮想クラスターに送信されたジョブ実行には反映されません。	Yes	CreateVirtualCluster
ジョブ実行	Yes	いいえ	Yes	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 つ以上のタグを追加、または上書きします	タグリソース	TagResource
リソースのタグを一覧表示します	list-tags-for-resource	ListTagsForResource
1 つ以上のタグを削除します	タグなしリソース	UntagResource

以下の例では、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