你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Bicep 部署 Azure IoT 中心和存储帐户

项目
01/05/2024

在本快速入门中，你将使用 Bicep 创建 IoT 中心、Azure 存储帐户，以及将消息从 IoT 中心发送到存储的路由。中心已配置，以便发送到中心的消息在满足路由条件时自动路由到存储帐户。在本快速入门教程时，你可以打开该存储帐户并查看发送的消息。

Bicep 是一种特定于域的语言 (DSL)，使用声明性语法来部署 Azure 资源。它提供简明的语法、可靠的类型安全性以及对代码重用的支持。 Bicep 会针对你的 Azure 基础结构即代码解决方案提供最佳创作体验。

先决条件

如果还没有 Azure 订阅，可以在开始前创建一个免费 Azure 帐户。
安装 Azure CLI

查阅 Bicep 文件

本快速入门中使用的 Bicep 文件称为 101-iothub-auto-route-messages，来自 Azure 快速入门模板。

该 Bicep 文件中定义了两个 Azure 资源：

微软。存储/storageAccounts：包含容器的存储帐户。
Microsoft.Devices/IotHubs：一个 IoT 中心，其中包含指向存储容器的终结点，以及将筛选的消息发送到该终结点的路由。

@description('Define the project name or prefix for all objects.')
@minLength(1)
@maxLength(11)
param projectName string = 'contoso'

@description('The datacenter to use for the deployment.')
param location string = resourceGroup().location

@description('The SKU to use for the IoT Hub.')
param skuName string = 'S1'

@description('The number of IoT Hub units.')
param skuUnits int = 1

@description('Partitions used for the event stream.')
param d2cPartitions int = 4

var iotHubName = '${projectName}Hub${uniqueString(resourceGroup().id)}'
var storageAccountName = '${toLower(projectName)}${uniqueString(resourceGroup().id)}'
var storageEndpoint = '${projectName}StorageEndpont'
var storageContainerName = '${toLower(projectName)}results'

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-01-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  properties: {
    allowBlobPublicAccess: false
    minimumTlsVersion: 'TLS1_2'
    supportsHttpsTrafficOnly: true
  }
}

resource container 'Microsoft.Storage/storageAccounts/blobServices/containers@2023-01-01' = {
  name: '${storageAccountName}/default/${storageContainerName}'
  properties: {
    publicAccess: 'None'
  }
  dependsOn: [
    storageAccount
  ]
}

resource IoTHub 'Microsoft.Devices/IotHubs@2023-06-30' = {
  name: iotHubName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {
    eventHubEndpoints: {
      events: {
        retentionTimeInDays: 1
        partitionCount: d2cPartitions
      }
    }
    routing: {
      endpoints: {
        storageContainers: [
          {
            connectionString: 'DefaultEndpointsProtocol=https;AccountName=${storageAccountName};EndpointSuffix=${environment().suffixes.storage};AccountKey=${storageAccount.listKeys().keys[0].value}'
            containerName: storageContainerName
            fileNameFormat: '{iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}'
            batchFrequencyInSeconds: 100
            maxChunkSizeInBytes: 104857600
            encoding: 'JSON'
            name: storageEndpoint
          }
        ]
      }
      routes: [
        {
          name: 'ContosoStorageRoute'
          source: 'DeviceMessages'
          condition: 'level="storage"'
          endpointNames: [
            storageEndpoint
          ]
          isEnabled: true
        }
      ]
      fallbackRoute: {
        name: '$fallback'
        source: 'DeviceMessages'
        condition: 'true'
        endpointNames: [
          'events'
        ]
        isEnabled: true
      }
    }
    messagingEndpoints: {
      fileNotifications: {
        lockDurationAsIso8601: 'PT1M'
        ttlAsIso8601: 'PT1H'
        maxDeliveryCount: 10
      }
    }
    enableFileUploadNotifications: false
    cloudToDevice: {
      maxDeliveryCount: 10
      defaultTtlAsIso8601: 'PT1H'
      feedback: {
        lockDurationAsIso8601: 'PT1M'
        ttlAsIso8601: 'PT1H'
        maxDeliveryCount: 10
      }
    }
  }
}

