Sdílet prostřednictvím


Microsoft.Devices IotHubs 2019-11-04

Definice prostředku Bicep

Typ prostředku IotHubs je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Devices/IotHubs, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Devices/IotHubs@2019-11-04' = {
  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'
          }
        ]
      }
      enrichments: [
        {
          endpointNames: [
            'string'
          ]
          key: 'string'
          value: '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'
  }
}

Hodnoty vlastností

CloudToDeviceProperties

Jméno Popis Hodnota
defaultTtlAsIso8601 Výchozí doba pro živé zprávy typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
zpětná vazba Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení FeedbackProperties
maxDeliveryCount Maximální počet doručení zpráv typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100

EnrichmentProperties

Jméno Popis Hodnota
endpointNames Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
hodnota Hodnota vlastnosti rozšiřování. string (povinné)

EventHubProperties

Jméno Popis Hodnota
partitionCount Počet oddílů pro příjem zpráv typu zařízení-cloud v koncovém bodu kompatibilním s centrem událostí. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Doba uchovávání zpráv typu zařízení-cloud ve dnech. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

Náhradní objektyRouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnocuje, aby se použila náhradní trasa. Pokud podmínka není za předpokladu, že se ve výchozím nastavení vyhodnotí jako true. Gramatika: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých jsou směrovány zprávy, které splňují podmínku. Aktuálně je povolený jenom 1 koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená náhradní trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec
zdroj Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

FeedbackProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání uzamčení fronty zpětné vazby. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
maxDeliveryCount Počet pokusů centra IoT o doručení zprávy do fronty zpětné vazby Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec

IotHubProperties

Jméno Popis Hodnota
authorizationPolicies Zásady sdíleného přístupu, které můžete použít k zabezpečení připojení k centru IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Vlastnosti zasílání zpráv typu cloud-zařízení ve službě IoT Hub CloudToDeviceProperties
komentáře Komentáře ke službě IoT Hub řetězec
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. Bool
eventHubEndpoints Vlastnosti koncového bodu kompatibilního s centrem událostí. Jediným možnými klíči tohoto slovníku jsou události. Tento klíč musí být ve slovníku k dispozici při vytváření nebo aktualizaci volání ioT Hubu. IotHubPropertiesEventHubEndpoints
rysy Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
ipFilterRules Pravidla filtru IP adres. IpFilterRule[]
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
storageEndpoints Seznam koncových bodů služby Azure Storage, kde můžete nahrávat soubory. V současné době můžete nakonfigurovat jenom jeden účet Azure Storage a tento klíč musí mít jako $default. Zadání více než jednoho účtu úložiště způsobí vyvolání chyby. Nezadávejte hodnotu pro tuto vlastnost, pokud je vlastnost enableFileUploadNotifications nastavena na Hodnotu True, způsobí vyvolání chyby. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Jméno Popis Hodnota

IotHubPropertiesMessagingEndpoints

Jméno Popis Hodnota

IotHubPropertiesStorageEndpoints

Jméno Popis Hodnota

IotHubSkuInfo

Jméno Popis Hodnota
kapacita Počet zřízených jednotek IoT Hubu. Viz: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Jméno Název skladové položky. "B1"
"B2"
"B3"
"F1"
S1
S2
S3 (povinné)

IpFilterRule

Jméno Popis Hodnota
akce Požadovaná akce pro požadavky zachycené tímto pravidlem. Přijmout
Odmítnout (povinné)
filterName Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

MessagingEndpointProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání zámku. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec
maxDeliveryCount Počet pokusů o doručení zprávy službou IoT Hub Viz: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec

Microsoft.Devices/IotHubs

Jméno Popis Hodnota
etag Pole Etag není povinné. Pokud je uvedený v textu odpovědi, musí se také poskytnout jako hlavička podle normální konvence značky ETag. řetězec
umístění Umístění prostředku. string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

Značky prostředků

Jméno Popis Hodnota

RouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnotí jako použití pravidla směrování. Pokud není zadanou podmínkou, vyhodnotí se ve výchozím nastavení jako true. Gramatiku najdete v tématu: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých se směrují zprávy, které splňují podmínku. Aktuálně je povolený jenom jeden koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
zdroj Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

RoutingEndpoints

