Dela via

Azure Event Hubs-verktyg för Azure MCP Server

Med Azure MCP Server kan du hantera Azure Event Hubs-resurser med frågor om naturligt språk. Du behöver inte komma ihåg någon specifik kommandosyntax.

Azure Event Hubs är en intern dataströmningstjänst i molnet som strömmar miljontals händelser per sekund, med låg svarstid, från alla källor till alla mål. Event Hubs är kompatibelt med Apache Kafka och låter dig köra befintliga Kafka-arbetsbelastningar utan några kodändringar.

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 nedan. Andra parametrar är globala och delas av alla verktyg. Mer information finns i Verktygsparametrar.

Händelsehubb: Ta bort konsumentgrupp

Ta bort en konsumentgrupp från den angivna händelsehubben.

Exempel på frågor är:

  • Ta bort en specifik konsumentgrupp: "Ta bort konsumentgruppen 'analytics-group' från Event Hub 'orders-hub' i namnområdet 'eventhub-prod'"
  • Ta bort konsumentgrupp: "Ta bort konsumentgruppen övervakningskonsumenter från min händelsehubb telemetrihändelser i namnområdet prod-eventhubs"
  • Rensa konsumentgrupp: "Ta bort konsumentgruppen 'test-group' från Event Hub 'user-events' i namnområdet 'development-eventhubs'
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Händelsehubb Krävs Namnet på händelsehubben i namnområdet.
Konsumentgrupp Krävs Namnet på konsumentgruppen i händelsehubben.

Händelsehubb: Hämta konsumentgrupp

Hämta konsumentgrupper från Azure Event Hubs. Det här verktyget kan:

  • Visa en lista över alla konsumentgrupper i en händelsehubb
  • Hämta en enskild konsumentgrupp efter namn

Parametrarna för händelsehubben och namnområdet krävs för både get och list. Du behöver bara parametern konsumentgrupp när du hämtar en specifik konsumentgrupp.

Exempel på frågor är:

  • Visa en lista över alla konsumentgrupper: "Visa en lista över alla konsumentgrupper i Event Hub "orders-hub" i namnområdet 'eventhub-prod' i resursgruppen 'production-resources'"
  • Hämta specifik konsumentgrupp: "Hämta information om konsumentgruppen 'analytics-group' från Event Hub 'orders-hub' i namnområdet 'eventhub-prod' i resursgruppen 'production-resources'"
  • Visa information om konsumentgrupper: "Visa mig konsumentgruppen "monitoring-consumers" från Event Hub 'telemetry-events'"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Händelsehubb Krävs Namnet på händelsehubben i namnområdet.
Konsumentgrupp Valfritt Namnet på konsumentgruppen i händelsehubben.

Händelsehubb: Skapa eller uppdatera konsumentgrupp

Skapa eller uppdatera en konsumentgrupp i den angivna händelsehubben. Verktyget skapar en ny konsumentgrupp eller uppdaterar en befintlig.

Exempel på frågor är:

  • Skapa ny konsumentgrupp: "Skapa en ny konsumentgrupp "analysgrupp" i Event Hub "orders-hub" i namnområdet 'eventhub-prod' i resursgruppen 'production-resources'"
  • Uppdatera befintlig konsumentgrupp: "Uppdatera konsumentgruppen 'analytics-group' i Event Hub 'orders-hub' i namnområdet 'eventhub-prod' i resursgruppen 'production-resources' med användarmetadata 'Uppdaterad för Q4-analys'"
  • Konfigurera konsumentgrupp: "Konfigurera en konsumentgrupp "monitoring-consumers" i Event Hub 'telemetry-events'"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Händelsehubb Krävs Namnet på händelsehubben i namnområdet.
Konsumentgrupp Krävs Namnet på konsumentgruppen i händelsehubben.
Användarmetadata Valfritt Användarmetadata för konsumentgruppen.

Händelsehubb: Ta bort händelsehubb

