Recherche d'un type de modification à l'aide de l'option de requête - Guide de l'utilisateur avancé d'AMS

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.

Recherche d'un type de modification à l'aide de l'option de requête

Cet exemple montre comment utiliser la console AMS pour trouver le type de modification approprié pour la RFC que vous souhaitez soumettre.

Vous pouvez utiliser la console ou le API/CLI pour rechercher un ID de type de modification (CT) ou une version. Il existe deux méthodes, soit la recherche, soit le choix de la classification. Pour les deux types de sélection, vous pouvez trier la recherche en choisissant le plus fréquemment utilisé, le plus récemment utilisé ou Alphabétique.

YouTube Vidéo : Comment créer une RFC à l'aide de l'AWS Managed Services CLI et où puis-je trouver le schéma CT ?

Dans la console AMS, sur la page RFCs-> Créer une RFC :

  • Lorsque l'option Parcourir par type de modification est sélectionnée (valeur par défaut), vous pouvez soit :

    • Utilisez la zone de création rapide pour sélectionner l'une des solutions les plus populaires d'AMS CTs. Cliquez sur une étiquette et la page Run RFC s'ouvre avec l'option Objet remplie automatiquement pour vous. Complétez les options restantes selon vos besoins et cliquez sur Exécuter pour soumettre la RFC.

    • Vous pouvez également faire défiler l'écran jusqu'à la zone Tous les types de modification et commencer à taper un nom CT dans la case d'option. Vous n'avez pas besoin du nom exact ou complet du type de modification. Vous pouvez également rechercher un CT par identifiant de type de modification, classification ou mode d'exécution (automatique ou manuel) en saisissant les mots pertinents.

      Lorsque la vue Cartes par défaut est sélectionnée, les cartes CT correspondantes apparaissent au fur et à mesure que vous tapez, sélectionnez une carte et cliquez sur Créer une RFC. Une fois la vue sous forme de tableau sélectionnée, choisissez le CT approprié et cliquez sur Créer une RFC. Les deux méthodes ouvrent la page Run RFC.

  • Sinon, pour explorer les choix de type de modification, cliquez sur Choisir par catégorie en haut de la page pour ouvrir une série de boîtes d'options déroulantes.

  • Choisissez une catégorie, une sous-catégorie, un article et une opération. La zone d'information correspondant à ce type de modification apparaît et un panneau apparaît en bas de page.

  • Lorsque vous êtes prêt, appuyez sur Entrée pour afficher la liste des types de modifications correspondants.

  • Choisissez un type de modification dans la liste. La zone d'information correspondant à ce type de modification apparaît au bas de la page.

  • Une fois que vous avez sélectionné le type de modification correct, choisissez Create RFC.

Note

L'AMS CLI doit être installée pour que ces commandes fonctionnent. Pour installer l'API ou la CLI AMS, rendez-vous sur la page Ressources pour développeurs de la console AMS. Pour des informations de référence sur l'API AMS CM ou l'API AMS SKMS, consultez la section Ressources d'information AMS du guide de l'utilisateur. Vous devrez peut-être ajouter une --profile option d'authentification ; par exemple,aws amsskms ams-cli-command --profile SAML. Vous devrez peut-être également ajouter --region cette option car toutes les commandes AMS sont exécutées à partir de us-east-1, par exemple. aws amscm ams-cli-command --region=us-east-1

Note

Les points de terminaison AMS API/CLI (amscm et amsskms) se trouvent dans la région AWS de Virginie du Nord,. us-east-1 En fonction de la configuration de votre authentification et de la région AWS dans laquelle se trouvent votre compte et vos ressources, vous devrez peut-être en ajouter --region us-east-1 lors de l'émission de commandes. Vous devrez peut-être également ajouter--profile saml, s'il s'agit de votre méthode d'authentification.

Pour rechercher un type de modification à l'aide de l'API AMS CM (voir ListChangeTypeClassificationSummaries) ou de la CLI :

Vous pouvez utiliser un filtre ou une requête pour effectuer une recherche. L' ListChangeTypeClassificationSummaries opération comporte des options de filtres pour Category SubcategoryItem,, etOperation, mais les valeurs doivent correspondre exactement aux valeurs existantes. Pour des résultats plus flexibles lors de l'utilisation de la CLI, vous pouvez utiliser l'--queryoption.

Changer le type de filtrage avec l'API/CLI AMS CM
Attribut Valeurs valides Condition valide/par défaut Remarques

ChangeTypeId

Toute chaîne représentant un ChangeTypeId (par exemple : ct-abc123xyz7890)

Égal à

Pour le type de modification IDs, consultez la référence du type de modification.

Pour le type de modification IDs, voir Trouver un type de modification ou CSIO.

Catégorie

Tout texte de forme libre

Contains

Les expressions régulières dans chaque champ individuel ne sont pas prises en charge. Recherche insensible aux majuscules et minuscules

Sous-catégorie

Élément

Opération

  1. Voici quelques exemples de classification des types de modification de liste :

    La commande suivante répertorie toutes les catégories de types de modifications.

    aws amscm list-change-type-categories

    La commande suivante répertorie les sous-catégories appartenant à une catégorie spécifiée.

    aws amscm list-change-type-subcategories --category CATEGORY

    La commande suivante répertorie les éléments appartenant à une catégorie et à une sous-catégorie spécifiées.

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. Voici quelques exemples de recherche de types de modifications à l'aide de requêtes CLI :

    La commande suivante recherche dans les résumés de classification CT ceux qui contiennent « S3 » dans le nom de l'élément et crée une sortie de la catégorie, de la sous-catégorie, de l'élément, de l'opération et de l'ID de type de modification sous forme de tableau. 

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. Vous pouvez ensuite utiliser l'ID du type de modification pour obtenir le schéma CT et examiner les paramètres. La commande suivante génère le schéma dans un fichier JSON nommé Creates3Params.Schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    Pour plus d'informations sur l'utilisation des requêtes CLI, consultez Comment filtrer la sortie avec l'option --query et la référence du langage de requête, JMESPath Spécification.

  4. Une fois que vous avez obtenu l'identifiant du type de modification, nous vous recommandons de vérifier la version du type de modification afin de vous assurer qu'il s'agit de la dernière version. Utilisez cette commande pour trouver la version correspondant à un type de modification spécifié :

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    Pour trouver le AutomationStatus type de modification correspondant à un type de modification spécifique, exécutez cette commande :

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    Pour trouver le ExpectedExecutionDurationInMinutes type de modification correspondant à un type de modification spécifique, exécutez cette commande :

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"