Learning to craft effective prompts to ask Amazon Q about your fleet - Amazon Systems Manager
Sample questions for Amazon QSupported operating system names and versions for prompts
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Learning to craft effective prompts to ask Amazon Q about your fleet

The better quality of the question, or the prompt, that you give to Amazon Q, the better the result it provides you with.

Tips for query prompts

Keep in mind the following tips when querying Amazon Q about your fleet:

  1. To help improve the accuracy of your results, use the terms "managed nodes" and "managed instances" in your prompts instead of just "nodes" and "instances".

  2. To query for results across multiple accounts that are part of an organization, as configured in Amazon Organizations, you must be logged into the delegated administrator account in the designated home Region.

  3. In the delegated administrator account, use terms to help Amazon Q understand that you are asking about nodes and instances across the organization by specifically using terms such as "in my organization" or "in my account 123456789012".

Sample questions for Amazon Q

In the following table, we provide sample questions demonstrate some ways you can create queries of Amazon Q that lead to better results.

We also provide examples of the filters Amazon Q will apply when running the ListNodes command, which are generated from the content of your prompt.

Sample natural language question Amazon Q applied filters
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

Supported operating system names and versions for prompts

When you are asking Amazon Q about the managed nodes in your account, it's helpful to provide the name of an operating system as its labeled in Systems Manager. You can also provide version numbers to further narrow down your results. For example, as represented in the following tables, you could ask for results specifically about macOS 14.5, Microsoft Windows Server 2019 Datacenter, and AlmaLinux 9.2 through 9.4, to name just a few examples.

These lists might not be exhaustive and are offered as examples only.

macOS
Platform name Version numbers
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
Releases Version numbers
Microsoft Windows Server 2008 Enterprise 6.0.6003
Microsoft Windows Server 2008 R2 Datacenter 6.1.7601
Microsoft Windows Server 2008 R2 Enterprise 6.1.7601
Microsoft Windows Server 2008 R2 Standard 6.1.7601
Microsoft Windows Server 2012 R2 Datacenter 6.3.9600
Microsoft Windows Server 2012 R2 Standard 6.3.9600
Microsoft Windows Server 2012 Standard 6.2.9200
Microsoft Windows Server 2016 Datacenter N/A
Microsoft Windows Server 2016 Standard 10.0.14393
Microsoft Windows Server 2019 Datacenter N/A
Microsoft Windows Server 2019 Standard N/A
Microsoft Windows Server 2022 Datacenter N/A
Microsoft Windows Server 2022 Standard 10.0.20348
Linux
Platform names Version numbers
AlmaLinux 8.10, 9.2, 9.3, 9.4
Amazon Linux 2 2.0 and greater
Amazon Linux 2023 2023.0.20230315.0 and greater
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 Server 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