你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在 Azure IoT 操作中，服务器发送事件的连接器（SSE）（预览版）允许访问 HTTP 服务公开的 SSE 端点中的数据。
Azure IoT 操作中的资产是用于表示物理资产或设备的逻辑实体。 Azure IoT 操作资产可以具有描述其行为和特征的自定义属性、数据点、流和事件。 资产与一个或多个设备相关联。 Azure IoT 操作将资产定义存储在 Azure 设备注册表中。
Azure IoT 操作中的设备是一个逻辑实体，用于定义与物理资产或设备的连接。 如果没有设备，数据无法从物理设备或资产流向 MQTT 代理。 配置设备和资产时，将建立与物理资产或设备的连接，而数据点值、事件和流将到达 Azure IoT 操作实例。 设备具有一个或多个入站终结点。 Azure IoT 操作将设备定义存储在 Azure 设备注册表中。
SSE 的连接器支持以下功能：
- 发生采样失败时自动重试。 报告无法重试的错误的失败状态。
- 与 OpenTelemetry 集成。
- 使用 设备端点 和 命名空间资源。
- 从 JSON 数据载荷推断架构。
- 多种身份验证方法：
- 用户名/密码基本 HTTP 身份验证
- x509 客户端证书
- 证书信任列表
- 用于测试目的的匿名访问
- 用于指定额外的证书颁发机构的证书信任包
对于每个配置的数据集，SSE 的连接器：
- 从指定的 SSE 终结点采样 SSE 事件。
- 根据接收的数据为每个数据集生成消息架构，并将其注册到架构注册表和 Azure 设备注册表。
- 将事件数据转发到指定的目标。
本文介绍如何使用 SSE 的连接器执行如下任务：
- 定义将 SSE 源连接到 Azure IoT 操作实例的设备。
- 添加资产，并定义事件以启用从 SSE 源到 MQTT 中转站或 中转站状态存储的数据流。
先决条件
要配置设备和资产，需要运行 Azure IoT 操作的预览实例。
要登录到操作体验 Web UI，则需要至少具有包含 Kubernetes - Azure Arc 实例的资源组参与者权限的 Microsoft Entra ID 帐户。 无法使用 Microsoft 帐户 (MSA) 登录。 在 Azure 租户中创建合适的 Microsoft Entra ID 帐户：
- 使用用于部署 Azure IoT 操作的同一租户和用户名登录到 Azure 门户。
- 在 Azure 门户中，前往“Microsoft Entra ID”部分，选择“用户”“+ 新用户”>“新建用户”>。 新建用户并记下密码，稍后登录时需要此密码。
- 在 Azure 门户中，前往包含 Kubernetes - Azure Arc 实例的资源组。 在“访问控制 (IAM)”页上，选择“+ 添加”“添加角色分配”>。
- 在“添加角色分配”页上，选择“特权管理员角色”。 选择“参与者”，然后选择“下一步”。
- 在“成员”页上，将新用户添加到角色。
- 选择“查看并分配”以完成新用户的设置。
现在可以使用新的用户帐户登录到 操作体验 Web 界面。
IT 管理员必须在 Azure 门户中为你的 Azure IoT 操作实例配置 SSE 模板的连接器。
需要任何凭据才能访问 SSE 源。 如果 SSE 源需要身份验证，则需要创建包含 SSE 源用户名和密码的 Kubernetes 机密。
为 SSE 部署连接器
部署 Azure IoT 操作的预览版时，部署包括三个预览连接器。 可以通过在 Azure 门户中检查是否为实例启用了预览功能来验证是否具有 Azure IoT 操作的预览实例：
在操作体验 Web UI 中使用预览连接器（ONVIF、媒体和 HTTP/REST）之前，管理员必须将连接器模板实例添加到 Azure IoT 操作实例。
所有三个预览连接器都可以将捕获的数据发布到 MQTT 代理。
若要将连接器模板实例添加到 Azure IoT 操作实例，请执行以下操作：
在 Azure 门户中，转到 Azure IoT 操作实例，选择“连接器模板”，然后选择“添加连接器模板实例”：
在“添加 Akri 连接器模板”向导的第一页上，选择要添加的连接器模板的类型，例如“ONVIF”、“媒体”或“HTTP REST”。 然后选择“元数据”。
在“元数据”页上，接受默认值，然后选择“设备入站终结点类型”。
在“设备入站终结点类型”页上，接受默认值，然后选择“诊断配置”。
在“诊断配置”页上，接受默认值，然后选择“运行时配置”。
在 “运行时配置 ”页上，接受默认值，然后选择“ 查看：
在“审阅”页上，查看连接器模板实例的详细信息，然后选择“创建”以创建连接器模板实例。
OT 用户现在可以使用操作体验 Web UI 来创建具有预览连接器终结点的设备。
创建设备
若要配置 SSE 的连接器，请先创建一个定义与 SSE 源的连接的设备。 设备包括 SSE 源的 URL 以及访问 SSE 源所需的任何凭据：
在操作体验 Web UI 中，选择左侧导航窗格中的“设备”。 然后选择“新建”。
输入设备的名称，例如
sse-connector。 若要为 SSE 的连接器添加终结点，请在 Microsoft.SSEHttp 磁贴上选择“新建”。添加 SSE 连接器终结点的详细信息，包括任何身份验证凭据：
选择“应用”以保存终结点。
在“设备详细信息”页上，选择“下一步”以继续。
在“添加自定义属性”页上，可以添加要与设备关联的任何其他属性。 例如，可以添加一个属性来指示相机制造商。 然后选择“下一步”继续
在“摘要”页上，查看设备的详细信息，然后选择“创建”以创建资产。
创建设备后，可以在“设备”列表中查看它：
创建命名空间资产
若要定义从 SSE 终结点发布事件的命名空间资产，请执行以下步骤：
在操作体验 Web UI 中，选择左侧导航窗格中的“资产”。 然后选择“创建命名空间资产”。
选择上个部分创建的 SSE 的连接器的入站终结点。
输入资产的名称，例如
my-sse-source。添加要与资产关联的任何自定义属性。 例如，可以添加一个属性来指示相机制造商。 选择“下一步”继续操作。
在“ 事件 ”页上，选择“ 添加事件 ”以添加资产的事件。 例如：
添加要发布到 MQTT 代理的每个事件的详细信息。
若要配置数据的目标，请选择“ 管理事件组 ”，然后选择事件组。 配置 MQTT 目标：
选择“下一步”继续操作。
在“审阅”页上，查看资产的详细信息，然后选择“创建”以创建资产。 几分钟后，资产将列在 “资产 ”页上：
