タグを使用すると、ECI インスタンスをグループ化して管理でき、フィルタリングやバッチ操作を簡素化できます。
背景情報
OpenAPI または Elastic Container Instance (ECI) コンソールを使用して ECI インスタンスを管理する際、管理上またはビジネス上の要件が共通するインスタンスにタグを付けます。
タグには次の制限があります：
-
各タグはキーと値のペアで構成されます。リソースのタグキーは一意である必要があります。
-
タグはリージョン固有です。
-
各 ECI インスタンスには、最大 20 個のタグを付けることができます。
-
タグを個別に削除することはできません。
説明ECI インスタンスを削除すると、そのタグも削除されます。
タグ付き ECI インスタンスの作成
API
CreateContainerGroup API を呼び出して ECI インスタンスを作成する際、Tag パラメーターを使用してタグを設定します。関連パラメーターについては、次の表を参照してください。詳細については、「CreateContainerGroup」をご参照ください。
|
パラメーター |
タイプ |
例 |
説明 |
|
Tag.N.Key |
文字列 |
version |
タグキー。N の値の範囲は 1～20 です。 キーは空の文字列にすることはできず、一意である必要があります。最大 64 文字まで指定でき、 |
|
Tag.N.Value |
文字列 |
2.0 |
タグ値。N の値の範囲は 1～20 です。 値は空の文字列にすることができます。最大 128 文字まで指定でき、 |
コンソール
Elastic Container Instance 購入ページで ECI インスタンスを作成する際に、[その他の設定] セクションでタグを追加します。
たとえば、キーが version、値が 2.0 のタグと、キーが type、値が eci のタグを追加します。さらにタグを追加するには、[+ タグを追加] をクリックします。
ECI インスタンスのタグの照会
API
DescribeContainerGroups API を呼び出して ECI インスタンスを照会すると、レスポンスの Tags フィールドに紐付けられたタグが返されます。レスポンスでは、Key がタグキー、Value がタグ値です。詳細については、「DescribeContainerGroups」をご参照ください。
コンソール
Elastic Container Instance コンソールの[コンテナグループ] ページで、目的のインスタンスを見つけ、タグ列のタグアイコンにポインターを合わせると、関連付けられたタグを表示できます。
タグによる ECI インスタンスのフィルタリング
ECI インスタンスにタグを追加した後、タグを使用してフィルタリングや権限付与を行うことができます。
API
DescribeContainerGroups API を呼び出して ECI インスタンスを照会する際、Tag 関連のパラメーターを渡して結果をフィルタリングします。詳細については、「DescribeContainerGroups」をご参照ください。
コンソール
Elastic Container Instance コンソールの [コンテナグループ] ページで、タグによって ECI インスタンスを絞り込みます。
検索バーで [コンテナグループタグ] フィルターを選択し、version:2.0 などのキーと値のペアを入力します。このタグ条件に一致する ECI インスタンスのみがページに表示されます。
RAM ユーザーを使用して ECI リソースを管理する場合、タグに基づく権限付与を使用できます。これにより、特定のタグが付いた ECI リソースに対する操作権限のみを RAM ユーザーに付与できます。詳細については、「タグに基づく RAM ユーザーへの権限付与」をご参照ください。
ECI インスタンスのタグの更新
タグを更新する前に、まず ECI インスタンスに紐付けられているタグを照会します。更新操作は、既存のタグセット全体を新しいタグセットで置き換えます。更新時に既存のタグを省略すると、そのタグは削除されます。
API
UpdateContainerGroup API を呼び出して ECI インスタンスを更新する際、新しい Tag パラメーターを渡してタグを更新します。関連パラメーターについては、次の表を参照してください。詳細については、「UpdateContainerGroup」をご参照ください。
|
パラメーター |
タイプ |
例 |
説明 |
|
Tag.N.Key |
文字列 |
version |
タグキー。N の値の範囲は 1～20 です。 キーは空の文字列にすることはできず、一意である必要があります。最大 64 文字まで指定でき、 |
|
Tag.N.Value |
文字列 |
2.0 |
タグ値。N の値の範囲は 1～20 です。 値は空の文字列にすることができます。最大 128 文字まで指定でき、 |
コンソール
既存の ECI インスタンスのタグを更新するには、Elastic Container Instance コンソールの[コンテナグループ]ページに移動し、インスタンスを見つけ、そのタグを変更します。
タグ設定エリアで、タグのキーと値のペアを入力します。たとえば、キーが version、値が 3.0 のタグと、キーが type、値が eci のタグを追加します。[+ タグを追加] をクリックして、さらにタグを追加します。合計で最大 20 個のタグを追加できます。