Megosztás a következőn keresztül:


Microsoft.Devices IotHubs

Bicep-erőforrásdefiníció

Az IotHubs-erőforrástípus üzembe helyezhető a célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Devices/IotHubs-erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

resource symbolicname 'Microsoft.Devices/IotHubs@2023-06-30' = {
  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'
    disableDeviceSAS: bool
    disableLocalAuth: bool
    disableModuleSAS: bool
    enableDataResidency: bool
    enableFileUploadNotifications: bool
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    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
    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'
  }
}

Tulajdonságértékek

ArmIdentitás

Név Leírás Érték
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az identitásokat a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities <ArmUserIdentity> szótára ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Név Leírás Érték

ArmUserIdentity

Név Leírás Érték

CloudToDeviceProperties

Név Leírás Érték
defaultTtlAsIso8601 A felhőből az eszközre irányuló üzenetek alapértelmezett élettartama az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
visszacsatolás A visszajelzési üzenetsor tulajdonságai a felhőből az eszközre irányuló üzenetekhez. FeedbackProperties
maxDeliveryCount A felhőből az eszközre irányuló üzenetek maximális kézbesítési száma az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100

EnrichmentProperties

Név Leírás Érték
endpointNames Azon végpontok listája, amelyekre a bővítés vonatkozik az üzenetre. sztring[] (kötelező)
kulcs A bővítési tulajdonság kulcsa vagy neve. sztring (kötelező)
érték A bővítési tulajdonság értéke. sztring (kötelező)

EventHubProperties

Név Leírás Érték
partitionCount Az Event Hub-kompatibilis végponton az eszközről a felhőbe irányuló üzenetek fogadására szolgáló partíciók száma. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Az eszközről a felhőbe irányuló üzenetek megőrzési ideje napokban. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Név Leírás Érték
feltétel A tartalék útvonal alkalmazásához kiértékelt feltétel. Ha a feltétel nincs megadva, alapértelmezés szerint igaz értékre lesz kiértékelve. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket irányítja a rendszer. Jelenleg csak 1 végpont engedélyezett. sztring[] (kötelező)
isEnabled Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr
forrás Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

FeedbackProperties

Név Leírás Érték
lockDurationAsIso8601 A visszajelzési üzenetsor zárolási időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet küldeni a visszajelzési üzenetsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr

IotHubProperties

Név Leírás Érték
allowedFqdnList Az Iot Hubról történő kimenő forgalomhoz engedélyezett teljes tartománynevek (teljes tartománynév) listája. sztring[]
authorizationPolicies Az IoT Hubhoz való csatlakozás biztonságossá tételéhez használható közös hozzáférési szabályzatok. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Az IoT Hub felhőalapú üzenetkezelési tulajdonságai. CloudToDeviceProperties
megjegyzések IoT Hub-megjegyzések. húr
disableDeviceSAS Ha igaz, az összes eszköz (beleértve az Edge-eszközöket is, de a modulok kivételével) hatókörébe tartozó SAS-kulcsok nem használhatók a hitelesítéshez. Bool
disableLocalAuth Ha igaz, az Iot Hub hatókörű SAS-kulcsokkal rendelkező SAS-jogkivonatok nem használhatók hitelesítésre. Bool
disableModuleSAS Ha igaz, a modul hatókörébe tartozó SAS-kulcsok nem használhatók hitelesítéshez. Bool
enableDataResidency Ez a tulajdonság, ha igaz értékre van állítva, engedélyezi az adattárolást, így letiltja a vészhelyreállítást. Bool
enableFileUploadNotifications Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. Bool
eventHubEndpoints Az Event Hub-kompatibilis végpont tulajdonságai. A szótár egyetlen lehetséges kulcsa az események. Ennek a kulcsnak szerepelnie kell a szótárban az IoT Hub hívásainak létrehozása vagy frissítése során. IotHubPropertiesEventHubEndpoints
Funkciók Az IoT Hubhoz engedélyezett képességek és funkciók. "DeviceManagement"
"Nincs"
ipFilterRules Az IP-szűrési szabályok. IpFilterRule[]
messagingEndpoints A fájlfeltöltési értesítési üzenetsor üzenetkezelési végpontjának tulajdonságai. IotHubPropertiesMessagingEndpoints
minTlsVersion Megadja a központ számára támogatott minimális TLS-verziót. Az "1.2" értékre állítható be, hogy az 1.2-esnél kisebb TLS-verziót használó ügyfelek elutasíthatók legyenek. húr
networkRuleSets Az IotHub hálózati szabálykészletének tulajdonságai NetworkRuleSetProperties
privateEndpointConnections Ezen az IotHubon létrehozott privát végpontkapcsolatok PrivateEndpointConnection[]
publicNetworkAccess A nyilvános hálózatról érkező kérések engedélyezése "Letiltva"
"Engedélyezve"
restrictOutboundNetworkAccess Ha igaz, az IotHubról való kimenő forgalom csak az engedélyezett teljes tartománynevekre lesz korlátozva, amelyek az allowedFqdnList használatával vannak konfigurálva. Bool
Útválasztás Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Az Azure Storage-végpontok listája, ahol fájlokat tölthet fel. Jelenleg csak egy Azure Storage-fiókot konfigurálhat, és a kulcsának $default kell lennie. Ha egynél több tárfiókot ad meg, hiba történik. Ha nem ad meg értéket ennek a tulajdonságnak, ha az enableFileUploadNotifications tulajdonság értéke True( Igaz) értékre van állítva, a rendszer hibát jelez. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Név Leírás Érték

IotHubPropertiesMessagingEndpoints

Név Leírás Érték

IotHubPropertiesStorageEndpoints

Név Leírás Érték

IotHubSkuInfo

Név Leírás Érték
kapacitás A kiépített IoT Hub-egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. Int
név Az termékváltozat neve. "B1"
"B2"
"B3"
"F1"
'S1'
'S2'
"S3" (kötelező)

IpFilterRule

Név Leírás Érték
akció A szabály által rögzített kérések kívánt művelete. "Elfogadás"
"Elutasítás" (kötelező)
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

ManagedIdentity

Név Leírás Érték
userAssignedIdentity A felhasználó által hozzárendelt identitás. húr

MessagingEndpointProperties

Név Leírás Érték
lockDurationAsIso8601 A zárolás időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet kézbesíteni. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr

Microsoft.Devices/IotHubs

Név Leírás Érték
etag Az Etag mező nem kötelező. Ha a válasz törzsében meg van adva, akkor fejlécként is meg kell adni a normál ETag-konvencióban. húr
azonosság Az IotHub felügyelt identitásai. ArmIdentity
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek IotHub-tulajdonságok IotHubProperties
Sku IotHub termékváltozat adatai IotHubSkuInfo (kötelező)
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

NetworkRuleSetIpRule

Név Leírás Érték
akció IP-szűrési művelet "Engedélyezés"
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

NetworkRuleSetProperties

