Outils de Azure MCP Server pour Azure Advisor

Le serveur MCP Azure vous aide à travailler avec Azure Advisor via des invites en langage naturel. Vous pouvez répertorier, résumer, hiérarchiser et mettre à jour des recommandations, explorer les métadonnées des recommandations, obtenir des conseils de correction et vérifier l’état des groupes de services.

Azure Advisor analyse vos ressources Azure et fournit des recommandations personnalisées et exploitables pour optimiser les coûts, les performances, la fiabilité et la sécurité. Pour plus d’informations, consultez Azure Advisor documentation.

Note

Paramètres de l’outil : les outils Azure MCP Server définissent des paramètres pour les données dont ils ont besoin pour effectuer des tâches. Certains de ces paramètres sont spécifiques à chaque outil et sont documentés ici. D’autres paramètres sont globaux et partagés par tous les outils. Pour plus d’informations, consultez Paramètres de l’outil.

Métadonnées : Récupérer

Obtient les métadonnées d’Azure Advisor pour un type de recommandation spécifique. Retourne le nom d’affichage, la catégorie, la sous-catégorie, l’impact, le type de ressource pris en charge, la description, les avantages potentiels et un lien vers la documentation pour en savoir plus du type de recommandation. Utilisez les métadonnées pour comprendre ce qu’une recommandation signifie et évaluer son impact.

Exemple de commande CLI

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Paramètre Type Obligatoire Description
recommendation-type-id string Oui ID stable du type de recommandation Advisor (properties.recommendationTypeId) à rechercher dans le catalogue global des métadonnées de recommandation. Il s’agit de la clé de jointure partagée avec les recommandations personnalisées. Required.
language string Non Paramètres régionaux du catalogue sur lesquels filtrer (properties.language). La valeur par défaut est « en ». Insensible à la casse. Valeurs prises en charge : en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-br, pt-pt, ru, sv, tr, zh-hans, zh-hant. Les balises qualifiées par région telles que «en-US» sont acceptées et mappées au langage de base ('en').

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Métadonnées : Liste

Répertorie le catalogue global de métadonnées des recommandations Azure Advisor, également appelé types de recommandations. Vous permet de découvrir quelles recommandations Azure Advisor pouvez produire avant de déployer des ressources telles que des machines virtuelles, même lorsqu’aucune recommandation active n’existe. Affiche les mises hors service du service Advisor qui se produisent à la date de mise hors service spécifiée, avant ou après celle-ci, et recherche les métadonnées de mise hors service par l’ID de suivi de Service Health. Prend en charge la découverte d’environnements vierges grâce au catalogue global Azure Resource Graph et au filtrage par type de ressource pour l’intégration d’environnements existants. Retourne les identifiants de type localisés, les noms, les catégories, les sous-catégories, l’impact, la priorité, les descriptions, les avantages, les actions, la portée, la requête d’origine et les détails sur la mise hors service du service. Trie les résultats par impact, de Élevé à Moyen à Faible, puis par nom d’affichage. Pour obtenir les recommandations actuelles ou les ressources affectées, utilisez Recommandation : Liste à la place.

Exemple de commande CLI

azmcp advisor metadata list \
  [--language <language>] \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>] \
  [--sub-category <sub-category>] \
  [--tracking-id <tracking-id>] \
  [--retirement-date <retirement-date>]
Paramètre Type Obligatoire Description
language string Non Langue des métadonnées de recommandation localisées. La valeur par défaut est l’anglais ('en'). Les langues de catalogue prises en charge sont en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-BR, pt-PT, ru, sv, tr, zh-Hans et zh-Hant. Les variantes régionales correspondent à une langue de base prise en charge lorsqu’elles sont disponibles, telles que en-US à en et fr-CA à fr ; Les langues de catalogue spécifiques aux paramètres régionaux restent distinctes.
resource-type string Non Filtre de type de ressource Azure facultatif, tel que « microsoft.compute/virtualmachines ». Utilisez-le lors de l’intégration de brownfield pour découvrir les types de recommandations applicables à ce type de ressource. Correspond sans tenir compte de la casse.
impact string Non Filtre facultatif de l’impact des recommandations Les valeurs autorisées sont Élevé, Moyen ou Faible. Correspondance sans tenir compte de la casse ; les résultats non filtrés sont classés Haut, Moyen, puis Faible.
category string Non Filtre exact facultatif sur la catégorie du conseiller. Les valeurs autorisées sont Cost, HighAvailability, Security, Performance et OperationalExcellence. Correspondance sans tenir compte de la casse.
sub-category string Non Filtre facultatif de sous-catégorie de recommandation exacte, avec correspondance sans tenir compte de la casse. Les valeurs de catalogue connues incluent ComputeOptimization, DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, Personalized, RegionalResiliency, Reservations, SafeAndSecureDeployment, SavingsPlan, Scalability, ServiceUpgradeAndRetirement, StorageOptimization, UsageOptimization et ZoneResiliency. Le catalogue peut s’enrichir de valeurs au fil du temps, afin que d’autres sous-catégories soient acceptées.
tracking-id string Non Filtre d’ID exact de suivi d’intégrité du service facultatif, tel que QNY1-HB8. Correspondance effectuée sans tenir compte de la casse dans les métadonnées ServiceUpgradeAndRetirement. --sous-catégorie peut être omise, mais ne peut pas spécifier une valeur différente.
retirement-date string Non Filtre facultatif de date de retrait du service au format <operator>:<yyyy-MM-dd>, par exemple ge:2026-03-31. Les opérateurs pris en charge sont eq, , ltle, gtet ge. S’applique uniquement à la sous-catégorie ServiceUpgradeAndRetirement ; --sub-category peut être omis, mais ne peut pas spécifier une valeur différente.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Recommandation : Liste