Jméno Popis Hodnota
eventHubs Seznam koncových bodů služby Event Hubs, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. Tento seznam neobsahuje integrovaný koncový bod služby Event Hubs. RoutingEventHubProperties[]
serviceBusQueues Seznam koncových bodů fronty služby Service Bus, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Seznam koncových bodů tématu služby Service Bus, do které centrum IoT směruje zprávy na základě pravidel směrování. RoutingServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch RoutingStorageContainerProperties[]

RoutingEventHubProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu centra událostí. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu centra událostí. řetězec
subscriptionId Identifikátor odběru koncového bodu centra událostí. řetězec

RoutingProperties

Jméno Popis Hodnota
Koncové body Vlastnosti související s vlastními koncovými body, do kterých vaše centrum IoT směruje zprávy na základě pravidel směrování. Pro placené rozbočovače je povolených maximálně 10 vlastních koncových bodů a pro bezplatná centra je povolený pouze 1 vlastní koncový bod. RoutingEndpoints
obohacení Seznam rozšíření poskytovaných uživatelem, které centrum IoT používá pro zprávy, které se mají doručovat do integrovaných a vlastních koncových bodů. Viz: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
náhradníroute Vlastnosti trasy, která se používá jako náhradní trasa, pokud nejsou splněny žádné podmínky zadané v části trasy. Jedná se o volitelný parametr. Pokud tato vlastnost není nastavená, zprávy, které nesplňují žádné podmínky zadané v části trasy, se směrují do integrovaného koncového bodu centra událostí. fallbackRouteProperties
trasy Seznam pravidel směrování poskytovaných uživatelem, která ioT Hub používá ke směrování zpráv do předdefinovaných a vlastních koncových bodů. Pro placené rozbočovače je povoleno maximálně 100 pravidel směrování a pro bezplatná centra jsou povolená maximálně 5 pravidel směrování. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu fronty služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název fronty. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu fronty služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu fronty služby Service Bus. řetězec

RoutingServiceBusTopicEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu tématu služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název tématu. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu tématu služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu tématu služby Service Bus. řetězec

RoutingStorageContainerProperties

Jméno Popis Hodnota
batchFrequencyInSeconds Časový interval, ve kterém se objekty blob zapisují do úložiště. Hodnota by měla být v rozmezí 60 až 720 sekund. Výchozí hodnota je 300 sekund. Int

Omezení:
Minimální hodnota = 60
Maximální hodnota = 720
connectionString Připojovací řetězec účtu úložiště. string (povinné)
containerName Název kontejneru úložiště v účtu úložiště. string (povinné)
kódování Kódování, které se používá k serializaci zpráv do objektů blob. Podporované hodnoty jsou avro, avrodeflate a JSON. Výchozí hodnota je avro. "Avro"
AvroDeflate
JSON
fileNameFormat Formát názvu souboru objektu blob. Výchozí formát je {iothub}/{partition}/{RRRR}/{MM}/{DD}/{HH}/{mm}. Všechny parametry jsou povinné, ale dají se změnit jejich pořadí. řetězec
maxChunkSizeInBytes Maximální počet bajtů pro každý objekt blob zapsaný do úložiště Hodnota by měla být mezi 10485760(10 MB) a 524288000(500 MB). Výchozí hodnota je 314572800(300 MB). Int

Omezení:
Minimální hodnota = 10485760
Maximální hodnota = 524288000
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků účtu úložiště. řetězec
subscriptionId Identifikátor předplatného účtu úložiště. řetězec

SharedAccessSignatureAuthorizationRule

Jméno Popis Hodnota
keyName Název zásady sdíleného přístupu. string (povinné)
primaryKey Primární klíč. řetězec
práva Oprávnění přiřazená k zásadám sdíleného přístupu. DeviceConnect
RegistrRead
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 (povinné)
secondaryKey Sekundární klíč. řetězec

StorageEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec pro účet služby Azure Storage, do kterého se soubory nahrají. string (povinné)
containerName Název kořenového kontejneru, do kterého nahráváte soubory. Kontejner nemusí existovat, ale měl by být creatable pomocí zadaného připojovacího řetězce. string (povinné)
sasTtlAsIso8601 Doba, po kterou je identifikátor URI SAS vygenerovaný službou IoT Hub pro nahrání souboru platný. Viz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. řetězec

Ukázky rychlého startu

Následující ukázky rychlého startu nasadí tento typ prostředku.