Név Leírás Érték
applyToBuiltInEventHubEndpoint Ha igaz, akkor a rendszer a hálózati szabálykészletet is alkalmazza az IotHub BuiltIn EventHub EndPointjára bool (kötelező)
defaultAction Hálózati szabálykészlet alapértelmezett művelete "Engedélyezés"
"Megtagadás"
ipRules IP-szabályok listája NetworkRuleSetIpRule[] (kötelező)

PrivateEndpoint

Név Leírás Érték

PrivateEndpointConnection

Név Leírás Érték
kellékek A privát végpontkapcsolat tulajdonságai PrivateEndpointConnectionProperties (kötelező)

PrivateEndpointConnectionProperties

Név Leírás Érték
privateEndpoint A privát végpontkapcsolat privát végponttulajdonsága PrivateEndpoint
privateLinkServiceConnectionState Privát végpontkapcsolat aktuális állapota PrivateLinkServiceConnectionState (kötelező)

PrivateLinkServiceConnectionState

Név Leírás Érték
actionsRequired Privát végpontkapcsolathoz szükséges műveletek húr
leírás A privát végpontkapcsolat aktuális állapotának leírása sztring (kötelező)
állapot Privát végpontkapcsolat állapota "Jóváhagyva"
"Leválasztva"
"Függőben"
"Elutasítva" (kötelező)

ResourceTags

Név Leírás Érték

RouteProperties

Név Leírás Érték
feltétel Az útválasztási szabály alkalmazásához kiértékelt feltétel. Ha nincs megadva feltétel, alapértelmezés szerint igaz értéket ad vissza. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azoknak a végpontoknak a listája, amelyekhez a feltételnek megfelelő üzenetek vannak átirányítva. Jelenleg csak egy végpont engedélyezett. sztring[] (kötelező)
isEnabled Az útvonal engedélyezésének megadására szolgál. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
forrás Az útválasztási szabályt alkalmazni kívánt forrás, például a DeviceMessages. "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

RoutingCosmosDBSqlApiProperties

Név Leírás Érték
authenticationType A Cosmos DB SQL-tárolóvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
containerName A cosmos DB sql-tároló neve a Cosmos DB-adatbázisban. sztring (kötelező)
databaseName A cosmos DB-adatbázis neve a cosmos DB-fiókban. sztring (kötelező)
endpointUri A cosmos DB-fiók URL-címe. Tartalmaznia kell a protokoll https:// sztring (kötelező)
azonosság Az útválasztási Cosmos DB-tárolóvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
partitionKeyName A cosmos DB SQL-tárolóhoz társított partíciókulcs neve, ha van ilyen. Ez egy nem kötelező paraméter. húr
partitionKeyTemplate A cosmos DB SQL-tárolóhoz használható szintetikus partíciókulcs-érték létrehozására szolgáló sablon. A sablonnak tartalmaznia kell legalább egy helyőrzőt: {iothub}, {deviceid}, {DD}, {MM} és {YYYY}. Egy helyőrző legfeljebb egyszer adható meg, de a sorrend és a nem helyőrző összetevők tetszőlegesek. Ez a paraméter csak akkor szükséges, ha a PartitionKeyName meg van adva. húr
primaryKey A cosmos DB-fiók elsődleges kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
resourceGroup A cosmos DB-fiók erőforráscsoportjának neve. húr
secondaryKey A cosmos DB-fiók másodlagos kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
subscriptionId A cosmos DB-fiók előfizetés-azonosítója. húr

RoutingEndpoints

Név Leírás Érték
cosmosDBSqlContainers Azoknak a Cosmos DB-tárolóvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingCosmosDBSqlApiProperties[]
eventHubs Azoknak az Event Hubs-végpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. Ez a lista nem tartalmazza a beépített Event Hubs-végpontot. RoutingEventHubProperties[]
serviceBusQueues Azoknak a Service Bus-üzenetsorvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Azoknak a Service Bus-témakörvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusTopicEndpointProperties[]
storageContainers Azon tárolóvégpontok listája, amelyekre az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Név Leírás Érték
authenticationType Az eseményközpont végpontja felé történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString Az eseményközpont végpontjának kapcsolati sztringje. húr
endpointUri Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Eseményközpont neve az eseményközpont névterében húr
azonosító Az eseményközpont végpontjának azonosítója húr
azonosság Az útválasztási eseményközpont végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup Az eseményközpont-végpont erőforráscsoportjának neve. húr
subscriptionId Az eseményközpont végpontjának előfizetés-azonosítója. húr

RoutingProperties

Név Leírás Érték
Végpontok Azokhoz az egyéni végpontokhoz kapcsolódó tulajdonságok, amelyekhez az IoT Hub az útválasztási szabályok alapján irányítja az üzeneteket. A fizetős központok összes végponttípusában legfeljebb 10 egyéni végpont engedélyezett, az ingyenes központokhoz pedig csak 1 egyéni végpont engedélyezett az összes végponttípuson. RoutingEndpoints
dúsítások Az IoT Hub által a beépített és egyéni végpontokra kézbesítendő üzenetekre vonatkozó, felhasználó által biztosított bővítések listája. Lásd: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute A visszaeső útvonalként használt útvonal tulajdonságai, ha az "útvonalak" szakaszban megadott feltételek egyike sem teljesül. Ez egy nem kötelező paraméter. Ha ez a tulajdonság nincs jelen a sablonban, a tartalék útvonal alapértelmezés szerint le van tiltva. FallbackRouteProperties
Útvonalak A felhasználó által biztosított útválasztási szabályok listája, amelyeket az IoT Hub az üzenetek beépített és egyéni végpontokra való átirányítására használ. A fizetős központok esetében legfeljebb 100 útválasztási szabály engedélyezett, az ingyenes központok esetében pedig legfeljebb 5 útválasztási szabály engedélyezett. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Név Leírás Érték
authenticationType A service bus-üzenetsorvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString A service bus-üzenetsor végpontjának kapcsolati sztringje. húr
endpointUri A service bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus névtérben húr
azonosító A service bus-üzenetsor végpontjának azonosítója húr
azonosság Az útválasztási szolgáltatásbusz-üzenetsorvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges üzenetsor nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-üzenetsor-végpont erőforráscsoportjának neve. húr
subscriptionId A service bus-üzenetsor végpontjának előfizetés-azonosítója. húr

RoutingServiceBusTopicEndpointProperties

Név Leírás Érték
authenticationType A service bus-témakör végpontjának hitelesítéséhez használt módszer "identityBased"
"keyBased"
connectionString A service bus-témakör végpontjának kapcsolati sztringje. húr
endpointUri A service bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus-témakörben húr
azonosító A service bus-témakör végpontjának azonosítója húr
azonosság A Service Bus-témakör végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges témakör nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-témakör végpontjának erőforráscsoportjának neve. húr
subscriptionId A service bus-témakör végpontjának előfizetés-azonosítója. húr

RoutingStorageContainerProperties

