AWS CloudFormation スタックベースのグループを更新する

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

Console

AWS CloudFormation スタックベースのグループを のタグベースのグループに変更することはできません AWS Management Console。ただし、グループのベースとなるスタックを変更したり、グループに含めるスタックリソースタイプを変更したりすることができます。グループの説明を追加または変更することもできます。

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

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

3. 注記

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

4. [グループの編集] ページの [グループ分けの条件] で、グループの基になっているスタックを変更するには、ドロップダウンリストからスタックを選択します。リソースグループは、1 つのスタックにのみ基づくことができます。スタックのリストをフィルタリングするには、スタックの名前の入力を開始します。サポートされているステータスのスタックのみがリストに表示されます。サポートされているステータスのリストについては、ガイドの「でのクエリベースのグループの作成 AWS Resource Groups」を参照してください。

5. リソースタイプを追加または削除します。スタック内の使用可能なリソースタイプのみが表示され、ドロップダウンリストに表示されます。デフォルトは [サポートされているすべてのリソースタイプ] です。1 つのクエリに最大 20 のリソースタイプを設定できます。リソースタイプを削除するには、リソースタイプのラベルの [X] を選択します。サポートされていて、グループに含めることができるリソースタイプの詳細については、「AWS Resource Groups およびタグエディタで使用できるリソースタイプ」を参照してください。

6. グループリソースのプレビューを選択して、選択したリソースタイプに一致する AWS CloudFormation スタック内のリソースのリストを取得します。

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

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

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

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

AWS CLI & AWS SDKs

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

1. グループの説明を変更しない場合は、このステップをスキップし、次に進みます。グループ名の値と説明を独自に設定した内容に置き換えて、次のコマンドを実行します。

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

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

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

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

2. グループのクエリとタグを更新するには、以下のコマンドを実行します。グループ名の値、スタック識別子、リソースタイプは、独自に設定した内容に置き換えます。リソースタイプを追加するには、追加するリソースタイプだけでなく、リソースタイプの完全なリストをコマンドに指定します。1 つのクエリに最大 20 のリソースタイプを設定できます。

   コマンド例に示すように、stack_identifier は、スタック ARN です。

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --description "description" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

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

   $ aws resource-groups update-group-query \
       --group-name "my-resource-group" \
       --description "Updated CloudFormation stack-based group" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:810000000000:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

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