Microsoft.Devices IotHubs 2021-02-01-preview
Bicep-erőforrásdefiníció
Az IotHubs-erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő műveleteket célják:
- Erőforráscsoportok – Lásd : erőforráscsoport üzembehelyezési parancsai
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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@2021-02-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
name: 'string'
}
etag: 'string'
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
authorizationPolicies: [
{
keyName: 'string'
primaryKey: 'string'
rights: 'string'
secondaryKey: 'string'
keyName: 'string'
primaryKey: 'string'
rights: 'string'
secondaryKey: 'string'
}
]
cloudToDevice: {
defaultTtlAsIso8601: 'string'
feedback: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
maxDeliveryCount: int
}
comments: 'string'
deviceStreams: {
streamingEndpoints: [
'string'
]
}
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'
}
]
messagingEndpoints: {
{customized property}: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
}
minTlsVersion: 'string'
networkRuleSets: {
applyToBuiltInEventHubEndpoint: bool
defaultAction: 'string'
ipRules: [
{
action: 'Allow'
filterName: 'string'
ipMask: 'string'
}
]
}
privateEndpointConnections: [
{
properties: {
privateEndpoint: {}
privateLinkServiceConnectionState: {
actionsRequired: 'string'
description: 'string'
status: 'string'
}
}
}
]
publicNetworkAccess: 'string'
routing: {
endpoints: {
eventHubs: [
{
authenticationType: 'string'
connectionString: 'string'
endpointUri: 'string'
entityPath: 'string'
id: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusQueues: [
{
authenticationType: 'string'
connectionString: 'string'
endpointUri: 'string'
entityPath: 'string'
id: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusTopics: [
{
authenticationType: 'string'
connectionString: 'string'
endpointUri: 'string'
entityPath: 'string'
id: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
storageContainers: [
{
authenticationType: 'string'
batchFrequencyInSeconds: int
connectionString: 'string'
containerName: 'string'
encoding: 'string'
endpointUri: 'string'
fileNameFormat: 'string'
id: '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'
sasTtlAsIso8601: 'string'
}
}
}
}
Tulajdonságértékek
IotHubs
Név | Leírás | Érték |
---|---|---|
name | Az erőforrás neve | sztring (kötelező) Karakterkorlát: 3-50 Érvényes karakterek: Alfanumerikák és kötőjelek. Nem lehet kötőjellel végződni. Az erőforrás nevének egyedinek kell lennie az Azure-ban. |
location | Az erőforrás helye. | sztring (kötelező) |
tags | Az erőforráscímkék. | Címkenevek és -értékek szótára. Címkék megtekintése sablonokban |
Sku | Az IotHub termékváltozatának adatai | IotHubSkuInfo (kötelező) |
Etag | Az Etag mezőre nincs szükség. Ha a válasz törzsében szerepel, akkor fejlécként is meg kell adni a normál ETag-konvenciók szerint. | sztring |
identity | Az IotHub felügyelt identitásai. | ArmIdentity |
properties | IotHub-tulajdonságok | IotHubProperties |
ArmIdentity
Név | Leírás | Érték |
---|---|---|
típus | Az erőforráshoz használt identitás típusa. A "SystemAssigned,UserAssigned" típus magában foglal egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is. A "Nincs" típus eltávolítja az identitásokat a szolgáltatásból. | "Nincs" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities | A(z) {ArmUserIdentity} szótára | ArmIdentityUserAssignedIdentities |
ArmIdentityUserAssignedIdentities
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | ArmUserIdentity |
ArmUserIdentity
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság a ReadOnly.
IotHubProperties
Név | Leírás | Érték |
---|---|---|
authorizationPolicies | Az IoT Hubhoz való csatlakozás biztonságossá tételéhez használható megosztott hozzáférési szabályzatok. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | Az IoT Hub felhőalapú üzenetküldési tulajdonságai. | CloudToDeviceProperties |
megjegyzések | IoT Hub-megjegyzések. | sztring |
deviceStreams | Az eszköz streameli az iothub tulajdonságait. | IotHubPropertiesDeviceStreams |
enableFileUploadNotifications | Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. | logikai |
titkosítás | Az IoT Hub titkosítási tulajdonságai. | EncryptionPropertiesDescription |
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 létrehozási vagy frissítési hívásainak indításakor. | 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 | Meghatározza a központ számára támogatni kívánt minimális TLS-verziót. Az "1.2" értékre állítható, hogy az 1.2-esnél régebbi TLS-verziót használó ügyfeleket elutasítsuk. | sztring |
networkRuleSets | Az IotHub hálózati szabálykészletének tulajdonságai | NetworkRuleSetProperties |
privateEndpointConnections | Ezen az IotHubon létrehozott privát végponti kapcsolatok | PrivateEndpointConnection[] |
publicNetworkAccess | Engedélyezve vannak-e a nyilvános hálózatról érkező kérések | "Letiltva" "Engedélyezve" |
Útválasztás | Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging | ÚtválasztásTulajdonságok |
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, a rendszer hibát jelez. Ha nem ad meg értéket ehhez a tulajdonsághoz, ha az enableFileUploadNotifications tulajdonság értéke Igaz, a rendszer hibát jelez. | IotHubPropertiesStorageEndpoints |
SharedAccessSignatureAuthorizationRule
Név | Leírás | Érték |
---|---|---|
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
CloudToDeviceProperties
Név | Leírás | Érték |
---|---|---|
defaultTtlAsIso8601 | Az alapértelmezett élettartam a felhőből az eszközre irányuló üzenetekhez az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | sztring |
visszajelzés | A visszajelzési üzenetsor tulajdonságai a felhőből az eszközre irányuló üzenetekhez. | Visszajelzéstulajdonságok |
maxDeliveryCount | A felhőből 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 |
Visszajelzéstulajdonságok
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. | sztring |
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. | sztring |
IotHubPropertiesDeviceStreams
Név | Leírás | Érték |
---|---|---|
streamingEndpoints | Az eszközstreamek végpontjainak listája. | sztring[] |
EncryptionPropertiesDescription
Név | Leírás | Érték |
---|---|---|
keySource | A kulcs forrása. | sztring |
keyVaultProperties | A KeyVault-kulcs tulajdonságai. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
Név | Leírás | Érték |
---|---|---|
identity | Az identitás. | KEKIdentitás |
keyIdentifier | A kulcs azonosítója. | sztring |
KEKIdentitás
Név | Leírás | Érték |
---|---|---|
userAssignedIdentity | A felhasználó által hozzárendelt identitás. | sztring |
IotHubPropertiesEventHubEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | EventHubProperties |
EventHubProperties
Név | Leírás | Érték |
---|---|---|
partitionCount | Az eszközről a felhőbe irányuló üzenetek fogadására szolgáló partíciók száma az Event Hub-kompatibilis végponton. 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 |
IpFilterRule
Név | Leírás | Érték |
---|---|---|
action | 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ő) |
IotHubPropertiesMessagingEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | MessagingEndpointProperties |
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. | sztring |
maxDeliveryCount | Az IoT Hub által az üzenetek kézbesítésére tett kísérletek száma. 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. | sztring |
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ő) |
NetworkRuleSetIpRule
Név | Leírás | Érték |
---|---|---|
action | IP-szűrő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ő) |
PrivateEndpointConnection
Név | Leírás | Érték |
---|---|---|
properties | Privát végpontkapcsolat tulajdonságai | PrivateEndpointConnectionProperties (kötelező) |
PrivateEndpointConnectionProperties
Név | Leírás | Érték |
---|---|---|
privateEndpoint | Magánvégpont-kapcsolat privát végponttulajdonsága | PrivateEndpoint |
privateLinkServiceConnectionState | Privát végpontkapcsolat aktuális állapota | PrivateLinkServiceConnectionState (kötelező) |
PrivateEndpoint
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság a ReadOnly.
PrivateLinkServiceConnectionState
Név | Leírás | Érték |
---|---|---|
actionsRequired | Privát végpontkapcsolathoz szükséges műveletek | sztring |
leírás | A privát végpontkapcsolat aktuális állapotának leírása | sztring (kötelező) |
status | Privát végpontkapcsolat állapota | "Jóváhagyva" "Leválasztva" "Függőben" "Elutasítva" (kötelező) |
ÚtválasztásTulajdonságok
Név | Leírás | Érték |
---|---|---|
Végpontok | Azoknak az egyéni végpontoknak a tulajdonságai, amelyekre az IoT Hub az útválasztási szabályok alapján irányítja az üzeneteket. A fizetős központok esetében az összes végponttípusban 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ípusban. | 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 beállítva, az "útvonalak" szakaszban megadott feltételeknek nem megfelelő üzenetek a beépített EventHub-végpontra lesznek irányítva. | FallbackRouteProperties |
Útvonalak | A felhasználó által megadott ú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ához használ. 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[] |
RoutingEndpoints
Név | Leírás | Érték |
---|---|---|
eventHubs | Azon Event Hubs-végpontok 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, amelyekhez 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 karakterlánc. | sztring |
endpointUri | Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Eseményközpont neve az eseményközpont névterében | sztring |
id | Az eseményközpont végpontjának azonosítója | sztring |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | Az eseményközpont-végpont erőforráscsoportjának neve. | sztring |
subscriptionId | Az eseményközpont végpontjának előfizetés-azonosítója. | sztring |
RoutingServiceBusQueueEndpointProperties
Név | Leírás | Érték |
---|---|---|
authenticationType | A Service Bus-üzenetsor végpontja alapján történő hitelesítéshez használt módszer | "identityBased" "keyBased" |
connectionString | A Service Bus-üzenetsor végpontjának kapcsolati karakterlánc. | sztring |
endpointUri | A Service Bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a Service Bus-névtérben | sztring |
id | A Service Bus-üzenetsor végpontjának azonosítója | sztring |
name | 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 az üzenetsor tényleges nevével. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A Service Bus-üzenetsor végpontjának erőforráscsoportjának neve. | sztring |
subscriptionId | A Service Bus-üzenetsor végpontjának előfizetés-azonosítója. | sztring |
RoutingServiceBusTopicEndpointProperties
Név | Leírás | Érték |
---|---|---|
authenticationType | A Service Bus-témakör végpontja alapján történő hitelesítéshez használt módszer | "identityBased" "keyBased" |
connectionString | A Service Bus-témakör végpontjának kapcsolati karakterlánc. | sztring |
endpointUri | A Service Bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a Service Bus-témakörben | sztring |
id | A Service Bus-témakör végpontjának azonosítója | sztring |
name | 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émakör tényleges nevével. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A Service Bus-témakör végpontjának erőforráscsoportjának neve. | sztring |
subscriptionId | A Service Bus-témakör végpontjának előfizetés-azonosítója. | sztring |
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 karakterlánc. | sztring |
containerName | A tárfiókban található tároló neve. | sztring (kötelező) |
Kódolás | Kódolás, amely az üzenetek blobokra való 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árolási végpont URL-címe. Tartalmaznia kell a protokollt https:// |
sztring |
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ő. | sztring |
id | A tárolóvégpont azonosítója | sztring |
maxChunkSizeInBytes | A tárolóba írt blobok maximális száma bájtban. Az értéknek 10485760(10 MB) és 524288000(500 MB) között kell lennie. Az alapértelmezett érték a 314572800 (300 MB). | int Korlátok: Minimális érték = 10485760 Maximális érték = 524288000 |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A tárfiók erőforráscsoportjának neve. | sztring |
subscriptionId | A tárfiók előfizetés-azonosítója. | sztring |
EnrichmentProperties
Név | Leírás | Érték |
---|---|---|
endpointNames | Azoknak a végpontoknak a listája, amelyekre a bővítés vonatkozik az üzenetre. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 |
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ő) |
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, akkor alapértelmezés szerint igaz értékre lesz kiértékelve. Nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket a rendszer átirányítja. Jelenleg csak 1 végpont engedélyezett. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. | bool (kötelező) |
name | Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket és kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. | sztring |
source | Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
Útvonaltulajdonságok
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 ki. Nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzenetek lesznek átirányítva. Jelenleg csak egy végpont engedélyezett. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy engedélyezve van-e egy útvonal. | bool (kötelező) |
name | Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket és kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
source | A forrás, amelyre az útválasztási szabályt alkalmazni kell, például DeviceMessages. | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
IotHubPropertiesStorageEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | StorageEndpointProperties |
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 karakterlánc, amelyre a fájlok fel vannak töltve. | 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ő) |
sasTtlAsIso8601 | Az az időtartam, amelyre a 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. | sztring |
IotHubSkuInfo
Név | Leírás | Érték |
---|---|---|
capacity | A kiépített IoT Hub egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. | int |
name | A termékváltozat neve. | "B1" "B2" "B3" "F1" 'S1' 'S2' "S3" (kötelező) |
Gyorssablonok
Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.
Sablon | Description |
---|---|
IOT Hub és Ubuntu edge-szimulátor létrehozása |
Ez a sablon létrehoz egy IOT Hub- és virtuálisgép-Ubuntu edge-szimulátort. |
Arm-sablon használata IoT Hub létrehozásához, az üzenetek irányításához és megtekintéséhez |
Ezzel a sablonnal helyezhet üzembe egy IoT Hub és egy tárfiókot. Futtasson egy alkalmazást, hogy üzeneteket küldjön a tárolóba átirányított központnak, majd tekintse meg az eredményeket. |
IoT Hub Device Provisioning Service létrehozása |
Ezzel a sablonnal létrehozhat egy IoT Hubot és egy IoT Hub Device Provisioning Service-t, és összekapcsolhatja a két szolgáltatást. |
IoT Hub és eszköz–felhő fogyasztói csoport létrehozása |
Ez a sablon lehetővé teszi, hogy egy IoT Hub-példányt helyezzen üzembe az eszközzel a felhőben és a felhőben az eszköz üzenetkezelési konfigurációiban, valamint egy eszközt a felhő fogyasztói csoportjában. |
Eszközfrissítés létrehozása IoT Hub fiókhoz, példányhoz IoT Hub |
Ez a sablon létrehoz egy fiókot, valamint egy példányt és egy központot, amellyel összekapcsolhatja a példányt. 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 egy Azure IoT Hub |
A MedTech szolgáltatás az egyik Olyan Azure Health Data Services, amelyet arra terveztek, hogy több eszközről töltse be az eszközadatokat, az eszközadatokat FHIR-megfigyelésekké alakítsa át, amelyek ezután megmaradnak az Azure Health Data Services FHIR szolgáltatásban. |
Használatalapú fizetéses (PAYG) környezet létrehozása IoT Hub |
Ez a sablon lehetővé teszi egy használatalapú fizetéses (PAYG) Time Series Insights-környezet üzembe helyezését, amely egy IoT Hub eseményeinek felhasználására van konfigurálva. |
ARM-sablon erőforrás-definíciója
Az IotHubs-erőforrástípus üzembe helyezhető a következő célműveletekkel:
- Erőforráscsoportok – Lásd : Erőforráscsoport üzembehelyezési parancsai
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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": "2021-02-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"name": "string"
},
"etag": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"authorizationPolicies": [
{
"keyName": "string",
"primaryKey": "string",
"rights": "string",
"secondaryKey": "string",
"keyName": "string",
"primaryKey": "string",
"rights": "string",
"secondaryKey": "string"
}
],
"cloudToDevice": {
"defaultTtlAsIso8601": "string",
"feedback": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
},
"maxDeliveryCount": "int"
},
"comments": "string",
"deviceStreams": {
"streamingEndpoints": [ "string" ]
},
"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"
}
],
"messagingEndpoints": {
"{customized property}": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
}
},
"minTlsVersion": "string",
"networkRuleSets": {
"applyToBuiltInEventHubEndpoint": "bool",
"defaultAction": "string",
"ipRules": [
{
"action": "Allow",
"filterName": "string",
"ipMask": "string"
}
]
},
"privateEndpointConnections": [
{
"properties": {
"privateEndpoint": {},
"privateLinkServiceConnectionState": {
"actionsRequired": "string",
"description": "string",
"status": "string"
}
}
}
],
"publicNetworkAccess": "string",
"routing": {
"endpoints": {
"eventHubs": [
{
"authenticationType": "string",
"connectionString": "string",
"endpointUri": "string",
"entityPath": "string",
"id": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusQueues": [
{
"authenticationType": "string",
"connectionString": "string",
"endpointUri": "string",
"entityPath": "string",
"id": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusTopics": [
{
"authenticationType": "string",
"connectionString": "string",
"endpointUri": "string",
"entityPath": "string",
"id": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"storageContainers": [
{
"authenticationType": "string",
"batchFrequencyInSeconds": "int",
"connectionString": "string",
"containerName": "string",
"encoding": "string",
"endpointUri": "string",
"fileNameFormat": "string",
"id": "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",
"sasTtlAsIso8601": "string"
}
}
}
}
Tulajdonságértékek
IotHubs
Név | Leírás | Érték |
---|---|---|
típus | Az erőforrás típusa | "Microsoft.Devices/IotHubs" |
apiVersion | Az erőforrás API-verziója | '2021-02-01-preview" |
name | Az erőforrás neve | sztring (kötelező) Karakterkorlát: 3-50 Érvényes karakterek: Alfanumerikus és kötőjelek. Nem lehet kötőjellel végződni. Az erőforrás nevének egyedinek kell lennie az Azure-ban. |
location | Az erőforrás helye. | sztring (kötelező) |
tags | Az erőforráscímkék. | Címkenevek és -értékek szótára. Címkék megtekintése sablonokban |
Sku | Az IotHub termékváltozatának adatai | IotHubSkuInfo (kötelező) |
Etag | Az Etag mezőre nincs szükség. Ha a válasz törzsében szerepel, akkor fejlécként is meg kell adni a normál ETag-konvenciónak megfelelően. | sztring |
identity | Az IotHub felügyelt identitásai. | ArmIdentity |
properties | Az IotHub tulajdonságai | IotHubProperties |
ArmIdentity
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 | A(z) {ArmUserIdentity} szótára | ArmIdentityUserAssignedIdentities |
ArmIdentityUserAssignedIdentities
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | ArmUserIdentity |
ArmUserIdentity
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság a ReadOnly.
IotHubProperties
Név | Leírás | Érték |
---|---|---|
authorizationPolicies | Az IoT Hubhoz való csatlakozás biztonságossá tételéhez használható megosztott hozzáférési szabályzatok. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | Az IoT Hub felhőalapú üzenetküldési tulajdonságai. | CloudToDeviceProperties |
megjegyzések | IoT Hub-megjegyzések. | sztring |
deviceStreams | Az eszköz streameli az iothub tulajdonságait. | IotHubPropertiesDeviceStreams |
enableFileUploadNotifications | Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. | logikai |
titkosítás | Az IoT Hub titkosítási tulajdonságai. | EncryptionPropertiesDescription |
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 létrehozási vagy frissítési hívásai 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 | Meghatározza az ehhez a központhoz 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. | sztring |
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" |
Útválasztás | Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging | ÚtválasztásTulajdonságok |
storageEndpoints | Az Azure Storage-végpontok listája, ahol fájlokat tölthet fel. Jelenleg csak egy Azure Storage-fiókot konfigurálhat, amelynek kulcsával $default kell rendelkeznie. Ha egynél több tárfiókot ad meg, a rendszer hibát jelez. Ha nem ad meg értéket ennek a tulajdonságnak, ha az enableFileUploadNotifications tulajdonság értéke True , a rendszer hibát jelez. | IotHubPropertiesStorageEndpoints |
SharedAccessSignatureAuthorizationRule
Név | Leírás | Érték |
---|---|---|
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
CloudToDeviceProperties
Név | Leírás | Érték |
---|---|---|
defaultTtlAsIso8601 | Az alapértelmezett élettartam a felhőből az eszközre irányuló üzenetekhez az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | sztring |
visszajelzés | A felhőből az eszközre irányuló üzenetek visszajelzési üzenetsorának tulajdonságai. | VisszajelzésTulajdonságok |
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 |
VisszajelzésTulajdonságok
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. | sztring |
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. | sztring |
IotHubPropertiesDeviceStreams
Név | Leírás | Érték |
---|---|---|
streamingEndpoints | Az eszközstreamek végpontjainak listája. | sztring[] |
EncryptionPropertiesDescription
Név | Leírás | Érték |
---|---|---|
keySource | A kulcs forrása. | sztring |
keyVaultProperties | A KeyVault kulcs tulajdonságai. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
Név | Leírás | Érték |
---|---|---|
identity | Az identitás. | KEKIdentitás |
keyIdentifier | A kulcs azonosítója. | sztring |
KEKIdentitás
Név | Leírás | Érték |
---|---|---|
userAssignedIdentity | A felhasználó által hozzárendelt identitás. | sztring |
IotHubPropertiesEventHubEndpoints
Név | Leírás | Érték |
---|---|---|
{customized property} | EventHubProperties |
EventHubProperties
Név | Leírás | Érték |
---|---|---|
partitionCount | Az eszközről a felhőbe irányuló üzenetek fogadásához használt partíciók száma az Event Hub-kompatibilis végponton. 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 |
IpFilterRule
Név | Leírás | Érték |
---|---|---|
action | 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 | Egy sztring, amely a szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazza. | sztring (kötelező) |
IotHubPropertiesMessagingEndpoints
Név | Leírás | Érték |
---|---|---|
{customized property} | MessagingEndpointProperties |
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. | sztring |
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. | sztring |
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ő) |
NetworkRuleSetIpRule
Név | Leírás | Érték |
---|---|---|
action | IP-szűrési művelet | "Engedélyezés" |
filterName | Az IP-szűrőszabály neve. | sztring (kötelező) |
ipMask | Egy sztring, amely a szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazza. | sztring (kötelező) |
PrivateEndpointConnection
Név | Leírás | Érték |
---|---|---|
properties | A privát végponti kapcsolat tulajdonságai | PrivateEndpointConnectionProperties (kötelező) |
PrivateEndpointConnectionProperties
Név | Leírás | Érték |
---|---|---|
privateEndpoint | A privát végponti kapcsolat privát végpont tulajdonsága | PrivateEndpoint |
privateLinkServiceConnectionState | Privát végpontkapcsolat aktuális állapota | PrivateLinkServiceConnectionState (kötelező) |
PrivateEndpoint
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság a ReadOnly.
PrivateLinkServiceConnectionState
Név | Leírás | Érték |
---|---|---|
actionsRequired | Privát végpontkapcsolathoz szükséges műveletek | sztring |
leírás | A privát végpontkapcsolat aktuális állapotának leírása | sztring (kötelező) |
status | Privát végpontkapcsolat állapota | "Jóváhagyva" "Leválasztva" "Függőben" "Elutasítva" (kötelező) |
ÚtválasztásTulajdonságok
Név | Leírás | Érték |
---|---|---|
Végpontok | Azoknak az egyéni végpontoknak a tulajdonságai, amelyekre az IoT Hub az útválasztási szabályok alapján irányítja az üzeneteket. A fizetős központok esetében az összes végponttípusban 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ípusban. | 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 beállítva, az "útvonalak" szakaszban megadott feltételeknek nem megfelelő üzenetek a beépített eventhub-végpontra lesznek irányítva. | FallbackRouteProperties |
Útvonalak | A felhasználó által megadott ú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[] |
RoutingEndpoints
Név | Leírás | Érték |
---|---|---|
eventHubs | Azon Event Hubs-végpontok listája, amelyekre 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, amelyekre 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 | Az IoT Hub által az üzeneteket az útválasztási szabályok alapján átirányító tárolóvégpontok listája. | 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 karakterlánc. | sztring |
endpointUri | Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Eseményközpont neve az eseményközpont névterén | sztring |
id | Az eseményközpont végpontjának azonosítója | sztring |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | Az eseményközpont-végpont erőforráscsoportjának neve. | sztring |
subscriptionId | Az eseményközpont végpontjának előfizetés-azonosítója. | sztring |
RoutingServiceBusQueueEndpointProperties
Név | Leírás | Érték |
---|---|---|
authenticationType | A service bus-üzenetsorvégponton való hitelesítéshez használt módszer | "identityBased" "keyBased" |
connectionString | A service bus-üzenetsorvégpont kapcsolati karakterlánc. | sztring |
endpointUri | A service bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a service bus-névtérben | sztring |
id | A service bus-üzenetsor végpontjának azonosítója | sztring |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A service bus-üzenetsorvégpont erőforráscsoportjának neve. | sztring |
subscriptionId | A service bus-üzenetsorvégpont előfizetés-azonosítója. | sztring |
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 karakterlánc. | sztring |
endpointUri | A service bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a service bus-témakörben | sztring |
id | A service bus-témakör végpontjának azonosítója | sztring |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A service bus-témakörvégpont erőforráscsoportjának neve. | sztring |
subscriptionId | A service bus-témakör végpontjának előfizetés-azonosítója. | sztring |
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 | Az az időintervallum, amikor a blobok tárolóba vannak írva. 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 karakterlánc. | sztring |
containerName | A tárfiókban található tároló neve. | sztring (kötelező) |
Kódolás | Kódolás, amely az üzenetek blobokra való 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 protokollt https:// |
sztring |
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ő. | sztring |
id | A tárolóvégpont azonosítója | sztring |
maxChunkSizeInBytes | A tárolóba írt blobok maximális száma bájtban. Az értéknek 10485760(10 MB) és 524288000(500 MB) között kell lennie. Az alapértelmezett érték a 314572800 (300 MB). | int Korlátok: Minimális érték = 10485760 Maximális érték = 524288000 |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A tárfiók erőforráscsoportjának neve. | sztring |
subscriptionId | A tárfiók előfizetés-azonosítója. | sztring |
EnrichmentProperties
Név | Leírás | Érték |
---|---|---|
endpointNames | Azon végpontok listája, amelyekre a bővítés vonatkozik az üzenetre. | string[] (kötelező) Korlátok: Minimális hossz = 1 |
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ő) |
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 true (igaz) értéket ad vissza. A nyelvhelyességet a következő témakörben találja: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket a rendszer átirányítja. Jelenleg csak 1 végpont engedélyezett. | string[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. | bool (kötelező) |
name | 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. | sztring |
source | Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
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 true (igaz) értéket ad vissza. A nyelvhelyességet a következő témakörben találja: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzenetek vannak átirányítva. Jelenleg csak egy végpont engedélyezett. | string[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy engedélyezve van-e egy útvonal. | bool (kötelező) |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
source | A forrás, amellyel az útválasztási szabályt alkalmazni kell, például DeviceMessages. | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
IotHubPropertiesStorageEndpoints
Név | Leírás | Érték |
---|---|---|
{customized property} | StorageEndpointProperties |
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 karakterlánc, ahová a fájlokat feltölti. | sztring (kötelező) |
containerName | Annak a gyökértárolónak a neve, ahová fájlokat tölt fel. A tárolónak nem kell léteznie, de a megadott connectionString használatával kreatálhatónak kell lennie. | sztring (kötelező) |
sasTtlAsIso8601 | Az az időtartam, amelyre a 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. | sztring |
IotHubSkuInfo
Név | Leírás | Érték |
---|---|---|
capacity | A kiépített IoT Hub egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. | int |
name | A termékváltozat neve. | "B1" "B2" "B3" "F1" 'S1' 'S2' "S3" (kötelező) |
Gyorssablonok
Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.
Sablon | Description |
---|---|
IOT Hub és Ubuntu edge-szimulátor létrehozása |
Ez a sablon létrehoz egy IOT Hub- és virtuálisgép-Ubuntu edge-szimulátort. |
Arm-sablon használata IoT Hub létrehozásához, az üzenetek irányításához és megtekintéséhez |
Ezzel a sablonnal helyezhet üzembe egy IoT Hub és egy tárfiókot. Futtasson egy alkalmazást, hogy üzeneteket küldjön a tárolóba átirányított központnak, majd tekintse meg az eredményeket. |
IoT Hub Device Provisioning Service létrehozása |
Ezzel a sablonnal létrehozhat egy IoT Hubot és egy IoT Hub Device Provisioning Service-t, és összekapcsolhatja a két szolgáltatást. |
IoT Hub és eszköz–felhő fogyasztói csoport létrehozása |
Ez a sablon lehetővé teszi, hogy egy IoT Hub-példányt helyezzen üzembe az eszközzel a felhőben és a felhőben az eszköz üzenetkezelési konfigurációiban, valamint egy eszközt a felhő fogyasztói csoportjában. |
Eszközfrissítés létrehozása IoT Hub fiókhoz, példányhoz IoT Hub |
Ez a sablon létrehoz egy fiókot, valamint egy példányt és egy központot, amellyel összekapcsolhatja a példányt. 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 egy Azure IoT Hub |
A MedTech szolgáltatás az egyik Olyan Azure Health Data Services, amelyet arra terveztek, hogy több eszközről töltse be az eszközadatokat, az eszközadatokat FHIR-megfigyelésekké alakítsa át, amelyek ezután megmaradnak az Azure Health Data Services FHIR szolgáltatásban. |
Használatalapú fizetéses (PAYG) környezet létrehozása IoT Hub |
Ez a sablon lehetővé teszi egy használatalapú fizetéses (PAYG) Time Series Insights-környezet üzembe helyezését, amely egy IoT Hub eseményeinek felhasználására van konfigurálva. |
Terraform -erőforrásdefiníció (AzAPI-szolgáltató)
Az IotHubs-erőforrástípus üzembe helyezhető a következő célműveletekkel:
- Erőforráscsoportok
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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@2021-02-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
authorizationPolicies = [
{
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
}
]
cloudToDevice = {
defaultTtlAsIso8601 = "string"
feedback = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
maxDeliveryCount = int
}
comments = "string"
deviceStreams = {
streamingEndpoints = [
"string"
]
}
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"
}
]
messagingEndpoints = {
{customized property} = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
}
minTlsVersion = "string"
networkRuleSets = {
applyToBuiltInEventHubEndpoint = bool
defaultAction = "string"
ipRules = [
{
action = "Allow"
filterName = "string"
ipMask = "string"
}
]
}
privateEndpointConnections = [
{
properties = {
privateEndpoint = {}
privateLinkServiceConnectionState = {
actionsRequired = "string"
description = "string"
status = "string"
}
}
}
]
publicNetworkAccess = "string"
routing = {
endpoints = {
eventHubs = [
{
authenticationType = "string"
connectionString = "string"
endpointUri = "string"
entityPath = "string"
id = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusQueues = [
{
authenticationType = "string"
connectionString = "string"
endpointUri = "string"
entityPath = "string"
id = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusTopics = [
{
authenticationType = "string"
connectionString = "string"
endpointUri = "string"
entityPath = "string"
id = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
storageContainers = [
{
authenticationType = "string"
batchFrequencyInSeconds = int
connectionString = "string"
containerName = "string"
encoding = "string"
endpointUri = "string"
fileNameFormat = "string"
id = "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"
sasTtlAsIso8601 = "string"
}
}
}
sku = {
capacity = int
name = "string"
}
etag = "string"
})
}
Tulajdonságértékek
IotHubs
Név | Leírás | Érték |
---|---|---|
típus | Az erőforrás típusa | "Microsoft.Devices/IotHubs@2021-02-01-preview" |
name | Az erőforrás neve | sztring (kötelező) Karakterkorlát: 3-50 Érvényes karakterek: Alfanumerikus és kötőjelek. Nem lehet kötőjellel végződni. Az erőforrás nevének egyedinek kell lennie az Azure-ban. |
location | Az erőforrás helye. | sztring (kötelező) |
parent_id | Az erőforráscsoportban való üzembe helyezéshez használja az erőforráscsoport azonosítóját. | sztring (kötelező) |
tags | Az erőforráscímkék. | Címkenevek és -értékek szótára. |
Sku | Az IotHub termékváltozatának adatai | IotHubSkuInfo (kötelező) |
Etag | Az Etag mezőre nincs szükség. Ha a válasz törzsében szerepel, akkor fejlécként is meg kell adni a normál ETag-konvenciónak megfelelően. | sztring |
identity | Az IotHub felügyelt identitásai. | ArmIdentity |
properties | Az IotHub tulajdonságai | IotHubProperties |
ArmIdentity
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. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
identity_ids | Az {ArmUserIdentity} szótára | Felhasználói identitásazonosítók tömbje. |
ArmIdentityUserAssignedIdentities
Név | Leírás | Érték |
---|---|---|
{customized property} | ArmUserIdentity |
ArmUserIdentity
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság readOnly.
IotHubProperties
Név | Leírás | Érték |
---|---|---|
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. | sztring |
deviceStreams | Az eszköz streameli az iothub tulajdonságait. | IotHubPropertiesDeviceStreams |
enableFileUploadNotifications | Ha igaz, a fájlfeltöltési értesítések engedélyezve vannak. | logikai |
titkosítás | Az IoT Hub titkosítási tulajdonságai. | EncryptionPropertiesDescription |
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 létrehozási vagy frissítési hívásainak indításakor. | 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 | Meghatározza a központ számára támogatni kívánt minimális TLS-verziót. Az "1.2" értékre állítható, hogy az 1.2-esnél régebbi TLS-verziót használó ügyfeleket elutasítsuk. | sztring |
networkRuleSets | Az IotHub hálózati szabálykészletének tulajdonságai | NetworkRuleSetProperties |
privateEndpointConnections | Ezen az IotHubon létrehozott privát végponti kapcsolatok | PrivateEndpointConnection[] |
publicNetworkAccess | Engedélyezve vannak-e a nyilvános hálózatról érkező kérések | "Letiltva" "Engedélyezve" |
Útválasztás | Az IoT Hub útválasztással kapcsolatos tulajdonságai. Lásd: /azure/iot-hub/iot-hub-devguide-messaging | ÚtválasztásTulajdonságok |
storageEndpoints | Az Azure Storage-végpontok listája, ahol fájlokat tölthet fel. Jelenleg csak egy Azure Storage-fiókot konfigurálhat, amelynek kulcsával $default kell rendelkeznie. Ha egynél több tárfiókot ad meg, a rendszer hibát jelez. Ha nem ad meg értéket ennek a tulajdonságnak, ha az enableFileUploadNotifications tulajdonság értéke True , a rendszer hibát jelez. | IotHubPropertiesStorageEndpoints |
SharedAccessSignatureAuthorizationRule
Név | Leírás | Érték |
---|---|---|
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
Kulcsnév | A megosztott hozzáférési szabályzat neve. | sztring (kötelező) |
primaryKey | Az elsődleges kulcs. | sztring |
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. | sztring |
CloudToDeviceProperties
Név | Leírás | Érték |
---|---|---|
defaultTtlAsIso8601 | Az alapértelmezett élettartam a felhőből az eszközre irányuló üzenetekhez az eszközsoron. Lásd: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | sztring |
visszajelzés | A visszajelzési üzenetsor tulajdonságai a felhőből az eszközre irányuló üzenetekhez. | Visszajelzéstulajdonságok |
maxDeliveryCount | A felhőből 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 |
Visszajelzéstulajdonságok
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. | sztring |
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. | sztring |
IotHubPropertiesDeviceStreams
Név | Leírás | Érték |
---|---|---|
streamingEndpoints | Az eszközstreamek végpontjainak listája. | sztring[] |
EncryptionPropertiesDescription
Név | Leírás | Érték |
---|---|---|
keySource | A kulcs forrása. | sztring |
keyVaultProperties | A KeyVault-kulcs tulajdonságai. | KeyVaultKeyProperties[] |
KeyVaultKeyProperties
Név | Leírás | Érték |
---|---|---|
identity | Az identitás. | KEKIdentitás |
keyIdentifier | A kulcs azonosítója. | sztring |
KEKIdentitás
Név | Leírás | Érték |
---|---|---|
userAssignedIdentity | A felhasználó által hozzárendelt identitás. | sztring |
IotHubPropertiesEventHubEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | EventHubProperties |
EventHubProperties
Név | Leírás | Érték |
---|---|---|
partitionCount | Az eszközről a felhőbe irányuló üzenetek fogadására szolgáló partíciók száma az Event Hub-kompatibilis végponton. 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 |
IpFilterRule
Név | Leírás | Érték |
---|---|---|
action | 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ő) |
IotHubPropertiesMessagingEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | MessagingEndpointProperties |
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. | sztring |
maxDeliveryCount | Az IoT Hub által az üzenetek kézbesítésére tett kísérletek száma. 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. | sztring |
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ő) |
NetworkRuleSetIpRule
Név | Leírás | Érték |
---|---|---|
action | IP-szűrési művelet | "Engedélyezés" |
filterName | Az IP-szűrőszabály neve. | sztring (kötelező) |
ipMask | Egy sztring, amely a szabály CIDR-jelölésében szereplő IP-címtartományt tartalmazza. | sztring (kötelező) |
PrivateEndpointConnection
Név | Leírás | Érték |
---|---|---|
properties | A privát végponti kapcsolat tulajdonságai | PrivateEndpointConnectionProperties (kötelező) |
PrivateEndpointConnectionProperties
Név | Leírás | Érték |
---|---|---|
privateEndpoint | A privát végponti kapcsolat privát végpont tulajdonsága | PrivateEndpoint |
privateLinkServiceConnectionState | A privát végponti kapcsolat aktuális állapota | PrivateLinkServiceConnectionState (kötelező) |
PrivateEndpoint
Ez az objektum nem tartalmaz az üzembe helyezés során beállítandó tulajdonságokat. Minden tulajdonság readOnly.
PrivateLinkServiceConnectionState
Név | Leírás | Érték |
---|---|---|
actionsRequired | Privát végponti kapcsolathoz szükséges műveletek | sztring |
leírás | A privát végponti kapcsolat aktuális állapotának leírása | sztring (kötelező) |
status | Privát végponti kapcsolat állapota | "Jóváhagyva" "Leválasztva" "Függőben" "Elutasítva" (kötelező) |
ÚtválasztásTulajdonságok
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 végponttípusai között 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 |
bővítés | A felhasználó által biztosított bővítések listája, amelyeket az IoT Hub a beépített és egyéni végpontokra kézbesítendő üzenetekre alkalmaz. 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 beállítva, az "útvonalak" szakaszban megadott feltételeknek nem megfelelő üzenetek a beépített EventHub-végpontra lesznek irányítva. | FallbackRouteProperties |
Útvonalak | A felhasználó által megadott ú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ához használ. 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[] |
RoutingEndpoints
Név | Leírás | Érték |
---|---|---|
eventHubs | Azon Event Hubs-végpontok 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, amelyekhez 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 karakterlánc. | sztring |
endpointUri | Az eseményközpont végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Eseményközpont neve az eseményközpont névterében | sztring |
id | Az eseményközpont végpontjának azonosítója | sztring |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | Az eseményközpont-végpont erőforráscsoportjának neve. | sztring |
subscriptionId | Az eseményközpont végpontjának előfizetés-azonosítója. | sztring |
RoutingServiceBusQueueEndpointProperties
Név | Leírás | Érték |
---|---|---|
authenticationType | A Service Bus-üzenetsor végpontja alapján történő hitelesítéshez használt módszer | "identityBased" "keyBased" |
connectionString | A Service Bus-üzenetsor végpontjának kapcsolati karakterlánc. | sztring |
endpointUri | A Service Bus-üzenetsor végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a Service Bus-névtérben | sztring |
id | A Service Bus-üzenetsor végpontjának azonosítója | sztring |
name | 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 az üzenetsor tényleges nevével. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A Service Bus-üzenetsor végpontjának erőforráscsoportjának neve. | sztring |
subscriptionId | A Service Bus-üzenetsor végpontjának előfizetés-azonosítója. | sztring |
RoutingServiceBusTopicEndpointProperties
Név | Leírás | Érték |
---|---|---|
authenticationType | A Service Bus-témakör végpontja alapján történő hitelesítéshez használt módszer | "identityBased" "keyBased" |
connectionString | A Service Bus-témakör végpontjának kapcsolati karakterlánc. | sztring |
endpointUri | A Service Bus-témakör végpontjának URL-címe. Tartalmaznia kell a protokoll sb:// | sztring |
entityPath | Üzenetsor neve a Service Bus-témakörben | sztring |
id | A Service Bus-témakör végpontjának azonosítója | sztring |
name | 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émakör tényleges nevével. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A Service Bus-témakör végpontjának erőforráscsoportjának neve. | sztring |
subscriptionId | A service bus-témakör végpontjának előfizetés-azonosítója. | sztring |
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 | Az az időintervallum, amikor a blobok tárolóba vannak írva. 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 karakterlánc. | sztring |
containerName | A tárfiókban található tároló neve. | sztring (kötelező) |
Kódolás | Kódolás, amely az üzenetek blobokra való 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 protokollt https:// |
sztring |
fileNameFormat | A blob fájlnévformátuma. Az alapértelmezett formátum a következő: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Minden paraméter kötelező, de átrendezhető. | sztring |
id | A tárolóvégpont azonosítója | sztring |
maxChunkSizeInBytes | A tárolóba írt blobok maximális szá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 |
name | 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. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
resourceGroup | A tárfiók erőforráscsoportjának neve. | sztring |
subscriptionId | A tárfiók előfizetés-azonosítója. | sztring |
EnrichmentProperties
Név | Leírás | Érték |
---|---|---|
endpointNames | Azoknak a végpontoknak a listája, amelyekre a bővítés vonatkozik az üzenetre. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 |
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ő) |
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, akkor alapértelmezés szerint igaz értékre lesz kiértékelve. Nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzeneteket a rendszer átirányítja. Jelenleg csak 1 végpont engedélyezett. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy a tartalék útvonal engedélyezve van-e. | bool (kötelező) |
name | Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket és kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. | sztring |
source | Az a forrás, amelyre az útválasztási szabályt alkalmazni kell. Például: DeviceMessages | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
Útvonaltulajdonságok
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 ki. Nyelvhelyességért lásd: /azure/iot-hub/iot-hub-devguide-query-language | sztring |
endpointNames | Azon végpontok listája, amelyekhez a feltételnek megfelelő üzenetek lesznek átirányítva. Jelenleg csak egy végpont engedélyezett. | sztring[] (kötelező) Korlátok: Minimális hossz = 1 Maximális hossz = 1 |
isEnabled | Annak megadására szolgál, hogy engedélyezve van-e egy útvonal. | bool (kötelező) |
name | Az útvonal neve. A név csak alfanumerikus karaktereket, pontokat, aláhúzásjeleket és kötőjeleket tartalmazhat, legfeljebb 64 karakter hosszúságú lehet, és egyedinek kell lennie. | sztring (kötelező) Korlátok: Minta = ^[A-Za-z0-9-._]{1,64}$ |
source | A forrás, amelyre az útválasztási szabályt alkalmazni kell, például DeviceMessages. | "DeviceConnectionStateEvents" "DeviceJobLifecycleEvents" "DeviceLifecycleEvents" "DeviceMessages" "DigitalTwinChangeEvents" "Érvénytelen" "TwinChangeEvents" (kötelező) |
IotHubPropertiesStorageEndpoints
Név | Leírás | Érték |
---|---|---|
{testreszabott tulajdonság} | StorageEndpointProperties |
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 karakterlánc, amelyre a fájlok fel vannak töltve. | 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ő) |
sasTtlAsIso8601 | Az az időtartam, amelyre a 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. | sztring |
IotHubSkuInfo
Név | Leírás | Érték |
---|---|---|
capacity | A kiépített IoT Hub egységek száma. Lásd: /azure/azure-subscription-service-limits#iot-hub-limits. | int |
name | A termékváltozat neve. | "B1" "B2" "B3" "F1" "S1" "S2" "S3" (kötelező) |