SuperAPI AI 工具集

azure-eventgrid-dotnet

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:Azure.Messaging.EventGrid 是 Azure Event Grid 的 .NET 客户端库,用于向 Azure Event Grid 的主题、域和命名空间发布事件,并支持消费事件,适合事件驱动架构与发布/订阅消息场景。

主要能力:推送投递(主题/域)通过 EventGridPublisherClient 发送 EventGridEvent 或 CloudEvent,支持单条与批量;拉取投递(命名空间)通过 EventGridSenderClient 发送、EventGridReceiverClient 接收,并提供 AcknowledgeAsync、ReleaseAsync、RejectAsync 处理确认、重试与死信。支持 API Key、Microsoft Entra ID(推荐)和 SAS Token 认证,支持自定义序列化、解析事件、系统事件类型,以及 Azure Functions 的 EventGridTrigger。

安装:dotnet add package Azure.Messaging.EventGrid;命名空间拉取投递用 dotnet add package Azure.Messaging.EventGrid.Namespaces;CloudNative CloudEvents 互操作用 dotnet add package Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents。当前稳定版本 4.28.0。

使用方式:配置端点与密钥环境变量(如 EVENT_GRID_TOPIC_ENDPOINT、EVENT_GRID_TOPIC_KEY),创建客户端后调用 SendEventAsync/SendEventsAsync 发布;命名空间场景使用发送与接收客户端,按 lock token 确认或释放事件。

限制:事件负载单条与批量上限均为 1MB;事件可能重复投递,处理需幂等;建议使用 Entra ID 而非访问密钥;输出不能替代环境相关的验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。