快速入門：使用ARM範本部署 Azure IoT 中樞和記憶體帳戶

發行項
03/14/2024

在本快速入門中，您會使用 Azure Resource Manager 範本（ARM 範本）來建立 IoT 中樞、Azure 儲存體帳戶，以及將訊息從 IoT 中樞傳送至記憶體的路由。已設定中樞，以便在訊息符合路由條件時，自動路由傳送至中樞的訊息至記憶體帳戶。在本快速入門結束時，您可以開啟記憶體帳戶，並查看已傳送的訊息。

Azure Resource Manager 範本是 JavaScript 物件表示法（JSON）檔案，可定義專案的基礎結構和組態。範本使用宣告式語法。您不需要撰寫程式設計命令順序來建立部署，即可描述預定的部署。

如果您的環境符合必要條件，而且您很熟悉 ARM 範本，請選取 [部署至 Azure] 按鈕。範本會在 Azure 入口網站中開啟。

必要條件

如果您沒有 Azure 訂用帳戶，請在開始前建立免費 Azure 帳戶。

檢閱範本

本快速入門中使用的範本會從 Azure 快速入門範本呼叫101-iothub-auto-route-messages。

範本中定義了兩個 Azure 資源：

微軟。儲存體/storageAccounts：具有容器的記憶體帳戶。
Microsoft.Devices/IotHubs：具有指向記憶體容器的端點的 IoT 中樞，以及傳送篩選訊息至該端點的路由。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.26.54.24096",
      "templateHash": "1111741482289134864"
    }
  },
  "parameters": {
    "projectName": {
      "type": "string",
      "defaultValue": "contoso",
      "minLength": 1,
      "maxLength": 11,
      "metadata": {
        "description": "Define the project name or prefix for all objects."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "The datacenter to use for the deployment."
      }
    },
    "skuName": {
      "type": "string",
      "defaultValue": "S1",
      "metadata": {
        "description": "The SKU to use for the IoT Hub."
      }
    },
    "skuUnits": {
      "type": "int",
      "defaultValue": 1,
      "metadata": {
        "description": "The number of IoT Hub units."
      }
    },
    "d2cPartitions": {
      "type": "int",
      "defaultValue": 4,
      "metadata": {
        "description": "Partitions used for the event stream."
      }
    }
  },
  "variables": {
    "iotHubName": "[format('{0}Hub{1}', parameters('projectName'), uniqueString(resourceGroup().id))]",
    "storageAccountName": "[format('{0}{1}', toLower(parameters('projectName')), uniqueString(resourceGroup().id))]",
    "storageEndpoint": "[format('{0}StorageEndpont', parameters('projectName'))]",
    "storageContainerName": "[format('{0}results', toLower(parameters('projectName')))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2023-01-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {
        "allowBlobPublicAccess": false,
        "minimumTlsVersion": "TLS1_2",
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
      "apiVersion": "2023-01-01",
      "name": "[format('{0}/default/{1}', variables('storageAccountName'), variables('storageContainerName'))]",
      "properties": {
        "publicAccess": "None"
      },
      "dependsOn": [
        "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
      ]
    },
    {
      "type": "Microsoft.Devices/IotHubs",
      "apiVersion": "2023-06-30",
      "name": "[variables('iotHubName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('skuName')]",
        "capacity": "[parameters('skuUnits')]"
      },
      "properties": {
        "eventHubEndpoints": {
          "events": {
            "retentionTimeInDays": 1,
            "partitionCount": "[parameters('d2cPartitions')]"
          }
        },
        "routing": {
          "endpoints": {
            "storageContainers": [
              {
                "connectionString": "[format('DefaultEndpointsProtocol=https;AccountName={0};EndpointSuffix={1};AccountKey={2}', variables('storageAccountName'), environment().suffixes.storage, listKeys(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName')), '2023-01-01').keys[0].value)]",
                "containerName": "[variables('storageContainerName')]",
                "fileNameFormat": "{iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}",
                "batchFrequencyInSeconds": 100,
                "maxChunkSizeInBytes": 104857600,
                "encoding": "JSON",
                "name": "[variables('storageEndpoint')]"
              }
            ]
          },
          "routes": [
            {
              "name": "ContosoStorageRoute",
              "source": "DeviceMessages",
              "condition": "level=\"storage\"",
              "endpointNames": [
                "[variables('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
          }
        }
      },
      "dependsOn": [
        "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
      ]
    }
  ],
  "outputs": {
    "name": {
      "type": "string",
      "value": "[variables('iotHubName')]"
    },
    "resourceId": {
      "type": "string",
      "value": "[resourceId('Microsoft.Devices/IotHubs', variables('iotHubName'))]"
    },
    "resourceGroupName": {
      "type": "string",
      "value": "[resourceGroup().name]"
    },
    "location": {
      "type": "string",
      "value": "[parameters('location')]"
    }
  }
}

部署範本

本節提供部署ARM範本的步驟。

部署 ARM 範本以建立資源。

傳送裝置到雲端訊息

在本節中，您會在新 IoT 中樞註冊裝置，然後將訊息從該裝置傳送至 IoT 中樞。 IoT 中樞中設定的範本只會在包含訊息屬性 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-32和base64編碼。如果您回讀訊息，則必須從base64和utf-32譯碼，才能將它讀為ASCII。如果您有興趣，您可以使用路由教學課程中的 ReadOneRowFromFile 方法，從其中一個訊息檔案讀取其中一個，並將它譯碼為 ASCII。 ReadOneRowFromFile 位於您針對本快速入門解壓縮的 IoT C# SDK 存放庫中。以下是該資料夾頂端的路徑： ./iothub/device/samples/gettinged/RoutingTutorial/SimulatedDevice/Program.cs。 將布爾值 readTheFile 設定為 true，並將磁碟上的檔案路徑硬式編碼，它會開啟並轉譯檔案中的第一個數據列。