Azure MCP Server-verktyg för Azure Advisor

Azure MCP Server hjälper dig att hantera Azure Advisor resurser, inklusive att tillämpa rekommendationer, få information, lista rekommendationer och tillhandahålla sammanfattningar, allt via frågor på naturligt språk.

Azure Advisor analyserar dina Azure resurser och ger anpassade, användbara rekommendationer för att optimera kostnader, prestanda, tillförlitlighet och säkerhet. Mer information finns i Azure Advisor dokumentation.

Anmärkning

Verktygsparametrar: Azure MCP Server-verktygen definierar parametrar för data som de behöver för att slutföra uppgifter. Vissa av dessa parametrar är specifika för varje verktyg och dokumenteras här. Andra parametrar är globala och delas av alla verktyg. Mer information finns i Verktygsparametrar.

Metadata: Hämta

Hämtar Azure Advisor metadata för en specifik rekommendationstyp. Returnerar rekommendationstypens visningsnamn, kategori, underkategori, påverkan, resurstyper som stöds, beskrivning, potentiella fördelar och reparationsåtgärder. Använd metadata för att förstå rekommendationen, utvärdera dess effekt och planera reparationssteg.

Cli-exempelkommando

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parameter Type Obligatoriskt Beskrivning
recommendation-type-id string Yes Det stabila Advisor-rekommendationstyp-ID:t (properties.recommendationTypeId) som används för att slå upp i den globala katalogen för rekommendationsmetadata. Det här ID:t är anslutningsnyckeln som delas med enskilda rekommendationer.
language string No Katalogspråk att filtrera efter (properties.language). Standardinställningen är en. Skiftlägesokänsligt. Värden som stöds: en, cs, de, es, fr, hu, id, jait, , ko, nl, pl, pt-br, pt-pt, ru, sv, tr, , zh-hanszh-hant. Advisor accepterar regionkvalificerade taggar som en-US och mappar dem till basspråket (en).

Anteckningsverktygstips:

Destruktiv Idempotent Öppen värld Skrivskyddad Secret Lokalt obligatoriskt

Metadata: Lista

Visar Azure Advisor rekommendationsmetadata, även kallade rekommendationstyper. Hjälper dig att identifiera vilka rekommendationer Azure Advisor kan ge innan du distribuerar resurser, till exempel virtuella datorer, även när det inte finns några aktiva rekommendationer. Visar Advisor-tjänstens avvecklingar som inträffar på, före eller efter ett angivet avvecklingsdatum och hittar metadata om tjänstavvecklingar med hjälp av Service Health-spårnings-ID. Stöder identifiering av greenfield-miljöer med hjälp av den globala Azure Resource Graph-katalogen och filtrering efter resurstyp för integrering av brownfield-miljöer. Accepterar valfria filter för språk, resurstyp, effekt, kategori, underkategori, spårnings-ID och slutdatum. Returnerar lokaliserade typ-ID:er, namn, kategorier, underkategorier, påverkan, prioritet, beskrivningar, fördelar, åtgärder, omfång, källfråga och information om tjänstavbrott. Sorterar resultaten efter påverkan från hög till medel till låg, och sedan efter visningsnamn.

Cli-exempelkommando

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 Obligatoriskt Beskrivning
language string No Språk för lokaliserade rekommendationsmetadata. Standard är engelska (en). Katalogspråk som stöds är en, cs, de, es, fr, hu, id, it, ja, ko, nl, pl, pt-BR, pt-PT, ru, sv, tr, zh-Hansoch zh-Hant. Regionala varianter mappas till ett basspråk som stöds när det är tillgängligt, till exempel en-US till en och fr-CA till fr; nationella katalogspråk förblir distinkta.
resource-type string No Valfritt exakt Azure resurstypfilter, till exempel microsoft.compute/virtualmachines. Använd den under brownfield onboarding för att identifiera rekommendationstyper som gäller för den resurstypen. Filtret är skiftlägesokänsligt.
impact string No Valfritt filter för rekommendationspåverkan. Tillåtna värden är High, Mediumeller Low. Filtret är skiftlägesokänsligt. Som standard visas resultaten i High, Mediumoch sedan Low ordning.
category string No Valfritt exakt Advisor-kategorifilter. Tillåtna värden är Cost, HighAvailability, Security, Performanceoch OperationalExcellence. Filtret är inte skiftlägeskänsligt.
sub-category string No Valfritt underkategorifilter för exakta rekommendationer. Filtret är inte skiftlägeskänsligt. Kända katalogvärden är ComputeOptimization, DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, , Personalized, RegionalResiliency, Reservations, SafeAndSecureDeployment, SavingsPlan, Scalability, ServiceUpgradeAndRetirement, StorageOptimization, och ZoneResiliencyUsageOptimization. Katalogen kan lägga till värden över tid, så verktyget accepterar andra underkategorier.
tracking-id string No Valfritt exakt Service Health-spårnings-ID-filter, till exempel QNY1-HB8. Filtret är inte skiftlägeskänsligt och gäller i metadata för ServiceUpgradeAndRetirement. Du kan utelämna --sub-category, men du kan inte ange ett annat värde.
retirement-date string No Valfritt datumfilter för tjänstavgång i <operator>:<yyyy-MM-dd> format, till exempel ge:2026-03-31. Operatorer som stöds är eq, lt, le, gtoch ge. Gäller endast för underkategorin ServiceUpgradeAndRetirement . Du kan utelämna --sub-category, men du kan inte ange ett annat värde.

Anteckningsverktygstips:

Destruktiv Idempotent Öppen värld Skrivskyddad Secret Lokalt obligatoriskt

Rekommendation: Använd

