Azure MCP Server-hulpprogramma's voor Azure Advisor

De Azure MCP-server helpt u bij het beheren van Azure Advisor resources, waaronder het toepassen van aanbevelingen, het ophalen van details, het weergeven van aanbevelingen en het verstrekken van samenvattingen, allemaal via prompts in natuurlijke taal.

Azure Advisor analyseert uw Azure resources en levert persoonlijke, bruikbare aanbevelingen om kosten, prestaties, betrouwbaarheid en beveiliging te optimaliseren. Zie Azure Advisor documentatie voor meer informatie.

Opmerking

Hulpprogrammaparameters: de Hulpprogramma's van Azure MCP Server definiëren parameters voor gegevens die ze nodig hebben om taken uit te voeren. Sommige van deze parameters zijn specifiek voor elk hulpprogramma en worden hier beschreven. Andere parameters zijn globaal en worden gedeeld door alle hulpprogramma's. Zie Hulpprogrammaparameters voor meer informatie.

Metagegevens: Ophalen

Hiermee haalt u Azure Advisor metagegevens op voor een specifiek aanbevelingstype. Retourneert de weergavenaam, categorie, subcategorie, impact, ondersteunde resourcetypen, beschrijving, mogelijke voordelen en herstelacties van het aanbevelingstype. Gebruik de metagegevens om inzicht te krijgen in de aanbeveling, de impact ervan te beoordelen en herstelstappen te plannen.

Voorbeeld van CLI-opdracht

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parameter Type Required Beschrijving
recommendation-type-id tekenreeks Yes De ID van het stabiele aanbevelingstype van Advisor (properties.recommendationTypeId) om in de algemene catalogus met metagegevens van aanbevelingen op te zoeken. Deze ID is de koppelingssleutel die gemeenschappelijk is voor individuele aanbevelingen.
language tekenreeks No Cataloguslocale om op te filteren (properties.language). Wordt standaard ingesteld op en. Niet hoofdlettergevoelig. Ondersteunde waarden: en, cs, de, es, fr, hu, it, id, ja, pl, pt-pt, sv, ru, tr, nl, pt-br, ko, zh-hans, zh-hant. Advisor accepteert regio-gekwalificeerde tags, zoals en-US en wijst deze toe aan de basistaal (en).

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist

Metagegevens: Lijst

Geeft een lijst van de metagegevens van Azure Advisor-aanbevelingen, ook wel aanbevelingstypen genoemd. Hiermee kunt u ontdekken welke aanbevelingen Azure Advisor kunnen produceren voordat u resources zoals virtuele machines implementeert, zelfs wanneer er geen actieve aanbevelingen bestaan. Toont uitdienststellingen van Advisor-services die plaatsvinden op, vóór of na een opgegeven uitdienststellingsdatum, en zoekt metagegevens over service-uitdienststellingen op basis van de tracking-id van Service Health. Ondersteunt greenfield-detectie met de globale Azure Resource Graph-catalogus en filters op resourcetypen voor brownfield-onboarding. Accepteert optionele filters voor taal, resourcetype, impact, categorie, subcategorie, tracerings-id en buitengebruikstellingsdatum. Geeft gelokaliseerde type-ID's, namen, categorieën, subcategorieën, impact, prioriteit, beschrijvingen, voordelen, acties, toepassingsgebied, bronquery en details over de uitfasering van diensten terug. Sorteert resultaten op impact van Hoog naar Gemiddeld naar Laag, en vervolgens op weergavenaam.