Név Leírás Érték
authenticationType A tárvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
batchFrequencyInSeconds A blobok tárolóba való írásának időintervalluma. Az értéknek 60 és 720 másodperc között kell lennie. Az alapértelmezett érték 300 másodperc. Int

Korlátok:
Minimális érték = 60
Maximális érték = 720
connectionString A tárfiók kapcsolati sztringje. húr
containerName A tárfiókban található tároló neve. sztring (kötelező)
kódolás Kódolás, amely az üzenetek blobok szerializálására szolgál. A támogatott értékek a következők: "avro", "avrodeflate" és "JSON". Az alapértelmezett érték az "avro". 'Avro'
'AvroDeflate'
"JSON"
endpointUri A tárvégpont URL-címe. Tartalmaznia kell a protokoll https:// húr
fileNameFormat A blob fájlnévformátuma. Alapértelmezett formátum: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Minden paraméter kötelező, de átrendezhető. húr
azonosító A tárolóvégpont azonosítója húr
azonosság Az útválasztási tárvégpont felügyelt identitástulajdonságai. ManagedIdentity
maxChunkSizeInBytes Tárba írt blobok maximális bájtszáma. Az értéknek 10485760(10 MB) és 524288000(500 MB) között kell lennie. Az alapértelmezett érték 314572800(300 MB). Int

Korlátok:
Minimális érték = 10485760
Maximális érték = 524288000
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A tárfiók erőforráscsoportjának neve. húr
subscriptionId A tárfiók előfizetés-azonosítója. húr

SharedAccessSignatureAuthorizationRule

Név Leírás Érték
keyName A megosztott hozzáférési szabályzat neve. sztring (kötelező)
primaryKey Az elsődleges kulcs. húr
Jogok A megosztott hozzáférési szabályzathoz rendelt engedélyek. "DeviceConnect"
"RegistryRead"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
"ServiceConnect"
"ServiceConnect, DeviceConnect" (kötelező)
secondaryKey A másodlagos kulcs. húr

StorageEndpointProperties

Név Leírás Érték
authenticationType Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. "identityBased"
"keyBased"
connectionString Annak az Azure Storage-fióknak a kapcsolati sztringje, amelyre a fájlokat feltölti. sztring (kötelező)
containerName Annak a gyökértárolónak a neve, amelyben fájlokat tölt fel. A tárolónak nem kell léteznie, de a megadott connectionString használatával creatable-nek kell lennie. sztring (kötelező)
azonosság A fájlfeltöltéshez használt tárolási végpont felügyelt identitástulajdonságai. ManagedIdentity
sasTtlAsIso8601 Az az időtartam, amelyre az IoT Hub által a fájlfeltöltéshez létrehozott SAS URI érvényes. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. húr

Használati példák

Azure gyorsútmutató-minták

Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.

Bicep-fájl Leírás
IoT Hub és eszköz létrehozása felhőalapú fogyasztói csoport Ez a sablon lehetővé teszi egy IoT Hub-példány üzembe helyezését az eszközről a felhőbe és a felhőbe az eszköz üzenetkezelési konfigurációira, valamint egy eszköz felhőbeli fogyasztói csoportra történő üzembe helyezését.
IoT Hub Device Provisioning Service- létrehozása Ez a sablon lehetővé teszi egy IoT Hub és egy IoT Hub eszközkiépítési szolgáltatás létrehozását, valamint a két szolgáltatás összekapcsolását.
Eszközfrissítés létrehozása IoT Hub-fiók, -példány, IoT Hub- Ez a sablon létrehoz egy fiókot, egy példányt és egy központot a példány összekapcsolásához. Konfigurálja a központot a szükséges hozzáférési szabályzatokkal, útvonalakkal és fogyasztói csoportokkal.
A MedTech szolgáltatás üzembe helyezése, beleértve az Azure IoT Hub A MedTech szolgáltatás az Azure Health Data Services egyik célja, hogy több eszköz eszközadatait betöltse, az eszközadatokat FHIR-megfigyelésekké alakítsa át, amelyek ezután megmaradnak az Azure Health Data Services FHIR szolgáltatásban.
AZ ARM-sablon használata az IoT Hub létrehozásához, az üzenetek átirányításához és megtekintéséhez Ezzel a sablonnal üzembe helyezhet egy IoT Hubot és egy tárfiókot. Futtasson egy alkalmazást, amely üzeneteket küld a tárolóba irányított központnak, majd tekintse meg az eredményeket.

ARM-sablon erőforrásdefiníciója

Az IotHubs-erőforrástípus üzembe helyezhető a célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Devices/IotHubs-erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2023-06-30",
  "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",
    "disableDeviceSAS": "bool",
    "disableLocalAuth": "bool",
    "disableModuleSAS": "bool",
    "enableDataResidency": "bool",
    "enableFileUploadNotifications": "bool",
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "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",
    "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"
  }
}

Tulajdonságértékek

ArmIdentitás

Név Leírás Érték
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az identitásokat a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities <ArmUserIdentity> szótára ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Név Leírás Érték

ArmUserIdentity

Név Leírás Érték

CloudToDeviceProperties

Név Leírás Érték
defaultTtlAsIso8601 A felhőből az eszközre irányuló üzenetek alapértelmezett élettartama az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
visszacsatolás A visszajelzési üzenetsor tulajdonságai a felhőből az eszközre irányuló üzenetekhez. FeedbackProperties
maxDeliveryCount A felhőből az eszközre irányuló üzenetek maximális kézbesítési száma az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100

EnrichmentProperties

Név Leírás Érték
endpointNames Azon végpontok listája, amelyekre a bővítés vonatkozik az üzenetre. sztring[] (kötelező)
kulcs A bővítési tulajdonság kulcsa vagy neve. sztring (kötelező)
érték A bővítési tulajdonság értéke. sztring (kötelező)

EventHubProperties

Név Leírás Érték
partitionCount Az Event Hub-kompatibilis végponton az eszközről a felhőbe irányuló üzenetek fogadására szolgáló partíciók száma. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Az eszközről a felhőbe irányuló üzenetek megőrzési ideje napokban. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Név Leírás Érték
feltétel A tartalék útvonal alkalmazásához kiértékelt feltétel. Ha a feltétel nincs megadva, alapértelmezés szerint igaz értékre lesz kiértékelve. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket irányítja a rendszer. Jelenleg csak 1 végpont engedélyezett. sztring[] (kötelező)
isEnabled Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr
forrás Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

FeedbackProperties

Név Leírás Érték
lockDurationAsIso8601 A visszajelzési üzenetsor zárolási időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet küldeni a visszajelzési üzenetsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr

IotHubProperties

