Amazon Q にフリートについてたずねる的確なプロンプトの作成方法 - AWS Systems Manager

Amazon Q にフリートについてたずねる的確なプロンプトの作成方法

Amazon Q に与える質問 (プロンプト) の質を上げれば、得られる結果の質も向上します。

クエリプロンプトのヒント

Amazon Q にフリートについてクエリする場合は、以下のヒントに留意してください。

  1. 結果の精度を高めるには、プロンプトで単に「ノード」や「インスタンス」を使用するのではなく「マネージドノード」や「マネージドインスタンス」という語句を使用します。

  2. AWS Organizations に設定されているように、組織に含まれる複数のアカウントを対象に結果をクエリするには、指定されたホームリージョンの委任管理者アカウントにログインする必要があります。

  3. 委任管理者アカウントでは、組織全体にわたるノードとインスタンスについてたずねていることを Amazon Q が理解できる用語を使用します。特に、「組織内で」や「123456789012 というアカウントで」といった用語を使用すると効果的です。

Amazon Q へのサンプルの質問

以下の表にサンプルの質問を挙げて、Amazon Q でよりよい結果を得るためのクエリの作成方法を示します。

ListNodes コマンドの実行時に Amazon Q が適用するフィルターの例も示します。これらは、プロンプトの内容から生成されます。

自然言語によるサンプルの質問 Amazon Q が適用したフィルター
Show me my Windows managed nodes.
PlatformType = Windows
List my managed instances in account 123456789012.
AccountId = 123456789012
Show me all managed nodes running Amazon Linux 1 across my organization.
PlatformName = Amazon Linux PlatformVersion = 1
Show me all managed instances running Microsoft Windows Server 2019 Datacenter in my organization.
PlatformName = Microsoft Windows Server 2019 Datacenter
Can you show me all managed nodes with SSM Agent version 3.3.1142.0?
AgentType = amazon-ssm-agent AgentVersion = 3.3.1142.0
List all Amazon Linux 2 managed instances in account 123456789012 that have SSM Agent version 3.3.1230.0.
PlatformName = Amazon Linux PlatformVersion = 2 AccountId = 123456789012 AgentType = amazon-ssm-agent AgentVersion = 3.3.1230.0
What Microsoft Windows Server 2008 R2 Enterprise managed nodes are running in the eu-central-1 region across my entire organization?
PlatformName = Microsoft Windows Server 2008 R2 Enterprise Region = eu-central-1
Show me all managed instances running CentOS Linux 7 in ou-d6ty-gxdma6vm.
PlatformName = CentOS Linux PlatformVersion = 7 OrganizationalUnitId = ou-d6ty-gxdma6vm
What Ubuntu managed instances are in account 123456789012?
PlatformName = Ubuntu AccountId = 123456789012
List my Linux managed instances.
PlatformType = Linux
Find my macOS managed nodes.
PlatformType = macOS
Show me all Amazon Linux managed nodes in my org.
PlatformName = Amazon Linux
List managed nodes running Amazon Linux 2 .
PlatformName = Amazon Linux PlatformVersion = 2
List the managed nodes with Ubuntu 16.04 in account 123456789012.
PlatformName = Ubuntu PlatformVersion = 16.04 AccountId = 123456789012
Find all managed nodes that have an SSM Agent version that is not 3.3.987.0.
AgentType = amazon-ssm-agent AgentVersion != 3.3.987.0
List all managed instances that are not running a Linux operating system.
PlatformType != Linux

プロンプトでサポートされているオペレーティングシステムの名前とバージョン

Amazon Q にアカウント内のマネージドノードについてたずねるときは、オペレーティングシステムの名前を Systems Manager でのラベルのとおりに指定すると効果的です。また、バージョン番号を指定して結果をさらに絞り込むこともできます。例えば、以下の表に示すように、macOS 14.5Microsoft Windows Server 2019 DatacenterAlmaLinux 9.2 through 9.4 といった名前を具体的に挙げて結果を求めることができます。

以下のリストは網羅的なものではなく、例として挙げているにすぎません。

macOS
プラットフォーム名 バージョン番号
macOS 11.6.7、11.7.10、12.6.6、12.7.6、13.2、13.4、13.7、14.1、14.5、14.6.1、15.0
Windows
リリース バージョン番号
Microsoft Windows Server 2008 Enterprise 6.0.6003
Microsoft Windows Server 2,008 R2 Datacenter 6.1.7601
Microsoft Windows Server 2008 R2 Enterprise 6.1.7601
Microsoft Windows Server 2,008 R2 Standard 6.1.7601
Microsoft Windows Server 2,012 R2 Datacenter 6.3.9600
Microsoft Windows Server 2,012 R2 Standard 6.3.9600
Microsoft Windows Server 2,012 Standard 6.2.9200
Microsoft Windows Server 2,016 Datacenter 該当なし
Microsoft Windows Server 2,016 Standard 10.0.14393
Microsoft Windows Server 2,019 Datacenter 該当なし
Microsoft Windows Server 2,019 Standard 該当なし
Microsoft Windows Server 2,022 Datacenter 該当なし
Microsoft Windows Server 2,022 Standard 10.0.20348
Linux
プラットフォーム名 バージョン番号
AlmaLinux 8.10、9.2、9.3、9.4
Amazon Linux 2 2.0 以降
Amazon Linux 2023 2,023.0.20230315.0 以降
Amazon Linux 2015.03、2015.09、2016.03、2016.09、2017.03、2017.09、2018.03
Bottlerocket 1.14.3、1.16.1、1.18.0、1.19.1、1.19.2、1.19.5、1.20.0、1.20.1、1.20.2、1.20.3、1.20.5、1.21.1、1.23.0、1.24.0、1.24.1、1.25.0、1.26.1、
CentOS 6.7、6.8、6.9 (Final)、6.10、6.10 (Final)
CentOS Linux 7、7.2.1511、7.2.1511 (Core)、7.3.1611、7.3.1611 (Core)、7.4.1708、7.5.1804、7.5.1804 (Core)、7.6.1810、7.7.1908、7.8.2003、7.9.2009、7.9.2009 (Core)、8.2.2004、8.5.2111
CentOS Stream 8、9
Debian GNU/Linux 8~12
Oracle Linux Server 7.8、8.2、8.3、8.8、8.9、8.10、9.4
Red Hat Enterprise Linux 8.2、8.3、8.4、8.5、8.6、8.7、8.8、8.9、8.10、9.2、9.3、9.4
Red Hat Enterprise Linux サーバー 6.9 (Santiago)、6.10 (Santiago)、7.3、7.6、7.7、7.8、7.9
Rocky Linux 8.6、8.7、8.8、8.9、8.10、9.1、9.2、9.3、9.4
SLES 12.4、15、15.1、15.2、15.3、15.4、15.5
Ubuntu 14.04、16.04、18.04、20.04、22.04、24.04