Soubor Bicep Popis
vytvoření ioT Hubu a zařízení do skupiny cloudových příjemců Tato šablona umožňuje nasadit instanci ioT Hubu se zařízením do cloudu a cloudu do konfigurací zasílání zpráv zařízení a zařízení do skupiny příjemců cloudu.
vytvoření služby IoT Hub Device Provisioning Tato šablona umožňuje vytvořit centrum IoT a službu IoT Hub Device Provisioning a propojit obě služby.
vytvoření účtu služby Device Update pro ioT Hub, instanci, službu IoT Hub Tato šablona vytvoří účet a instanci a centrum pro propojení instance s touto instancí. Nakonfiguruje centrum s potřebnými zásadami přístupu, trasami a skupinou příjemců.
nasazení služby MedTech, včetně služby Azure IoT Hub Služba MedTech je jednou ze služeb Azure Health Data Services navržená tak, aby ingestovala data zařízení z více zařízení, transformovala data zařízení na pozorování FHIR, která se pak uchovávají ve službě FHIR služby Azure Health Data Services.
Vytvoření služby IoT Hub, směrování a zobrazení zpráv pomocí šablony ARM Pomocí této šablony můžete nasadit IoT Hub a účet úložiště. Spuštěním aplikace odešlete zprávy do centra, které je směrováno do úložiště, a zobrazte výsledky.

Definice prostředku šablony ARM

Typ prostředku IotHubs je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Devices/IotHubs, přidejte do šablony následující JSON.

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2019-11-04",
  "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"
          }
        ]
      },
      "enrichments": [
        {
          "endpointNames": [ "string" ],
          "key": "string",
          "value": "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"
  }
}

Hodnoty vlastností

CloudToDeviceProperties

Jméno Popis Hodnota
defaultTtlAsIso8601 Výchozí doba pro živé zprávy typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
zpětná vazba Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení FeedbackProperties
maxDeliveryCount Maximální počet doručení zpráv typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100

EnrichmentProperties

Jméno Popis Hodnota
endpointNames Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
hodnota Hodnota vlastnosti rozšiřování. string (povinné)

EventHubProperties

Jméno Popis Hodnota
partitionCount Počet oddílů pro příjem zpráv typu zařízení-cloud v koncovém bodu kompatibilním s centrem událostí. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Doba uchovávání zpráv typu zařízení-cloud ve dnech. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

Náhradní objektyRouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnocuje, aby se použila náhradní trasa. Pokud podmínka není za předpokladu, že se ve výchozím nastavení vyhodnotí jako true. Gramatika: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých jsou směrovány zprávy, které splňují podmínku. Aktuálně je povolený jenom 1 koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená náhradní trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec
zdroj Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

FeedbackProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání uzamčení fronty zpětné vazby. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
maxDeliveryCount Počet pokusů centra IoT o doručení zprávy do fronty zpětné vazby Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec

IotHubProperties

Jméno Popis Hodnota
authorizationPolicies Zásady sdíleného přístupu, které můžete použít k zabezpečení připojení k centru IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Vlastnosti zasílání zpráv typu cloud-zařízení ve službě IoT Hub CloudToDeviceProperties
komentáře Komentáře ke službě IoT Hub řetězec
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. Bool
eventHubEndpoints Vlastnosti koncového bodu kompatibilního s centrem událostí. Jediným možnými klíči tohoto slovníku jsou události. Tento klíč musí být ve slovníku k dispozici při vytváření nebo aktualizaci volání ioT Hubu. IotHubPropertiesEventHubEndpoints
rysy Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
ipFilterRules Pravidla filtru IP adres. IpFilterRule[]
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
storageEndpoints Seznam koncových bodů služby Azure Storage, kde můžete nahrávat soubory. V současné době můžete nakonfigurovat jenom jeden účet Azure Storage a tento klíč musí mít jako $default. Zadání více než jednoho účtu úložiště způsobí vyvolání chyby. Nezadávejte hodnotu pro tuto vlastnost, pokud je vlastnost enableFileUploadNotifications nastavena na Hodnotu True, způsobí vyvolání chyby. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Jméno Popis Hodnota

IotHubPropertiesMessagingEndpoints

Jméno Popis Hodnota

IotHubPropertiesStorageEndpoints

Jméno Popis Hodnota

IotHubSkuInfo

Jméno Popis Hodnota
kapacita Počet zřízených jednotek IoT Hubu. Viz: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Jméno Název skladové položky. "B1"
"B2"
"B3"
"F1"
S1
S2
S3 (povinné)