Név Leírás Érték
allowedFqdnList Az Iot Hubról történő kimenő forgalomhoz engedélyezett teljes tartománynevek (teljes tartománynév) listája. sztring[]
authorizationPolicies Az IoT Hubhoz való csatlakozás biztonságossá tételéhez használható közös hozzáférési szabályzatok. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Az IoT Hub felhőalapú üzenetkezelési tulajdonságai. CloudToDeviceProperties
megjegyzések IoT Hub-megjegyzések. húr
disableDeviceSAS Ha igaz, az összes eszköz (beleértve az Edge-eszközöket is, de a modulok kivételével) hatókörébe tartozó SAS-kulcsok nem használhatók a hitelesítéshez. Bool
disableLocalAuth Ha igaz, az Iot Hub hatókörű SAS-kulcsokkal rendelkező SAS-jogkivonatok nem használhatók hitelesítésre. Bool
disableModuleSAS Ha igaz, a modul hatókörébe tartozó SAS-kulcsok nem használhatók hitelesítéshez. Bool
enableDataResidency Ez a tulajdonság, ha igaz értékre van állítva, engedélyezi az adattárolást, így letiltja a vészhelyreállítást. Bool
enableFileUploadNotifications Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. Bool
eventHubEndpoints Az Event Hub-kompatibilis végpont tulajdonságai. A szótár egyetlen lehetséges kulcsa az események. Ennek a kulcsnak szerepelnie kell a szótárban az IoT Hub hívásainak létrehozása vagy frissítése során. IotHubPropertiesEventHubEndpoints
Funkciók Az IoT Hubhoz engedélyezett képességek és funkciók. "DeviceManagement"
"Nincs"
ipFilterRules Az IP-szűrési szabályok. IpFilterRule[]
messagingEndpoints A fájlfeltöltési értesítési üzenetsor üzenetkezelési végpontjának tulajdonságai. IotHubPropertiesMessagingEndpoints
minTlsVersion Megadja a központ számára támogatott minimális TLS-verziót. Az "1.2" értékre állítható be, hogy az 1.2-esnél kisebb TLS-verziót használó ügyfelek elutasíthatók legyenek. húr
networkRuleSets Az IotHub hálózati szabálykészletének tulajdonságai NetworkRuleSetProperties
privateEndpointConnections Ezen az IotHubon létrehozott privát végpontkapcsolatok PrivateEndpointConnection[]
publicNetworkAccess A nyilvános hálózatról érkező kérések engedélyezése "Letiltva"
"Engedélyezve"
restrictOutboundNetworkAccess Ha igaz, az IotHubról való kimenő forgalom csak az engedélyezett teljes tartománynevekre lesz korlátozva, amelyek az allowedFqdnList használatával vannak konfigurálva. Bool
Útválasztás Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Az Azure Storage-végpontok listája, ahol fájlokat tölthet fel. Jelenleg csak egy Azure Storage-fiókot konfigurálhat, és a kulcsának $default kell lennie. Ha egynél több tárfiókot ad meg, hiba történik. Ha nem ad meg értéket ennek a tulajdonságnak, ha az enableFileUploadNotifications tulajdonság értéke True( Igaz) értékre van állítva, a rendszer hibát jelez. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Név Leírás Érték

IotHubPropertiesMessagingEndpoints

Név Leírás Érték

IotHubPropertiesStorageEndpoints

Név Leírás Érték

IotHubSkuInfo

Név Leírás Érték
kapacitás A kiépített IoT Hub-egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. Int
név Az termékváltozat neve. "B1"
"B2"
"B3"
"F1"
'S1'
'S2'
"S3" (kötelező)

IpFilterRule

Név Leírás Érték
akció A szabály által rögzített kérések kívánt művelete. "Elfogadás"
"Elutasítás" (kötelező)
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

ManagedIdentity

Név Leírás Érték
userAssignedIdentity A felhasználó által hozzárendelt identitás. húr

MessagingEndpointProperties

Név Leírás Érték
lockDurationAsIso8601 A zárolás időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet kézbesíteni. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr

Microsoft.Devices/IotHubs

Név Leírás Érték
apiVersion Az API verziója '2023-06-30'
etag Az Etag mező nem kötelező. Ha a válasz törzsében meg van adva, akkor fejlécként is meg kell adni a normál ETag-konvencióban. húr
azonosság Az IotHub felügyelt identitásai. ArmIdentity
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek IotHub-tulajdonságok IotHubProperties
Sku IotHub termékváltozat adatai IotHubSkuInfo (kötelező)
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.Devices/IotHubs"

NetworkRuleSetIpRule

Név Leírás Érték
akció IP-szűrési művelet "Engedélyezés"
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

NetworkRuleSetProperties

Név Leírás Érték
applyToBuiltInEventHubEndpoint Ha igaz, akkor a rendszer a hálózati szabálykészletet is alkalmazza az IotHub BuiltIn EventHub EndPointjára bool (kötelező)
defaultAction Hálózati szabálykészlet alapértelmezett művelete "Engedélyezés"
"Megtagadás"
ipRules IP-szabályok listája NetworkRuleSetIpRule[] (kötelező)

PrivateEndpoint

Név Leírás Érték

PrivateEndpointConnection

Név Leírás Érték
kellékek A privát végpontkapcsolat tulajdonságai PrivateEndpointConnectionProperties (kötelező)

PrivateEndpointConnectionProperties

Név Leírás Érték
privateEndpoint A privát végpontkapcsolat privát végponttulajdonsága PrivateEndpoint
privateLinkServiceConnectionState Privát végpontkapcsolat aktuális állapota PrivateLinkServiceConnectionState (kötelező)

PrivateLinkServiceConnectionState

Név Leírás Érték
actionsRequired Privát végpontkapcsolathoz szükséges műveletek húr
leírás A privát végpontkapcsolat aktuális állapotának leírása sztring (kötelező)
állapot Privát végpontkapcsolat állapota "Jóváhagyva"
"Leválasztva"
"Függőben"
"Elutasítva" (kötelező)

ResourceTags

Név Leírás Érték

RouteProperties

Név Leírás Érték
feltétel Az útválasztási szabály alkalmazásához kiértékelt feltétel. Ha nincs megadva feltétel, alapértelmezés szerint igaz értéket ad vissza. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azoknak a végpontoknak a listája, amelyekhez a feltételnek megfelelő üzenetek vannak átirányítva. Jelenleg csak egy végpont engedélyezett. sztring[] (kötelező)
isEnabled Az útvonal engedélyezésének megadására szolgál. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
forrás Az útválasztási szabályt alkalmazni kívánt forrás, például a DeviceMessages. "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

RoutingCosmosDBSqlApiProperties

Név Leírás Érték
authenticationType A Cosmos DB SQL-tárolóvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
containerName A cosmos DB sql-tároló neve a Cosmos DB-adatbázisban. sztring (kötelező)
databaseName A cosmos DB-adatbázis neve a cosmos DB-fiókban. sztring (kötelező)
endpointUri A cosmos DB-fiók URL-címe. Tartalmaznia kell a protokoll https:// sztring (kötelező)
azonosság Az útválasztási Cosmos DB-tárolóvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
partitionKeyName A cosmos DB SQL-tárolóhoz társított partíciókulcs neve, ha van ilyen. Ez egy nem kötelező paraméter. húr
partitionKeyTemplate A cosmos DB SQL-tárolóhoz használható szintetikus partíciókulcs-érték létrehozására szolgáló sablon. A sablonnak tartalmaznia kell legalább egy helyőrzőt: {iothub}, {deviceid}, {DD}, {MM} és {YYYY}. Egy helyőrző legfeljebb egyszer adható meg, de a sorrend és a nem helyőrző összetevők tetszőlegesek. Ez a paraméter csak akkor szükséges, ha a PartitionKeyName meg van adva. húr
primaryKey A cosmos DB-fiók elsődleges kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
resourceGroup A cosmos DB-fiók erőforráscsoportjának neve. húr
secondaryKey A cosmos DB-fiók másodlagos kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
subscriptionId A cosmos DB-fiók előfizetés-azonosítója. húr

