適用於 Azure MCP 伺服器的 Azure Event Hubs 工具概述

Azure MCP 伺服器可讓您使用自然語言提示來管理 Azure 事件中樞資源。 您不需要記住特定的命令語法。

Azure 事件中樞是 雲端中的原生資料串流服務，每秒以低延遲從任何來源串流數百萬個事件至任何目的地。 事件中樞與 Apache Kafka 相容，可讓您執行現有的 Kafka 工作負載，而不需要任何程式碼變更。

事件中樞：刪除取用者群組

從指定的事件中樞刪除取用者群組。

範例提示包括：

• 刪除特定消費者群組：「從 Event Hub 的命名空間 'orders-hub' 中刪除 'analytics-group'，該命名空間為 'eventhub-prod'，資源群組 'my-resource-group'」
• 移除消費者群組：「將我的事件中心中的消費者群組 'monitoring-consumers' 移除，名稱空間中的 'telemetry-events' 在資源群組 'my-resource-group' 中移除 'prod-eventhubs'」
• 清理消費者群組：「在資源群組 'my-resource-group' 的 development-eventhubs 命名空間中，從事件中心的 'user-events' 中刪除消費者群組 'test-group'」。」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

事件中樞：取得取用者群組

從 Azure 事件中樞取得取用者群組。 此工具可以：

• 列出事件中樞中的所有取用者群組
• 依名稱取得單一取用者群組

事件中樞和命名空間參數都是 get 和 list 的必要條件。 只有在取得特定消費者群組時，才需要消費者群組參數。

範例提示包括：

• 列出所有消費者群組：「在 Event Hub 中列出所有消費者群組，名稱空間為 'eventhub-prod'，資源群組為 'my-resource-group'」。」
• 取得特定消費者群組：「從 Event Hub 的命名空間 'orders-hub' 取得消費者群組 'analytics-group' 的詳細資料，資源群組 'my-resource-group' 的命名空間 'eventhub-prod'」
• 顯示消費者群組資訊：「請顯示 Event Hub 的消費者群組 'monitoring-consumers' 名稱空間 'telemetry-events' 在資源群組 'my-resource-group' 中 'prod-eventhubs'」

工具註解提示：

破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌

事件中樞：建立或更新取用者群組

在指定的事件中樞內建立或更新取用者群組。 該工具會建立新的取用者群組或更新現有的取用者群組。

範例提示包括：

• 建立新的消費者群組：「在 Event Hub 建立一個新的消費者群組 'analytics-group'，在命名空間建立 'orders-hub'，在資源群組 'my-resource-group' 中建立 'eventhub-prod'」。」
• 更新現有的消費者群組：「在 Event Hub 更新消費者群組 'analytics-group'，在命名空間的 'orders-hub'，在資源群組 'my-resource-group' 中更新使用者元資料，並以「為第四季分析更新」。」
• 建立消費者群組：「在事件中心建立消費者群組 'monitoring-consumers'，命名空間中建立 'telemetry-events'，資源群組 'my-resource-group' 中建立 'prod-eventhubs'」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

事件中樞：刪除事件中樞

從 Azure 事件中樞命名空間刪除事件中樞。 此動作會永久刪除事件中樞中的所有訊息和取用者群組。

範例提示包括：

• 刪除特定事件中心：「從資源群組 'my-resource-group' 的命名空間 'eventhub-prod' 刪除事件中心 'orders-hub'」」
• 移除事件中心：「從資源群組 'my-resource-group' 中移除 'prod-eventhubs' 命名空間中的事件中心 'telemetry-events'」
• 清理事件中心：「從資源群組 'my-resource-group' 的命名空間 'dev-eventhubs' 中刪除事件中心 'test-events'」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

事件中樞：取得事件中樞

從 Azure 命名空間取得事件中樞。 這個工具：

• 列出命名空間中的所有事件中樞
• 依名稱取得單一事件中樞

當您擷取單一事件中樞或列出多個事件中樞時，命令會傳回所有事件中樞的詳細資訊，包括分割區計數、設定和中繼資料。

範例提示包括：