Hjälper dig att tillämpa Azure Advisor rekommendationer för IaC-filer (infrastruktur som kod), till exempel Azure Resource Manager-mallar (ARM) och Terraform-konfigurationer. Den returnerar regler som ska tillämpas på IaC-filen.

Cli-exempelkommando

azmcp advisor recommendation apply \
  --resource <resource>
Parameter Type Obligatoriskt Beskrivning
resource string Yes Den Azure resurstyp som du vill hämta IaC-filregler för. Tillgängliga alternativ: 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

Anteckningsverktygstips:

Destruktiv Idempotent Öppen värld Skrivskyddad Secret Lokalt obligatoriskt

Rekommendation: Lista

Listar enskilda Azure Advisor-rekommendationer för en prenumeration och returnerar en post per rekommendation. Använd endast det här kommandot om du vill visa rekommendationsinnehåll och information. Använd i stället för aggregerings-, rangordnings-, jämförelse- eller antalsfrågor advisor recommendation summary . Returnerar endast aktiva rekommendationer med status New och exkluderar avvisade och uppskjutna rekommendationer. Stöder valfria filter för kategori, påverkan, resurstyp, resurs och fritextsökning. Ett top parametertak returnerade objekt med standardvärdet 50 och högst 100. Eftersom kommandot returnerar högst 100 poster kan dess resultat för aggregerade beräkningar underräkna totalsumman.

Cli-exempelkommando

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parameter Type Obligatoriskt Beskrivning
category string No Filtrera rekommendationer efter kategori (till exempel Security, Cost, Performance, HighAvailability, OperationalExcellence). Skiftlägesokänslig exakt matchning.
impact string No Filtrera rekommendationer efter affärspåverkan (High, Mediumeller Low). Skiftlägesokänslig exakt matchning.
resource-type string No Filtrera rekommendationer efter påverkad Azure resurstyp (till exempel Microsoft.Storage/storageAccounts). Skiftlägesokänslig exakt matchning.
resource string No Filtrera rekommendationer efter resursnamn som påverkas eller fullständigt ARM-resurs-ID. Skiftlägesokänslig matchning av delsträng.
search string No Tillämpar ett fritextfilter på texten för rekommendationsproblemet (skiftlägesokänslig matchning av delsträng). Använd detta när en begäran innehåller en aktuell fras som related to Microsoft Foundry, about encryption, mentioning right-sizeeller for Key Vault. Extrahera de framträdande substantiven från frasen (till exempel Foundry, , encryptright-size, ) Key Vaultoch skicka dem hit.
top string No Maximalt antal objekt som ska returneras. För list: standardvärdet är 50, med ett intervall på serversidan på 1–100. För summary: valfritt visningstak för antalet bucketar som returneras (standardvärdet är alla). TotalRecommendations återspeglar alltid hela den filtrerade populationen oavsett --top.
resource-group string No Namnet på Azure-resursgruppen.

Anteckningsverktygstips:

Destruktiv Idempotent Öppen värld Skrivskyddad Secret Lokalt obligatoriskt

Rekommendation: Sammanfattning

Det här kommandot aggregerar aktiva Azure Advisor rekommendationer med status New och returnerar antal per bucket plus en korrekt summa. Använd det här kommandot för frågor om aggregering, rangordning, jämförelse och antal. Filter gäller före aggregering. Gruppera resultat efter recommendation-type, category, impacteller resource-type. Standardgruppering är category, som innehåller övergripande teman som Kostnad, Säkerhet och Tillförlitlighet. Parametern top begränsar de visade bucketarna, men TotalRecommendations återspeglar alltid den fullständiga filtrerade populationen. Kommandot bevarar bucketen Unknown som slutresultatet. Inkludera den som den sista raden när du visar grupper i en tabell.

Cli-exempelkommando

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 Obligatoriskt Beskrivning
group-by string No Fält för att gruppera sammanfattningen efter. En av: recommendation-type, category, impact, resource-type. Standardvärdet är category, vilket visar de övergripande temana (kostnad, säkerhet, tillförlitlighet med mera), så att promptar som summarize the key themes from my Advisor recommendations fungerar utan att ange ett fält.
category string No Filtrera rekommendationer efter kategori (till exempel Security, Cost, Performance, HighAvailability, OperationalExcellence). Skiftlägesokänslig exakt matchning.
impact string No Filtrera rekommendationer efter affärspåverkan (High, Mediumeller Low). Skiftlägesokänslig exakt matchning.
resource-type string No Filtrera rekommendationer efter påverkad Azure resurstyp (till exempel Microsoft.Storage/storageAccounts). Skiftlägesokänslig exakt matchning.
resource string No Filtrera rekommendationer efter resursnamn som påverkas eller fullständigt ARM-resurs-ID. Skiftlägesokänslig matchning av delsträng.
search string No Fritextfilter som tillämpas på rekommendationsproblemtexten (skiftlägesokänslig delsträngsmatchning). Använd det här filtret när din begäran innehåller en aktuell fras som related to Microsoft Foundry, about encryption, mentioning right-sizeeller for Key Vault. Extrahera de framträdande substantiven från frasen (till exempel Foundry, , encryptright-size, ) Key Vaultoch skicka dem hit.
top string No Maximalt antal objekt som ska returneras. För list: standardvärdet är 50, fastklämt till 1–100 (gräns på serversidan). För summary: valfritt visningstak för antalet bucketar som returneras (standardvärdet är alla). TotalRecommendations återspeglar alltid hela den filtrerade populationen oavsett --top.
resource-group string No Namnet på Azure-resursgruppen.

Anteckningsverktygstips:

Destruktiv Idempotent Öppen värld Skrivskyddad Secret Lokalt obligatoriskt