Répertorie les recommandations Azure Advisor individuelles et leurs détails sur les ressources affectées dans un abonnement ou un groupe de services. Prend en charge les filtres pour la catégorie, la sous-catégorie, l’impact, l’état, l’ID de type de recommandation, la ressource affectée, le type de ressource, le texte libre, les ID de suivi Service Health et la date de mise hors service. Retourne des recommandations au format de ressource Azure Resource Manager (ARM), ainsi qu’un indicateur qui indique si les résultats ont été tronqués. Le name de chaque recommandation est son ID de recommandation.

Utilisez cet outil pour afficher des recommandations individuelles. Pour les décomptes, les totaux, les classements ou l’analyse groupée, utilisez Recommandation : Résumé à la place. Pour trouver les recommandations les plus importantes ou les plus critiques tous types confondus, commencez par un résumé hiérarchisé, puis utilisez cet outil avec l’ID du type de recommandation sélectionné et avec prioritized défini sur true pour classer ses recommandations individuelles.

Exemple de commande CLI

azmcp advisor recommendation list \
  [--service-group <service-group>] \
  [--resource-group <resource-group>] \
  [--category <category>] \
  [--impact <impact>] \
  [--status <status>] \
  [--recommendation-type-id <recommendation-type-id>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--sub-category <sub-category>] \
  [--tracking-ids <tracking-id1> <tracking-id2>] \
  [--retirement-date <retirement-date>] \
  [--top <top>] \
  [--prioritized <true|false>] \
  [--show-prioritization-signals <true|false>]
Paramètre Type Obligatoire Description
service-group string Non Le groupe de services Azure pour lequel répertorier les recommandations, fourni sous la forme du segment de nom de son ID de ressource ARM. Spécifiez un groupe de services ou un abonnement, et non les deux. Si vous omettez les deux, l’outil utilise l’abonnement par défaut configuré.
resource-group string Non Le nom du groupe de ressources Azure. S’applique uniquement à l’étendue de l’abonnement.
category string Non Filtrer les recommandations par catégorie : Cost, HighAvailability, Security, Performance, ou OperationalExcellence. Correspondance exacte qui ne respecte pas la casse.
impact string Non Filtrer les recommandations par impact métier : High, Mediumou Low. Correspondance exacte qui ne respecte pas la casse.
status string Non Filtrer les recommandations par état : New, Postponed, Dismissed, ou Completed. La valeur par défaut est New.
recommendation-type-id string Non Filtrez les recommandations par ID de type de recommandation (GUID). Correspondance exacte qui ne respecte pas la casse.
resource-type string Non Filtrez les recommandations par type de ressource Azure impacté, tel que Microsoft.Storage/storageAccounts. Correspondance exacte qui ne respecte pas la casse.
resource string Non Filtrez les recommandations en fonction du nom de la ressource affectée ou de l’ID de ressource ARM complet. Correspondance de sous-chaîne qui ne respecte pas la casse.
search string Non Filtre de texte libre sur le texte du problème de recommandation, tel que encryption ou right-size. Correspondance de sous-chaîne qui ne respecte pas la casse. Préférez un filtre structuré lorsqu’il convient à la demande.
sub-category string Non Filtrez les recommandations par sous-catégorie, comme ServiceUpgradeAndRetirement ou ZoneResiliency. Insensible à la casse.
tracking-ids tableau de chaînes de caractères Non Filtrez les recommandations par un ou plusieurs ID de suivi Service Health, tels que QNY1-HB8. Transmettez plusieurs identifiants sous forme de valeurs séparées par des espaces. S’applique à la sous-catégorie ServiceUpgradeAndRetirement.
retirement-date string Non Filtrez les recommandations par date de mise hors service au <operator>:<yyyy-MM-dd> format, par exemple ge:2026-03-31. Les opérateurs pris en charge sont eq, , ltle, gtet ge. S’applique à la sous-catégorie ServiceUpgradeAndRetirement.
top integer Non Nombre maximal d’enregistrements de recommandation à retourner. La valeur par défaut est 50, avec une plage de 1 à 100.
prioritized boolean Non Trie les recommandations correspondantes par priorité. Exige recommendation-type-id. Les recommandations relatives aux coûts sont classées par économies annuelles ; d’autres catégories sont classées par score de criticité. La valeur par défaut est false.
show-prioritization-signals boolean Non Inclut les signaux de hiérarchisation pour chaque recommandation lorsqu’ils sont disponibles. Doit prioritized être défini sur true. La valeur par défaut est false.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Recommandation : Résumé