output name string = IoTHub.name
output resourceId string = IoTHub.id
output resourceGroupName string = resourceGroup().name
output location string = location

部署 Bicep 文件

本部分提供部署 Bicep 文件的步骤。

从 Azure 快速入门模板存储库下载 main.bicep 文件。
使用 Azure CLI 部署 Bicep 文件来创建资源。
```
az group create --name ContosoResourceGrp --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep
```
部署需要数分钟才能完成。部署完成后，应会看到详细描述已部署资源的输出。

发送设备到云的消息

在本部分中，将在新的 IoT 中心注册设备，然后将消息从该设备发送到IoT 中心。 IoT 中心中配置的 Bicep 文件仅当消息包含消息属性 level=storage时才会将消息发送到存储。为了测试此路由条件按预期工作，我们将发送一些包含该属性的消息，有些消息没有。

提示

本快速入门使用 Azure CLI 模拟设备来方便起见。有关使用消息属性发送设备到云消息的代码示例，请参阅适用于 .NET 的 Azure IoT SDK 中的 HubRoutingSample 。

检索为你创建的模板的 IoT 中心的名称。

如果使用了上一部分中的默认命令，则已在 ContosoResourceGrp 资源组中创建资源。如果使用了其他资源组，请更新以下命令以匹配。
```
az iot hub list --resource-group ContosoResourceGrp --output table
```
从输出中复制 IoT 中心的名称。它的格式应类似于 contosoHub{randomidentifier}

将设备添加到中心。

az iot hub device-identity create --device-id contosoDevice --hub-name {YourIoTHubName}

模拟设备并发送设备到云的消息。

该 --data 参数允许我们设置消息正文。
```
az iot device simulate \
  --device-id contosoDevice \
  --hub-name {YourIoTHubName} \
  --data "This message won't be routed."
```
模拟器发送 100 条消息，然后断开连接。对于本快速入门，无需等待所有 100 个。

提示

Azure CLI 不会在发送消息时打印消息。如果要在到达中心时监视消息，可以安装适用于 Visual Studio Code 的 Azure IoT 中心扩展，并使用它监视内置终结点。
发送要路由到存储的设备到云的消息。

该 --properties 参数允许我们向默认消息添加消息、应用程序或系统属性。对于本快速入门，IoT 中心的路由查找包含消息属性 level=storage的消息。
```
az iot device simulate \
  --device-id contosoDevice \
  --hub-name {YourIoTHubName} \
  --properties level=storage \
  --data "This message will be routed to storage."
```

查看路由的消息

登录到Azure 门户并选择资源组，然后选择存储帐户。
向下钻取到存储帐户，直到找到文件。
选择其中一个文件并选择“下载”，将文件下载到你稍后可以找到的位置。它具有数字名称，如 47。在末尾添加“.txt”，然后双击文件打开它。
打开文件时，每一行对应一条不同的消息。每条消息的正文都进行了加密。必须这样才能对消息正文执行查询。

注意

这些消息在 UTF-8 和 base64 中编码。如果读回消息，则必须从 base64 和 utf-8 解码消息，才能将其读取为 ASCII。如果你感兴趣，可以使用路由教程中的 ReadOneRowFromFile 方法从其中某个消息文件对其进行读取，并将其解码为 ASCII。 ReadOneRowFromFile 位于你为此快速入门解压缩的 IoT C# SDK 存储库中。下面是该文件夹顶部的路径： ./iothub/device/samples/how to guides/HubRoutingSample/Program.cs 将布尔 readTheFile 值设置为 true，并将路径硬编码到磁盘上的文件，它将打开并转换文件中的第一行。

在本快速入门中，你部署了一个 Bicep 文件来创建 IoT 中心和存储帐户，然后运行一个程序将消息发送到中心。这些消息根据其消息属性进行路由，并存储在可以查看它们的存储帐户中。

清理资源

当你不再需要所创建的资源时，请删除资源组。

az group delete --name exampleRG

后续步骤

快速入门：使用 Visual Studio Code 创建 Bicep 文件

Share via