Outils de Azure MCP Server pour Azure Advisor

Le serveur MCP Azure vous aide à gérer les ressources Azure Advisor, notamment pour appliquer des recommandations, en consulter les détails, en afficher la liste et en fournir des résumés, le tout via des requêtes en langage naturel.

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 complet, la catégorie, la sous-catégorie, l’impact, les types de ressources pris en charge, la description, les avantages potentiels et les actions de correction du type de recommandation. Utilisez les métadonnées pour comprendre la recommandation, évaluer son impact et planifier les étapes de correction.

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 du type de recommandation Advisor stable (properties.recommendationTypeId) à rechercher dans le catalogue global des métadonnées de recommandation. Cet identifiant est la clé de jointure commune aux recommandations individuelles.
language string Non Paramètre régional du catalogue sur lequel appliquer le filtre (properties.language). La valeur par défaut est en. Insensible à la casse. Valeurs prises en charge : en, de, cs, hu, zh-hans, ru, zh-hant, tr, sv, pt-pt, pt-br, pl, nl, ja, id, ko, es, fr, it. Advisor accepte les balises qualifiées par région, telles que en-US et les mappe à la langue 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 les métadonnées de recommandation d’Azure Advisor, également appelées types de recommandation. 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. Accepte les filtres facultatifs pour la langue, le type de ressource, l’impact, la catégorie, la sous-catégorie, l’ID de suivi et la date de mise hors service. 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.

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). Langues de catalogue prises en charge : en, de, cs, it, ja, hu, id, ko, pt-BR, nl, pl, fr, es, pt-PT, sv, tr, ru, zh-Hans et zh-Hant. Les variantes régionales correspondent à une langue de base prise en charge lorsqu’elle est disponible, par exemple de en-US à fr-CA et de en à fr ; les langues de catalogue propres aux paramètres régionaux restent distinctes.
resource-type string Non Filtre de type de ressource Azure exact 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. Le filtre ne respecte pas la casse.
impact string Non Filtre facultatif de l’impact des recommandations Les valeurs autorisées sont High, Mediumou Low. Le filtre ne respecte pas la casse. Par défaut, les résultats apparaissent dans l’ordre High, Medium, puis Low.
category string Non Filtre exact facultatif sur la catégorie du conseiller. Les valeurs autorisées sont Cost, HighAvailability, Security, Performance et OperationalExcellence. Le filtre ne respecte pas la casse.
sub-category string Non Filtre de sous-catégorie de recommandation exacte facultatif. Le filtre ne respecte pas la casse. Les valeurs connues du catalogue incluent ComputeOptimization, EfficiencyOptimization, DataPerformance, DataProtectionAndRecovery, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, Personalized, RegionalResiliency, Reservations, SafeAndSecureDeployment, SavingsPlan, Scalability, ServiceUpgradeAndRetirement, StorageOptimization, UsageOptimization et ZoneResiliency. Le catalogue peut ajouter des valeurs au fil du temps, de sorte que l’outil accepte d’autres sous-catégories.
tracking-id string Non Filtre optionnel par ID exact de suivi de l’intégrité du service, tel que QNY1-HB8. Le filtre n’est pas sensible à la casse et s’applique au sein des métadonnées ServiceUpgradeAndRetirement. Vous pouvez omettre --sub-category, mais vous ne pouvez pas spécifier de 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 ServiceUpgradeAndRetirement sous-catégorie. Vous pouvez omettre --sub-category, mais vous ne pouvez pas spécifier de valeur différente.

Indicateurs d’annotation d’outil :

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

Recommandation : Appliquer

Vous aide à appliquer des recommandations Azure Advisor aux fichiers IaC (Infrastructure-as-code), tels que les modèles Azure Resource Manager (ARM) et les configurations Terraform. Elle retourne des règles à appliquer au fichier IaC.

Exemple de commande CLI

azmcp advisor recommendation apply \
  --resource <resource>
Paramètre Type Obligatoire Description
resource string Oui Type de ressource Azure pour lequel obtenir les règles relatives aux fichiers IaC. Options disponibles : aad_domainservices, apimanagement_service, cognitiveservices_accounts, compute_virtualmachines, compute_virtualmachinescalesets, containerregistry_registries, containerservice_managedclusters, dbforpostgresql_flexibleservers, documentdb_databaseaccounts, keyvault_vaults, kubernetes_connectedclusters, kubernetesconfiguration_extensions, netapp_volumes, network_applicationgatewaywebapplicationfirewallpolicies, network_expressrouteports, network_frontdoorwebapplicationfirewallpolicies, sql_managedinstances, storage_storageaccounts, web_serverfarms, web_staticsites

Indicateurs d’annotation d’outil :

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

Recommandation : Liste