Résume les recommandations d’Azure Advisor dans un abonnement ou un groupe de services avec des nombres côté serveur, des totaux, des classements et des distributions. Utilisez-le pour répondre à des questions telles que le nombre de recommandations, leur répartition, les plus fréquentes ou les types de ressources qui en comptent le plus. Regrouper les résultats par recommendation-type, impact, category, resource-type, status, sub-category, ou retirement-date. Le regroupement par défaut est category. Tous les regroupements, à l’exception de status, incluent uniquement des recommandations actives avec l’état New.

Définissez prioritized sur true pour classer les types de recommandations actifs par priorité, pour les requêtes telles que les recommandations principales, les plus critiques ou les éléments à corriger en premier. Chaque type classé inclut son nombre de ressources affectées et les signaux qui expliquent son classement. Pour afficher les recommandations individuelles d’un type classé, utilisez Recommandation : Liste avec son ID de type de recommandation.

TotalRecommendations reflète toujours la population filtrée complète, même lorsque top limite les groupes renvoyés.

Exemple de commande CLI

azmcp advisor recommendation summary \
  [--service-group <service-group>] \
  [--resource-group <resource-group>] \
  [--group-by <group-by>] \
  [--prioritized <true|false>] \
  [--category <category>] \
  [--impact <impact>] \
  [--recommendation-type-id <recommendation-type-id>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--sub-category <sub-category>] \
  [--retirement-date <retirement-date>] \
  [--top <top>]
Paramètre Type Obligatoire Description
service-group string Non Le groupe de services Azure à résumer, fourni en tant que segment de nom de son ID de ressource ARM. Spécifiez un groupe de services ou un abonnement, et non les deux. Si vous omettez les deux, l’outil utilise l’abonnement par défaut configuré.
resource-group string Non Le nom du groupe de ressources Azure. S’applique uniquement à l’étendue de l’abonnement.
group-by string Non Champ pour regrouper le résumé par : recommendation-type, impact, category, resource-type, status, sub-category, ou retirement-date. La valeur par défaut est category. Omettez-le quand prioritized est true, car les résumés hiérarchisés regroupent toujours par type de recommandation.
prioritized boolean Non Classe les types de recommandation actifs par priorité au lieu de les compter. Le classement prend en compte le score de priorité, les économies annuelles, la criticité, la date de mise hors service et le nombre de ressources affectées. La valeur par défaut est false.
category string Non Filtrer les recommandations par catégorie : Cost, HighAvailability, Security, Performance, ou OperationalExcellence. Insensible à la casse.
impact string Non Filtrer les recommandations par impact métier : High, Mediumou Low. Insensible à la casse.
recommendation-type-id string Non Filtrez les recommandations par ID de type de recommandation (GUID). Correspondance exacte qui ne respecte pas la casse.
resource-type string Non Filtrez les recommandations par type de ressource Azure impacté, tel que Microsoft.Storage/storageAccounts. Correspondance exacte qui ne respecte pas la casse.
resource string Non Filtrez les recommandations en fonction du nom de la ressource affectée ou de l’ID de ressource ARM complet. Correspondance de sous-chaîne qui ne respecte pas la casse.
search string Non Filtre de texte libre sur le texte du problème de recommandation, tel que encryption ou right-size. Correspondance de sous-chaîne qui ne respecte pas la casse. Préférez un filtre structuré lorsqu’il convient à la demande.
sub-category string Non Filtrer les recommandations par sous-catégorie, telles que ServiceUpgradeAndRetirement, ZoneResiliencyou RegionalResiliency. Correspondance exacte qui ne respecte pas la casse.
retirement-date string Non Filtrez les recommandations par date de mise hors service au <operator>:<yyyy-MM-dd> format, par exemple le:2026-12-31. Les opérateurs pris en charge sont eq, , ltle, gtet ge. Les opérateurs le et lt incluent les mises hors service dont la date est dépassée, mais qui sont toujours actives.
top integer Non Nombre maximal de groupes à retourner, compris entre 1 et 100. Est défini par défaut sur tous les groupes, ou sur 10 quand prioritized est true.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Recommandation : mise à jour