Ta bort en händelsehubb från ett Azure Event Hubs-namnområde. Den här åtgärden tar bort alla meddelanden och konsumentgrupper permanent i händelsehubben.

Exempel på frågor är:

  • Ta bort en specifik händelsehubb: "Ta bort Event Hub 'orders-hub' från namnområdet 'eventhub-prod' i resursgruppen 'production-resources'"
  • Ta bort händelsehubben: "Ta bort händelsehubbens telemetrihändelser från mitt prod-eventhubs-namnområde i resursgruppen "production-resources"
  • Rensa händelsehubben: "Ta bort Event Hub 'test-events' från namnområdet 'dev-eventhubs'"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Händelsehubb Krävs Namnet på händelsehubben i namnområdet.

Händelsehubb: Hämta händelsehubb

Hämta händelsehubbar från ett Azure-namnområde. Det här verktyget:

  • Visa en lista över alla händelsehubbar i ett namnområde
  • Hämta en enskild händelsehubb efter namn

När du hämtar en enskild händelsehubb eller listar flera händelsehubbar returnerar kommandot detaljerad information för alla händelsehubbar, inklusive partitionsantal, inställningar och metadata.

Exempel på frågor är:

  • Visa en lista över alla händelsehubbar: "Visa en lista över alla händelsehubbar i mitt prod-eventhubs-namnområde i resursgruppen "production-resources"
  • Hämta specifik händelsehubb: "Hämta information om min händelsehubb "orders-hub" i namnområdet 'eventhub-prod' i resursgruppen 'production-resources'"
  • Visa händelsehubbens information: "Visa mig händelsehubbens telemetrihändelser från namnområdet "monitoring-hubs"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Händelsehubb Valfritt Namnet på händelsehubben i namnområdet.

Händelsehubb: Skapa eller uppdatera Händelsehubb

Skapa eller uppdatera en händelsehubb i ett Azure Event Hubs-namnområde. Det här kommandot:

  • Skapar en ny händelsehubb om den inte finns
  • Uppdaterar en befintlig händelsehubbs konfiguration

Du kan konfigurera följande egenskaper:

  • Antal partitioner (antal partitioner för parallell bearbetning)
  • Kvarhållningstid för meddelanden (hur länge meddelanden behålls i timmar)

Vissa egenskaper som partitionsantal kan inte ändras när de har skapats. Det här är en potentiellt tidskrävande åtgärd som väntar på slutförande.

Exempel på frågor är:

  • Skapa ny händelsehubb: "Skapa en ny händelsehubb "orders-hub" i mitt namnområde "production-eventhubs" och resursgruppen 'prod-resources'"
  • Uppdatera befintlig händelsehubb: "Uppdatera min händelsehubb "telemetri-events" i mitt namnområde "monitoring-hubs" och resursgruppen "monitoring-resources"
  • Skapa med konfiguration: "Skapa händelsehubbens användaraktivitet i namnområdet "analytics-hubs" med 4 partitioner och 24 timmars kvarhållning av meddelanden"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet. Måste användas med resursgruppsparametern.
Händelsehubb Krävs Namnet på händelsehubben i namnområdet.
Antal partitioner Valfritt Antalet partitioner för händelsehubben. Måste vara mellan 1 och 32 (eller högre baserat på namnområdesnivå).
Kvarhållning av meddelanden i timmar Valfritt Kvarhållningstiden för meddelanden i timmar. Minimum är 1 timme, max beror på namnområdesnivå.
Status Valfritt Status för händelsehubben (till exempel Active, Disabled). Status kan vara skrivskyddad i vissa åtgärder.

Namnområde: Ta bort namnområde

Ta bort ett Event Hubs-namnområde. Den här åtgärden går inte att ångra och tar permanent bort alla händelsehubbar, konsumentgrupper och konfigurationer i namnområdet.

Exempel på frågor är:

  • Ta bort specifikt namnområde: "Ta bort händelsehubbens namnområde 'eventhub-prod' i resursgruppen 'production-resources'"
  • Ta bort namnområde: "Ta bort Event Hubs-namnområdet 'test-eventhubs'"
  • Rensa namnområdet: "Ta bort namnområdet 'dev-eventhubs' permanent"
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.