RoutingEndpoints

Név Leírás Érték
cosmosDBSqlContainers Azoknak a Cosmos DB-tárolóvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingCosmosDBSqlApiProperties[]
eventHubs Azoknak az Event Hubs-végpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. Ez a lista nem tartalmazza a beépített Event Hubs-végpontot. RoutingEventHubProperties[]
serviceBusQueues Azoknak a Service Bus-üzenetsorvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Azoknak a Service Bus-témakörvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusTopicEndpointProperties[]
storageContainers Azon tárolóvégpontok listája, amelyekre az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Név Leírás Érték
authenticationType Az eseményközpont végpontja felé történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString Az eseményközpont végpontjának kapcsolati sztringje. húr
endpointUri Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Eseményközpont neve az eseményközpont névterében húr
azonosító Az eseményközpont végpontjának azonosítója húr
azonosság Az útválasztási eseményközpont végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup Az eseményközpont-végpont erőforráscsoportjának neve. húr
subscriptionId Az eseményközpont végpontjának előfizetés-azonosítója. húr

RoutingProperties

Név Leírás Érték
Végpontok Azokhoz az egyéni végpontokhoz kapcsolódó tulajdonságok, amelyekhez az IoT Hub az útválasztási szabályok alapján irányítja az üzeneteket. A fizetős központok összes végponttípusában legfeljebb 10 egyéni végpont engedélyezett, az ingyenes központokhoz pedig csak 1 egyéni végpont engedélyezett az összes végponttípuson. RoutingEndpoints
dúsítások Az IoT Hub által a beépített és egyéni végpontokra kézbesítendő üzenetekre vonatkozó, felhasználó által biztosított bővítések listája. Lásd: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute A visszaeső útvonalként használt útvonal tulajdonságai, ha az "útvonalak" szakaszban megadott feltételek egyike sem teljesül. Ez egy nem kötelező paraméter. Ha ez a tulajdonság nincs jelen a sablonban, a tartalék útvonal alapértelmezés szerint le van tiltva. FallbackRouteProperties
Útvonalak A felhasználó által biztosított útválasztási szabályok listája, amelyeket az IoT Hub az üzenetek beépített és egyéni végpontokra való átirányítására használ. A fizetős központok esetében legfeljebb 100 útválasztási szabály engedélyezett, az ingyenes központok esetében pedig legfeljebb 5 útválasztási szabály engedélyezett. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Név Leírás Érték
authenticationType A service bus-üzenetsorvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString A service bus-üzenetsor végpontjának kapcsolati sztringje. húr
endpointUri A service bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus névtérben húr
azonosító A service bus-üzenetsor végpontjának azonosítója húr
azonosság Az útválasztási szolgáltatásbusz-üzenetsorvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges üzenetsor nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-üzenetsor-végpont erőforráscsoportjának neve. húr
subscriptionId A service bus-üzenetsor végpontjának előfizetés-azonosítója. húr

RoutingServiceBusTopicEndpointProperties

Név Leírás Érték
authenticationType A service bus-témakör végpontjának hitelesítéséhez használt módszer "identityBased"
"keyBased"
connectionString A service bus-témakör végpontjának kapcsolati sztringje. húr
endpointUri A service bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus-témakörben húr
azonosító A service bus-témakör végpontjának azonosítója húr
azonosság A Service Bus-témakör végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges témakör nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-témakör végpontjának erőforráscsoportjának neve. húr
subscriptionId A service bus-témakör végpontjának előfizetés-azonosítója. húr

RoutingStorageContainerProperties

Név Leírás Érték
authenticationType A tárvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
batchFrequencyInSeconds A blobok tárolóba való írásának időintervalluma. Az értéknek 60 és 720 másodperc között kell lennie. Az alapértelmezett érték 300 másodperc. Int

Korlátok:
Minimális érték = 60
Maximális érték = 720
connectionString A tárfiók kapcsolati sztringje. húr
containerName A tárfiókban található tároló neve. sztring (kötelező)
kódolás Kódolás, amely az üzenetek blobok szerializálására szolgál. A támogatott értékek a következők: "avro", "avrodeflate" és "JSON". Az alapértelmezett érték az "avro". 'Avro'
'AvroDeflate'
"JSON"
endpointUri A tárvégpont URL-címe. Tartalmaznia kell a protokoll https:// húr
fileNameFormat A blob fájlnévformátuma. Alapértelmezett formátum: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Minden paraméter kötelező, de átrendezhető. húr
azonosító A tárolóvégpont azonosítója húr
azonosság Az útválasztási tárvégpont felügyelt identitástulajdonságai. ManagedIdentity
maxChunkSizeInBytes Tárba írt blobok maximális bájtszáma. Az értéknek 10485760(10 MB) és 524288000(500 MB) között kell lennie. Az alapértelmezett érték 314572800(300 MB). Int

Korlátok:
Minimális érték = 10485760
Maximális érték = 524288000
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A tárfiók erőforráscsoportjának neve. húr
subscriptionId A tárfiók előfizetés-azonosítója. húr

SharedAccessSignatureAuthorizationRule

Név Leírás Érték
keyName A megosztott hozzáférési szabályzat neve. sztring (kötelező)
primaryKey Az elsődleges kulcs. húr
Jogok A megosztott hozzáférési szabályzathoz rendelt engedélyek. "DeviceConnect"
"RegistryRead"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
"ServiceConnect"
"ServiceConnect, DeviceConnect" (kötelező)
secondaryKey A másodlagos kulcs. húr

StorageEndpointProperties

Név Leírás Érték
authenticationType Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. "identityBased"
"keyBased"
connectionString Annak az Azure Storage-fióknak a kapcsolati sztringje, amelyre a fájlokat feltölti. sztring (kötelező)
containerName Annak a gyökértárolónak a neve, amelyben fájlokat tölt fel. A tárolónak nem kell léteznie, de a megadott connectionString használatával creatable-nek kell lennie. sztring (kötelező)
azonosság A fájlfeltöltéshez használt tárolási végpont felügyelt identitástulajdonságai. ManagedIdentity
sasTtlAsIso8601 Az az időtartam, amelyre az IoT Hub által a fájlfeltöltéshez létrehozott SAS URI érvényes. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. húr

Használati példák

Azure gyorsútmutató-sablonok

Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.

