适用于 Azure MCP 服务器的 Azure 事件中心工具

使用 Azure MCP 服务器,可以使用自然语言提示管理 Azure 事件中心资源。 无需记住特定的命令语法。

Azure 事件中心 是云中的本机数据流式处理服务,每秒流式传输数百万个事件,延迟低,从任何源流式传输到任何目标。 事件中心与 Apache Kafka 兼容,可让你在不进行任何代码更改的情况下运行现有的 Kafka 工作负载。

注释

工具参数:Azure MCP 服务器工具为完成任务所需的数据定义参数。 其中一些参数特定于每个工具,如下所示。 其他参数是全局参数,由所有工具共享。 有关详细信息,请参阅 工具参数

事件中心:删除使用者组

从指定的事件中心删除使用者组。

示例提示包括:

  • 删除特定使用者组:“从资源组”my-resource-group“中的命名空间”eventhub-prod“中的事件中心”orders-hub“中删除使用者组”analytics-group”
  • 删除使用者组:“从资源组”my-resource-group“的命名空间”prod-eventhubs“中的事件中心”telemetry-events“中删除使用者组”monitoring-consumers”
  • 清理使用者组:“从资源组”my-resource-group“中的”development-eventhubs“命名空间中的事件中心”user-events“中删除使用者组”test-group”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
事件中心 必选 命名空间中事件中心的名称。
使用者组 必选 事件中心内的使用者组的名称。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌

事件中心:获取使用者组

从 Azure 事件中心获取使用者组。 此工具可以:

  • 列出事件中心中的所有使用者组
  • 按名称获取单个使用者组

获取和列出都需要事件中心和命名空间参数。 获取特定使用者组时,只需使用使用者组参数。

示例提示包括:

  • 列出所有使用者组:“列出资源组”my-resource-group“命名空间”eventhub-prod“中的事件中心”orders-hub“中的所有使用者组”
  • 获取特定使用者组:“从资源组”my-resource-group“中的命名空间”eventhub-prod“中的事件中心”orders-hub“获取使用者组”analytics-group“的详细信息
  • 显示使用者组信息:“在资源组”my-resource-group“的命名空间”prod-eventhubs“中,显示来自事件中心”telemetry-events“的使用者组”monitoring-consumers”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
事件中心 必选 命名空间中事件中心的名称。
使用者组 可选 事件中心内的使用者组的名称。

工具批注提示

破坏性: ❌ |幂等: ✅ |开放世界: ❌ |只读: ✅ |机密: ❌ |本地必需: ❌

事件中心:创建或更新使用者组

在指定的事件中心内创建或更新使用者组。 该工具将创建新的使用者组或更新现有使用者组。

示例提示包括:

  • 创建新的使用者组:“在资源组”my-resource-group“的命名空间”eventhub-prod“中,在事件中心”orders-hub“中创建新的使用者组”analytics-group”
  • 更新现有使用者组:“在资源组”my-resource-group“中命名空间”eventhub-prod“中的事件中心”orders-hub“中更新使用者组”analytics-group“,并使用用户元数据”已为 Q4 analytics 更新“”
  • 设置使用者组:“在资源组”my-resource-group“的命名空间”prod-eventhubs“中,在事件中心”telemetry-events“中设置使用者组”monitoring-consumers”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
事件中心 必选 命名空间中事件中心的名称。
使用者组 必选 事件中心内的使用者组的名称。
用户元数据 可选 使用者组的用户元数据。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌

事件中心:删除事件中心

从 Azure 事件中心命名空间中删除事件中心。 此作永久删除事件中心中的所有消息和使用者组。

示例提示包括:

  • 删除特定事件中心:“从资源组”my-resource-group“中的命名空间”eventhub-prod“中删除事件中心”orders-hub”
  • 删除事件中心:“从资源组”my-resource-group“中的”prod-eventhubs“命名空间中删除事件中心”telemetry-events”
  • 清理事件中心:“从资源组”my-resource-group“中的命名空间”dev-eventhubs“中删除事件中心”test-events”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
事件中心 必选 命名空间中事件中心的名称。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌

事件中心:获取事件中心

从 Azure 命名空间获取事件中心。 此工具:

  • 列出命名空间中的所有事件中心
  • 按名称获取单个事件中心

检索单个事件中心或列出多个事件中心时,该命令将返回所有事件中心的详细信息,包括分区计数、设置和元数据。

示例提示包括:

  • 列出所有事件中心:“列出资源组”my-resource-group“中”prod-eventhubs“命名空间中的所有事件中心”
  • 获取特定的事件中心:“获取资源组”my-resource-group“命名空间”eventhub-prod“中事件中心”orders-hub“的详细信息”
  • 显示事件中心信息:“显示资源组”my-resource-group“中命名空间”monitoring-hubs“中的事件中心”telemetry-events”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
事件中心 可选 命名空间中事件中心的名称。

工具批注提示

破坏性: ❌ |幂等: ✅ |开放世界: ❌ |只读: ✅ |机密: ❌ |本地必需: ❌

事件中心:创建或更新事件中心

在 Azure 事件中心命名空间中创建或更新事件中心。 此命令:

  • 创建新的事件中心(如果不存在)
  • 更新现有事件中心配置

