Freigeben über

Microsoft.Devices IotHubs 2019-03-22

  • Artikel

Bicep-Ressourcendefinition

Der IotHubs-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Devices/IotHubs-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Devices/IotHubs@2019-03-22' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    cloudToDevice: {
      defaultTtlAsIso8601: 'string'
      feedback: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
      maxDeliveryCount: int
    }
    comments: 'string'
    enableFileUploadNotifications: bool
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    routing: {
      endpoints: {
        eventHubs: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            connectionString: 'string'
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            fileNameFormat: 'string'
            maxChunkSizeInBytes: int
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
      }
      fallbackRoute: {
        condition: 'string'
        endpointNames: [
          'string'
        ]
        isEnabled: bool
        name: 'string'
        source: 'string'
      }
      routes: [
        {
          condition: 'string'
          endpointNames: [
            'string'
          ]
          isEnabled: bool
          name: 'string'
          source: 'string'
        }
      ]
    }
    storageEndpoints: {
      {customized property}: {
        connectionString: 'string'
        containerName: 'string'
        sasTtlAsIso8601: 'string'
      }
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

CloudToDeviceProperties

Name Beschreibung Wert
defaultTtlAsIso8601 Die Standardzeit für Cloud-zu-Gerät-Nachrichten in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
Feedback Die Eigenschaften der Feedbackwarteschlange für Cloud-to-Device-Nachrichten. FeedbackProperties-
maxDeliveryCount Die maximale Anzahl der Zustellungen für Nachrichten in der Cloud-zu-Gerät in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100

EventHubProperties

Name Beschreibung Wert
partitionCount Die Anzahl der Partitionen für den Empfang von Geräte-zu-Cloud-Nachrichten im Event Hub-kompatiblen Endpunkt. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Die Aufbewahrungszeit für Geräte-zu-Cloud-Nachrichten in Tagen. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Fallbackroute anzuwenden. Wenn die Bedingung nicht angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik: /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die die Nachrichten, die die Bedingung erfüllen, weitergeleitet werden. Derzeit ist nur 1 Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob die Fallbackroute aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur
Quelle Die Quelle, auf die die Routingregel angewendet werden soll. Beispiel: DeviceMessages "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

FeedbackProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer für die Feedbackwarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht in der Feedbackwarteschlange zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur

IotHubProperties

Name Beschreibung Wert
authorizationPolicies Die Richtlinien für den freigegebenen Zugriff, die Sie verwenden können, um eine Verbindung mit dem IoT-Hub zu sichern. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Die IoT-Hub-Cloud-to-Device-Messaging-Eigenschaften. CloudToDeviceProperties
Kommentare IoT-Hubkommentare. Schnur
enableFileUploadNotifications Bei "True" sind Dateiuploadbenachrichtigungen aktiviert. Bool
eventHubEndpoints Die Ereignishub-kompatiblen Endpunkteigenschaften. Die einzigen möglichen Schlüssel für dieses Wörterbuch sind Ereignisse. Dieser Schlüssel muss im Wörterbuch vorhanden sein, während Aufrufe für den IoT-Hub erstellt oder aktualisiert werden. IotHubPropertiesEventHubEndpoints
Funktionen Die Funktionen und Features, die für den IoT-Hub aktiviert sind. "DeviceManagement"
'None'
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
messagingEndpoints Die Messaging-Endpunkteigenschaften für die Benachrichtigungswarteschlange für den Dateiupload. IotHubPropertiesMessagingEndpoints
Routing Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties-
storageEndpoints Die Liste der Azure Storage-Endpunkte, in die Sie Dateien hochladen können. Derzeit können Sie nur ein Azure Storage-Konto konfigurieren und den Schlüssel als $default haben. Wenn Sie mehrere Speicherkonten angeben, wird ein Fehler ausgelöst. Wenn die Eigenschaft "enableFileUploadNotifications" nicht auf "True" festgelegt ist, wird ein Fehler ausgelöst. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Name Beschreibung Wert

IotHubPropertiesMessagingEndpoints

Name Beschreibung Wert

IotHubPropertiesStorageEndpoints

Name Beschreibung Wert

IotHubSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitgestellten IoT Hub-Einheiten. Siehe: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Name Der Name der SKU. 'B1'
'B2'
"B3"
'F1'
'S1'
'S2'
'S3' (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)

MessagingEndpointProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur

Microsoft.Devices/IotHubs

Name Beschreibung Wert
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften IotHub-Eigenschaften IotHubProperties-
Sku IotHub-SKU-Informationen IotHubSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

ResourceTags

Name Beschreibung Wert

RouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Routingregel anzuwenden. Wenn keine Bedingung angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik finden Sie unter : /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die Nachrichten weitergeleitet werden, die die Bedingung erfüllen. Derzeit ist nur ein Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob eine Route aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
Quelle Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages. "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

RoutingEndpoints

Name Beschreibung Wert
eventHubs Die Liste der Event Hubs-Endpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Diese Liste enthält nicht den integrierten Event Hubs-Endpunkt. RoutingEventHubProperties[]
serviceBusQueues Die Liste der Endpunkte der Servicebus-Warteschlange, an die IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Die Liste der ServiceBus-Themenendpunkte, an die der IoT-Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusTopicEndpointProperties[]
storageContainers Die Liste der Speichercontainerendpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Event Hub-Endpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Event Hub-Endpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Event Hub-Endpunkts. Schnur

RoutingProperties

Name Beschreibung Wert
Endpunkte Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT-Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur 1 benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig. RoutingEndpoints-
fallbackRoute Die Eigenschaften der Route, die als Fallbackroute verwendet wird, wenn keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllt ist. Dies ist ein optionaler Parameter. Wenn diese Eigenschaft nicht festgelegt ist, werden die Nachrichten, die keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllen, an den integrierten EventHub-Endpunkt weitergeleitet. FallbackRouteProperties
Routen Die Liste der vom Benutzer bereitgestellten Routingregeln, die der IoT-Hub zum Weiterleiten von Nachrichten an integrierte und benutzerdefinierte Endpunkte verwendet. Maximal 100 Routingregeln sind für kostenpflichtige Hubs zulässig, und maximal 5 Routingregeln sind für kostenlose Hubs zulässig. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Dienstenbus-Warteschlangenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Warteschlangennamen übereinstimmen. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Dienstenbus-Warteschlangenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Dienstenbus-Warteschlangenendpunkts. Schnur

RoutingServiceBusTopicEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Servicebus-Themenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Themanamen identisch sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Servicebus-Themenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Servicebus-Themenendpunkts. Schnur

RoutingStorageContainerProperties

Name Beschreibung Wert
batchFrequencyInSeconds Zeitintervall, in das Blobs in den Speicher geschrieben werden. Der Wert sollte zwischen 60 und 720 Sekunden betragen. Der Standardwert beträgt 300 Sekunden. Int

Zwänge:
Min.-Wert = 60
Max. Wert = 720
connectionString Die Verbindungszeichenfolge des Speicherkontos. Zeichenfolge (erforderlich)
containerName Der Name des Speichercontainers im Speicherkonto. Zeichenfolge (erforderlich)
Codierung Codierung, die zum Serialisieren von Nachrichten in Blobs verwendet wird. Unterstützte Werte sind "avro", "avrodeflate" und "JSON". Der Standardwert ist "avro". 'Avro'
'AvroDeflate'
"JSON"
fileNameFormat Dateinamenformat für das Blob. Das Standardformat ist {iothub}/{partition}/{JJJJ}/{MM}/{DD}/{HH}/{mm}. Alle Parameter sind obligatorisch, können aber neu angeordnet werden. Schnur
maxChunkSizeInBytes Maximale Anzahl von Bytes für jedes blob, das in den Speicher geschrieben wurde. Der Wert sollte zwischen 10485760(10 MB) und 524288000(500 MB) sein. Der Standardwert ist 314572800(300 MB). Int

Zwänge:
Min-Wert = 10485760
Max. Wert = 524288000
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Speicherkontos. Schnur
subscriptionId Der Abonnementbezeichner des Speicherkontos. Schnur

SharedAccessSignatureAuthorizationRule

Name Beschreibung Wert
keyName Der Name der Richtlinie für den freigegebenen Zugriff. Zeichenfolge (erforderlich)
primaryKey Der Primärschlüssel. Schnur
Rechte Die Berechtigungen, die der Richtlinie für den freigegebenen Zugriff zugewiesen sind. "DeviceConnect"
'RegistryRead'
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
'RegistryWrite'
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
'ServiceConnect'
"ServiceConnect, DeviceConnect" (erforderlich)
secondaryKey Der sekundäre Schlüssel. Schnur

StorageEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden. Zeichenfolge (erforderlich)
containerName Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte jedoch mithilfe der angegebenen connectionString erstellt werden. Zeichenfolge (erforderlich)
sasTtlAsIso8601 Der Zeitraum, für den der SAS-URI, der vom IoT Hub für den Dateiupload generiert wurde, gültig ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. Schnur

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Erstellen eines IoT Hub und eines Geräts für Cloud Consumer Group Mit dieser Vorlage können Sie eine IoT Hub-Instanz mit Gerät in der Cloud und der Cloud für Gerätenachrichtenkonfigurationen und ein Gerät in der Cloud-Consumergruppe bereitstellen.
Erstellen eines IoT Hub-Gerätebereitstellungsdiensts Mit dieser Vorlage können Sie einen IoT-Hub und einen IoT Hub-Gerätebereitstellungsdienst erstellen und die beiden Dienste miteinander verknüpfen.
Erstellen des Geräteupdates für IoT Hub-Konto, Instanz, IoT Hub- Diese Vorlage erstellt ein Konto und eine Instanz und einen Hub, mit dem die Instanz verknüpft werden soll. Er konfiguriert den Hub mit den erforderlichen Zugriffsrichtlinien, Routen und Verbrauchergruppen.
Bereitstellen des MedTech-Diensts einschließlich eines Azure IoT Hub- Der MedTech-Dienst ist einer der Azure Health Data Services, der zum Aufnehmen von Gerätedaten von mehreren Geräten entwickelt wurde, transformieren sie die Gerätedaten in FHIR-Beobachtungen, die dann im Azure Health Data Services-FHIR-Dienst gespeichert werden.
Verwenden der ARM-Vorlage zum Erstellen von IoT Hub- und Routen- und Anzeigen von Nachrichten Verwenden Sie diese Vorlage, um einen IoT Hub und ein Speicherkonto bereitzustellen. Führen Sie eine App aus, um Nachrichten an den Hub zu senden, die an den Speicher weitergeleitet werden, und zeigen Sie dann die Ergebnisse an.

ARM-Vorlagenressourcendefinition

Der IotHubs-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Devices/IotHubs-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2019-03-22",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "cloudToDevice": {
      "defaultTtlAsIso8601": "string",
      "feedback": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      },
      "maxDeliveryCount": "int"
    },
    "comments": "string",
    "enableFileUploadNotifications": "bool",
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "routing": {
      "endpoints": {
        "eventHubs": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "connectionString": "string",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "fileNameFormat": "string",
            "maxChunkSizeInBytes": "int",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ]
      },
      "fallbackRoute": {
        "condition": "string",
        "endpointNames": [ "string" ],
        "isEnabled": "bool",
        "name": "string",
        "source": "string"
      },
      "routes": [
        {
          "condition": "string",
          "endpointNames": [ "string" ],
          "isEnabled": "bool",
          "name": "string",
          "source": "string"
        }
      ]
    },
    "storageEndpoints": {
      "{customized property}": {
        "connectionString": "string",
        "containerName": "string",
        "sasTtlAsIso8601": "string"
      }
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

CloudToDeviceProperties

Name Beschreibung Wert
defaultTtlAsIso8601 Die Standardzeit für Cloud-zu-Gerät-Nachrichten in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
Feedback Die Eigenschaften der Feedbackwarteschlange für Cloud-to-Device-Nachrichten. FeedbackProperties-
maxDeliveryCount Die maximale Anzahl der Zustellungen für Nachrichten in der Cloud-zu-Gerät in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100

EventHubProperties

Name Beschreibung Wert
partitionCount Die Anzahl der Partitionen für den Empfang von Geräte-zu-Cloud-Nachrichten im Event Hub-kompatiblen Endpunkt. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Die Aufbewahrungszeit für Geräte-zu-Cloud-Nachrichten in Tagen. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Fallbackroute anzuwenden. Wenn die Bedingung nicht angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik: /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die die Nachrichten, die die Bedingung erfüllen, weitergeleitet werden. Derzeit ist nur 1 Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob die Fallbackroute aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur
Quelle Die Quelle, auf die die Routingregel angewendet werden soll. Beispiel: DeviceMessages "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

FeedbackProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer für die Feedbackwarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht in der Feedbackwarteschlange zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur

IotHubProperties

Name Beschreibung Wert
authorizationPolicies Die Richtlinien für den freigegebenen Zugriff, die Sie verwenden können, um eine Verbindung mit dem IoT-Hub zu sichern. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Die IoT-Hub-Cloud-to-Device-Messaging-Eigenschaften. CloudToDeviceProperties
Kommentare IoT-Hubkommentare. Schnur
enableFileUploadNotifications Bei "True" sind Dateiuploadbenachrichtigungen aktiviert. Bool
eventHubEndpoints Die Ereignishub-kompatiblen Endpunkteigenschaften. Die einzigen möglichen Schlüssel für dieses Wörterbuch sind Ereignisse. Dieser Schlüssel muss im Wörterbuch vorhanden sein, während Aufrufe für den IoT-Hub erstellt oder aktualisiert werden. IotHubPropertiesEventHubEndpoints
Funktionen Die Funktionen und Features, die für den IoT-Hub aktiviert sind. "DeviceManagement"
'None'
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
messagingEndpoints Die Messaging-Endpunkteigenschaften für die Benachrichtigungswarteschlange für den Dateiupload. IotHubPropertiesMessagingEndpoints
Routing Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties-
storageEndpoints Die Liste der Azure Storage-Endpunkte, in die Sie Dateien hochladen können. Derzeit können Sie nur ein Azure Storage-Konto konfigurieren und den Schlüssel als $default haben. Wenn Sie mehrere Speicherkonten angeben, wird ein Fehler ausgelöst. Wenn die Eigenschaft "enableFileUploadNotifications" nicht auf "True" festgelegt ist, wird ein Fehler ausgelöst. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Name Beschreibung Wert

IotHubPropertiesMessagingEndpoints

Name Beschreibung Wert

IotHubPropertiesStorageEndpoints

Name Beschreibung Wert

IotHubSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitgestellten IoT Hub-Einheiten. Siehe: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Name Der Name der SKU. 'B1'
'B2'
"B3"
'F1'
'S1'
'S2'
'S3' (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)

MessagingEndpointProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur

Microsoft.Devices/IotHubs

Name Beschreibung Wert
apiVersion Die API-Version '2019-03-22'
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften IotHub-Eigenschaften IotHubProperties-
Sku IotHub-SKU-Informationen IotHubSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.Devices/IotHubs"

ResourceTags

Name Beschreibung Wert

RouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Routingregel anzuwenden. Wenn keine Bedingung angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik finden Sie unter : /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die Nachrichten weitergeleitet werden, die die Bedingung erfüllen. Derzeit ist nur ein Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob eine Route aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
Quelle Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages. "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

RoutingEndpoints

Name Beschreibung Wert
eventHubs Die Liste der Event Hubs-Endpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Diese Liste enthält nicht den integrierten Event Hubs-Endpunkt. RoutingEventHubProperties[]
serviceBusQueues Die Liste der Endpunkte der Servicebus-Warteschlange, an die IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Die Liste der ServiceBus-Themenendpunkte, an die der IoT-Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusTopicEndpointProperties[]
storageContainers Die Liste der Speichercontainerendpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Event Hub-Endpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Event Hub-Endpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Event Hub-Endpunkts. Schnur

RoutingProperties

Name Beschreibung Wert
Endpunkte Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT-Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur 1 benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig. RoutingEndpoints-
fallbackRoute Die Eigenschaften der Route, die als Fallbackroute verwendet wird, wenn keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllt ist. Dies ist ein optionaler Parameter. Wenn diese Eigenschaft nicht festgelegt ist, werden die Nachrichten, die keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllen, an den integrierten EventHub-Endpunkt weitergeleitet. FallbackRouteProperties
Routen Die Liste der vom Benutzer bereitgestellten Routingregeln, die der IoT-Hub zum Weiterleiten von Nachrichten an integrierte und benutzerdefinierte Endpunkte verwendet. Maximal 100 Routingregeln sind für kostenpflichtige Hubs zulässig, und maximal 5 Routingregeln sind für kostenlose Hubs zulässig. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Dienstenbus-Warteschlangenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Warteschlangennamen übereinstimmen. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Dienstenbus-Warteschlangenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Dienstenbus-Warteschlangenendpunkts. Schnur

RoutingServiceBusTopicEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Servicebus-Themenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Themanamen identisch sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Servicebus-Themenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Servicebus-Themenendpunkts. Schnur

RoutingStorageContainerProperties

Name Beschreibung Wert
batchFrequencyInSeconds Zeitintervall, in das Blobs in den Speicher geschrieben werden. Der Wert sollte zwischen 60 und 720 Sekunden betragen. Der Standardwert beträgt 300 Sekunden. Int

Zwänge:
Min.-Wert = 60
Max. Wert = 720
connectionString Die Verbindungszeichenfolge des Speicherkontos. Zeichenfolge (erforderlich)
containerName Der Name des Speichercontainers im Speicherkonto. Zeichenfolge (erforderlich)
Codierung Codierung, die zum Serialisieren von Nachrichten in Blobs verwendet wird. Unterstützte Werte sind "avro", "avrodeflate" und "JSON". Der Standardwert ist "avro". 'Avro'
'AvroDeflate'
"JSON"
fileNameFormat Dateinamenformat für das Blob. Das Standardformat ist {iothub}/{partition}/{JJJJ}/{MM}/{DD}/{HH}/{mm}. Alle Parameter sind obligatorisch, können aber neu angeordnet werden. Schnur
maxChunkSizeInBytes Maximale Anzahl von Bytes für jedes blob, das in den Speicher geschrieben wurde. Der Wert sollte zwischen 10485760(10 MB) und 524288000(500 MB) sein. Der Standardwert ist 314572800(300 MB). Int

Zwänge:
Min-Wert = 10485760
Max. Wert = 524288000
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Speicherkontos. Schnur
subscriptionId Der Abonnementbezeichner des Speicherkontos. Schnur

SharedAccessSignatureAuthorizationRule

Name Beschreibung Wert
keyName Der Name der Richtlinie für den freigegebenen Zugriff. Zeichenfolge (erforderlich)
primaryKey Der Primärschlüssel. Schnur
Rechte Die Berechtigungen, die der Richtlinie für den freigegebenen Zugriff zugewiesen sind. "DeviceConnect"
'RegistryRead'
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
'RegistryWrite'
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
'ServiceConnect'
"ServiceConnect, DeviceConnect" (erforderlich)
secondaryKey Der sekundäre Schlüssel. Schnur

StorageEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden. Zeichenfolge (erforderlich)
containerName Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte jedoch mithilfe der angegebenen connectionString erstellt werden. Zeichenfolge (erforderlich)
sasTtlAsIso8601 Der Zeitraum, für den der SAS-URI, der vom IoT Hub für den Dateiupload generiert wurde, gültig ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. Schnur

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Erstellen einer Pay As You Go (PAYG)-Umgebung mit einem IoT Hub-

Bereitstellen in Azure 		Mit dieser Vorlage können Sie eine Pay As You Go (PAYG) Time Series Insights-Umgebung bereitstellen, die für die Nutzung von Ereignissen von einem IoT Hub konfiguriert ist.
Erstellen eines IoT Hub und eines Geräts für Cloud Consumer Group

Bereitstellen in Azure 		Mit dieser Vorlage können Sie eine IoT Hub-Instanz mit Gerät in der Cloud und der Cloud für Gerätenachrichtenkonfigurationen und ein Gerät in der Cloud-Consumergruppe bereitstellen.
Erstellen eines IOT Hub- und Ubuntu-Edgesimulators

Bereitstellen in Azure 		Diese Vorlage erstellt einen IOT Hub und einen Virtuellen Computer Ubuntu Edge Simulator.
Erstellen eines IoT Hub-Gerätebereitstellungsdiensts

Bereitstellen in Azure 		Mit dieser Vorlage können Sie einen IoT-Hub und einen IoT Hub-Gerätebereitstellungsdienst erstellen und die beiden Dienste miteinander verknüpfen.
Erstellen des Geräteupdates für IoT Hub-Konto, Instanz, IoT Hub-

Bereitstellen in Azure 		Diese Vorlage erstellt ein Konto und eine Instanz und einen Hub, mit dem die Instanz verknüpft werden soll. Er konfiguriert den Hub mit den erforderlichen Zugriffsrichtlinien, Routen und Verbrauchergruppen.
Bereitstellen des MedTech-Diensts einschließlich eines Azure IoT Hub-

Bereitstellen in Azure 		Der MedTech-Dienst ist einer der Azure Health Data Services, der zum Aufnehmen von Gerätedaten von mehreren Geräten entwickelt wurde, transformieren sie die Gerätedaten in FHIR-Beobachtungen, die dann im Azure Health Data Services-FHIR-Dienst gespeichert werden.
Verwenden der ARM-Vorlage zum Erstellen von IoT Hub- und Routen- und Anzeigen von Nachrichten

Bereitstellen in Azure 		Verwenden Sie diese Vorlage, um einen IoT Hub und ein Speicherkonto bereitzustellen. Führen Sie eine App aus, um Nachrichten an den Hub zu senden, die an den Speicher weitergeleitet werden, und zeigen Sie dann die Ergebnisse an.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der IotHubs-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Devices/IotHubs-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2019-03-22"
  name = "string"
  etag = "string"
  location = "string"
  body = jsonencode({
    properties = {
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      enableFileUploadNotifications = bool
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      routing = {
        endpoints = {
          eventHubs = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              connectionString = "string"
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              fileNameFormat = "string"
              maxChunkSizeInBytes = int
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
        }
        fallbackRoute = {
          condition = "string"
          endpointNames = [
            "string"
          ]
          isEnabled = bool
          name = "string"
          source = "string"
        }
        routes = [
          {
            condition = "string"
            endpointNames = [
              "string"
            ]
            isEnabled = bool
            name = "string"
            source = "string"
          }
        ]
      }
      storageEndpoints = {
        {customized property} = {
          connectionString = "string"
          containerName = "string"
          sasTtlAsIso8601 = "string"
        }
      }
    }
  })
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Eigenschaftswerte

CloudToDeviceProperties

Name Beschreibung Wert
defaultTtlAsIso8601 Die Standardzeit für Cloud-zu-Gerät-Nachrichten in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
Feedback Die Eigenschaften der Feedbackwarteschlange für Cloud-to-Device-Nachrichten. FeedbackProperties-
maxDeliveryCount Die maximale Anzahl der Zustellungen für Nachrichten in der Cloud-zu-Gerät in der Gerätewarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100

EventHubProperties

Name Beschreibung Wert
partitionCount Die Anzahl der Partitionen für den Empfang von Geräte-zu-Cloud-Nachrichten im Event Hub-kompatiblen Endpunkt. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Die Aufbewahrungszeit für Geräte-zu-Cloud-Nachrichten in Tagen. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Fallbackroute anzuwenden. Wenn die Bedingung nicht angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik: /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die die Nachrichten, die die Bedingung erfüllen, weitergeleitet werden. Derzeit ist nur 1 Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob die Fallbackroute aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur
Quelle Die Quelle, auf die die Routingregel angewendet werden soll. Beispiel: DeviceMessages "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

FeedbackProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer für die Feedbackwarteschlange. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht in der Feedbackwarteschlange zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Schnur

IotHubProperties

Name Beschreibung Wert
authorizationPolicies Die Richtlinien für den freigegebenen Zugriff, die Sie verwenden können, um eine Verbindung mit dem IoT-Hub zu sichern. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Die IoT-Hub-Cloud-to-Device-Messaging-Eigenschaften. CloudToDeviceProperties
Kommentare IoT-Hubkommentare. Schnur
enableFileUploadNotifications Bei "True" sind Dateiuploadbenachrichtigungen aktiviert. Bool
eventHubEndpoints Die Ereignishub-kompatiblen Endpunkteigenschaften. Die einzigen möglichen Schlüssel für dieses Wörterbuch sind Ereignisse. Dieser Schlüssel muss im Wörterbuch vorhanden sein, während Aufrufe für den IoT-Hub erstellt oder aktualisiert werden. IotHubPropertiesEventHubEndpoints
Funktionen Die Funktionen und Features, die für den IoT-Hub aktiviert sind. "DeviceManagement"
'None'
ipFilterRules Die IP-Filterregeln. IpFilterRule-[]
messagingEndpoints Die Messaging-Endpunkteigenschaften für die Benachrichtigungswarteschlange für den Dateiupload. IotHubPropertiesMessagingEndpoints
Routing Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties-
storageEndpoints Die Liste der Azure Storage-Endpunkte, in die Sie Dateien hochladen können. Derzeit können Sie nur ein Azure Storage-Konto konfigurieren und den Schlüssel als $default haben. Wenn Sie mehrere Speicherkonten angeben, wird ein Fehler ausgelöst. Wenn die Eigenschaft "enableFileUploadNotifications" nicht auf "True" festgelegt ist, wird ein Fehler ausgelöst. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Name Beschreibung Wert

IotHubPropertiesMessagingEndpoints

Name Beschreibung Wert

IotHubPropertiesStorageEndpoints

Name Beschreibung Wert

IotHubSkuInfo

Name Beschreibung Wert
Fassungsvermögen Die Anzahl der bereitgestellten IoT Hub-Einheiten. Siehe: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Name Der Name der SKU. 'B1'
'B2'
"B3"
'F1'
'S1'
'S2'
'S3' (erforderlich)

IpFilterRule

Name Beschreibung Wert
Aktion Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. "Annehmen"
"Ablehnen" (erforderlich)
filterName Der Name der IP-Filterregel. Zeichenfolge (erforderlich)
ipMask Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. Zeichenfolge (erforderlich)

MessagingEndpointProperties

Name Beschreibung Wert
lockDurationAsIso8601 Die Sperrdauer. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur
maxDeliveryCount Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht zu übermitteln. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 100
ttlAsIso8601 Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT-Hub abgelaufen ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload. Schnur

Microsoft.Devices/IotHubs

Name Beschreibung Wert
etag Das Feld "Etag" ist nicht erforderlich. Wenn sie im Antworttext bereitgestellt wird, muss sie auch als Kopfzeile gemäß der normalen ETag-Konvention bereitgestellt werden. Schnur
Ort Der Ressourcenspeicherort. Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften IotHub-Eigenschaften IotHubProperties-
Sku IotHub-SKU-Informationen IotHubSkuInfo- (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.Devices/IotHubs@2019-03-22"

ResourceTags

Name Beschreibung Wert

RouteProperties

Name Beschreibung Wert
Zustand Die Bedingung, die ausgewertet wird, um die Routingregel anzuwenden. Wenn keine Bedingung angegeben wird, wird sie standardmäßig als "true" ausgewertet. Grammatik finden Sie unter : /azure/iot-hub/iot-hub-devguide-query-language Schnur
endpointNames Die Liste der Endpunkte, an die Nachrichten weitergeleitet werden, die die Bedingung erfüllen. Derzeit ist nur ein Endpunkt zulässig. string[] (erforderlich)
isEnabled Wird verwendet, um anzugeben, ob eine Route aktiviert ist. bool (erforderlich)
Name Der Name der Route. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche, maximal 64 Zeichen enthalten und muss eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
Quelle Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages. "DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
'Ungültig'
"TwinChangeEvents" (erforderlich)

RoutingEndpoints

Name Beschreibung Wert
eventHubs Die Liste der Event Hubs-Endpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Diese Liste enthält nicht den integrierten Event Hubs-Endpunkt. RoutingEventHubProperties[]
serviceBusQueues Die Liste der Endpunkte der Servicebus-Warteschlange, an die IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Die Liste der ServiceBus-Themenendpunkte, an die der IoT-Hub die Nachrichten basierend auf den Routingregeln weiterleitet. RoutingServiceBusTopicEndpointProperties[]
storageContainers Die Liste der Speichercontainerendpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Event Hub-Endpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Event Hub-Endpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Event Hub-Endpunkts. Schnur

RoutingProperties

Name Beschreibung Wert
Endpunkte Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT-Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur 1 benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig. RoutingEndpoints-
fallbackRoute Die Eigenschaften der Route, die als Fallbackroute verwendet wird, wenn keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllt ist. Dies ist ein optionaler Parameter. Wenn diese Eigenschaft nicht festgelegt ist, werden die Nachrichten, die keine der im Abschnitt "Routen" angegebenen Bedingungen erfüllen, an den integrierten EventHub-Endpunkt weitergeleitet. FallbackRouteProperties
Routen Die Liste der vom Benutzer bereitgestellten Routingregeln, die der IoT-Hub zum Weiterleiten von Nachrichten an integrierte und benutzerdefinierte Endpunkte verwendet. Maximal 100 Routingregeln sind für kostenpflichtige Hubs zulässig, und maximal 5 Routingregeln sind für kostenlose Hubs zulässig. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Dienstenbus-Warteschlangenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Warteschlangennamen übereinstimmen. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Dienstenbus-Warteschlangenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Dienstenbus-Warteschlangenendpunkts. Schnur

RoutingServiceBusTopicEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge des Servicebus-Themenendpunkts. Zeichenfolge (erforderlich)
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Themanamen identisch sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Servicebus-Themenendpunkts. Schnur
subscriptionId Der Abonnementbezeichner des Servicebus-Themenendpunkts. Schnur

RoutingStorageContainerProperties

Name Beschreibung Wert
batchFrequencyInSeconds Zeitintervall, in das Blobs in den Speicher geschrieben werden. Der Wert sollte zwischen 60 und 720 Sekunden betragen. Der Standardwert beträgt 300 Sekunden. Int

Zwänge:
Min.-Wert = 60
Max. Wert = 720
connectionString Die Verbindungszeichenfolge des Speicherkontos. Zeichenfolge (erforderlich)
containerName Der Name des Speichercontainers im Speicherkonto. Zeichenfolge (erforderlich)
Codierung Codierung, die zum Serialisieren von Nachrichten in Blobs verwendet wird. Unterstützte Werte sind "avro", "avrodeflate" und "JSON". Der Standardwert ist "avro". 'Avro'
'AvroDeflate'
"JSON"
fileNameFormat Dateinamenformat für das Blob. Das Standardformat ist {iothub}/{partition}/{JJJJ}/{MM}/{DD}/{HH}/{mm}. Alle Parameter sind obligatorisch, können aber neu angeordnet werden. Schnur
maxChunkSizeInBytes Maximale Anzahl von Bytes für jedes blob, das in den Speicher geschrieben wurde. Der Wert sollte zwischen 10485760(10 MB) und 524288000(500 MB) sein. Der Standardwert ist 314572800(300 MB). Int

Zwänge:
Min-Wert = 10485760
Max. Wert = 524288000
Name Der Name, der diesen Endpunkt identifiziert. Der Name kann nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche und eine maximale Länge von 64 Zeichen enthalten. Die folgenden Namen sind reserviert: Ereignisse, FileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Schnur

Zwänge:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (erforderlich)
resourceGroup Der Name der Ressourcengruppe des Speicherkontos. Schnur
subscriptionId Der Abonnementbezeichner des Speicherkontos. Schnur

SharedAccessSignatureAuthorizationRule

Name Beschreibung Wert
keyName Der Name der Richtlinie für den freigegebenen Zugriff. Zeichenfolge (erforderlich)
primaryKey Der Primärschlüssel. Schnur
Rechte Die Berechtigungen, die der Richtlinie für den freigegebenen Zugriff zugewiesen sind. "DeviceConnect"
'RegistryRead'
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
'RegistryWrite'
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
'ServiceConnect'
"ServiceConnect, DeviceConnect" (erforderlich)
secondaryKey Der sekundäre Schlüssel. Schnur

StorageEndpointProperties

Name Beschreibung Wert
connectionString Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden. Zeichenfolge (erforderlich)
containerName Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte jedoch mithilfe der angegebenen connectionString erstellt werden. Zeichenfolge (erforderlich)
sasTtlAsIso8601 Der Zeitraum, für den der SAS-URI, der vom IoT Hub für den Dateiupload generiert wurde, gültig ist. Siehe: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. Schnur