Sablon Leírás
Pay As You Go (PAYG) környezet létrehozása IoT Hub-

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy Pay As You Go (PAYG) Time Series Insights-környezet üzembe helyezését, amely úgy van konfigurálva, hogy eseményeket használjon fel egy IoT Hubról.
IoT Hub és eszköz létrehozása felhőalapú fogyasztói csoport

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy IoT Hub-példány üzembe helyezését az eszközről a felhőbe és a felhőbe az eszköz üzenetkezelési konfigurációira, valamint egy eszköz felhőbeli fogyasztói csoportra történő üzembe helyezését.
IOT Hub és Ubuntu élszimulátor létrehozása

Üzembe helyezés az Azure
Ez a sablon létrehoz egy IOT Hub és virtuális gép Ubuntu élszimulátort.
IoT Hub Device Provisioning Service- létrehozása

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy IoT Hub és egy IoT Hub eszközkiépítési szolgáltatás létrehozását, valamint a két szolgáltatás összekapcsolását.
Eszközfrissítés létrehozása IoT Hub-fiók, -példány, IoT Hub-

Üzembe helyezés az Azure
Ez a sablon létrehoz egy fiókot, egy példányt és egy központot a példány összekapcsolásához. Konfigurálja a központot a szükséges hozzáférési szabályzatokkal, útvonalakkal és fogyasztói csoportokkal.
A MedTech szolgáltatás üzembe helyezése, beleértve az Azure IoT Hub

Üzembe helyezés az Azure
A MedTech szolgáltatás az Azure Health Data Services egyik célja, hogy több eszköz eszközadatait betöltse, az eszközadatokat FHIR-megfigyelésekké alakítsa át, amelyek ezután megmaradnak az Azure Health Data Services FHIR szolgáltatásban.
AZ ARM-sablon használata az IoT Hub létrehozásához, az üzenetek átirányításához és megtekintéséhez

Üzembe helyezés az Azure
Ezzel a sablonnal üzembe helyezhet egy IoT Hubot és egy tárfiókot. Futtasson egy alkalmazást, amely üzeneteket küld a tárolóba irányított központnak, majd tekintse meg az eredményeket.

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

Az IotHubs-erőforrástípus üzembe helyezhető a célműveletekkel:

  • erőforráscsoportok

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Devices/IotHubs-erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2023-06-30"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
      disableDeviceSAS = bool
      disableLocalAuth = bool
      disableModuleSAS = bool
      enableDataResidency = bool
      enableFileUploadNotifications = bool
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      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
      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"
        }
      }
    }
  })
}

Tulajdonságértékek

ArmIdentitás

Név Leírás Érték
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolítja az identitásokat a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities <ArmUserIdentity> szótára ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Név Leírás Érték

ArmUserIdentity

Név Leírás Érték

CloudToDeviceProperties

Név Leírás Érték
defaultTtlAsIso8601 A felhőből az eszközre irányuló üzenetek alapértelmezett élettartama az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
visszacsatolás A visszajelzési üzenetsor tulajdonságai a felhőből az eszközre irányuló üzenetekhez. FeedbackProperties
maxDeliveryCount A felhőből az eszközre irányuló üzenetek maximális kézbesítési száma az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100

EnrichmentProperties

Név Leírás Érték
endpointNames Azon végpontok listája, amelyekre a bővítés vonatkozik az üzenetre. sztring[] (kötelező)
kulcs A bővítési tulajdonság kulcsa vagy neve. sztring (kötelező)
érték A bővítési tulajdonság értéke. sztring (kötelező)

EventHubProperties

Név Leírás Érték
partitionCount Az Event Hub-kompatibilis végponton az eszközről a felhőbe irányuló üzenetek fogadására szolgáló partíciók száma. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Az eszközről a felhőbe irányuló üzenetek megőrzési ideje napokban. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Név Leírás Érték
feltétel A tartalék útvonal alkalmazásához kiértékelt feltétel. Ha a feltétel nincs megadva, alapértelmezés szerint igaz értékre lesz kiértékelve. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket irányítja a rendszer. Jelenleg csak 1 végpont engedélyezett. sztring[] (kötelező)
isEnabled Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr
forrás Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

FeedbackProperties

Név Leírás Érték
lockDurationAsIso8601 A visszajelzési üzenetsor zárolási időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet küldeni a visszajelzési üzenetsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. húr

IotHubProperties

Név Leírás Érték
allowedFqdnList Az Iot Hubról történő kimenő forgalomhoz engedélyezett teljes tartománynevek (teljes tartománynév) listája. sztring[]
authorizationPolicies Az IoT Hubhoz való csatlakozás biztonságossá tételéhez használható közös hozzáférési szabályzatok. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Az IoT Hub felhőalapú üzenetkezelési tulajdonságai. CloudToDeviceProperties
megjegyzések IoT Hub-megjegyzések. húr
disableDeviceSAS Ha igaz, az összes eszköz (beleértve az Edge-eszközöket is, de a modulok kivételével) hatókörébe tartozó SAS-kulcsok nem használhatók a hitelesítéshez. Bool
disableLocalAuth Ha igaz, az Iot Hub hatókörű SAS-kulcsokkal rendelkező SAS-jogkivonatok nem használhatók hitelesítésre. Bool
disableModuleSAS Ha igaz, a modul hatókörébe tartozó SAS-kulcsok nem használhatók hitelesítéshez. Bool
enableDataResidency Ez a tulajdonság, ha igaz értékre van állítva, engedélyezi az adattárolást, így letiltja a vészhelyreállítást. Bool
enableFileUploadNotifications Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. Bool
eventHubEndpoints Az Event Hub-kompatibilis végpont tulajdonságai. A szótár egyetlen lehetséges kulcsa az események. Ennek a kulcsnak szerepelnie kell a szótárban az IoT Hub hívásainak létrehozása vagy frissítése során. IotHubPropertiesEventHubEndpoints
Funkciók Az IoT Hubhoz engedélyezett képességek és funkciók. "DeviceManagement"
"Nincs"
ipFilterRules Az IP-szűrési szabályok. IpFilterRule[]
messagingEndpoints A fájlfeltöltési értesítési üzenetsor üzenetkezelési végpontjának tulajdonságai. IotHubPropertiesMessagingEndpoints
minTlsVersion Megadja a központ számára támogatott minimális TLS-verziót. Az "1.2" értékre állítható be, hogy az 1.2-esnél kisebb TLS-verziót használó ügyfelek elutasíthatók legyenek. húr
networkRuleSets Az IotHub hálózati szabálykészletének tulajdonságai NetworkRuleSetProperties
privateEndpointConnections Ezen az IotHubon létrehozott privát végpontkapcsolatok PrivateEndpointConnection[]
publicNetworkAccess A nyilvános hálózatról érkező kérések engedélyezése "Letiltva"
"Engedélyezve"
restrictOutboundNetworkAccess Ha igaz, az IotHubról való kimenő forgalom csak az engedélyezett teljes tartománynevekre lesz korlátozva, amelyek az allowedFqdnList használatával vannak konfigurálva. Bool
Útválasztás Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Az Azure Storage-végpontok listája, ahol fájlokat tölthet fel. Jelenleg csak egy Azure Storage-fiókot konfigurálhat, és a kulcsának $default kell lennie. Ha egynél több tárfiókot ad meg, hiba történik. Ha nem ad meg értéket ennek a tulajdonságnak, ha az enableFileUploadNotifications tulajdonság értéke True( Igaz) értékre van állítva, a rendszer hibát jelez. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Név Leírás Érték

