Amazon EKS
ユーザーガイド

Amazon EKS リソースにタグを付ける

Amazon EKS クラスターを管理しやすくするために、 タグ形式で各リソースに独自のメタデータを割り当てることができます。ここでは、タグとその作成方法について説明します。

タグの基本

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

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

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

タグには、Amazon EKS に関連する意味はなく、完全に文字列として解釈されます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、古い値は新しい値によって上書きされます。

AWS マネジメントコンソール、AWS CLI、および Amazon EKS API を使用して、タグで作業できます。

注記

Amazon EKS タグは、現在では eksctl にサポートされていません。

AWS Identity and Access Management (IAM) を使用している場合は、AWS アカウント内のどのユーザーがタグを作成、編集、削除するアクセス許可を持つかを制御できます。

リソースにタグを付ける

新規または既存の Amazon EKS クラスターにタグを付けることができます。

Amazon EKS コンソールを使用している場合、新規リソースには作成時にタグを適用でき、既存のリソースには関連するリソースページの [Tags (タグ)] タブを使用していつでもタグを適用できます。

Amazon EKS API、AWS CLI、または AWS SDK を使用している場合、関連する API アクションの tags パラメータを使用して新規リソースにタグを適用でき、TagResource API アクションを使用して既存のリソースにタグを適用できます。詳細については、「TagResource」を参照してください。

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

次の表では、タグ付け可能な Amazon EKS リソースと、作成時にタグ付け可能なリソースについて説明します。

Amazon EKS リソースのタグ付けのサポート

リソース タグをサポート タグの伝播をサポート 作成時のタグ付けをサポート (Amazon EKS API、AWS CLI、AWS SDK)

Amazon EKS クラスター

はい

いいえ。クラスタータグは、クラスターに関連付けられた他のリソースには伝達されません。

はい

タグの制限

タグには以下のような基本制限があります。

  • リソースあたりのタグの最大数は 50 です。

  • タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。

  • キーの最大長 – 128 文字 (Unicode) (UTF-8)

  • 値の最大長 – 256 文字 (Unicode) (UTF-8)

  • 複数の AWS サービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスでも許可される文字に制限が適用されることがあるのでご注意ください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および +、-、=、.、_、:、/、@。

  • タグのキーと値は大文字と小文字が区別されます。

  • aws:AWS:、またはその大文字または小文字の組み合わせを、キーまたは値のプレフィックスとして使用しないでください。これらの文字列は AWS による使用のために予約されています。このプレフィックスが含まれるタグのキーや値を編集したり削除することはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限時には計算されません。

コンソールでのタグの処理

新規または既存のクラスターに関連付けられたタグは、Amazon EKS コンソールを使用して管理することができます。

Amazon EKS コンソールでリソース固有のページを選択すると、リソースリストが表示されます。たとえば、ナビゲーションペインで [Clusters (クラスター)] を選択すると、Amazon EKS クラスターのリストがコンソールに表示されます。そのリスト (特定のクラスターなど) からリソースを 1 つ選択すると、そのリソースでタグがサポートされている場合は、[Tags (タグ)] タブでタグを表示および管理できます。

作成時に個々のリソースにタグを追加する

作成時に Amazon EKS クラスターにタグを追加できます。詳細については、「Amazon EKS クラスターの作成」を参照してください。

個々のリソースでのタグの追加と削除

Amazon EKS では、クラスターに関連付けられたタグをリソースのページから直接追加または削除できます。

個々のリソースのタグを追加または削除するには

  1. https://console.aws.amazon.com/eks/home#/clusters」にある Amazon EKS コンソールを開きます。

  2. ナビゲーションバーから、使用するリージョンを選択します。

  3. ナビゲーションペインで [クラスター] を選択します。

  4. 特定のクラスターを選択し、下にスクロールして、[Manage tags (タグの管理)] を選択します。

  5. [Update tags (タグの更新)] ページで、必要に応じてタグを追加または削除します。

    • タグ — を追加するには、[Add Tag (タグの追加)] を選択して、各タグのキーと値を指定します。

    • タグ — を削除するには、[Remove tag (タグの削除)] を選択します。

  6. 追加または削除するタグごとにこのプロセスを繰り返し、[Update (更新)] を選択して終了します。

CLI または API でのタグの操作

リソースのタグの追加、更新、リスト表示、および削除には、次の AWS CLI コマンドまたは Amazon EKS API オペレーションを使用します。

Amazon EKS リソースのタグ付けのサポート

タスク AWS CLI API アクション

1 つ以上のタグを追加、または上書きします。

tag-resource

TagResource

1 つ以上のタグを削除します。

untag-resource

UntagResource

以下の例では、AWS CLI を使用して、リソースに対してタグ付けまたはタグ削除する方法を示しています。

例 1: 既存のクラスターへのタグ付け

次のコマンドは既存のクラスターにタグ付けします。

aws eks tag-resource --resource-arn resource_ARN --tags team=devs

例 2: 既存のクラスターでのタグ削除

次のコマンドは既存のクラスターからタグを削除します。

aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key

例 3: リソースのタグのリスト取得

次のコマンドは、既存のリソースに関連付けられているタグのリストを取得します。

aws eks list-tags-for-resource --resource-arn resource_ARN

一部のリソース作成アクションでは、リソースの作成時にタグを指定できます。以下のアクションでは、作成時のタグ付けがサポートされます。

タスク AWS CLI AWS Tools for Windows PowerShell API アクション

クラスターの作成

create-cluster

New-EKSCluster

CreateCluster