IpFilterRule

Jméno Popis Hodnota
akce Požadovaná akce pro požadavky zachycené tímto pravidlem. Přijmout
Odmítnout (povinné)
filterName Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

MessagingEndpointProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání zámku. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec
maxDeliveryCount Počet pokusů o doručení zprávy službou IoT Hub Viz: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec

Microsoft.Devices/IotHubs

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2019-11-04'
etag Pole Etag není povinné. Pokud je uvedený v textu odpovědi, musí se také poskytnout jako hlavička podle normální konvence značky ETag. řetězec
umístění Umístění prostředku. string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.Devices/IotHubs

Značky prostředků

Jméno Popis Hodnota

RouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnotí jako použití pravidla směrování. Pokud není zadanou podmínkou, vyhodnotí se ve výchozím nastavení jako true. Gramatiku najdete v tématu: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých se směrují zprávy, které splňují podmínku. Aktuálně je povolený jenom jeden koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
zdroj Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

RoutingEndpoints

Jméno Popis Hodnota
eventHubs Seznam koncových bodů služby Event Hubs, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. Tento seznam neobsahuje integrovaný koncový bod služby Event Hubs. RoutingEventHubProperties[]
serviceBusQueues Seznam koncových bodů fronty služby Service Bus, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Seznam koncových bodů tématu služby Service Bus, do které centrum IoT směruje zprávy na základě pravidel směrování. RoutingServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch RoutingStorageContainerProperties[]

RoutingEventHubProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu centra událostí. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu centra událostí. řetězec
subscriptionId Identifikátor odběru koncového bodu centra událostí. řetězec

RoutingProperties

Jméno Popis Hodnota
Koncové body Vlastnosti související s vlastními koncovými body, do kterých vaše centrum IoT směruje zprávy na základě pravidel směrování. Pro placené rozbočovače je povolených maximálně 10 vlastních koncových bodů a pro bezplatná centra je povolený pouze 1 vlastní koncový bod. RoutingEndpoints
obohacení Seznam rozšíření poskytovaných uživatelem, které centrum IoT používá pro zprávy, které se mají doručovat do integrovaných a vlastních koncových bodů. Viz: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
náhradníroute Vlastnosti trasy, která se používá jako náhradní trasa, pokud nejsou splněny žádné podmínky zadané v části trasy. Jedná se o volitelný parametr. Pokud tato vlastnost není nastavená, zprávy, které nesplňují žádné podmínky zadané v části trasy, se směrují do integrovaného koncového bodu centra událostí. fallbackRouteProperties
trasy Seznam pravidel směrování poskytovaných uživatelem, která ioT Hub používá ke směrování zpráv do předdefinovaných a vlastních koncových bodů. Pro placené rozbočovače je povoleno maximálně 100 pravidel směrování a pro bezplatná centra jsou povolená maximálně 5 pravidel směrování. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu fronty služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název fronty. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu fronty služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu fronty služby Service Bus. řetězec

RoutingServiceBusTopicEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu tématu služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název tématu. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu tématu služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu tématu služby Service Bus. řetězec

RoutingStorageContainerProperties

Jméno Popis Hodnota
batchFrequencyInSeconds Časový interval, ve kterém se objekty blob zapisují do úložiště. Hodnota by měla být v rozmezí 60 až 720 sekund. Výchozí hodnota je 300 sekund. Int

Omezení:
Minimální hodnota = 60
Maximální hodnota = 720
connectionString Připojovací řetězec účtu úložiště. string (povinné)
containerName Název kontejneru úložiště v účtu úložiště. string (povinné)
kódování Kódování, které se používá k serializaci zpráv do objektů blob. Podporované hodnoty jsou avro, avrodeflate a JSON. Výchozí hodnota je avro. "Avro"
AvroDeflate
JSON
fileNameFormat Formát názvu souboru objektu blob. Výchozí formát je {iothub}/{partition}/{RRRR}/{MM}/{DD}/{HH}/{mm}. Všechny parametry jsou povinné, ale dají se změnit jejich pořadí. řetězec
maxChunkSizeInBytes Maximální počet bajtů pro každý objekt blob zapsaný do úložiště Hodnota by měla být mezi 10485760(10 MB) a 524288000(500 MB). Výchozí hodnota je 314572800(300 MB). Int