IotHubPropertiesMessagingEndpoints

Név Leírás Érték

IotHubPropertiesStorageEndpoints

Név Leírás Érték

IotHubSkuInfo

Név Leírás Érték
kapacitás A kiépített IoT Hub-egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. Int
név Az termékváltozat neve. "B1"
"B2"
"B3"
"F1"
'S1'
'S2'
"S3" (kötelező)

IpFilterRule

Név Leírás Érték
akció A szabály által rögzített kérések kívánt művelete. "Elfogadás"
"Elutasítás" (kötelező)
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

ManagedIdentity

Név Leírás Érték
userAssignedIdentity A felhasználó által hozzárendelt identitás. húr

MessagingEndpointProperties

Név Leírás Érték
lockDurationAsIso8601 A zárolás időtartama. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr
maxDeliveryCount Az IoT Hub hányszor kísérel meg üzenetet kézbesíteni. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. Int

Korlátok:
Minimális érték = 1
Maximális érték = 100
ttlAsIso8601 Az az időtartam, amelyre egy üzenet felhasználható, mielőtt az IoT Hub lejárt volna. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload. húr

Microsoft.Devices/IotHubs

Név Leírás Érték
etag Az Etag mező nem kötelező. Ha a válasz törzsében meg van adva, akkor fejlécként is meg kell adni a normál ETag-konvencióban. húr
azonosság Az IotHub felügyelt identitásai. ArmIdentity
hely Az erőforrás helye. sztring (kötelező)
név Az erőforrás neve sztring (kötelező)
kellékek IotHub-tulajdonságok IotHubProperties
Sku IotHub termékváltozat adatai IotHubSkuInfo (kötelező)
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.Devices/IotHubs@2023-06-30"

NetworkRuleSetIpRule

Név Leírás Érték
akció IP-szűrési művelet "Engedélyezés"
filterName Az IP-szűrőszabály neve. sztring (kötelező)
ipMask A szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazó sztring. sztring (kötelező)

NetworkRuleSetProperties

Név Leírás Érték
applyToBuiltInEventHubEndpoint Ha igaz, akkor a rendszer a hálózati szabálykészletet is alkalmazza az IotHub BuiltIn EventHub EndPointjára bool (kötelező)
defaultAction Hálózati szabálykészlet alapértelmezett művelete "Engedélyezés"
"Megtagadás"
ipRules IP-szabályok listája NetworkRuleSetIpRule[] (kötelező)

PrivateEndpoint

Név Leírás Érték

PrivateEndpointConnection

Név Leírás Érték
kellékek A privát végpontkapcsolat tulajdonságai PrivateEndpointConnectionProperties (kötelező)

PrivateEndpointConnectionProperties

Név Leírás Érték
privateEndpoint A privát végpontkapcsolat privát végponttulajdonsága PrivateEndpoint
privateLinkServiceConnectionState Privát végpontkapcsolat aktuális állapota PrivateLinkServiceConnectionState (kötelező)

PrivateLinkServiceConnectionState

Név Leírás Érték
actionsRequired Privát végpontkapcsolathoz szükséges műveletek húr
leírás A privát végpontkapcsolat aktuális állapotának leírása sztring (kötelező)
állapot Privát végpontkapcsolat állapota "Jóváhagyva"
"Leválasztva"
"Függőben"
"Elutasítva" (kötelező)

ResourceTags

Név Leírás Érték

RouteProperties

Név Leírás Érték
feltétel Az útválasztási szabály alkalmazásához kiértékelt feltétel. Ha nincs megadva feltétel, alapértelmezés szerint igaz értéket ad vissza. A nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language húr
endpointNames Azoknak a végpontoknak a listája, amelyekhez a feltételnek megfelelő üzenetek vannak átirányítva. Jelenleg csak egy végpont engedélyezett. sztring[] (kötelező)
isEnabled Az útvonal engedélyezésének megadására szolgál. bool (kötelező)
név Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
forrás Az útválasztási szabályt alkalmazni kívánt forrás, például a DeviceMessages. "DeviceConnectionStateEvents"
"DeviceJobLifecycleEvents"
"DeviceLifecycleEvents"
"DeviceMessages"
"Érvénytelen"
"TwinChangeEvents" (kötelező)

RoutingCosmosDBSqlApiProperties

Név Leírás Érték
authenticationType A Cosmos DB SQL-tárolóvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
containerName A cosmos DB sql-tároló neve a Cosmos DB-adatbázisban. sztring (kötelező)
databaseName A cosmos DB-adatbázis neve a cosmos DB-fiókban. sztring (kötelező)
endpointUri A cosmos DB-fiók URL-címe. Tartalmaznia kell a protokoll https:// sztring (kötelező)
azonosság Az útválasztási Cosmos DB-tárolóvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
partitionKeyName A cosmos DB SQL-tárolóhoz társított partíciókulcs neve, ha van ilyen. Ez egy nem kötelező paraméter. húr
partitionKeyTemplate A cosmos DB SQL-tárolóhoz használható szintetikus partíciókulcs-érték létrehozására szolgáló sablon. A sablonnak tartalmaznia kell legalább egy helyőrzőt: {iothub}, {deviceid}, {DD}, {MM} és {YYYY}. Egy helyőrző legfeljebb egyszer adható meg, de a sorrend és a nem helyőrző összetevők tetszőlegesek. Ez a paraméter csak akkor szükséges, ha a PartitionKeyName meg van adva. húr
primaryKey A cosmos DB-fiók elsődleges kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
resourceGroup A cosmos DB-fiók erőforráscsoportjának neve. húr
secondaryKey A cosmos DB-fiók másodlagos kulcsa. húr

Korlátok:
Bizalmas érték. Adja meg biztonságos paraméterként.
subscriptionId A cosmos DB-fiók előfizetés-azonosítója. húr

RoutingEndpoints

Név Leírás Érték
cosmosDBSqlContainers Azoknak a Cosmos DB-tárolóvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingCosmosDBSqlApiProperties[]
eventHubs Azoknak az Event Hubs-végpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. Ez a lista nem tartalmazza a beépített Event Hubs-végpontot. RoutingEventHubProperties[]
serviceBusQueues Azoknak a Service Bus-üzenetsorvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Azoknak a Service Bus-témakörvégpontoknak a listája, amelyekhez az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingServiceBusTopicEndpointProperties[]
storageContainers Azon tárolóvégpontok listája, amelyekre az IoT Hub átirányítja az üzeneteket az útválasztási szabályok alapján. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Név Leírás Érték
authenticationType Az eseményközpont végpontja felé történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString Az eseményközpont végpontjának kapcsolati sztringje. húr
endpointUri Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Eseményközpont neve az eseményközpont névterében húr
azonosító Az eseményközpont végpontjának azonosítója húr
azonosság Az útválasztási eseményközpont végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup Az eseményközpont-végpont erőforráscsoportjának neve. húr
subscriptionId Az eseményközpont végpontjának előfizetés-azonosítója. húr