可以配置以下属性:

  • 分区计数(用于并行处理的分区数)
  • 消息保留时间(保留消息的时长(以小时为单位)

创建后,某些属性(如分区计数)无法更改。 这是一个可能长时间运行的作,等待完成。

示例提示包括:

  • 创建新的事件中心:“在资源组”my-resource-group“的命名空间”production-eventhubs“中创建新的事件中心”orders-hub”
  • 更新现有事件中心:“更新资源组”my-resource-group“中命名空间”monitoring-hubs“中的事件中心”telemetry-events”
  • 使用配置创建:“使用 4 个分区和 24 小时消息保留在资源组”my-resource-group“的命名空间”analytics-hubs“中创建事件中心”user-activity”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。 必须与资源组参数一起使用。
事件中心 必选 命名空间中事件中心的名称。
分区计数 可选 事件中心的分区数。 必须介于 132 (或基于命名空间层)之间。
消息保留(以小时为单位) 可选 消息保留时间(以小时为单位)。 最小值为 1 小时,最大值取决于命名空间层。
地位 可选 事件中心的状态(例如 ActiveDisabled)。 某些作中状态可能为只读。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌

命名空间:删除命名空间

删除事件中心命名空间。 此作不可逆,并永久删除命名空间中的所有事件中心、使用者组和配置。

示例提示包括:

  • 删除特定命名空间:“删除资源组”my-resource-group“中的事件中心命名空间”eventhub-prod”
  • 删除命名空间:“删除资源组”my-resource-group“中的事件中心命名空间”test-eventhubs”
  • 清理命名空间:“永久删除资源组”my-resource-group“中的命名空间”dev-eventhubs”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌

命名空间:获取命名空间

从 Azure 获取事件中心命名空间。 行为取决于你提供的参数。 检索单个命名空间时,该工具将返回详细信息,包括 SKU、设置和元数据。 列出命名空间时,该工具返回指定范围中所有命名空间的相同详细信息。

示例提示包括:

  • 列出所有命名空间:“列出订阅中的所有事件中心命名空间”
  • 获取特定命名空间:“获取资源组”my-resource-group“中命名空间'eventhub-prod'的详细信息”
  • 显示命名空间信息:“在资源组”my-resource-group“详细信息中显示命名空间”monitoring-hubs”
参数 必需还是可选 Description
资源组 可选 Azure 资源组的名称。 省略时,系统会列出订阅中的所有命名空间。 如果未提供命名空间,系统会列出资源组中的所有命名空间。 获取特定命名空间时是必需的。
命名空间 可选 要检索的事件中心命名空间的名称。 提供后,返回特定命名空间的详细信息(需要资源组)。 省略时,返回命名空间列表。

工具批注提示

破坏性: ❌ |幂等: ✅ |开放世界: ❌ |只读: ✅ |机密: ❌ |本地必需: ❌

命名空间:创建或更新命名空间

在指定的资源组中创建或更新命名空间。 此工具创建新的命名空间或更新现有命名空间。 该工具可能会修改现有配置,并被视为破坏性配置。 此工具可能需要很长时间。

更新现有命名空间时,仅提供要更改的属性。 未指定的属性保留其现有值。 必须至少提供一个更新属性。

常见更新方案包括:

  • 通过更改 SKU 层或容量来纵向扩展或缩减
  • 启用或禁用自动膨胀并设置最大吞吐量单位
  • 启用或禁用 Kafka 支持
  • 修改资源管理的标记
  • 启用或禁用区域冗余(仅限高级 SKU)

示例提示包括:

  • 创建新命名空间:“在美国东部的资源组”my-resource-group“中创建新的事件中心命名空间”production-events”
  • 更新命名空间容量:“更新资源组”my-resource-group“中的命名空间”eventhub-prod“,以将容量增加到 10 个吞吐量单位”
  • 启用 Kafka 支持:“在资源组”my-resource-group“中对事件中心命名空间”monitoring-hubs“启用 Kafka”
参数 必需还是可选 Description
资源组 必选 Azure 资源组的名称。 这是 Azure 资源的逻辑容器。
命名空间 必选 事件中心命名空间的名称。
位置 可选 命名空间所在的 Azure 区域(例如 eastuswestus2)。
SKU 名称 可选 命名空间的 SKU 名称。 有效值:Basic、、StandardPremium.
SKU 层 可选 命名空间的 SKU 层。 有效值:Basic、、StandardPremium.
SKU 容量 可选 命名空间的 SKU 容量(吞吐量单位)。 有效范围取决于 SKU。
是否已启用自动膨胀 可选 启用或禁用命名空间的自动膨胀。
最大吞吐量单位 可选 启用自动膨胀时的最大吞吐量单位。
已启用 Kafka 可选 启用或禁用命名空间的 Kafka。
区域冗余 可选 启用或禁用命名空间的区域冗余。
标签 可选 JSON 格式命名空间的标记(例如 {"key1":"value1","key2":"value2"})。

工具批注提示

破坏性: ✅ |幂等: ✅ |开放世界: ❌ |只读: ❌ |机密: ❌ |本地必需: ❌