SuperAPI AI 工具集

azure-eventgrid-py

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:Azure Event Grid 是事件路由服务,采用发布/订阅语义,用于构建事件驱动应用。本技能为 Python SDK,用于向 Event Grid 发布事件、处理 CloudEvents。

安装:pip install azure-eventgrid azure-identity

环境变量:EVENTGRID_TOPIC_ENDPOINT 与 EVENTGRID_NAMESPACE_ENDPOINT 分别指向自定义主题与命名空间端点。

认证:使用 azure.identity 的 DefaultAzureCredential,配合 EventGridPublisherClient(endpoint, credential) 创建客户端。

事件格式:CloudEvent(CloudEvents 1.0,标准且可互操作,推荐)与 EventGridEvent(Azure 原生格式)。CloudEvent 必填 type、source,可选 subject、datacontenttype、dataschema、time、extensions;EventGridEvent 必填 subject、event_type、data、data_version,topic 与 event_time 可选。

发布:client.send(event) 发送单个事件,client.send(events) 批量发送。异步客户端位于 azure.eventgrid.aio,配合 azure.identity.aio 使用 async with 与 await client.send(event)。

命名空间主题:Event Grid Namespaces 采用拉取投递,使用命名空间端点并传入 namespace_topic 参数发送。

最佳实践:新应用优先用 CloudEvents;批量发布;设置有意义 subject 便于过滤;高吞吐用异步客户端;利用内置重试;合理设置事件类型用于路由与过滤。

限制:资料未提供定价、配额、区域可用性及具体错误处理细节。