RoutingProperties

Név Leírás Érték
Végpontok Azokhoz az egyéni végpontokhoz kapcsolódó tulajdonságok, amelyekhez az IoT Hub az útválasztási szabályok alapján irányítja az üzeneteket. A fizetős központok összes végponttípusában legfeljebb 10 egyéni végpont engedélyezett, az ingyenes központokhoz pedig csak 1 egyéni végpont engedélyezett az összes végponttípuson. RoutingEndpoints
dúsítások Az IoT Hub által a beépített és egyéni végpontokra kézbesítendő üzenetekre vonatkozó, felhasználó által biztosított bővítések listája. Lásd: https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute A visszaeső útvonalként használt útvonal tulajdonságai, ha az "útvonalak" szakaszban megadott feltételek egyike sem teljesül. Ez egy nem kötelező paraméter. Ha ez a tulajdonság nincs jelen a sablonban, a tartalék útvonal alapértelmezés szerint le van tiltva. FallbackRouteProperties
Útvonalak A felhasználó által biztosított útválasztási szabályok listája, amelyeket az IoT Hub az üzenetek beépített és egyéni végpontokra való átirányítására használ. A fizetős központok esetében legfeljebb 100 útválasztási szabály engedélyezett, az ingyenes központok esetében pedig legfeljebb 5 útválasztási szabály engedélyezett. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Név Leírás Érték
authenticationType A service bus-üzenetsorvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
connectionString A service bus-üzenetsor végpontjának kapcsolati sztringje. húr
endpointUri A service bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus névtérben húr
azonosító A service bus-üzenetsor végpontjának azonosítója húr
azonosság Az útválasztási szolgáltatásbusz-üzenetsorvégpont felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges üzenetsor nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-üzenetsor-végpont erőforráscsoportjának neve. húr
subscriptionId A service bus-üzenetsor végpontjának előfizetés-azonosítója. húr

RoutingServiceBusTopicEndpointProperties

Név Leírás Érték
authenticationType A service bus-témakör végpontjának hitelesítéséhez használt módszer "identityBased"
"keyBased"
connectionString A service bus-témakör végpontjának kapcsolati sztringje. húr
endpointUri A service bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// húr
entityPath Üzenetsor neve a service bus-témakörben húr
azonosító A service bus-témakör végpontjának azonosítója húr
azonosság A Service Bus-témakör végpontjának felügyelt identitástulajdonságai. ManagedIdentity
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. A névnek nem kell megegyeznie a tényleges témakör nevével. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A service bus-témakör végpontjának erőforráscsoportjának neve. húr
subscriptionId A service bus-témakör végpontjának előfizetés-azonosítója. húr

RoutingStorageContainerProperties

Név Leírás Érték
authenticationType A tárvégponton történő hitelesítéshez használt módszer "identityBased"
"keyBased"
batchFrequencyInSeconds A blobok tárolóba való írásának időintervalluma. Az értéknek 60 és 720 másodperc között kell lennie. Az alapértelmezett érték 300 másodperc. Int

Korlátok:
Minimális érték = 60
Maximális érték = 720
connectionString A tárfiók kapcsolati sztringje. húr
containerName A tárfiókban található tároló neve. sztring (kötelező)
kódolás Kódolás, amely az üzenetek blobok szerializálására szolgál. A támogatott értékek a következők: "avro", "avrodeflate" és "JSON". Az alapértelmezett érték az "avro". 'Avro'
'AvroDeflate'
"JSON"
endpointUri A tárvégpont URL-címe. Tartalmaznia kell a protokoll https:// húr
fileNameFormat A blob fájlnévformátuma. Alapértelmezett formátum: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Minden paraméter kötelező, de átrendezhető. húr
azonosító A tárolóvégpont azonosítója húr
azonosság Az útválasztási tárvégpont felügyelt identitástulajdonságai. ManagedIdentity
maxChunkSizeInBytes Tárba írt blobok maximális bájtszáma. Az értéknek 10485760(10 MB) és 524288000(500 MB) között kell lennie. Az alapértelmezett érték 314572800(300 MB). Int

Korlátok:
Minimális érték = 10485760
Maximális érték = 524288000
név A végpontot azonosító név. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket, kötőjeleket tartalmazhat, és legfeljebb 64 karakter hosszúságú lehet. A következő nevek vannak fenntartva: események, fileNotifications, $default. A végpontneveknek egyedinek kell lenniük a végponttípusok között. húr

Korlátok:
Minta = ^[A-Za-z0-9-._]{1,64}$ (kötelező)
resourceGroup A tárfiók erőforráscsoportjának neve. húr
subscriptionId A tárfiók előfizetés-azonosítója. húr

SharedAccessSignatureAuthorizationRule

Név Leírás Érték
keyName A megosztott hozzáférési szabályzat neve. sztring (kötelező)
primaryKey Az elsődleges kulcs. húr
Jogok A megosztott hozzáférési szabályzathoz rendelt engedélyek. "DeviceConnect"
"RegistryRead"
"RegistryRead, DeviceConnect"
"RegistryRead, RegistryWrite"
"RegistryRead, RegistryWrite, DeviceConnect"
"RegistryRead, RegistryWrite, ServiceConnect"
"RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect"
"RegistryRead, ServiceConnect"
"RegistryRead, ServiceConnect, DeviceConnect"
"RegistryWrite"
"RegistryWrite, DeviceConnect"
"RegistryWrite, ServiceConnect"
"RegistryWrite, ServiceConnect, DeviceConnect"
"ServiceConnect"
"ServiceConnect, DeviceConnect" (kötelező)
secondaryKey A másodlagos kulcs. húr

StorageEndpointProperties

Név Leírás Érték
authenticationType Megadja a tárfiókhoz való csatlakozáshoz használt hitelesítési típust. "identityBased"
"keyBased"
connectionString Annak az Azure Storage-fióknak a kapcsolati sztringje, amelyre a fájlokat feltölti. sztring (kötelező)
containerName Annak a gyökértárolónak a neve, amelyben fájlokat tölt fel. A tárolónak nem kell léteznie, de a megadott connectionString használatával creatable-nek kell lennie. sztring (kötelező)
azonosság A fájlfeltöltéshez használt tárolási végpont felügyelt identitástulajdonságai. ManagedIdentity
sasTtlAsIso8601 Az az időtartam, amelyre az IoT Hub által a fájlfeltöltéshez létrehozott SAS URI érvényes. Lásd: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. húr