Voorbeeld van CLI-opdracht

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>]
Parameter Type Required Beschrijving
language tekenreeks No Taal voor gelokaliseerde metagegevens van aanbevelingen. Standaard ingesteld op Engels (en). Ondersteunde catalogustalen zijn en, cs, de, es, hu, fr, id, it, nl, pl, ja, sv, ru, tr, pt-BR, pt-PT, ko, zh-Hans en zh-Hant. Regionale varianten worden gekoppeld aan een ondersteunde basistaal wanneer die beschikbaar is, zoals van en-US naar en en van fr-CA naar fr; lokale catalogustalen blijven onderscheiden.
resource-type tekenreeks No Optioneel filter voor exact Azure-resourcetype, zoals microsoft.compute/virtualmachines. Gebruik dit tijdens brownfield-onboarding om typen aanbevelingen te ontdekken die van toepassing zijn op dat resourcetype. Het filter is niet hoofdlettergevoelig.
impact tekenreeks No Optioneel filter voor de impact van aanbevelingen. Toegestane waarden zijn High, Mediumof Low. Het filter is niet hoofdlettergevoelig. Standaard worden de resultaten weergegeven in High, Mediumen vervolgens Low in volgorde.
category tekenreeks No Optionele exacte categoriefilter voor adviseurs. Toegestane waarden zijnCost, , , HighAvailabilityen SecurityPerformanceOperationalExcellence. Het filter is niet hoofdlettergevoelig.
sub-category tekenreeks No Optioneel subcategoriefilter voor exacte aanbevelingen. Het filter is niet hoofdlettergevoelig. Bekende cataloguswaarden omvatten ComputeOptimization, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, SafeAndSecureDeployment, Reservations, ServiceUpgradeAndRetirement, SavingsPlan, Personalized, Scalability, RegionalResiliency, StorageOptimization, UsageOptimization, ZoneResiliency en DataPerformance. De catalogus kan in de loop van de tijd waarden toevoegen, zodat het hulpprogramma andere subcategorieën accepteert.
tracking-id tekenreeks No Optioneel filter voor de exacte tracking-id van Service Health, zoals QNY1-HB8. Het filter is niet hoofdlettergevoelig en is van toepassing binnen ServiceUpgradeAndRetirement metagegevens. U kunt weglaten --sub-category, maar u kunt geen andere waarde opgeven.
retirement-date tekenreeks No Optioneel filter voor de uitdienststellingsdatum in de notatie <operator>:<yyyy-MM-dd>, bijvoorbeeld ge:2026-03-31. Ondersteunde operators zijneq, lt, , leen gtge. Is alleen van toepassing op de ServiceUpgradeAndRetirement subcategorie. U kunt weglaten --sub-category, maar u kunt geen andere waarde opgeven.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist

Aanbeveling: Toepassen

Hiermee kunt u Azure Advisor aanbevelingen toepassen op IaC-bestanden (infrastructure-as-code), zoals arm-sjablonen (Azure Resource Manager) en Terraform-configuraties. Het geeft regels terug die op het IaC-bestand moeten worden toegepast.

Voorbeeld van CLI-opdracht

azmcp advisor recommendation apply \
  --resource <resource>
Parameter Type Required Beschrijving
resource tekenreeks Yes Het Azure-resourcetype waarvoor IaC-bestandsregels worden opgehaald. Beschikbare opties: 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

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist

Aanbeveling: Lijst

Bevat afzonderlijke Azure Advisor aanbevelingen voor een abonnement en retourneert één record per aanbeveling. Gebruik deze opdracht alleen om de inhoud en details van de aanbeveling weer te geven. Gebruik in plaats daarvan voor vragen advisor recommendation summary over aggregaat, rangschikken, vergelijken of tellen. Retourneert alleen actieve aanbevelingen met status New en sluit genegeerde en uitgesteld aanbevelingen uit. Ondersteunt optionele filters voor categorie, impact, resourcetype, resource en zoeken in vrije tekst. Een top parameterlimiet retourneert items met een standaardwaarde van 50 en maximaal 100. Omdat de opdracht maximaal 100 records retourneert, kan het gebruik van de resultaten ervan voor geaggregeerde berekeningen leiden tot een onderschatting van het totaal.