Omezení:
Minimální hodnota = 10485760
Maximální hodnota = 524288000
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků účtu úložiště. řetězec
subscriptionId Identifikátor předplatného účtu úložiště. řetězec

SharedAccessSignatureAuthorizationRule

Jméno Popis Hodnota
keyName Název zásady sdíleného přístupu. string (povinné)
primaryKey Primární klíč. řetězec
práva Oprávnění přiřazená k zásadám sdíleného přístupu. DeviceConnect
RegistrRead
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 (povinné)
secondaryKey Sekundární klíč. řetězec

StorageEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec pro účet služby Azure Storage, do kterého se soubory nahrají. string (povinné)
containerName Název kořenového kontejneru, do kterého nahráváte soubory. Kontejner nemusí existovat, ale měl by být creatable pomocí zadaného připojovacího řetězce. string (povinné)
sasTtlAsIso8601 Doba, po kterou je identifikátor URI SAS vygenerovaný službou IoT Hub pro nahrání souboru platný. Viz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují tento typ prostředku.

Šablona Popis
vytvoření prostředí s průběžnými platbami (PAYG) pomocí IoT Hubu

nasazení do Azure
Tato šablona umožňuje nasadit prostředí Time Series Insights s průběžnou platbou (Pay As You Go), které je nakonfigurované pro využívání událostí ze služby IoT Hub.
vytvoření ioT Hubu a zařízení do skupiny cloudových příjemců

nasazení do Azure
Tato šablona umožňuje nasadit instanci ioT Hubu se zařízením do cloudu a cloudu do konfigurací zasílání zpráv zařízení a zařízení do skupiny příjemců cloudu.
vytvoření simulátoru IOT Hub a Ubuntu Edge

nasazení do Azure
Tato šablona vytvoří simulátor ioT Hubu a hraničního simulátoru Ubuntu virtuálního počítače.
vytvoření služby IoT Hub Device Provisioning

nasazení do Azure
Tato šablona umožňuje vytvořit centrum IoT a službu IoT Hub Device Provisioning a propojit obě služby.
vytvoření účtu služby Device Update pro ioT Hub, instanci, službu IoT Hub

nasazení do Azure
Tato šablona vytvoří účet a instanci a centrum pro propojení instance s touto instancí. Nakonfiguruje centrum s potřebnými zásadami přístupu, trasami a skupinou příjemců.
nasazení služby MedTech, včetně služby Azure IoT Hub

nasazení do Azure
Služba MedTech je jednou ze služeb Azure Health Data Services navržená tak, aby ingestovala data zařízení z více zařízení, transformovala data zařízení na pozorování FHIR, která se pak uchovávají ve službě FHIR služby Azure Health Data Services.
Vytvoření služby IoT Hub, směrování a zobrazení zpráv pomocí šablony ARM

nasazení do Azure
Pomocí této šablony můžete nasadit IoT Hub a účet úložiště. Spuštěním aplikace odešlete zprávy do centra, které je směrováno do úložiště, a zobrazte výsledky.

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku IotHubs je možné nasadit s operacemi, které cílí:

  • skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Devices/IotHubs, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2019-11-04"
  name = "string"
  etag = "string"
  location = "string"
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "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"
            }
          ]
        }
        enrichments = [
          {
            endpointNames = [
              "string"
            ]
            key = "string"
            value = "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"
        }
      }
    }
  })
}

Hodnoty vlastností

CloudToDeviceProperties

Jméno Popis Hodnota
defaultTtlAsIso8601 Výchozí doba pro živé zprávy typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
zpětná vazba Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení FeedbackProperties
maxDeliveryCount Maximální počet doručení zpráv typu cloud-zařízení ve frontě zařízení. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100

EnrichmentProperties

Jméno Popis Hodnota
endpointNames Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
hodnota Hodnota vlastnosti rozšiřování. string (povinné)

EventHubProperties

Jméno Popis Hodnota
partitionCount Počet oddílů pro příjem zpráv typu zařízení-cloud v koncovém bodu kompatibilním s centrem událostí. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Doba uchovávání zpráv typu zařízení-cloud ve dnech. Viz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

Náhradní objektyRouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnocuje, aby se použila náhradní trasa. Pokud podmínka není za předpokladu, že se ve výchozím nastavení vyhodnotí jako true. Gramatika: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých jsou směrovány zprávy, které splňují podmínku. Aktuálně je povolený jenom 1 koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená náhradní trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec
zdroj Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

FeedbackProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání uzamčení fronty zpětné vazby. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec
maxDeliveryCount Počet pokusů centra IoT o doručení zprávy do fronty zpětné vazby Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. řetězec

IotHubProperties

Jméno Popis Hodnota
authorizationPolicies Zásady sdíleného přístupu, které můžete použít k zabezpečení připojení k centru IoT. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Vlastnosti zasílání zpráv typu cloud-zařízení ve službě IoT Hub CloudToDeviceProperties
komentáře Komentáře ke službě IoT Hub řetězec
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. Bool
eventHubEndpoints Vlastnosti koncového bodu kompatibilního s centrem událostí. Jediným možnými klíči tohoto slovníku jsou události. Tento klíč musí být ve slovníku k dispozici při vytváření nebo aktualizaci volání ioT Hubu. IotHubPropertiesEventHubEndpoints
rysy Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
ipFilterRules Pravidla filtru IP adres. IpFilterRule[]
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
storageEndpoints Seznam koncových bodů služby Azure Storage, kde můžete nahrávat soubory. V současné době můžete nakonfigurovat jenom jeden účet Azure Storage a tento klíč musí mít jako $default. Zadání více než jednoho účtu úložiště způsobí vyvolání chyby. Nezadávejte hodnotu pro tuto vlastnost, pokud je vlastnost enableFileUploadNotifications nastavena na Hodnotu True, způsobí vyvolání chyby. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Jméno Popis Hodnota

IotHubPropertiesMessagingEndpoints

Jméno Popis Hodnota

IotHubPropertiesStorageEndpoints

Jméno Popis Hodnota

IotHubSkuInfo

Jméno Popis Hodnota
kapacita Počet zřízených jednotek IoT Hubu. Viz: /azure/azure-subscription-service-limits#iot-hub-limits. Int
Jméno Název skladové položky. "B1"
"B2"
"B3"
"F1"
S1
S2
S3 (povinné)

IpFilterRule

Jméno Popis Hodnota
akce Požadovaná akce pro požadavky zachycené tímto pravidlem. Přijmout
Odmítnout (povinné)
filterName Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

MessagingEndpointProperties

Jméno Popis Hodnota
lockDurationAsIso8601 Doba trvání zámku. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec
maxDeliveryCount Počet pokusů o doručení zprávy službou IoT Hub Viz: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 100
ttlAsIso8601 Doba, po kterou je zpráva k dispozici, než jí vyprší platnost centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-file-upload. řetězec

Microsoft.Devices/IotHubs

Jméno Popis Hodnota
etag Pole Etag není povinné. Pokud je uvedený v textu odpovědi, musí se také poskytnout jako hlavička podle normální konvence značky ETag. řetězec
umístění Umístění prostředku. string (povinné)
Jméno Název prostředku string (povinné)
vlastnosti Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku "Microsoft.Devices/IotHubs@2019-11-04"

Značky prostředků

Jméno Popis Hodnota

RouteProperties

Jméno Popis Hodnota
podmínka Podmínka, která se vyhodnotí jako použití pravidla směrování. Pokud není zadanou podmínkou, vyhodnotí se ve výchozím nastavení jako true. Gramatiku najdete v tématu: /azure/iot-hub/iot-hub-devguide-query-language řetězec
endpointNames Seznam koncových bodů, do kterých se směrují zprávy, které splňují podmínku. Aktuálně je povolený jenom jeden koncový bod. string[] (povinné)
isEnabled Slouží k určení, jestli je povolená trasa. bool (povinné)
Jméno Název trasy. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky, maximální délku 64 znaků a musí být jedinečný. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
zdroj Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceJobLifecycleEvents
'DeviceLifecycleEvents'
DeviceMessages
Neplatné
TwinChangeEvents (povinné)

RoutingEndpoints

Jméno Popis Hodnota
eventHubs Seznam koncových bodů služby Event Hubs, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. Tento seznam neobsahuje integrovaný koncový bod služby Event Hubs. RoutingEventHubProperties[]
serviceBusQueues Seznam koncových bodů fronty služby Service Bus, do které Služba IoT Hub směruje zprávy na základě pravidel směrování. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Seznam koncových bodů tématu služby Service Bus, do které centrum IoT směruje zprávy na základě pravidel směrování. RoutingServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch RoutingStorageContainerProperties[]

RoutingEventHubProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu centra událostí. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu centra událostí. řetězec
subscriptionId Identifikátor odběru koncového bodu centra událostí. řetězec

