タグベースのクエリグループの更新

次の手順は、タグベースのクエリグループを更新する方法を示しています。

Console

グループの基になっているクエリ内のリソースタイプまたはタグを変更して、タグベースのグループを更新します。グループの説明を追加または変更することもできます。

1. AWS Resource Groups コンソール にサインインします。

2. ナビゲーションペインの [保存したリソースグループ] で、グループの名前を選択し、[編集] を選択します。

   注記

   ユーザーが所有するリソースグループのみを更新することができます。[所有者] 列には、各リソースグループのアカウントの所有権が表示されます。サインインしているもの以外のアカウント所有者を持つグループが AWS License Managerで作成されました。詳細については、「License Manager ユーザーガイド」の「AWS License Managerのホストリソースグループ」を参照してください。

3. [グループの編集] ページの [グループ分けの条件] で、リソースタイプを追加または削除します。1 つのクエリに最大 20 のリソースタイプを設定できます。リソースタイプを削除するには、リソースタイプのラベルの [X] を選択します。この変更によるグループのリソースメンバーへの影響を確認するには、[グループリソースの表示] を選択します。このウォークスルーでは、リソースタイプ [AWS::RDS::DBInstance] をクエリに追加します。

4. [グループ分けの条件] で、必要に応じてタグを編集します。この例では、[ステージ] のタグキーを含むリソースをフィルタリングし、[テスト] のタグ値を追加します。タグ値はオプションですが、クエリの結果を絞り込むことができます。タグを削除するには、タグのラベルで [X] を選択します。

5. [追加情報] で、グループの説明を編集できます。グループの作成後にグループの名前を編集することはできません。

6. (オプション) [グループタグ] で、タグを追加または削除できます。グループタグは、リソースグループに関するメタデータです。メンバーリソースには影響しません。リソースグループのクエリによって返されるリソースを変更するには、[グループ分けの条件] の下にあるタグを編集します。

   グループタグは、このグループを大規模なグループのメンバーにする場合に便利です。グループを作成するには、少なくとも 1 つのタグキーを指定する必要があります。したがって、より大規模なグループにネストさせる予定のグループには、[グループタグ] 内の少なくとも 1 つのタグキーを追加してください。

7. [リソースグループのプレビュー] を選択すると、指定されたタグキーに一致する、アカウント内の EC2 インスタンスおよび S3 バケット、および Amazon RDS データベースデータベースインスタンスの更新されたリストが返されます。リソースがリストに表示されない場合は、該当リソースが、[グループ分けの条件] で指定したタグでタグ付けされていることを確認してください。

8. 完了したら、[変更の保存] を選択します。

AWS CLI & AWS SDKs

では AWS CLI、2 つの異なるコマンドを使用して、グループのクエリを更新し、リソースグループの説明を更新します。既存グループの名前を編集することはできません。では AWS CLI、タグベースのグループを CloudFormation スタックベースのグループに、またはその逆に変更できます。

1. グループの説明を変更しない場合は、このステップをスキップし、次に進みます。 AWS CLI セッションで、次のように入力し、Enter キーを押して、グループ名と説明の値を独自の値に置き換えます。

   $ aws resource-groups update-group \
       --group-name resource-group-name \
       --description "description_text"

   コマンドの例を次に示します。

   $ aws resource-groups update-group \
       --group-name my-resource-group \
       --description "EC2 instances, S3 buckets, and RDS DBs that we are using for the test stage."

   このコマンドでは、更新されたグループの完全な説明が返ります。

2. グループのクエリとタグを更新するには、次のコマンドを入力します。グループ名の値、リソースタイプ、タグ値は、独自に設定した内容に置き換えます。次に、Enter キーを押します。1 つのクエリに最大 20 のリソースタイプを設定できます。

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"],\"TagFilters\":[{\"Key\":\"Key1\",\"Values\":[\"Value1\",\"Value2\"]},{\"Key\":\"Key2\",\"Values\":[\"Value1\",\"Value2\"]}]}"}'

   コマンドの例を次に示します。

   $ aws resource-groups update-group-query \
       --group-name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\",\"AWS::RDS::DBInstance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   このコマンドでは、更新されたクエリが結果として返ります。