Voorbeeld van CLI-opdracht

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parameter Type Required Beschrijving
category tekenreeks No Filter aanbevelingen op categorie (bijvoorbeeldSecurity, Cost, Performance, , HighAvailability, ). OperationalExcellence Hoofdlettergevoelige exacte overeenkomst.
impact tekenreeks No Aanbevelingen filteren op bedrijfsimpact (High, Medium of Low). Hoofdlettergevoelige exacte overeenkomst.
resource-type tekenreeks No Filter aanbevelingen op basis van het beïnvloede Azure-resource type (bijvoorbeeld Microsoft.Storage/storageAccounts). Hoofdlettergevoelige exacte overeenkomst.
resource tekenreeks No Filter aanbevelingen op betrokken resourcenaam of volledige ARM-resource-id. Niet-hoofdlettergevoelige subtekenreeksovereenkomst.
search tekenreeks No Past een vrijetekstfilter toe op de tekst van het aanbevelingsprobleem (overeenkomst met een subtekenreeks zonder onderscheid tussen hoofdletters en kleine letters). Gebruik dit wanneer een aanvraag een actuele woordgroep bevat, zoals related to Microsoft Foundry, about encryption, mentioning right-sizeof for Key Vault. Extraheer de belangrijkste zelfstandige naamwoorden uit de zinsnede (bijvoorbeeld Foundry, encrypt, right-size, Key Vault) en geef deze hier door.
top tekenreeks No Maximum aantal te retourneren items. Voor list: is standaard ingesteld op 50 met een bereik aan de serverzijde van 1-100. Voor summary: optionele weergavelimiet voor het aantal buckets dat wordt geretourneerd (standaard ingesteld op alle). TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie, ongeacht --top.
resource-group tekenreeks No De naam van de Azure-resourcegroep.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist

Aanbeveling: Samenvatting

Met deze opdracht worden actieve Azure Advisor aanbevelingen met status New samengevoegd en worden aantallen per bucket geretourneerd plus een nauwkeurig totaal. Gebruik deze opdracht voor vragen over aggregaat, rangschikken, vergelijken en tellen. Filters zijn van toepassing vóór aggregatie. Groepeer resultaten op recommendation-type, category, impactof resource-type. De standaardgroepering is category, waarmee thema's op hoog niveau worden weergegeven, zoals Kosten, Beveiliging en Betrouwbaarheid. De top parameter beperkt de weergegeven buckets, maar TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie. Met de opdracht blijft de Unknown bucket behouden als het uiteindelijke resultaat. Neem deze op als de laatste rij wanneer u groepen in een tabel weergeeft.

Voorbeeld van CLI-opdracht

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>]
Parameter Type Required Beschrijving
group-by tekenreeks No Veld om de samenvatting op te groeperen. Een van: recommendation-type, category, impact, . resource-type Standaard ingesteld op category, waarmee de hoofdthema’s (Kosten, Beveiliging, Betrouwbaarheid en meer) zichtbaar worden gemaakt, zodat prompts zoals summarize the key themes from my Advisor recommendations werken zonder een veld te benoemen.
category tekenreeks No Filter aanbevelingen op categorie (bijvoorbeeldSecurity, Cost, Performance, , HighAvailability, ). OperationalExcellence Hoofdlettergevoelige exacte overeenkomst.
impact tekenreeks No Aanbevelingen filteren op bedrijfsimpact (High, Medium of Low). Hoofdlettergevoelige exacte overeenkomst.
resource-type tekenreeks No Filter aanbevelingen op basis van het beïnvloede Azure-resource type (bijvoorbeeld Microsoft.Storage/storageAccounts). Hoofdlettergevoelige exacte overeenkomst.
resource tekenreeks No Filter aanbevelingen op betrokken resourcenaam of volledige ARM-resource-id. Niet-hoofdlettergevoelige subtekenreeksovereenkomst.
search tekenreeks No Filter voor vrije tekst toegepast op de tekst van het aanbevelingsprobleem (overeenkomst met een deeltekenreeks zonder onderscheid tussen hoofdletters en kleine letters). Gebruik dit filter wanneer uw aanvraag een actuele woordgroep bevat, zoals related to Microsoft Foundry, about encryptionof mentioning right-sizefor Key Vault. Extraheer de belangrijkste zelfstandige naamwoorden uit de zinsnede (bijvoorbeeld Foundry, encrypt, right-size, Key Vault) en geef deze hier door.
top tekenreeks No Maximum aantal te retourneren items. Voor list: is standaard ingesteld op 50, vastgeklemd tot 1-100 (limiet aan serverzijde). Voor summary: optionele weergavelimiet voor het aantal buckets dat wordt geretourneerd (standaard ingesteld op alle). TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie, ongeacht --top.
resource-group tekenreeks No De naam van de Azure-resourcegroep.

Hints voor aantekening van hulpprogramma's:

Destructief Idempotent (onveranderlijk bij herhaald gebruik) Open wereld Alleen lezen Secret Lokaal vereist