RoutingProperties

Jméno Popis Hodnota
Koncové body Vlastnosti související s vlastními koncovými body, do kterých vaše centrum IoT směruje zprávy na základě pravidel směrování. Pro placené rozbočovače je povolených maximálně 10 vlastních koncových bodů a pro bezplatná centra je povolený pouze 1 vlastní koncový bod. RoutingEndpoints
obohacení Seznam rozšíření poskytovaných uživatelem, které centrum IoT používá pro zprávy, které se mají doručovat do integrovaných a vlastních koncových bodů. Viz: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
náhradníroute Vlastnosti trasy, která se používá jako náhradní trasa, pokud nejsou splněny žádné podmínky zadané v části trasy. Jedná se o volitelný parametr. Pokud tato vlastnost není nastavená, zprávy, které nesplňují žádné podmínky zadané v části trasy, se směrují do integrovaného koncového bodu centra událostí. fallbackRouteProperties
trasy Seznam pravidel směrování poskytovaných uživatelem, která ioT Hub používá ke směrování zpráv do předdefinovaných a vlastních koncových bodů. Pro placené rozbočovače je povoleno maximálně 100 pravidel směrování a pro bezplatná centra jsou povolená maximálně 5 pravidel směrování. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu fronty služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název fronty. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu fronty služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu fronty služby Service Bus. řetězec

RoutingServiceBusTopicEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec koncového bodu tématu služby Service Bus. string (povinné)
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. Název nemusí být stejný jako skutečný název tématu. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků koncového bodu tématu služby Service Bus. řetězec
subscriptionId Identifikátor předplatného koncového bodu tématu služby Service Bus. řetězec

RoutingStorageContainerProperties

Jméno Popis Hodnota
batchFrequencyInSeconds Časový interval, ve kterém se objekty blob zapisují do úložiště. Hodnota by měla být v rozmezí 60 až 720 sekund. Výchozí hodnota je 300 sekund. Int

Omezení:
Minimální hodnota = 60
Maximální hodnota = 720
connectionString Připojovací řetězec účtu úložiště. string (povinné)
containerName Název kontejneru úložiště v účtu úložiště. string (povinné)
kódování Kódování, které se používá k serializaci zpráv do objektů blob. Podporované hodnoty jsou avro, avrodeflate a JSON. Výchozí hodnota je avro. "Avro"
AvroDeflate
JSON
fileNameFormat Formát názvu souboru objektu blob. Výchozí formát je {iothub}/{partition}/{RRRR}/{MM}/{DD}/{HH}/{mm}. Všechny parametry jsou povinné, ale dají se změnit jejich pořadí. řetězec
maxChunkSizeInBytes Maximální počet bajtů pro každý objekt blob zapsaný do úložiště Hodnota by měla být mezi 10485760(10 MB) a 524288000(500 MB). Výchozí hodnota je 314572800(300 MB). Int

Omezení:
Minimální hodnota = 10485760
Maximální hodnota = 524288000
Jméno Název, který identifikuje tento koncový bod. Název může obsahovat pouze alfanumerické znaky, tečky, podtržítka, pomlčky a maximální délku 64 znaků. Následující názvy jsou vyhrazené: události, fileNotifications, $default. Názvy koncových bodů musí být v různých typech koncových bodů jedinečné. řetězec

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
resourceGroup Název skupiny prostředků účtu úložiště. řetězec
subscriptionId Identifikátor předplatného účtu úložiště. řetězec

SharedAccessSignatureAuthorizationRule

Jméno Popis Hodnota
keyName Název zásady sdíleného přístupu. string (povinné)
primaryKey Primární klíč. řetězec
práva Oprávnění přiřazená k zásadám sdíleného přístupu. DeviceConnect
RegistrRead
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 (povinné)
secondaryKey Sekundární klíč. řetězec

StorageEndpointProperties

Jméno Popis Hodnota
connectionString Připojovací řetězec pro účet služby Azure Storage, do kterého se soubory nahrají. string (povinné)
containerName Název kořenového kontejneru, do kterého nahráváte soubory. Kontejner nemusí existovat, ale měl by být creatable pomocí zadaného připojovacího řetězce. string (povinné)
sasTtlAsIso8601 Doba, po kterou je identifikátor URI SAS vygenerovaný službou IoT Hub pro nahrání souboru platný. Viz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. řetězec