• 列出所有事件中心：「在資源群組 'my-resource-group' 中，列出我在 'prod-eventhubs' 命名空間中的所有事件中心。」
• 取得特定事件中心：「在資源群組 'my-resource-group' 的命名空間 'eventhub-prod' 中取得我的事件中心 'orders-hub' 的詳細資料。」
• 顯示事件中心資訊：「在資源群組 'my-resource-group' 中，從命名空間的 'monitoring-hubs' 顯示事件中心的 'telemetry-events'」」

工具註解提示：

破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌

事件中樞：建立或更新事件中樞

在 Azure 事件中樞命名空間內建立或更新事件中樞。 此命令：

• 建立新的事件中樞 （如果不存在）
• 更新現有事件中樞的設定

您可以設定下列內容：

• 分割區計數 （平行處理的分割區數目）
• 訊息保留時間 （訊息保留的時間長度，以小時為單位）

某些屬性 （例如分割區計數） 無法在建立之後變更。 這是等待完成的可能長時間執行作業。

範例提示包括：

• 建立新的事件中心：「在我的命名空間 'production-eventhubs' 中，資源群組 'my-resource-group' 建立一個新的事件中心 'orders-hub'」。」
• 更新現有事件中心：「在資源群組 'my-resource-group' 中，將我的事件中心 'telemetry-events' 更新到我的命名空間 'monitoring-hubs'」
• 透過設定建立：「在命名空間建立事件集線器 'user-activity'，在資源群組 'my-resource-group' 中建立事件集線器 'user-activity'，並有 4 個分割區，並具備 24 小時訊息保留功能」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

命名空間：刪除命名空間

刪除事件中樞命名空間。 此作業是不可逆的，並會永久刪除命名空間內的所有事件中樞、取用者群組和設定。

範例提示包括：

• 刪除特定命名空間：「刪除資源群組 'my-resource-group' 中的事件集線中心命名空間 'eventhub-prod'」
• 移除命名空間：「移除資源群組 'my-resource-group' 中的事件中心命名空間 'test-eventhubs'」」
• 清理命名空間：「永久刪除資源群組 'my-resource-group' 中的命名空間 'dev-eventhubs'」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

命名空間：取得命名空間

從 Azure 取得事件中樞命名空間。 行為取決於您提供的參數。 當您擷取單一命名空間時，工具會傳回詳細資訊，包括SKU、設定和中繼資料。 當您列出命名空間時，工具會針對指定範圍中的所有命名空間傳回相同的詳細資訊。

範例提示包括：

• 列出所有命名空間：「列出我的訂用帳戶中的所有事件中樞命名空間」
• 取得特定命名空間：「在我的資源群組 'my-resource-group' 中取得我的命名空間 'eventhub-prod' 的詳細資料」
• 顯示命名空間資訊：「請在資源群組 'my-resource-group' 詳細資料中顯示命名空間 'monitoring-hubs'」」

工具註解提示：

破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌

命名空間：建立或更新命名空間

在指定的資源群組內建立或更新命名空間。 此工具會建立新的命名空間或更新現有的命名空間。 該工具可能會修改現有的配置，並被視為破壞性。 此工具可能需要很長時間。

更新現有命名空間時，請僅提供您要變更的屬性。 未指定的屬性會保留其現有值。 您必須提供至少一個更新屬性。

常見的更新案例包括：

• 藉由變更 SKU 層或容量來相應增加或縮小
• 啟用或停用自動膨脹並設定最大輸送量單位
• 啟用或停用 Kafka 支援
• 修改資源管理的標籤
• 啟用或停用區域備援 （僅限進階 SKU）

範例提示包括：

• 建立新命名空間：「在美國東部資源群組 'my-resource-group' 中建立新的事件中心命名空間 'production-events'」」
• 更新命名空間容量：「在資源群組 'my-resource-group' 中更新我的命名空間 'eventhub-prod'，以將容量提升到 10 個吞吐量單元」
• 啟用 Kafka 支援：「在我的事件中心命名空間 'monitoring-hubs' 上啟用 Kafka，資源群組 'my-resource-group'」

工具註解提示：

破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌

相關內容

• 什麼是 Azure MCP 伺服器工具？
• 開始使用 Azure MCP 伺服器
• Azure 事件中樞工具