教程：使用 IoT 中心消息路由将设备数据发送到Azure 存储

Azure 门户没有其他先决条件。

可以使用本地 Azure CLI。

• 如果需要，请安装 Azure CLI 来运行 CLI 参考命令。

• 本地 Azure CLI，请了解如何安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

  • 通过使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。

  • 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。

  • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

1. 登录 Azure 门户，导航到 IoT 中心。

2. 从菜单的“设备管理”部分选择“设备”。

3. 选择“添加设备”。

   

4. 提供设备 ID，然后选择“保存”。

5. 新设备现在应处于设备列表中。 如果不在该列表中，请刷新页面。 选择设备 ID 以打开设备详细信息页面。

6. 复制其中一个设备密钥并保存。 你将使用此值配置生成模拟设备遥测消息的示例代码。

   

1. 为 IoT 中心和设备定义变量。

   IOTHUB_NAME：将此占位符替换为 IoT 中心的名称。

   DEVICE_NAME：将此占位符替换为本教程中要用于设备的任何名称。

   hubName=IOTHUB_NAME
   deviceName=DEVICE_NAME
   

2. 在 CLI shell 中运行 az iot hub device-identity create 命令。 此命令创建设备标识。

   az iot hub device-identity create --device-id $deviceName --hub-name $hubName
   

3. 在设备标识输出中，复制不带两旁引号的 primaryKey 值并保存。 你将使用此值配置生成模拟设备遥测消息的示例代码。

1. 在 Azure 门户中导航到 IoT 中心。

2. 从菜单的“安全设置”部分选择“共享访问策略”。

3. 选择“iothubowner”策略。

   

4. 复制“主连接字符串”。

   

1. 运行 az iot hub connection-string show 命令：

   az iot hub connection-string show --hub-name $hubName
   

2. 复制不带两旁引号的连接字符串。

1. 在 Azure 门户中，搜索“存储帐户”。

2. 选择“创建”。

3. 为存储帐户提供以下值：

   展开表

   参数	值
   订阅	选择包含 IoT 中心的相同订阅。
   资源组	选择包含 IoT 中心的相同资源组。
   存储帐户名称	为存储帐户提供全局唯一的名称。
   性能	接受默认“标准”值。

   

4. 可以通过选择“查看 + 创建”来接受所有其他默认值。

5. 验证完成后，选择“创建”。

6. 部署完成后，选择“转到资源”。

7. 在存储帐户菜单中，从“数据存储”部分选择“容器”。

8. 选择“+ 容器”来新建容器。

   

9. 为容器提供名称，然后选择“创建”。

1. 为存储帐户和容器定义变量。

   GROUP_NAME：将此占位符替换为包含 IoT 中心的资源组的名称。

   STORAGE_NAME：将此占位符替换为存储帐户的名称。 存储帐户名称必须为小写，且全局唯一。

   CONTAINER_NAME：将此占位符替换为容器的名称。

   resourceGroup=GROUP_NAME
   storageName=STORAGE_NAME
   containerName=CONTAINER_NAME
   

2. 使用 az storage account create 命令创建标准通用 v2 存储帐户。

   az storage account create --name $storageName --resource-group $resourceGroup
   

3. 使用 az storage container create 将容器添加到存储帐户。

   az storage container create --auth-mode login --account-name $storageName --name $containerName
   

1. 在 Azure 门户中，转到 IoT 中心。

2. 在资源菜单中的“中心设置”下，选择“消息路由”，然后选择“添加”。

   

3. 在“终结点”选项卡上，通过提供以下信息创建存储终结点：

   展开表

   参数	值
   终结点类型	选择“存储”。
   端点名称	提供此终结点的独一无二的名称。
   Azure 存储容器	选择“选取容器”。 按照提示选择在上一部分创建的存储帐户和容器。
   编码	选择“JSON”。 如果此字段灰显，则存储帐户区域不支持 JSON。 在这种情况下，继续使用默认“AVRO”。

   

4. 接受其余参数的默认值，然后选择“创建 + 下一步”。

5. 在“路由”选项卡上，提供以下信息以创建指向所创建的存储终结点的路由：

   展开表

   参数	值
   名称	为路由创建名称。
   数据源	验证是否从下拉列表中选择了“设备遥测消息”。
   启用路由	验证此字段是否已选中。
   路由查询	输入 level="storage" 作为查询字符串。

   

6. 选择“创建 + 跳过扩充”。

1. 配置终结点和路由命令所需的变量。

   ENDPOINT_NAME：提供表示存储容器的终结点的名称。

   ROUTE_NAME：提供为存储终结点筛选消息的路由的名称

   endpointName=ENDPOINT_NAME
   routeName=ROUTE_NAME
   

2. 使用 az iot hub message-endpoint create 命令创建一个指向上一部分中创建的存储容器的自定义终结点。

   az iot hub message-endpoint create storage-container \
     --connection-string $(az storage account show-connection-string --name $storageName --query connectionString -o tsv) \
     --endpoint-name $endpointName \
     --hub-name $hubName \
     --container $containerName \
     --resource-group $resourceGroup \
     --encoding json
   

3. 使用 az iot hub message-route create 命令创建一个路由，用于将满足 level=storage 条件的任何消息传递到存储容器终结点。

   az iot hub message-route create \
     --route-name $routeName \
     --hub-name $hubName \
     --resource-group $resourceGroup \
     --source-type devicemessages \
     --endpoint-name $endpointName \
     --enabled true \
     --condition 'level="storage"'
   

1. 在 Azure 门户中，导航到包含本教程的 IoT 中心和存储帐户的资源组。
2. 查看资源组中的所有资源，以确定要清理的资源。
   • 如果要删除所有资源，请选择“删除资源组”。
   • 如果只想删除某些资源，请使用每个资源名称旁的复选框选择要删除的资源。 然后选择“删除”。

1. 使用 az resource list 命令查看资源组中的所有资源。

   az resource list --resource-group $resourceGroup --output table
   

2. 查看资源组中的所有资源，以确定要清理的资源。

   • 如果要删除所有资源，请使用 az group delete 命令。

     az group delete --name $resourceGroup
     

   • 如果要删除某些资源，请使用 az resource delete 命令。 例如：

     az resource delete --resource-group $resourceGroup --name $storageName