Comment élaborer des invites efficaces pour interroger Amazon Q sur votre flotte - AWS Systems Manager

AWS Systems ManagerChange Managern'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment élaborer des invites efficaces pour interroger Amazon Q sur votre flotte

Plus la question ou l’invite que vous soumettez à Amazon Q est de qualité, meilleur est le résultat obtenu.

Conseils pour les invites de requêtes

Tenez compte des conseils suivants lorsque vous interrogez Amazon Q à propos de votre flotte :

  1. Pour améliorer la précision de vos résultats, utilisez les termes « nœuds gérés » et « instances gérées » dans vos invites au lieu de simplement « nœuds » et « instances ».

  2. Pour demander des résultats sur plusieurs comptes faisant partie d'une organisation, tels que configurés dans AWS Organizations, vous devez être connecté au compte d'administrateur délégué dans la région d'origine désignée.

  3. Dans le compte d’administrateur délégué, utilisez des termes pour aider Amazon Q à comprendre que vous posez des questions sur les nœuds et les instances au sein de l’organisation en utilisant spécifiquement des termes tels que « dans mon organisation » ou « dans mon compte 123456789012 ».

Exemples de questions pour Amazon Q

Dans le tableau suivant, nous proposons des exemples de questions qui montrent comment créer des requêtes à Amazon Q afin d’obtenir de meilleurs résultats.

Nous fournissons également des exemples des filtres qu'Amazon Q appliquera lors de l'exécution de la ListNodescommande, qui sont générés à partir du contenu de votre invite.

Exemple de question en langage naturel Amazon Q a appliqué les filtres
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 2 across my organization.
PlatformName = Amazon Linux PlatformVersion = 2
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 2012 R2 Enterprise managed nodes are running in the eu-central-1 region across my entire organization?
PlatformName = Microsoft Windows Server 2012 R2 Enterprise Region = eu-central-1
Show me all managed instances running Red Hat Linux 7 in ou-d6ty-gxdma6vm.
PlatformName = RHEL 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 versions of 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

Noms et versions des systèmes d’exploitation pris en charge pour les invites

Lorsque vous interrogez Amazon Q concernant les nœuds gérés de votre compte, il est utile de fournir le nom d’un système d’exploitation tel qu’il est étiqueté dans Systems Manager. Vous pouvez également fournir des numéros de version pour affiner vos résultats. Par exemple, comme indiqué dans les tableaux suivants, vous pouvez demander des résultats portant spécifiquement sur macOS 14.5, Microsoft Windows Server 2019 Datacenter et AlmaLinux 9.2 through 9.4, pour ne citer que quelques exemples.

Ces listes peuvent ne pas être exhaustives et ne sont proposées qu’à titre d’exemple.

macOS
Nom de la plateforme Numéros de version
macOS 13.2, 13.4, 13.7, 14.1, 14.5, 14.6.1, 15.0
Windows
Versions Numéros de version
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 S/O
Microsoft Windows Server 2016 Standard 10,0,14393
Microsoft Windows Server 2019 Datacenter S/O
Microsoft Windows Server 2019 Standard S/O
Microsoft Windows Server 2022 Datacenter S/O
Microsoft Windows Server 2022 Standard 10,0.20348
Linux
Noms des plateformes Numéros de version
AlmaLinux 8.10, 9.2, 9.3, 9.4
Amazon Linux 2 2.0 et versions ultérieures
Amazon Linux 2023 2023.0.20230315.0 et versions ultérieures
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 Stream 9
Debian GNU/Linux 11-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
Serveur Red Hat Enterprise Linux 17.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
Ubuntu Server 16.04, 18.04, 20.04, 22.04, 24.04