Met à jour l’état d’une recommandation Azure Advisor dans un abonnement ou un groupe de services. Marquez une recommandation comme terminée, rejetez-la, reportez-la (mettre en veille) jusqu’à une date et une heure ultérieures, ou réactivez-la en la définissant sur New. Retourne la recommandation mise à jour dans la forme de ressource ARM. Vous ne pouvez pas mettre à jour les recommandations de sécurité ou les recommandations que la plateforme résout.

Exemple de commande CLI

azmcp advisor recommendation update \
  --recommendation-id <recommendation-id> \
  --recommendation-status <recommendation-status> \
  [--service-group <service-group>] \
  [--postponed-until-date-time <postponed-until-date-time>] \
  [--recommendation-dismiss-reason <recommendation-dismiss-reason>]
Paramètre Type Obligatoire Description
recommendation-id string Oui ID stable de la recommandation Advisor à mettre à jour.
recommendation-status string Oui Le nouvel état de recommandation : New, Postponed, Dismissed, ou Completed. Utilisez New pour réactiver une recommandation reportée, ignorée ou terminée.
service-group string Non Le groupe de services Azure qui contient la recommandation, fourni en tant que segment de nom de son ID de ressource ARM. Spécifiez un groupe de services ou un abonnement, et non les deux. Si vous omettez les deux, l’outil utilise l’abonnement par défaut configuré.
postponed-until-date-time string Non La date et l’heure futures jusqu’auxquelles la recommandation est reportée, au format ISO 8601 avec un décalage de fuseau horaire. Obligatoire quand recommendation-status est Postponed.
recommendation-dismiss-reason string Non Motif de l’abandon de la recommandation : ExcessiveCostInvestmentRequired, IncompatibleWithTheCurrentConfiguration, ImplementationStepsAreUnclear, RiskIsAcceptable, TooComplexOrImpracticalToImplement, AnAlternativeSolutionIsAlreadyInPlace, ou Other. La valeur par défaut est Other lorsqu’elle est omise.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
✅ ✅ ❌ ❌ ❌ ❌

Correction : Obtenir

Récupère le package de remédiation associé à un type de recommandation Azure Advisor, qui explique comment résoudre le problème. Selon la recommandation, le package contient des instructions de remédiation manuelle détaillées, des artefacts prêts à être exécutés aux formats Azure CLI, PowerShell, Bicep, modèle ARM et Terraform, ou les deux. Il comprend également des étapes ordonnées, des paramètres, des procédures de vérification et des caractéristiques indiquant notamment si la remédiation est destructive ou réversible, son niveau de confiance et l’effort nécessaire à sa mise en œuvre.

Exemple de commande CLI

azmcp advisor remediation get \
  --recommendation-type-id <recommendation-type-id>
Paramètre Type Obligatoire Description
recommendation-type-id string Oui ID de type de recommandation Advisor (GUID) pour obtenir le package de correction, sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Informations sur les groupes de services : Obtenir

Obtient l'état actuel Azure Advisor et la criticité d'un groupe de services, ou de tous les groupes de services accessibles lorsque vous ne spécifiez pas celui-ci. Les valeurs d’état sont On Track, Attention Needed, At Risk, Critical et Unavailable. Chaque résultat inclut le nom et l’ID du groupe de services, la criticité, l’état, la description de l’état, où se concentrer, l’objectif quand il est défini et l’heure de la dernière mise à jour. La réponse explique également comment l’état est calculé. Si vous avez accès à plusieurs tenants, spécifiez le tenant.

Exemple de commande CLI

azmcp advisor servicegroupintelligence get \
  [--service-group <service-group>] \
  [--criticality <criticality>] \
  [--status <status>] \
  [--top <top>]
Paramètre Type Obligatoire Description
service-group string Non Nom du groupe de services, tel que commerce, pas son ID de ressource ARM complet. Si vous l’omettez, l’outil retourne tous les groupes de services accessibles.
criticality string Non Filtrer par niveau de criticité : MissionCritical (niveau 0), BusinessCritical (niveau 1), BusinessOperational (niveau 2), Administrative (niveau 3) ou NotApplicable. Insensible à la casse. Tier0 à 0 et Tier3 à 3 sont également acceptés.
status string Non Filtrer par état : On Track, Attention Needed, At Risk, Critical, ou Unavailable. Insensible à la casse et les espaces sont facultatifs.
top integer Non Nombre maximal de groupes de services à retourner, compris entre 1 et 500. La valeur par défaut est 50.

Indicateurs d’annotation d’outil :

Destructeur Idempotent Open World Lecture seule Secret Paramètres régionaux requis
❌ ✅ ❌ ✅ ❌ ❌

Contenu connexe

  • Dernière mise à jour :