Namnområde: Hämta namnområde

Hämta Event Hubs-namnområden från Azure. Beteendet beror på vilka parametrar du anger. När du hämtar ett enda namnområde returnerar verktyget detaljerad information, inklusive SKU, inställningar och metadata. När du listar namnområden returnerar verktyget samma detaljerade information för alla namnområden i det angivna omfånget.

Exempel på frågor är:

  • Visa en lista över alla namnområden: "Visa en lista över alla event hub-namnområden i min prenumeration"
  • Hämta specifikt namnområde: "Hämta information om mitt namnområde 'eventhub-prod' i min resursgrupp 'production-resources'"
  • Visa namnområdesinformation: "Visa information om namnområdet "monitoring-hubs"
Parameter Obligatorisk eller valfri Description
resursgrupp Valfritt Namnet på Azure-resursgruppen. När det utelämnas listar systemet alla namnområden i prenumerationen. När det tillhandahålls utan namnområde listar systemet alla namnområden i resursgruppen. Krävs när du hämtar ett specifikt namnområde.
Namespace Valfritt Namnet på det Event Hubs-namnområde som ska hämtas. När den tillhandahålls returneras detaljerad information för det specifika namnområdet (kräver resursgrupp). När den utelämnas returneras en lista med namnområden.

Namnområde: Skapa eller uppdatera namnområde

Skapa eller uppdatera ett namnområde i den angivna resursgruppen. Det här verktyget skapar ett nytt namnområde eller uppdaterar ett befintligt. Verktyget kan ändra befintliga konfigurationer och anses vara destruktivt. Det här verktyget kan ta lång tid.

När du uppdaterar ett befintligt namnområde anger du bara de egenskaper som du vill ändra. Ospecificerade egenskaper behåller sina befintliga värden. Du måste ange minst en uppdateringsegenskap.

Vanliga uppdateringsscenarier är:

  • Skala upp eller ned genom att ändra SKU-nivån eller kapaciteten
  • Aktivera eller inaktivera autouppfyllnad och ange maximalt dataflödesenheter
  • Aktivera eller inaktivera Kafka-stöd
  • Ändra taggar för resurshantering
  • Aktivera eller inaktivera zonredundans (endast Premium SKU)

Exempel på frågor är:

  • Skapa nytt namnområde: "Skapa ett nytt Event Hubs-namnområde "production-events" i USA, östra"
  • Uppdatera namnområdeskapacitet: "Uppdatera mitt namnområde 'eventhub-prod' för att öka kapaciteten till 10 dataflödesenheter"
  • Aktivera Kafka-stöd: "Aktivera Kafka på mitt Event Hubs-namnområde "monitoring-hubs""
Parameter Obligatorisk eller valfri Description
Namespace Krävs Namnet på Event Hubs-namnområdet.
Läge Valfritt Den Azure-region där namnområdet finns (till exempel eastus, westus2).
SKU-namn Valfritt SKU-namnet för namnområdet. Giltiga värden: Basic, Standard, Premium.
SKU-nivå Valfritt SKU-nivån för namnområdet. Giltiga värden: Basic, Standard, Premium.
SKU-kapacitet Valfritt SKU-kapaciteten (dataflödesenheter) för namnområdet. Det giltiga intervallet beror på SKU:n.
Aktiveras automatiskt Valfritt Aktivera eller inaktivera automatisk inflate för namnområdet.
Maximalt dataflödesenheter Valfritt De maximala dataflödesenheterna när automatisk blåses in är aktiverat.
Kafka aktiverat Valfritt Aktivera eller inaktivera Kafka för namnområdet.
Zonredundant Valfritt Aktivera eller inaktivera zonredundans för namnområdet.
Tags Valfritt Taggar för namnområdet i JSON-format (till exempel {"key1":"value1","key2":"value2"}).

Relaterat innehåll