Microsoft. Zařízení IotHubs 2026-03-01-preview

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.

Příklady použití

ukázky Bicep

Základní příklad nasazení IotHubu.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource iotHub 'Microsoft.Devices/IotHubs@2022-04-30-preview' = {
  name: resourceName
  location: location
  sku: {
    capacity: 1
    name: 'S1'
  }
  properties: {
    cloudToDevice: {}
    enableFileUploadNotifications: false
    messagingEndpoints: {}
    routing: {
      fallbackRoute: {
        condition: 'true'
        endpointNames: [
          'events'
        ]
        isEnabled: true
        source: 'DeviceMessages'
      }
    }
    storageEndpoints: {}
  }
}

Ukázky rychlého startu Azure

Následující šablony Azure pro rychlý start obsahují ukázky Bicep pro nasazení tohoto typu prostředku.

Soubor Bicep Description
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 jedním z Azure Health Data Services navržených tak, aby ingestovala data zařízení z více zařízení, transformovala data zařízení na FHIR Observations, které se pak uchovávají ve službě Azure Health Data Services FHIR.
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.

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@2026-03-01-preview' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    cloudToDevice: {
      defaultTtlAsIso8601: 'string'
      feedback: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
      maxDeliveryCount: int
    }
    comments: 'string'
    deviceRegistry: {
      identityResourceId: 'string'
      namespaceResourceId: 'string'
    }
    deviceStreams: {
      streamingEndpoints: [
        'string'
      ]
    }
    disableDeviceSAS: bool
    disableLocalAuth: bool
    disableModuleSAS: bool
    enableDataResidency: bool
    enableFileUploadNotifications: bool
    encryption: {
      keySource: 'string'
      keyVaultProperties: [
        {
          identity: {
            userAssignedIdentity: 'string'
          }
          keyIdentifier: 'string'
        }
      ]
    }
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    ipVersion: 'string'
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    minTlsVersion: 'string'
    networkRuleSets: {
      applyToBuiltInEventHubEndpoint: bool
      defaultAction: 'string'
      ipRules: [
        {
          action: 'string'
          filterName: 'string'
          ipMask: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    restrictOutboundNetworkAccess: bool
    rootCertificate: {
      enableRootCertificateV2: bool
    }
    routing: {
      endpoints: {
        cosmosDBSqlContainers: [
          {
            authenticationType: 'string'
            containerName: 'string'
            databaseName: 'string'
            endpointUri: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            partitionKeyName: 'string'
            partitionKeyTemplate: 'string'
            primaryKey: 'string'
            resourceGroup: 'string'
            secondaryKey: 'string'
            subscriptionId: 'string'
          }
        ]
        eventHubs: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            authenticationType: 'string'
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            endpointUri: 'string'
            fileNameFormat: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: '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}: {
        authenticationType: 'string'
        connectionString: 'string'
        containerName: 'string'
        identity: {
          userAssignedIdentity: 'string'
        }
        sasTtlAsIso8601: 'string'
      }
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Hodnoty vlastností

Microsoft. Zařízení / IotHubs

název Description Value
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
identita Spravované identity pro IotHub. ArmIdentita
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
název Název prostředku string (povinné)
properties Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

ArmIdentita

název Description Value
typ Typ identity používané pro prostředek. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere ze služby všechny identity. None (Žádný)
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Slovník <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

název Description Value

ArmUserIdentity

název Description Value

CloudToDeviceProperties

název Description Value
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
názory Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení Vlastnosti zpětné vazby
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

Registr zařízení

název Description Value
ID prostředku identity Identita používaná ke správě oboru názvů ADR z roviny dat. řetězec
jmenný prostorResourceId Identifikátor jmenného prostoru Azure Device Registry řetězec

EncryptionPropertiesDescription

název Description Value
Zdroj klíčů Zdroj klíče. řetězec
vlastnosti trezoru klíčů Vlastnosti klíče keyVault. keyVaultKeyProperties[]

Vlastnosti rozšíření

název Description Value
Názvy koncových bodů Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
value Hodnota vlastnosti rozšiřování. string (povinné)

Vlastnosti EventHubu

název Description Value
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

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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
odeslat k provedení Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

Vlastnosti zpětné vazby

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

Vlastnosti IotHubu

název Description Value
allowedFqdnList Seznam povolených plně kvalifikovaných názvů domén (plně kvalifikovaný název domény) pro výchozí přenos dat ze služby Iot Hub řetězec[]
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
comments Komentáře ke službě IoT Hub řetězec
Registr zařízení Představuje vlastnosti související s registrem zařízení Azure (ADR). Registr zařízení
deviceStreams Zařízení streamuje vlastnosti iothubu. IotHubPropertiesDeviceStreams
disableDeviceSAS Pokud je hodnota true, všechna zařízení (včetně zařízení Edge, ale s výjimkou modulů) s vymezeným oborem SAS se nedají použít k ověřování. bool
disableLocalAuth Pokud je pravda, tokeny SAS s klíči SAS s vymezeným oborem služby Iot Hub se nedají použít k ověřování. bool
disableModuleSAS Pokud je pravda, nelze pro ověřování použít všechny klíče SAS s vymezeným oborem modulu. bool
enableDataResidency Tato vlastnost při nastavení na hodnotu true povolí rezidenci dat, a tím zakáže zotavení po havárii. bool
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. bool
šifrování Vlastnosti šifrování pro centrum IoT. encryptionPropertiesDescription
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
features Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
Pravidla filtru ipFilterRules Pravidla filtru IP adres. Pravidlo filtru IP[]
ipVersion Tato vlastnost určuje verzi PROTOKOLU IP, která centrum aktuálně využívá. Ipv4
Ipv4ipv6
Ipv6
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
Verze minTls Určuje minimální verzi protokolu TLS, která se má pro toto centrum podporovat. Můžete nastavit na 1.2, aby klienti, kteří používají protokol TLS verze nižší než 1.2, mohli odmítnout. řetězec
networkRuleSets Vlastnosti sady pravidel sítě iotHubu NetworkRuleSetProperties
privateEndpointConnections Připojení privátního koncového bodu vytvořená na tomto IotHubu PrivateEndpointConnection[]
publicNetworkAccess Jestli jsou povolené požadavky z veřejné sítě Zakázáno
Povoleno
restrictOutboundNetworkAccess Pokud ano, výchozí přenos dat z IotHubu se omezí jenom na povolené plně kvalifikované názvy domén nakonfigurované přes allowedFqdnList. bool
kořenový_certifikát Tato vlastnost ukládá informace související s kořenovým certifikátem. rootCertificateProperties
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
Koncové body úložiště 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

IotHubPropertiesDeviceStreams

název Description Value
streamingEndpoints Seznam koncových bodů streamů zařízení řetězec[]

IotHubPropertiesEventHubEndpoints

název Description Value

IotHubPropertiesMessagingEndpoints

název Description Value

IotHubPropertiesStorageEndpoints

název Description Value

IotHubSkuInfo

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

Pravidlo filtru IPPr1

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

Vlastnosti klíče v trezoru klíčů

název Description Value
identita Vlastnosti spravované identity klíče služby KeyVault ManagedIdentity
identifikátor klíče Identifikátor klíče. řetězec

ManagedIdentity

název Description Value
userAssignedIdentity Identita přiřazená uživatelem. řetězec

MessagingEndpointProperties

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

NetworkRuleSetIpRule

název Description Value
akce Akce filtru IP adres Povolit
název_filtru Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

NetworkRuleSetProperties

název Description Value
applyToBuiltInEventHubEndpoint Pokud je hodnota True, použije se sada pravidel sítě také u koncového bodu BuiltIn EventHubu iotHubu. bool (povinné)
Výchozí akce Výchozí akce pro sadu pravidel sítě Povolit
"Odepřít"
IpRules Seznam pravidel PROTOKOLU IP NetworkRuleSetIpRule[] (povinné)

PrivateEndpoint

název Description Value

PrivateEndpointConnection

název Description Value
properties Vlastnosti připojení privátního koncového bodu privateEndpointConnectionProperties (povinné)

PrivateEndpointConnectionProperties

název Description Value
privateEndpoint Vlastnost privátního koncového bodu připojení privátního koncového bodu PrivateEndpoint
privateLinkServiceConnectionState Aktuální stav připojení privátního koncového bodu PrivateLinkServiceConnectionState (povinné)

PrivateLinkServiceConnectionState

název Description Value
ActionsRequired Akce vyžadované pro připojení privátního koncového bodu řetězec
popis Popis aktuálního stavu připojení privátního koncového bodu string (povinné)
stav Stav připojení privátního koncového bodu "Schváleno"
Odpojeno
Čeká na vyřízení
Odmítnuto (povinné)

Vlastnosti kořenového_certifikátu

název Description Value
enableRootCertificateV2 Tato vlastnost, pokud je nastavena na hodnotu true, hub bude používat certifikát G2; zatímco je nastavená na false, centrum používá Baltimore Cert. bool

Vlastnosti trasy

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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ý. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
odeslat k provedení Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

SměrováníCosmosDBSqlApiVlastnosti

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu kontejneru SQL služby Cosmos DB IdentityBased
KeyBased
containerName Název kontejneru SQL cosmos DB v databázi cosmos DB. string (povinné)
databaseName Název databáze cosmos DB v účtu cosmos DB. string (povinné)
endpointUri Adresa URL účtu cosmos DB. Musí obsahovat protokol https:// string (povinné)
identita Vlastnosti spravované identity směrování koncového bodu kontejneru cosmos DB ManagedIdentity
název 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é. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
název klíče oddílu Název klíče oddílu přidruženého k tomuto kontejneru SQL cosmos DB, pokud existuje. Jedná se o volitelný parametr. řetězec
šablonaKlíčeOddílu Šablona pro generování hodnoty syntetického klíče oddílu pro použití s tímto kontejnerem SQL služby Cosmos DB. Šablona musí obsahovat alespoň jeden z následujících zástupných symbolů: {iothub}, {deviceid}, {DD}, {MM} a {YYYY}. Všechny zástupné symboly mohou být zadány najednou, ale pořadí a neschybné součásti jsou libovolné. Tento parametr se vyžaduje pouze v případě, že je zadaný název PartitionKeyName. řetězec
primární klíč Primární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
resourceGroup Název skupiny prostředků účtu cosmos DB. řetězec
sekundární klíč Sekundární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
subscriptionId Identifikátor předplatného účtu cosmos DB. řetězec

Koncové body směrování

název Description Value
CosmosDBSqlContainers Seznam koncových bodů kontejneru Cosmos DB, do které IoT Hub směruje zprávy na základě pravidel směrování. SměrováníCosmosDBSqlApiProperties[]
Centra událostí 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. SměrováníEventHubProperties[]
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í. SměrováníServiceBusQueueEndpointProperties[]
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í. SměrováníServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch SměrováníStorageContainerProperties[]

Vlastnosti RoutingEventHubu

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu centra událostí IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu centra událostí. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu centra událostí. Musí obsahovat protokol sb:// řetězec
entityPath Název centra událostí v oboru názvů centra událostí řetězec
id ID koncového bodu centra událostí řetězec
identita Vlastnosti spravované identity koncového bodu centra událostí směrování ManagedIdentity
název 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é. string

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

Vlastnosti směrování

název Description Value
endpoints 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 Vlastnosti obohacení[]
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í. Vlastnosti trasy[]

SměrováníServiceBusQueueEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření vůči koncovému bodu fronty služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu fronty služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu fronty služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v oboru názvů služby Service Bus řetězec
id ID koncového bodu fronty služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu fronty služby Service Bus ManagedIdentity
název 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. string

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

SměrováníBusTopicEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu tématu služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu tématu služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu tématu služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v tématu služby Service Bus řetězec
id ID koncového bodu tématu služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu tématu služby Service Bus směrování ManagedIdentity
název 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. string

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

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu úložiště IdentityBased
KeyBased
DávkaFrekvenceVSekundy Č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
connection string Připojovací řetězec účtu úložiště. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
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
endpointUri Adresa URL koncového bodu úložiště. Musí obsahovat protokol https:// řetězec
Formát názvu souboru 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
id ID koncového bodu kontejneru úložiště řetězec
identita Vlastnosti spravované identity koncového bodu úložiště směrování ManagedIdentity
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
název 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é. string

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

název Description Value
keyName Název zásady sdíleného přístupu. string (povinné)
primární klíč 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é)
sekundární klíč Sekundární klíč. řetězec

Vlastnosti koncového bodu úložiště

název Description Value
authenticationType Určuje typ ověřování, který se používá pro připojení k účtu úložiště. IdentityBased
KeyBased
connection string 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é)
identita Vlastnosti spravované identity koncového bodu úložiště pro nahrání souboru ManagedIdentity
sasTtlAsIso8601 řekl: 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

TrackedResourceTags

název Description Value

Definice prostředku šablony ARM

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

Příklady použití

šablony pro rychlý start pro Azure

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Template Description
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 jedním z Azure Health Data Services navržených tak, aby ingestovala data zařízení z více zařízení, transformovala data zařízení na FHIR Observations, které se pak uchovávají ve službě Azure Health Data Services FHIR.
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.

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": "2026-03-01-preview",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "cloudToDevice": {
      "defaultTtlAsIso8601": "string",
      "feedback": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      },
      "maxDeliveryCount": "int"
    },
    "comments": "string",
    "deviceRegistry": {
      "identityResourceId": "string",
      "namespaceResourceId": "string"
    },
    "deviceStreams": {
      "streamingEndpoints": [ "string" ]
    },
    "disableDeviceSAS": "bool",
    "disableLocalAuth": "bool",
    "disableModuleSAS": "bool",
    "enableDataResidency": "bool",
    "enableFileUploadNotifications": "bool",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": [
        {
          "identity": {
            "userAssignedIdentity": "string"
          },
          "keyIdentifier": "string"
        }
      ]
    },
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "ipVersion": "string",
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "minTlsVersion": "string",
    "networkRuleSets": {
      "applyToBuiltInEventHubEndpoint": "bool",
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "string",
          "filterName": "string",
          "ipMask": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "restrictOutboundNetworkAccess": "bool",
    "rootCertificate": {
      "enableRootCertificateV2": "bool"
    },
    "routing": {
      "endpoints": {
        "cosmosDBSqlContainers": [
          {
            "authenticationType": "string",
            "containerName": "string",
            "databaseName": "string",
            "endpointUri": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "partitionKeyName": "string",
            "partitionKeyTemplate": "string",
            "primaryKey": "string",
            "resourceGroup": "string",
            "secondaryKey": "string",
            "subscriptionId": "string"
          }
        ],
        "eventHubs": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "authenticationType": "string",
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "endpointUri": "string",
            "fileNameFormat": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "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}": {
        "authenticationType": "string",
        "connectionString": "string",
        "containerName": "string",
        "identity": {
          "userAssignedIdentity": "string"
        },
        "sasTtlAsIso8601": "string"
      }
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Hodnoty vlastností

Microsoft. Zařízení / IotHubs

název Description Value
apiVersion Verze rozhraní API 'Náhled 1. 3. 2026'
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
identita Spravované identity pro IotHub. ArmIdentita
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
název Název prostředku string (povinné)
properties Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku 'Microsoft. Zařízení/IotHuby

ArmIdentita

název Description Value
typ Typ identity používané pro prostředek. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere ze služby všechny identity. None (Žádný)
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Slovník <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

název Description Value

ArmUserIdentity

název Description Value

CloudToDeviceProperties

název Description Value
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
názory Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení Vlastnosti zpětné vazby
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

Registr zařízení

název Description Value
ID prostředku identity Identita používaná ke správě oboru názvů ADR z roviny dat. řetězec
jmenný prostorResourceId Identifikátor jmenného prostoru Azure Device Registry řetězec

EncryptionPropertiesDescription

název Description Value
Zdroj klíčů Zdroj klíče. řetězec
vlastnosti trezoru klíčů Vlastnosti klíče keyVault. keyVaultKeyProperties[]

Vlastnosti rozšíření

název Description Value
Názvy koncových bodů Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
value Hodnota vlastnosti rozšiřování. string (povinné)

Vlastnosti EventHubu

název Description Value
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

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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
odeslat k provedení Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

Vlastnosti zpětné vazby

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

Vlastnosti IotHubu

název Description Value
allowedFqdnList Seznam povolených plně kvalifikovaných názvů domén (plně kvalifikovaný název domény) pro výchozí přenos dat ze služby Iot Hub řetězec[]
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
comments Komentáře ke službě IoT Hub řetězec
Registr zařízení Představuje vlastnosti související s registrem zařízení Azure (ADR). Registr zařízení
deviceStreams Zařízení streamuje vlastnosti iothubu. IotHubPropertiesDeviceStreams
disableDeviceSAS Pokud je hodnota true, všechna zařízení (včetně zařízení Edge, ale s výjimkou modulů) s vymezeným oborem SAS se nedají použít k ověřování. bool
disableLocalAuth Pokud je pravda, tokeny SAS s klíči SAS s vymezeným oborem služby Iot Hub se nedají použít k ověřování. bool
disableModuleSAS Pokud je pravda, nelze pro ověřování použít všechny klíče SAS s vymezeným oborem modulu. bool
enableDataResidency Tato vlastnost při nastavení na hodnotu true povolí rezidenci dat, a tím zakáže zotavení po havárii. bool
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. bool
šifrování Vlastnosti šifrování pro centrum IoT. encryptionPropertiesDescription
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
features Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
Pravidla filtru ipFilterRules Pravidla filtru IP adres. Pravidlo filtru IP[]
ipVersion Tato vlastnost určuje verzi PROTOKOLU IP, která centrum aktuálně využívá. Ipv4
Ipv4ipv6
Ipv6
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
Verze minTls Určuje minimální verzi protokolu TLS, která se má pro toto centrum podporovat. Můžete nastavit na 1.2, aby klienti, kteří používají protokol TLS verze nižší než 1.2, mohli odmítnout. řetězec
networkRuleSets Vlastnosti sady pravidel sítě iotHubu NetworkRuleSetProperties
privateEndpointConnections Připojení privátního koncového bodu vytvořená na tomto IotHubu PrivateEndpointConnection[]
publicNetworkAccess Jestli jsou povolené požadavky z veřejné sítě Zakázáno
Povoleno
restrictOutboundNetworkAccess Pokud ano, výchozí přenos dat z IotHubu se omezí jenom na povolené plně kvalifikované názvy domén nakonfigurované přes allowedFqdnList. bool
kořenový_certifikát Tato vlastnost ukládá informace související s kořenovým certifikátem. rootCertificateProperties
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
Koncové body úložiště 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

IotHubPropertiesDeviceStreams

název Description Value
streamingEndpoints Seznam koncových bodů streamů zařízení řetězec[]

IotHubPropertiesEventHubEndpoints

název Description Value

IotHubPropertiesMessagingEndpoints

název Description Value

IotHubPropertiesStorageEndpoints

název Description Value

IotHubSkuInfo

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

Pravidlo filtru IPPr1

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

Vlastnosti klíče v trezoru klíčů

název Description Value
identita Vlastnosti spravované identity klíče služby KeyVault ManagedIdentity
identifikátor klíče Identifikátor klíče. řetězec

ManagedIdentity

název Description Value
userAssignedIdentity Identita přiřazená uživatelem. řetězec

MessagingEndpointProperties

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

NetworkRuleSetIpRule

název Description Value
akce Akce filtru IP adres Povolit
název_filtru Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

NetworkRuleSetProperties

název Description Value
applyToBuiltInEventHubEndpoint Pokud je hodnota True, použije se sada pravidel sítě také u koncového bodu BuiltIn EventHubu iotHubu. bool (povinné)
Výchozí akce Výchozí akce pro sadu pravidel sítě Povolit
"Odepřít"
IpRules Seznam pravidel PROTOKOLU IP NetworkRuleSetIpRule[] (povinné)

PrivateEndpoint

název Description Value

PrivateEndpointConnection

název Description Value
properties Vlastnosti připojení privátního koncového bodu privateEndpointConnectionProperties (povinné)

PrivateEndpointConnectionProperties

název Description Value
privateEndpoint Vlastnost privátního koncového bodu připojení privátního koncového bodu PrivateEndpoint
privateLinkServiceConnectionState Aktuální stav připojení privátního koncového bodu PrivateLinkServiceConnectionState (povinné)

PrivateLinkServiceConnectionState

název Description Value
ActionsRequired Akce vyžadované pro připojení privátního koncového bodu řetězec
popis Popis aktuálního stavu připojení privátního koncového bodu string (povinné)
stav Stav připojení privátního koncového bodu "Schváleno"
Odpojeno
Čeká na vyřízení
Odmítnuto (povinné)

Vlastnosti kořenového_certifikátu

název Description Value
enableRootCertificateV2 Tato vlastnost, pokud je nastavena na hodnotu true, hub bude používat certifikát G2; zatímco je nastavená na false, centrum používá Baltimore Cert. bool

Vlastnosti trasy

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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ý. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
odeslat k provedení Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

SměrováníCosmosDBSqlApiVlastnosti

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu kontejneru SQL služby Cosmos DB IdentityBased
KeyBased
containerName Název kontejneru SQL cosmos DB v databázi cosmos DB. string (povinné)
databaseName Název databáze cosmos DB v účtu cosmos DB. string (povinné)
endpointUri Adresa URL účtu cosmos DB. Musí obsahovat protokol https:// string (povinné)
identita Vlastnosti spravované identity směrování koncového bodu kontejneru cosmos DB ManagedIdentity
název 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é. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
název klíče oddílu Název klíče oddílu přidruženého k tomuto kontejneru SQL cosmos DB, pokud existuje. Jedná se o volitelný parametr. řetězec
šablonaKlíčeOddílu Šablona pro generování hodnoty syntetického klíče oddílu pro použití s tímto kontejnerem SQL služby Cosmos DB. Šablona musí obsahovat alespoň jeden z následujících zástupných symbolů: {iothub}, {deviceid}, {DD}, {MM} a {YYYY}. Všechny zástupné symboly mohou být zadány najednou, ale pořadí a neschybné součásti jsou libovolné. Tento parametr se vyžaduje pouze v případě, že je zadaný název PartitionKeyName. řetězec
primární klíč Primární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
resourceGroup Název skupiny prostředků účtu cosmos DB. řetězec
sekundární klíč Sekundární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
subscriptionId Identifikátor předplatného účtu cosmos DB. řetězec

Koncové body směrování

název Description Value
CosmosDBSqlContainers Seznam koncových bodů kontejneru Cosmos DB, do které IoT Hub směruje zprávy na základě pravidel směrování. SměrováníCosmosDBSqlApiProperties[]
Centra událostí 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. SměrováníEventHubProperties[]
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í. SměrováníServiceBusQueueEndpointProperties[]
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í. SměrováníServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch SměrováníStorageContainerProperties[]

Vlastnosti RoutingEventHubu

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu centra událostí IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu centra událostí. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu centra událostí. Musí obsahovat protokol sb:// řetězec
entityPath Název centra událostí v oboru názvů centra událostí řetězec
id ID koncového bodu centra událostí řetězec
identita Vlastnosti spravované identity koncového bodu centra událostí směrování ManagedIdentity
název 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é. string

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

Vlastnosti směrování

název Description Value
endpoints 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 Vlastnosti obohacení[]
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í. Vlastnosti trasy[]

SměrováníServiceBusQueueEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření vůči koncovému bodu fronty služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu fronty služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu fronty služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v oboru názvů služby Service Bus řetězec
id ID koncového bodu fronty služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu fronty služby Service Bus ManagedIdentity
název 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. string

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

SměrováníBusTopicEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu tématu služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu tématu služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu tématu služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v tématu služby Service Bus řetězec
id ID koncového bodu tématu služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu tématu služby Service Bus směrování ManagedIdentity
název 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. string

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

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu úložiště IdentityBased
KeyBased
DávkaFrekvenceVSekundy Č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
connection string Připojovací řetězec účtu úložiště. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
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
endpointUri Adresa URL koncového bodu úložiště. Musí obsahovat protokol https:// řetězec
Formát názvu souboru 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
id ID koncového bodu kontejneru úložiště řetězec
identita Vlastnosti spravované identity koncového bodu úložiště směrování ManagedIdentity
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
název 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é. string

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

název Description Value
keyName Název zásady sdíleného přístupu. string (povinné)
primární klíč 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é)
sekundární klíč Sekundární klíč. řetězec

Vlastnosti koncového bodu úložiště

název Description Value
authenticationType Určuje typ ověřování, který se používá pro připojení k účtu úložiště. IdentityBased
KeyBased
connection string 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é)
identita Vlastnosti spravované identity koncového bodu úložiště pro nahrání souboru ManagedIdentity
sasTtlAsIso8601 řekl: 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

TrackedResourceTags

název Description Value

Definice prostředku Terraformu (poskytovatel AzAPI)

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

  • Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení IotHubu.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "IotHub" {
  type      = "Microsoft.Devices/IotHubs@2022-04-30-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      cloudToDevice = {
      }
      enableFileUploadNotifications = false
      messagingEndpoints = {
      }
      routing = {
        fallbackRoute = {
          condition = "true"
          endpointNames = [
            "events",
          ]
          isEnabled = true
          source    = "DeviceMessages"
        }
      }
      storageEndpoints = {
      }
    }
    sku = {
      capacity = 1
      name     = "S1"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

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@2026-03-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    etag = "string"
    properties = {
      allowedFqdnList = [
        "string"
      ]
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      deviceRegistry = {
        identityResourceId = "string"
        namespaceResourceId = "string"
      }
      deviceStreams = {
        streamingEndpoints = [
          "string"
        ]
      }
      disableDeviceSAS = bool
      disableLocalAuth = bool
      disableModuleSAS = bool
      enableDataResidency = bool
      enableFileUploadNotifications = bool
      encryption = {
        keySource = "string"
        keyVaultProperties = [
          {
            identity = {
              userAssignedIdentity = "string"
            }
            keyIdentifier = "string"
          }
        ]
      }
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      ipVersion = "string"
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      minTlsVersion = "string"
      networkRuleSets = {
        applyToBuiltInEventHubEndpoint = bool
        defaultAction = "string"
        ipRules = [
          {
            action = "string"
            filterName = "string"
            ipMask = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      restrictOutboundNetworkAccess = bool
      rootCertificate = {
        enableRootCertificateV2 = bool
      }
      routing = {
        endpoints = {
          cosmosDBSqlContainers = [
            {
              authenticationType = "string"
              containerName = "string"
              databaseName = "string"
              endpointUri = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              partitionKeyName = "string"
              partitionKeyTemplate = "string"
              primaryKey = "string"
              resourceGroup = "string"
              secondaryKey = "string"
              subscriptionId = "string"
            }
          ]
          eventHubs = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              authenticationType = "string"
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              endpointUri = "string"
              fileNameFormat = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "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} = {
          authenticationType = "string"
          connectionString = "string"
          containerName = "string"
          identity = {
            userAssignedIdentity = "string"
          }
          sasTtlAsIso8601 = "string"
        }
      }
    }
    sku = {
      capacity = int
      name = "string"
    }
  }
}

Hodnoty vlastností

Microsoft. Zařízení / IotHubs

název Description Value
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
identita Spravované identity pro IotHub. ArmIdentita
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
název Název prostředku string (povinné)
properties Vlastnosti IotHubu IotHubProperties
sku Informace o skladové posílce IotHubu IotHubSkuInfo (povinné)
tags Štítky prostředků Slovník názvů a hodnot značek
typ Typ prostředku "Microsoft. Zařízení/IotHubs@2026-03-01-preview"

ArmIdentita

název Description Value
typ Typ identity používané pro prostředek. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere ze služby všechny identity. None (Žádný)
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Slovník <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

název Description Value

ArmUserIdentity

název Description Value

CloudToDeviceProperties

název Description Value
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
názory Vlastnosti fronty zpětné vazby pro zprávy typu cloud-zařízení Vlastnosti zpětné vazby
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

Registr zařízení

název Description Value
ID prostředku identity Identita používaná ke správě oboru názvů ADR z roviny dat. řetězec
jmenný prostorResourceId Identifikátor jmenného prostoru Azure Device Registry řetězec

EncryptionPropertiesDescription

název Description Value
Zdroj klíčů Zdroj klíče. řetězec
vlastnosti trezoru klíčů Vlastnosti klíče keyVault. keyVaultKeyProperties[]

Vlastnosti rozšíření

název Description Value
Názvy koncových bodů Seznamkoncovýchch string[] (povinné)
klíč Klíč nebo název vlastnosti rozšiřování. string (povinné)
value Hodnota vlastnosti rozšiřování. string (povinné)

Vlastnosti EventHubu

název Description Value
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

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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
odeslat k provedení Zdroj, na který se má pravidlo směrování použít. Například DeviceMessages DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

Vlastnosti zpětné vazby

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

Vlastnosti IotHubu

název Description Value
allowedFqdnList Seznam povolených plně kvalifikovaných názvů domén (plně kvalifikovaný název domény) pro výchozí přenos dat ze služby Iot Hub řetězec[]
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
comments Komentáře ke službě IoT Hub řetězec
Registr zařízení Představuje vlastnosti související s registrem zařízení Azure (ADR). Registr zařízení
deviceStreams Zařízení streamuje vlastnosti iothubu. IotHubPropertiesDeviceStreams
disableDeviceSAS Pokud je hodnota true, všechna zařízení (včetně zařízení Edge, ale s výjimkou modulů) s vymezeným oborem SAS se nedají použít k ověřování. bool
disableLocalAuth Pokud je pravda, tokeny SAS s klíči SAS s vymezeným oborem služby Iot Hub se nedají použít k ověřování. bool
disableModuleSAS Pokud je pravda, nelze pro ověřování použít všechny klíče SAS s vymezeným oborem modulu. bool
enableDataResidency Tato vlastnost při nastavení na hodnotu true povolí rezidenci dat, a tím zakáže zotavení po havárii. bool
enableFileUploadNotifications Pokud je true, oznámení o nahrání souboru jsou povolená. bool
šifrování Vlastnosti šifrování pro centrum IoT. encryptionPropertiesDescription
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
features Možnosti a funkce povolené pro Centrum IoT. DeviceManagement
None (Žádný)
Pravidla filtru ipFilterRules Pravidla filtru IP adres. Pravidlo filtru IP[]
ipVersion Tato vlastnost určuje verzi PROTOKOLU IP, která centrum aktuálně využívá. Ipv4
Ipv4ipv6
Ipv6
messagingEndpoints Vlastnosti koncového bodu zasílání zpráv pro frontu oznámení pro nahrání souboru. IotHubPropertiesMessagingEndpoints
Verze minTls Určuje minimální verzi protokolu TLS, která se má pro toto centrum podporovat. Můžete nastavit na 1.2, aby klienti, kteří používají protokol TLS verze nižší než 1.2, mohli odmítnout. řetězec
networkRuleSets Vlastnosti sady pravidel sítě iotHubu NetworkRuleSetProperties
privateEndpointConnections Připojení privátního koncového bodu vytvořená na tomto IotHubu PrivateEndpointConnection[]
publicNetworkAccess Jestli jsou povolené požadavky z veřejné sítě Zakázáno
Povoleno
restrictOutboundNetworkAccess Pokud ano, výchozí přenos dat z IotHubu se omezí jenom na povolené plně kvalifikované názvy domén nakonfigurované přes allowedFqdnList. bool
kořenový_certifikát Tato vlastnost ukládá informace související s kořenovým certifikátem. rootCertificateProperties
směrování Vlastnosti související se směrováním centra IoT. Viz: /azure/iot-hub/iot-hub-devguide-messaging routingProperties
Koncové body úložiště 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

IotHubPropertiesDeviceStreams

název Description Value
streamingEndpoints Seznam koncových bodů streamů zařízení řetězec[]

IotHubPropertiesEventHubEndpoints

název Description Value

IotHubPropertiesMessagingEndpoints

název Description Value

IotHubPropertiesStorageEndpoints

název Description Value

IotHubSkuInfo

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

Pravidlo filtru IPPr1

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

Vlastnosti klíče v trezoru klíčů

název Description Value
identita Vlastnosti spravované identity klíče služby KeyVault ManagedIdentity
identifikátor klíče Identifikátor klíče. řetězec

ManagedIdentity

název Description Value
userAssignedIdentity Identita přiřazená uživatelem. řetězec

MessagingEndpointProperties

název Description Value
lockDurationAsIso8601 řekl: 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 řekl: 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

NetworkRuleSetIpRule

název Description Value
akce Akce filtru IP adres Povolit
název_filtru Název pravidla filtru IP adres. string (povinné)
ipMask Řetězec, který obsahuje rozsah IP adres v zápisu CIDR pravidla. string (povinné)

NetworkRuleSetProperties

název Description Value
applyToBuiltInEventHubEndpoint Pokud je hodnota True, použije se sada pravidel sítě také u koncového bodu BuiltIn EventHubu iotHubu. bool (povinné)
Výchozí akce Výchozí akce pro sadu pravidel sítě Povolit
"Odepřít"
IpRules Seznam pravidel PROTOKOLU IP NetworkRuleSetIpRule[] (povinné)

PrivateEndpoint

název Description Value

PrivateEndpointConnection

název Description Value
properties Vlastnosti připojení privátního koncového bodu privateEndpointConnectionProperties (povinné)

PrivateEndpointConnectionProperties

název Description Value
privateEndpoint Vlastnost privátního koncového bodu připojení privátního koncového bodu PrivateEndpoint
privateLinkServiceConnectionState Aktuální stav připojení privátního koncového bodu PrivateLinkServiceConnectionState (povinné)

PrivateLinkServiceConnectionState

název Description Value
ActionsRequired Akce vyžadované pro připojení privátního koncového bodu řetězec
popis Popis aktuálního stavu připojení privátního koncového bodu string (povinné)
stav Stav připojení privátního koncového bodu "Schváleno"
Odpojeno
Čeká na vyřízení
Odmítnuto (povinné)

Vlastnosti kořenového_certifikátu

název Description Value
enableRootCertificateV2 Tato vlastnost, pokud je nastavena na hodnotu true, hub bude používat certifikát G2; zatímco je nastavená na false, centrum používá Baltimore Cert. bool

Vlastnosti trasy

název Description Value
condition 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
Názvy koncových bodů 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é)
název 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ý. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
odeslat k provedení Zdroj, na který se má pravidlo směrování použít, například DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
'Události životního cyklu zařízení'
DeviceMessages
DigitalTwinChangeEvents
'Invalid'
MqttBrokerMessages
TwinChangeEvents (povinné)

SměrováníCosmosDBSqlApiVlastnosti

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu kontejneru SQL služby Cosmos DB IdentityBased
KeyBased
containerName Název kontejneru SQL cosmos DB v databázi cosmos DB. string (povinné)
databaseName Název databáze cosmos DB v účtu cosmos DB. string (povinné)
endpointUri Adresa URL účtu cosmos DB. Musí obsahovat protokol https:// string (povinné)
identita Vlastnosti spravované identity směrování koncového bodu kontejneru cosmos DB ManagedIdentity
název 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é. string

Omezení:
Model = ^[A-Za-z0-9-._]{1,64}$ (povinné)
název klíče oddílu Název klíče oddílu přidruženého k tomuto kontejneru SQL cosmos DB, pokud existuje. Jedná se o volitelný parametr. řetězec
šablonaKlíčeOddílu Šablona pro generování hodnoty syntetického klíče oddílu pro použití s tímto kontejnerem SQL služby Cosmos DB. Šablona musí obsahovat alespoň jeden z následujících zástupných symbolů: {iothub}, {deviceid}, {DD}, {MM} a {YYYY}. Všechny zástupné symboly mohou být zadány najednou, ale pořadí a neschybné součásti jsou libovolné. Tento parametr se vyžaduje pouze v případě, že je zadaný název PartitionKeyName. řetězec
primární klíč Primární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
resourceGroup Název skupiny prostředků účtu cosmos DB. řetězec
sekundární klíč Sekundární klíč účtu cosmos DB. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
subscriptionId Identifikátor předplatného účtu cosmos DB. řetězec

Koncové body směrování

název Description Value
CosmosDBSqlContainers Seznam koncových bodů kontejneru Cosmos DB, do které IoT Hub směruje zprávy na základě pravidel směrování. SměrováníCosmosDBSqlApiProperties[]
Centra událostí 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. SměrováníEventHubProperties[]
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í. SměrováníServiceBusQueueEndpointProperties[]
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í. SměrováníServiceBusTopicEndpointProperties[]
storageContainers Seznam koncovýchbodůch SměrováníStorageContainerProperties[]

Vlastnosti RoutingEventHubu

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu centra událostí IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu centra událostí. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu centra událostí. Musí obsahovat protokol sb:// řetězec
entityPath Název centra událostí v oboru názvů centra událostí řetězec
id ID koncového bodu centra událostí řetězec
identita Vlastnosti spravované identity koncového bodu centra událostí směrování ManagedIdentity
název 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é. string

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

Vlastnosti směrování

název Description Value
endpoints 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 Vlastnosti obohacení[]
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í. Vlastnosti trasy[]

SměrováníServiceBusQueueEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření vůči koncovému bodu fronty služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu fronty služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu fronty služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v oboru názvů služby Service Bus řetězec
id ID koncového bodu fronty služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu fronty služby Service Bus ManagedIdentity
název 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. string

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

SměrováníBusTopicEndpointProperties

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu tématu služby Service Bus IdentityBased
KeyBased
connection string Připojovací řetězec koncového bodu tématu služby Service Bus. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
endpointUri Adresa URL koncového bodu tématu služby Service Bus. Musí obsahovat protokol sb:// řetězec
entityPath Název fronty v tématu služby Service Bus řetězec
id ID koncového bodu tématu služby Service Bus řetězec
identita Vlastnosti spravované identity koncového bodu tématu služby Service Bus směrování ManagedIdentity
název 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. string

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

název Description Value
authenticationType Metoda použitá k ověření v koncovém bodu úložiště IdentityBased
KeyBased
DávkaFrekvenceVSekundy Č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
connection string Připojovací řetězec účtu úložiště. string

Omezení:
Citlivá hodnota. Předejte ho jako zabezpečený parametr.
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
endpointUri Adresa URL koncového bodu úložiště. Musí obsahovat protokol https:// řetězec
Formát názvu souboru 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
id ID koncového bodu kontejneru úložiště řetězec
identita Vlastnosti spravované identity koncového bodu úložiště směrování ManagedIdentity
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
název 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é. string

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

název Description Value
keyName Název zásady sdíleného přístupu. string (povinné)
primární klíč 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é)
sekundární klíč Sekundární klíč. řetězec

Vlastnosti koncového bodu úložiště

název Description Value
authenticationType Určuje typ ověřování, který se používá pro připojení k účtu úložiště. IdentityBased
KeyBased
connection string 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é)
identita Vlastnosti spravované identity koncového bodu úložiště pro nahrání souboru ManagedIdentity
sasTtlAsIso8601 řekl: 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

TrackedResourceTags

název Description Value