Répertorie les recommandations de Azure Advisor individuelles pour un abonnement, en retournant un enregistrement par recommandation. Utilisez cette commande uniquement pour afficher le contenu et les détails des recommandations. Pour les questions d’agrégation, de classement, de comparaison ou de comptage, utilisez advisor recommendation summary à la place. Retourne uniquement les recommandations actives avec l’état New et exclut les recommandations ignorées et reportées. Prend en charge les filtres facultatifs pour la catégorie, l’impact, le type de ressource, la ressource et la recherche en texte libre. Une top limite de paramètre renvoie des éléments, avec une valeur par défaut de 50 et un maximum de 100. Étant donné que la commande retourne au maximum 100 enregistrements, l’utilisation de ses résultats pour les calculs agrégés peut sous-calculer le total.

Exemple de commande CLI

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Paramètre Type Obligatoire Description
category string Non Filtrer les recommandations par catégorie (par exemple, Security, , CostPerformanceHighAvailability, , OperationalExcellence). Correspondance exacte qui ne respecte pas la casse.
impact string Non Filtrer les recommandations par impact métier (Highou MediumLow). Correspondance exacte qui ne respecte pas la casse.
resource-type string Non Filtrer les recommandations par type de ressource Azure impacté (par exemple). 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 Applique un filtre de texte libre appliqué au texte du problème de recommandation (correspondance sur une sous-chaîne qui ne respecte pas la casse). Utilisez cette option chaque fois qu’une demande inclut une expression d’actualité telle que related to Microsoft Foundry, , about encryptionmentioning right-sizeou for Key Vault. Extrayez les noms saillants de l’expression (par exemple, Foundry, , encryptright-size, Key Vault, ) et passez-les ici.
top string Non Nombre maximal d’éléments à retourner. Pour list: la valeur par défaut est 50 avec une plage côté serveur de 1 à 100. Pour summary: limite d’affichage facultative du nombre de compartiments retournés (valeur par défaut pour tous). TotalRecommendations reflète toujours la population filtrée complète indépendamment de --top.
resource-group string Non Le nom du groupe de ressources Azure.

Indicateurs d’annotation d’outil :

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

Recommandation : Résumé

Cette commande agrège les recommandations Azure Advisor actives ayant le statut New et renvoie le nombre d’éléments par compartiment ainsi qu’un total exact. Utilisez cette commande pour les questions d’agrégation, de classement, de comparaison et de comptage. Les filtres s’appliquent avant l’agrégation. Regrouper les résultats par recommendation-type, , categoryimpactou resource-type. Le regroupement par défaut est category, qui expose des thèmes de haut niveau tels que coût, sécurité et fiabilité. Le top paramètre limite les compartiments affichés, mais TotalRecommendations reflète toujours la population filtrée complète. La commande conserve le Unknown compartiment comme résultat final ; incluez-le comme ligne finale lorsque vous affichez des groupes dans une table.

Exemple de commande CLI

azmcp advisor recommendation summary \
  [--group-by <group-by>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Paramètre Type Obligatoire Description
group-by string Non Champ dans lequel regrouper le résumé. Un des : recommendation-type, , categoryimpact, resource-type. Par défaut, la valeur est définie sur category, ce qui met en avant les thèmes de haut niveau (coût, sécurité, fiabilité, etc.), afin que des requêtes comme summarize the key themes from my Advisor recommendations fonctionnent sans préciser de champ.
category string Non Filtrer les recommandations par catégorie (par exemple, Security, , CostPerformanceHighAvailability, , OperationalExcellence). Correspondance exacte qui ne respecte pas la casse.
impact string Non Filtrer les recommandations par impact métier (Highou MediumLow). Correspondance exacte qui ne respecte pas la casse.
resource-type string Non Filtrer les recommandations par type de ressource Azure impacté (par exemple). 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 appliqué au texte du problème de recommandation (correspondance sur une sous-chaîne qui ne respecte pas la casse). Utilisez ce filtre chaque fois que votre demande inclut une expression d’actualité telle que related to Microsoft Foundry, , about encryption, mentioning right-sizeou for Key Vault. Extrayez les noms saillants de l’expression (par exemple, Foundry, , encryptright-size, Key Vault, ) et passez-les ici.
top string Non Nombre maximal d’éléments à retourner. Pour list: la valeur par défaut est 50, limitée à 1 à 100 (limite côté serveur). Pour summary: limite d’affichage facultative du nombre de compartiments retournés (valeur par défaut pour tous). TotalRecommendations reflète toujours la population filtrée complète indépendamment de --top.
resource-group string Non Le nom du groupe de ressources Azure.

Indicateurs d’annotation d’outil :

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

Contenu connexe

  • Last updated on