Microsoft.Devices IotHubs 2020-03-01
- più recenti
- 2023-06-30
- 2023-06-30-preview
- 2022-11-15-preview
- 2022-04-30-preview
- 2021-07-02
- 2021-07-02-preview
- 2021-07-01
- 2021-07-01-preview
- 2021-03-31
03-03-2021 - 2021-02-01-preview
- 2020-08-31
- 2020-08-31-preview
- 2020-08-01
- 2020-07-10-preview
- 2020-06-15
- 2020-04-01
- 2020-03-01
- 2019-11-04
- 2019-07-01-preview
- 2019-03-22
- 2019-03-22-preview
- 12-12-01-preview 2018
- 2018-04-01
- 2018-01-22
- 2017-07-01
- 2017-01-19
- 2016-02-03
Definizione di risorsa Bicep
Il tipo di risorsa IotHubs può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Devices/IotHubs, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Devices/IotHubs@2020-03-01' = {
etag: 'string'
location: 'string'
name: 'string'
properties: {
authorizationPolicies: [
{
keyName: 'string'
primaryKey: 'string'
rights: 'string'
secondaryKey: 'string'
}
]
cloudToDevice: {
defaultTtlAsIso8601: 'string'
feedback: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
maxDeliveryCount: int
}
comments: 'string'
enableFileUploadNotifications: bool
eventHubEndpoints: {
{customized property}: {
partitionCount: int
retentionTimeInDays: int
}
}
features: 'string'
ipFilterRules: [
{
action: 'string'
filterName: 'string'
ipMask: 'string'
}
]
messagingEndpoints: {
{customized property}: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
}
minTlsVersion: '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'
}
tags: {
{customized property}: 'string'
}
}
Valori delle proprietà
CloudToDeviceProperties
Nome | Descrizione | Valore |
---|---|---|
defaultTtlAsIso8601 | Durata predefinita per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
Valutazione | Proprietà della coda di feedback per i messaggi da cloud a dispositivo. | FeedbackProprietà |
maxDeliveryCount | Numero massimo di recapito per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
Proprietà di arricchimento
Nome | Descrizione | Valore |
---|---|---|
endpointNames | Elenco di endpoint per cui viene applicato l'arricchimento al messaggio. | string[] (obbligatorio) |
chiave | Chiave o nome per la proprietà di arricchimento. | stringa (obbligatorio) |
valore | Valore per la proprietà di arricchimento. | stringa (obbligatorio) |
EventHubProperties
Nome | Descrizione | Valore |
---|---|---|
partitionCount | Numero di partizioni per la ricezione di messaggi da dispositivo a cloud nell'endpoint compatibile con Hub eventi. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
retentionTimeInDays | Tempo di conservazione per i messaggi da dispositivo a cloud in giorni. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
FallbackRouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la route di fallback. Se la condizione non viene fornita, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito solo 1 endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se la route di fallback è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda |
fonte | Origine a cui applicare la regola di routing. Ad esempio, DeviceMessages | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
FeedbackProperties
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco per la coda di commenti e suggerimenti. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
maxDeliveryCount | Numero di tentativi di recapito dell'hub IoT nella coda di feedback. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
IotHubProperties
Nome | Descrizione | Valore |
---|---|---|
authorizationPolicies | I criteri di accesso condiviso che è possibile usare per proteggere una connessione all'hub IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | Proprietà di messaggistica da cloud a dispositivo dell'hub IoT. | CloudToDeviceProperties |
Commenti | Commenti dell'hub IoT. | corda |
enableFileUploadNotifications | Se True, le notifiche di caricamento dei file sono abilitate. | Bool |
eventHubEndpoints | Proprietà dell'endpoint compatibili con Hub eventi. Le uniche chiavi possibili per questo dizionario sono gli eventi. Questa chiave deve essere presente nel dizionario durante l'esecuzione di chiamate di creazione o aggiornamento per l'hub IoT. | IotHubPropertiesEventHubEndpoints |
tratti somatici | Funzionalità e funzionalità abilitate per l'hub IoT. | 'DeviceManagement' 'Nessuno' |
ipFilterRules | Regole di filtro IP. | IpFilterRule[] |
messagingEndpoints | Proprietà dell'endpoint di messaggistica per la coda di notifica di caricamento file. | IotHubPropertiesMessagingEndpoints |
minTlsVersion | Specifica la versione minima di TLS da supportare per questo hub. Può essere impostato su "1.2" per fare in modo che i client che usano una versione TLS precedente alla 1.2 vengano rifiutati. | corda |
privateEndpointConnections | Connessioni endpoint private create in questo IotHub | PrivateEndpointConnection[] |
publicNetworkAccess | Indica se le richieste dalla rete pubblica sono consentite | 'Disabilitato' 'Enabled' |
instradamento | Proprietà correlate al routing dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | Elenco degli endpoint di Archiviazione di Azure in cui è possibile caricare i file. Attualmente è possibile configurare un solo account di archiviazione di Azure e che DEVE avere la relativa chiave come $default. Se si specificano più account di archiviazione, viene generato un errore. Se non si specifica un valore per questa proprietà quando la proprietà enableFileUploadNotifications è impostata su True, viene generato un errore. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesMessagingEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesStorageEndpoints
Nome | Descrizione | Valore |
---|
IotHubSkuInfo
Nome | Descrizione | Valore |
---|---|---|
capacità | Numero di unità dell'hub IoT di cui è stato effettuato il provisioning. Vedere: /azure/azure-subscription-service-limits#iot-hub-limits. | Int |
nome | Nome dello SKU. | 'B1' 'B2' 'B3' 'F1' 'S1' 'S2' 'S3' (obbligatorio) |
IpFilterRule
Nome | Descrizione | Valore |
---|---|---|
azione | Azione desiderata per le richieste acquisite da questa regola. | 'Accept' 'Reject' (obbligatorio) |
filterName | Nome della regola di filtro IP. | stringa (obbligatorio) |
ipMask | Stringa che contiene l'intervallo di indirizzi IP nella notazione CIDR per la regola. | stringa (obbligatorio) |
Proprietà MessagingEndpoint
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
maxDeliveryCount | Numero di tentativi di recapitare un messaggio nell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
Microsoft.Devices/IotHubs
Nome | Descrizione | Valore |
---|---|---|
etag | Il campo Etag è non obbligatorio. Se viene specificato nel corpo della risposta, deve anche essere fornito come intestazione in base alla normale convenzione ETag. | corda |
ubicazione | Percorso della risorsa. | stringa (obbligatorio) |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà IotHub | IotHubProperties |
Sku | Informazioni sullo SKU IotHub | IotHubSkuInfo (obbligatorio) |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
PrivateEndpoint
Nome | Descrizione | Valore |
---|
PrivateEndpointConnection
Nome | Descrizione | Valore |
---|---|---|
proprietà | Proprietà di una connessione endpoint privato | PrivateEndpointConnectionProperties (obbligatorio) |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
Nome | Descrizione | Valore |
---|---|---|
actionsRequired | Azioni necessarie per una connessione all'endpoint privato | corda |
descrizione | Descrizione dello stato corrente di una connessione endpoint privato | stringa (obbligatorio) |
stato | Stato di una connessione endpoint privato | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' (obbligatorio) |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la regola di routing. Se non viene specificata alcuna condizione, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito un solo endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se una route è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
fonte | Origine a cui applicare la regola di routing, ad esempio DeviceMessages. | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
RoutingEndpoints
Nome | Descrizione | Valore |
---|---|---|
eventHubs | Elenco di endpoint di Hub eventi a cui l'hub IoT instrada i messaggi, in base alle regole di routing. Questo elenco non include l'endpoint predefinito di Hub eventi. | RoutingEventHubProperties[] |
serviceBusQueues | Elenco di endpoint della coda del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | Elenco di endpoint dell'argomento del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | Elenco di endpoint del contenitore di archiviazione a cui l'hub IoT instrada i messaggi in base alle regole di routing. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint dell'hub eventi | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'hub eventi. | corda |
endpointUri | URL dell'endpoint dell'hub eventi. Deve includere il protocollo sb:// | corda |
entityPath | Nome dell'hub eventi nello spazio dei nomi dell'hub eventi | corda |
Id | ID dell'endpoint dell'hub eventi | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'hub eventi. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'hub eventi. | corda |
RoutingProprietà
Nome | Descrizione | Valore |
---|---|---|
Endpoint | Le proprietà correlate agli endpoint personalizzati a cui l'hub IoT instrada i messaggi in base alle regole di routing. Un massimo di 10 endpoint personalizzati è consentito in tutti i tipi di endpoint per gli hub a pagamento e solo 1 endpoint personalizzato è consentito in tutti i tipi di endpoint per gli hub gratuiti. | routingEndpoints |
arricchimenti | Elenco di arricchimenti forniti dall'utente che l'hub IoT applica ai messaggi da recapitare agli endpoint predefiniti e personalizzati. Vedere: https://aka.ms/telemetryoneventgrid | proprietà di arricchimento |
fallbackRoute | Proprietà della route utilizzata come route di fallback quando non vengono soddisfatte le condizioni specificate nella sezione "route". Si tratta di un parametro facoltativo. Quando questa proprietà non è impostata, i messaggi che non soddisfano alcuna delle condizioni specificate nella sezione "route" vengono indirizzati all'endpoint eventhub predefinito. | FallbackRouteProperties |
Itinerari | Elenco di regole di routing fornite dall'utente usate dall'hub IoT per instradare i messaggi agli endpoint predefiniti e personalizzati. Per gli hub a pagamento sono consentiti un massimo di 100 regole di routing e sono consentite un massimo di 5 regole di routing per hub gratuiti. | proprietà route[] |
RoutingServiceBusQueueEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint della coda del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint della coda del bus di servizio. | corda |
endpointUri | URL dell'endpoint della coda del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nello spazio dei nomi del bus di servizio | corda |
Id | ID dell'endpoint della coda del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo della coda. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint della coda del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint della coda del bus di servizio. | corda |
RoutingServiceBusTopicEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint dell'argomento del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'argomento del bus di servizio. | corda |
endpointUri | URL dell'endpoint dell'argomento del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nell'argomento del bus di servizio | corda |
Id | ID dell'endpoint dell'argomento del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo dell'argomento. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'argomento del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'argomento del bus di servizio. | corda |
RoutingStorageContainerProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint di archiviazione | 'identityBased' 'keyBased' |
batchFrequencyInSeconds | Intervallo di tempo in cui i BLOB vengono scritti nell'archiviazione. Il valore deve essere compreso tra 60 e 720 secondi. Il valore predefinito è 300 secondi. | Int Vincoli: Valore minimo = 60 Valore massimo = 720 |
connectionString | Stringa di connessione dell'account di archiviazione. | corda |
containerName | Nome del contenitore di archiviazione nell'account di archiviazione. | stringa (obbligatorio) |
codifica | Codifica utilizzata per serializzare i messaggi nei BLOB. I valori supportati sono 'avro', 'avrodeflate' e 'JSON'. Il valore predefinito è 'avro'. | 'Avro' 'AvroDeflate' 'JSON' |
endpointUri | URL dell'endpoint di archiviazione. Deve includere il protocollo https:// | corda |
fileNameFormat | Formato del nome file per il BLOB. Il formato predefinito è {iothub}/{partition}/{AAAA}/{MM}/{DD}/{HH}/{mm}. Tutti i parametri sono obbligatori, ma possono essere riordinati. | corda |
Id | ID dell'endpoint del contenitore di archiviazione | corda |
maxChunkSizeInBytes | Numero massimo di byte per ogni BLOB scritto nell'archivio. Il valore deve essere compreso tra 10485760(10MB) e 524288000(500 MB). Il valore predefinito è 314572800(300 MB). | Int Vincoli: Valore minimo = 10485760 Valore massimo = 524288000 |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'account di archiviazione. | corda |
subscriptionId | Identificatore della sottoscrizione dell'account di archiviazione. | corda |
SharedAccessSignatureAuthorizationRule
Nome | Descrizione | Valore |
---|---|---|
keyName | Nome dei criteri di accesso condiviso. | stringa (obbligatorio) |
primaryKey | Chiave primaria. | corda |
diritti | Autorizzazioni assegnate ai criteri di accesso condiviso. | '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' (obbligatorio) |
secondaryKey | Chiave secondaria. | corda |
StorageEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Specifica il tipo di autenticazione usato per la connessione all'account di archiviazione. | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione per l'account di archiviazione di Azure in cui vengono caricati i file. | stringa (obbligatorio) |
containerName | Nome del contenitore radice in cui si caricano i file. Il contenitore non deve esistere, ma deve essere creato usando connectionString specificato. | stringa (obbligatorio) |
sasTtlAsIso8601 | Periodo di tempo per il quale l'URI di firma di accesso condiviso generato dall'hub IoT per il caricamento di file è valido. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-upload-notification-configuration-options. | corda |
Esempi di avvio rapido
Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Bicep File | Descrizione |
---|---|
Creare un hub IoT e un gruppo di consumer da dispositivo a cloud | Questo modello consente di distribuire un'istanza dell'hub IoT con dispositivo nel cloud e nel cloud nelle configurazioni di messaggistica dei dispositivi e un dispositivo nel gruppo di consumer cloud. |
Creare un servizio Device Provisioning in hub IoT | Questo modello consente di creare un hub IoT e un servizio Device Provisioning in hub IoT e collegare i due servizi. |
Creare l'aggiornamento dei dispositivi per l'account dell'hub IoT, l'istanza, l'hub IoT | Questo modello crea un account e un'istanza e un hub con cui collegare l'istanza. Configura l'hub con i criteri di accesso, le route e il gruppo di consumer necessari. |
Distribuire il servizio MedTech, incluso un hub IoT di Azure | Il servizio MedTech è uno dei servizi dati di Integrità di Azure progettato per inserire i dati dei dispositivi da più dispositivi, trasformare i dati del dispositivo in osservazioni FHIR, che vengono quindi mantenuti nel servizio FHIR di Servizi dati di integrità di Azure. |
Usare il modello di Resource Manager per creare l'hub IoT, indirizzare e visualizzare i messaggi | Usare questo modello per distribuire un hub IoT e un account di archiviazione. Eseguire un'app per inviare messaggi all'hub indirizzati all'archiviazione, quindi visualizzare i risultati. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa IotHubs può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Devices/IotHubs, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2020-03-01",
"name": "string",
"etag": "string",
"location": "string",
"properties": {
"authorizationPolicies": [
{
"keyName": "string",
"primaryKey": "string",
"rights": "string",
"secondaryKey": "string"
}
],
"cloudToDevice": {
"defaultTtlAsIso8601": "string",
"feedback": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
},
"maxDeliveryCount": "int"
},
"comments": "string",
"enableFileUploadNotifications": "bool",
"eventHubEndpoints": {
"{customized property}": {
"partitionCount": "int",
"retentionTimeInDays": "int"
}
},
"features": "string",
"ipFilterRules": [
{
"action": "string",
"filterName": "string",
"ipMask": "string"
}
],
"messagingEndpoints": {
"{customized property}": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
}
},
"minTlsVersion": "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"
},
"tags": {
"{customized property}": "string"
}
}
Valori delle proprietà
CloudToDeviceProperties
Nome | Descrizione | Valore |
---|---|---|
defaultTtlAsIso8601 | Durata predefinita per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
Valutazione | Proprietà della coda di feedback per i messaggi da cloud a dispositivo. | FeedbackProprietà |
maxDeliveryCount | Numero massimo di recapito per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
Proprietà di arricchimento
Nome | Descrizione | Valore |
---|---|---|
endpointNames | Elenco di endpoint per cui viene applicato l'arricchimento al messaggio. | string[] (obbligatorio) |
chiave | Chiave o nome per la proprietà di arricchimento. | stringa (obbligatorio) |
valore | Valore per la proprietà di arricchimento. | stringa (obbligatorio) |
EventHubProperties
Nome | Descrizione | Valore |
---|---|---|
partitionCount | Numero di partizioni per la ricezione di messaggi da dispositivo a cloud nell'endpoint compatibile con Hub eventi. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
retentionTimeInDays | Tempo di conservazione per i messaggi da dispositivo a cloud in giorni. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
FallbackRouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la route di fallback. Se la condizione non viene fornita, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito solo 1 endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se la route di fallback è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda |
fonte | Origine a cui applicare la regola di routing. Ad esempio, DeviceMessages | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
FeedbackProperties
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco per la coda di commenti e suggerimenti. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
maxDeliveryCount | Numero di tentativi di recapito dell'hub IoT nella coda di feedback. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
IotHubProperties
Nome | Descrizione | Valore |
---|---|---|
authorizationPolicies | I criteri di accesso condiviso che è possibile usare per proteggere una connessione all'hub IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | Proprietà di messaggistica da cloud a dispositivo dell'hub IoT. | CloudToDeviceProperties |
Commenti | Commenti dell'hub IoT. | corda |
enableFileUploadNotifications | Se True, le notifiche di caricamento dei file sono abilitate. | Bool |
eventHubEndpoints | Proprietà dell'endpoint compatibili con Hub eventi. Le uniche chiavi possibili per questo dizionario sono gli eventi. Questa chiave deve essere presente nel dizionario durante l'esecuzione di chiamate di creazione o aggiornamento per l'hub IoT. | IotHubPropertiesEventHubEndpoints |
tratti somatici | Funzionalità e funzionalità abilitate per l'hub IoT. | 'DeviceManagement' 'Nessuno' |
ipFilterRules | Regole di filtro IP. | IpFilterRule[] |
messagingEndpoints | Proprietà dell'endpoint di messaggistica per la coda di notifica di caricamento file. | IotHubPropertiesMessagingEndpoints |
minTlsVersion | Specifica la versione minima di TLS da supportare per questo hub. Può essere impostato su "1.2" per fare in modo che i client che usano una versione TLS precedente alla 1.2 vengano rifiutati. | corda |
privateEndpointConnections | Connessioni endpoint private create in questo IotHub | PrivateEndpointConnection[] |
publicNetworkAccess | Indica se le richieste dalla rete pubblica sono consentite | 'Disabilitato' 'Enabled' |
instradamento | Proprietà correlate al routing dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | Elenco degli endpoint di Archiviazione di Azure in cui è possibile caricare i file. Attualmente è possibile configurare un solo account di archiviazione di Azure e che DEVE avere la relativa chiave come $default. Se si specificano più account di archiviazione, viene generato un errore. Se non si specifica un valore per questa proprietà quando la proprietà enableFileUploadNotifications è impostata su True, viene generato un errore. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesMessagingEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesStorageEndpoints
Nome | Descrizione | Valore |
---|
IotHubSkuInfo
Nome | Descrizione | Valore |
---|---|---|
capacità | Numero di unità dell'hub IoT di cui è stato effettuato il provisioning. Vedere: /azure/azure-subscription-service-limits#iot-hub-limits. | Int |
nome | Nome dello SKU. | 'B1' 'B2' 'B3' 'F1' 'S1' 'S2' 'S3' (obbligatorio) |
IpFilterRule
Nome | Descrizione | Valore |
---|---|---|
azione | Azione desiderata per le richieste acquisite da questa regola. | 'Accept' 'Reject' (obbligatorio) |
filterName | Nome della regola di filtro IP. | stringa (obbligatorio) |
ipMask | Stringa che contiene l'intervallo di indirizzi IP nella notazione CIDR per la regola. | stringa (obbligatorio) |
Proprietà MessagingEndpoint
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
maxDeliveryCount | Numero di tentativi di recapitare un messaggio nell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
Microsoft.Devices/IotHubs
Nome | Descrizione | Valore |
---|---|---|
apiVersion | Versione dell'API | '2020-03-01' |
etag | Il campo Etag è non obbligatorio. Se viene specificato nel corpo della risposta, deve anche essere fornito come intestazione in base alla normale convenzione ETag. | corda |
ubicazione | Percorso della risorsa. | stringa (obbligatorio) |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà IotHub | IotHubProperties |
Sku | Informazioni sullo SKU IotHub | IotHubSkuInfo (obbligatorio) |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. Vedere tag nei modelli |
digitare | Tipo di risorsa | 'Microsoft.Devices/IotHubs' |
PrivateEndpoint
Nome | Descrizione | Valore |
---|
PrivateEndpointConnection
Nome | Descrizione | Valore |
---|---|---|
proprietà | Proprietà di una connessione endpoint privato | PrivateEndpointConnectionProperties (obbligatorio) |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
Nome | Descrizione | Valore |
---|---|---|
actionsRequired | Azioni necessarie per una connessione all'endpoint privato | corda |
descrizione | Descrizione dello stato corrente di una connessione endpoint privato | stringa (obbligatorio) |
stato | Stato di una connessione endpoint privato | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' (obbligatorio) |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la regola di routing. Se non viene specificata alcuna condizione, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito un solo endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se una route è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
fonte | Origine a cui applicare la regola di routing, ad esempio DeviceMessages. | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
RoutingEndpoints
Nome | Descrizione | Valore |
---|---|---|
eventHubs | Elenco di endpoint di Hub eventi a cui l'hub IoT instrada i messaggi, in base alle regole di routing. Questo elenco non include l'endpoint predefinito di Hub eventi. | RoutingEventHubProperties[] |
serviceBusQueues | Elenco di endpoint della coda del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | Elenco di endpoint dell'argomento del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | Elenco di endpoint del contenitore di archiviazione a cui l'hub IoT instrada i messaggi in base alle regole di routing. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint dell'hub eventi | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'hub eventi. | corda |
endpointUri | URL dell'endpoint dell'hub eventi. Deve includere il protocollo sb:// | corda |
entityPath | Nome dell'hub eventi nello spazio dei nomi dell'hub eventi | corda |
Id | ID dell'endpoint dell'hub eventi | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'hub eventi. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'hub eventi. | corda |
RoutingProprietà
Nome | Descrizione | Valore |
---|---|---|
Endpoint | Le proprietà correlate agli endpoint personalizzati a cui l'hub IoT instrada i messaggi in base alle regole di routing. Un massimo di 10 endpoint personalizzati è consentito in tutti i tipi di endpoint per gli hub a pagamento e solo 1 endpoint personalizzato è consentito in tutti i tipi di endpoint per gli hub gratuiti. | routingEndpoints |
arricchimenti | Elenco di arricchimenti forniti dall'utente che l'hub IoT applica ai messaggi da recapitare agli endpoint predefiniti e personalizzati. Vedere: https://aka.ms/telemetryoneventgrid | proprietà di arricchimento |
fallbackRoute | Proprietà della route utilizzata come route di fallback quando non vengono soddisfatte le condizioni specificate nella sezione "route". Si tratta di un parametro facoltativo. Quando questa proprietà non è impostata, i messaggi che non soddisfano alcuna delle condizioni specificate nella sezione "route" vengono indirizzati all'endpoint eventhub predefinito. | FallbackRouteProperties |
Itinerari | Elenco di regole di routing fornite dall'utente usate dall'hub IoT per instradare i messaggi agli endpoint predefiniti e personalizzati. Per gli hub a pagamento sono consentiti un massimo di 100 regole di routing e sono consentite un massimo di 5 regole di routing per hub gratuiti. | proprietà route[] |
RoutingServiceBusQueueEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint della coda del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint della coda del bus di servizio. | corda |
endpointUri | URL dell'endpoint della coda del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nello spazio dei nomi del bus di servizio | corda |
Id | ID dell'endpoint della coda del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo della coda. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint della coda del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint della coda del bus di servizio. | corda |
RoutingServiceBusTopicEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint dell'argomento del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'argomento del bus di servizio. | corda |
endpointUri | URL dell'endpoint dell'argomento del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nell'argomento del bus di servizio | corda |
Id | ID dell'endpoint dell'argomento del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo dell'argomento. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'argomento del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'argomento del bus di servizio. | corda |
RoutingStorageContainerProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint di archiviazione | 'identityBased' 'keyBased' |
batchFrequencyInSeconds | Intervallo di tempo in cui i BLOB vengono scritti nell'archiviazione. Il valore deve essere compreso tra 60 e 720 secondi. Il valore predefinito è 300 secondi. | Int Vincoli: Valore minimo = 60 Valore massimo = 720 |
connectionString | Stringa di connessione dell'account di archiviazione. | corda |
containerName | Nome del contenitore di archiviazione nell'account di archiviazione. | stringa (obbligatorio) |
codifica | Codifica utilizzata per serializzare i messaggi nei BLOB. I valori supportati sono 'avro', 'avrodeflate' e 'JSON'. Il valore predefinito è 'avro'. | 'Avro' 'AvroDeflate' 'JSON' |
endpointUri | URL dell'endpoint di archiviazione. Deve includere il protocollo https:// | corda |
fileNameFormat | Formato del nome file per il BLOB. Il formato predefinito è {iothub}/{partition}/{AAAA}/{MM}/{DD}/{HH}/{mm}. Tutti i parametri sono obbligatori, ma possono essere riordinati. | corda |
Id | ID dell'endpoint del contenitore di archiviazione | corda |
maxChunkSizeInBytes | Numero massimo di byte per ogni BLOB scritto nell'archivio. Il valore deve essere compreso tra 10485760(10MB) e 524288000(500 MB). Il valore predefinito è 314572800(300 MB). | Int Vincoli: Valore minimo = 10485760 Valore massimo = 524288000 |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'account di archiviazione. | corda |
subscriptionId | Identificatore della sottoscrizione dell'account di archiviazione. | corda |
SharedAccessSignatureAuthorizationRule
Nome | Descrizione | Valore |
---|---|---|
keyName | Nome dei criteri di accesso condiviso. | stringa (obbligatorio) |
primaryKey | Chiave primaria. | corda |
diritti | Autorizzazioni assegnate ai criteri di accesso condiviso. | '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' (obbligatorio) |
secondaryKey | Chiave secondaria. | corda |
StorageEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Specifica il tipo di autenticazione usato per la connessione all'account di archiviazione. | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione per l'account di archiviazione di Azure in cui vengono caricati i file. | stringa (obbligatorio) |
containerName | Nome del contenitore radice in cui si caricano i file. Il contenitore non deve esistere, ma deve essere creato usando connectionString specificato. | stringa (obbligatorio) |
sasTtlAsIso8601 | Periodo di tempo per il quale l'URI di firma di accesso condiviso generato dall'hub IoT per il caricamento di file è valido. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-upload-notification-configuration-options. | corda |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Sagoma | Descrizione |
---|---|
Creare un ambiente con pagamento in base al consumo con un hub IoT |
Questo modello consente di distribuire un ambiente Time Series Insights con pagamento in base al consumo configurato per l'utilizzo di eventi da un hub IoT. |
Creare un hub IoT e un gruppo di consumer da dispositivo a cloud |
Questo modello consente di distribuire un'istanza dell'hub IoT con dispositivo nel cloud e nel cloud nelle configurazioni di messaggistica dei dispositivi e un dispositivo nel gruppo di consumer cloud. |
Creare un hub IOT e un simulatore perimetrale Ubuntu |
Questo modello crea un hub IOT e un simulatore perimetrale Ubuntu della macchina virtuale. |
Creare un servizio Device Provisioning in hub IoT |
Questo modello consente di creare un hub IoT e un servizio Device Provisioning in hub IoT e collegare i due servizi. |
Creare l'aggiornamento dei dispositivi per l'account dell'hub IoT, l'istanza, l'hub IoT |
Questo modello crea un account e un'istanza e un hub con cui collegare l'istanza. Configura l'hub con i criteri di accesso, le route e il gruppo di consumer necessari. |
Distribuire il servizio MedTech, incluso un hub IoT di Azure |
Il servizio MedTech è uno dei servizi dati di Integrità di Azure progettato per inserire i dati dei dispositivi da più dispositivi, trasformare i dati del dispositivo in osservazioni FHIR, che vengono quindi mantenuti nel servizio FHIR di Servizi dati di integrità di Azure. |
Usare il modello di Resource Manager per creare l'hub IoT, indirizzare e visualizzare i messaggi |
Usare questo modello per distribuire un hub IoT e un account di archiviazione. Eseguire un'app per inviare messaggi all'hub indirizzati all'archiviazione, quindi visualizzare i risultati. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa IotHubs può essere distribuito con operazioni destinate a:
- gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Devices/IotHubs, aggiungere il comando Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/IotHubs@2020-03-01"
name = "string"
etag = "string"
location = "string"
body = jsonencode({
properties = {
authorizationPolicies = [
{
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
}
]
cloudToDevice = {
defaultTtlAsIso8601 = "string"
feedback = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
maxDeliveryCount = int
}
comments = "string"
enableFileUploadNotifications = bool
eventHubEndpoints = {
{customized property} = {
partitionCount = int
retentionTimeInDays = int
}
}
features = "string"
ipFilterRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
}
]
messagingEndpoints = {
{customized property} = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
}
minTlsVersion = "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"
}
tags = {
{customized property} = "string"
}
}
Valori delle proprietà
CloudToDeviceProperties
Nome | Descrizione | Valore |
---|---|---|
defaultTtlAsIso8601 | Durata predefinita per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
Valutazione | Proprietà della coda di feedback per i messaggi da cloud a dispositivo. | FeedbackProprietà |
maxDeliveryCount | Numero massimo di recapito per i messaggi da cloud a dispositivo nella coda del dispositivo. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
Proprietà di arricchimento
Nome | Descrizione | Valore |
---|---|---|
endpointNames | Elenco di endpoint per cui viene applicato l'arricchimento al messaggio. | string[] (obbligatorio) |
chiave | Chiave o nome per la proprietà di arricchimento. | stringa (obbligatorio) |
valore | Valore per la proprietà di arricchimento. | stringa (obbligatorio) |
EventHubProperties
Nome | Descrizione | Valore |
---|---|---|
partitionCount | Numero di partizioni per la ricezione di messaggi da dispositivo a cloud nell'endpoint compatibile con Hub eventi. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
retentionTimeInDays | Tempo di conservazione per i messaggi da dispositivo a cloud in giorni. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
FallbackRouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la route di fallback. Se la condizione non viene fornita, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito solo 1 endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se la route di fallback è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda |
fonte | Origine a cui applicare la regola di routing. Ad esempio, DeviceMessages | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
FeedbackProperties
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco per la coda di commenti e suggerimenti. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
maxDeliveryCount | Numero di tentativi di recapito dell'hub IoT nella coda di feedback. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | corda |
IotHubProperties
Nome | Descrizione | Valore |
---|---|---|
authorizationPolicies | I criteri di accesso condiviso che è possibile usare per proteggere una connessione all'hub IoT. | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | Proprietà di messaggistica da cloud a dispositivo dell'hub IoT. | CloudToDeviceProperties |
Commenti | Commenti dell'hub IoT. | corda |
enableFileUploadNotifications | Se True, le notifiche di caricamento dei file sono abilitate. | Bool |
eventHubEndpoints | Proprietà dell'endpoint compatibili con Hub eventi. Le uniche chiavi possibili per questo dizionario sono gli eventi. Questa chiave deve essere presente nel dizionario durante l'esecuzione di chiamate di creazione o aggiornamento per l'hub IoT. | IotHubPropertiesEventHubEndpoints |
tratti somatici | Funzionalità e funzionalità abilitate per l'hub IoT. | 'DeviceManagement' 'Nessuno' |
ipFilterRules | Regole di filtro IP. | IpFilterRule[] |
messagingEndpoints | Proprietà dell'endpoint di messaggistica per la coda di notifica di caricamento file. | IotHubPropertiesMessagingEndpoints |
minTlsVersion | Specifica la versione minima di TLS da supportare per questo hub. Può essere impostato su "1.2" per fare in modo che i client che usano una versione TLS precedente alla 1.2 vengano rifiutati. | corda |
privateEndpointConnections | Connessioni endpoint private create in questo IotHub | PrivateEndpointConnection[] |
publicNetworkAccess | Indica se le richieste dalla rete pubblica sono consentite | 'Disabilitato' 'Enabled' |
instradamento | Proprietà correlate al routing dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | Elenco degli endpoint di Archiviazione di Azure in cui è possibile caricare i file. Attualmente è possibile configurare un solo account di archiviazione di Azure e che DEVE avere la relativa chiave come $default. Se si specificano più account di archiviazione, viene generato un errore. Se non si specifica un valore per questa proprietà quando la proprietà enableFileUploadNotifications è impostata su True, viene generato un errore. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesMessagingEndpoints
Nome | Descrizione | Valore |
---|
IotHubPropertiesStorageEndpoints
Nome | Descrizione | Valore |
---|
IotHubSkuInfo
Nome | Descrizione | Valore |
---|---|---|
capacità | Numero di unità dell'hub IoT di cui è stato effettuato il provisioning. Vedere: /azure/azure-subscription-service-limits#iot-hub-limits. | Int |
nome | Nome dello SKU. | 'B1' 'B2' 'B3' 'F1' 'S1' 'S2' 'S3' (obbligatorio) |
IpFilterRule
Nome | Descrizione | Valore |
---|---|---|
azione | Azione desiderata per le richieste acquisite da questa regola. | 'Accept' 'Reject' (obbligatorio) |
filterName | Nome della regola di filtro IP. | stringa (obbligatorio) |
ipMask | Stringa che contiene l'intervallo di indirizzi IP nella notazione CIDR per la regola. | stringa (obbligatorio) |
Proprietà MessagingEndpoint
Nome | Descrizione | Valore |
---|---|---|
lockDurationAsIso8601 | Durata del blocco. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
maxDeliveryCount | Numero di tentativi di recapitare un messaggio nell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Vincoli: Valore minimo = 1 Valore massimo = 100 |
ttlAsIso8601 | Periodo di tempo per il quale un messaggio è disponibile per l'utilizzo prima della scadenza dell'hub IoT. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload. | corda |
Microsoft.Devices/IotHubs
Nome | Descrizione | Valore |
---|---|---|
etag | Il campo Etag è non obbligatorio. Se viene specificato nel corpo della risposta, deve anche essere fornito come intestazione in base alla normale convenzione ETag. | corda |
ubicazione | Percorso della risorsa. | stringa (obbligatorio) |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà IotHub | IotHubProperties |
Sku | Informazioni sullo SKU IotHub | IotHubSkuInfo (obbligatorio) |
Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
digitare | Tipo di risorsa | "Microsoft.Devices/IotHubs@2020-03-01" |
PrivateEndpoint
Nome | Descrizione | Valore |
---|
PrivateEndpointConnection
Nome | Descrizione | Valore |
---|---|---|
proprietà | Proprietà di una connessione endpoint privato | PrivateEndpointConnectionProperties (obbligatorio) |
PrivateEndpointConnectionProperties
PrivateLinkServiceConnectionState
Nome | Descrizione | Valore |
---|---|---|
actionsRequired | Azioni necessarie per una connessione all'endpoint privato | corda |
descrizione | Descrizione dello stato corrente di una connessione endpoint privato | stringa (obbligatorio) |
stato | Stato di una connessione endpoint privato | 'Approvato' 'Disconnesso' 'In sospeso' 'Rejected' (obbligatorio) |
ResourceTags
Nome | Descrizione | Valore |
---|
RouteProperties
Nome | Descrizione | Valore |
---|---|---|
condizione | Condizione valutata per applicare la regola di routing. Se non viene specificata alcuna condizione, restituisce true per impostazione predefinita. Per la grammatica, vedere: /azure/iot-hub/iot-hub-devguide-query-language | corda |
endpointNames | Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito un solo endpoint. | string[] (obbligatorio) |
isEnabled | Consente di specificare se una route è abilitata. | bool (obbligatorio) |
nome | Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, ha una lunghezza massima di 64 caratteri e deve essere univoco. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
fonte | Origine a cui applicare la regola di routing, ad esempio DeviceMessages. | 'DeviceJobLifecycleEvents' 'DeviceLifecycleEvents' 'DeviceMessages' 'Invalid' 'TwinChangeEvents' (obbligatorio) |
RoutingEndpoints
Nome | Descrizione | Valore |
---|---|---|
eventHubs | Elenco di endpoint di Hub eventi a cui l'hub IoT instrada i messaggi, in base alle regole di routing. Questo elenco non include l'endpoint predefinito di Hub eventi. | RoutingEventHubProperties[] |
serviceBusQueues | Elenco di endpoint della coda del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | Elenco di endpoint dell'argomento del bus di servizio a cui l'hub IoT indirizza i messaggi, in base alle regole di routing. | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | Elenco di endpoint del contenitore di archiviazione a cui l'hub IoT instrada i messaggi in base alle regole di routing. | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint dell'hub eventi | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'hub eventi. | corda |
endpointUri | URL dell'endpoint dell'hub eventi. Deve includere il protocollo sb:// | corda |
entityPath | Nome dell'hub eventi nello spazio dei nomi dell'hub eventi | corda |
Id | ID dell'endpoint dell'hub eventi | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'hub eventi. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'hub eventi. | corda |
RoutingProprietà
Nome | Descrizione | Valore |
---|---|---|
Endpoint | Le proprietà correlate agli endpoint personalizzati a cui l'hub IoT instrada i messaggi in base alle regole di routing. Un massimo di 10 endpoint personalizzati è consentito in tutti i tipi di endpoint per gli hub a pagamento e solo 1 endpoint personalizzato è consentito in tutti i tipi di endpoint per gli hub gratuiti. | routingEndpoints |
arricchimenti | Elenco di arricchimenti forniti dall'utente che l'hub IoT applica ai messaggi da recapitare agli endpoint predefiniti e personalizzati. Vedere: https://aka.ms/telemetryoneventgrid | proprietà di arricchimento |
fallbackRoute | Proprietà della route utilizzata come route di fallback quando non vengono soddisfatte le condizioni specificate nella sezione "route". Si tratta di un parametro facoltativo. Quando questa proprietà non è impostata, i messaggi che non soddisfano alcuna delle condizioni specificate nella sezione "route" vengono indirizzati all'endpoint eventhub predefinito. | FallbackRouteProperties |
Itinerari | Elenco di regole di routing fornite dall'utente usate dall'hub IoT per instradare i messaggi agli endpoint predefiniti e personalizzati. Per gli hub a pagamento sono consentiti un massimo di 100 regole di routing e sono consentite un massimo di 5 regole di routing per hub gratuiti. | proprietà route[] |
RoutingServiceBusQueueEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint della coda del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint della coda del bus di servizio. | corda |
endpointUri | URL dell'endpoint della coda del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nello spazio dei nomi del bus di servizio | corda |
Id | ID dell'endpoint della coda del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo della coda. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint della coda del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint della coda del bus di servizio. | corda |
RoutingServiceBusTopicEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per eseguire l'autenticazione nell'endpoint dell'argomento del bus di servizio | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione dell'endpoint dell'argomento del bus di servizio. | corda |
endpointUri | URL dell'endpoint dell'argomento del bus di servizio. Deve includere il protocollo sb:// | corda |
entityPath | Nome della coda nell'argomento del bus di servizio | corda |
Id | ID dell'endpoint dell'argomento del bus di servizio | corda |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. Il nome non deve corrispondere al nome effettivo dell'argomento. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'endpoint dell'argomento del bus di servizio. | corda |
subscriptionId | Identificatore della sottoscrizione dell'endpoint dell'argomento del bus di servizio. | corda |
RoutingStorageContainerProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Metodo usato per l'autenticazione nell'endpoint di archiviazione | 'identityBased' 'keyBased' |
batchFrequencyInSeconds | Intervallo di tempo in cui i BLOB vengono scritti nell'archiviazione. Il valore deve essere compreso tra 60 e 720 secondi. Il valore predefinito è 300 secondi. | Int Vincoli: Valore minimo = 60 Valore massimo = 720 |
connectionString | Stringa di connessione dell'account di archiviazione. | corda |
containerName | Nome del contenitore di archiviazione nell'account di archiviazione. | stringa (obbligatorio) |
codifica | Codifica utilizzata per serializzare i messaggi nei BLOB. I valori supportati sono 'avro', 'avrodeflate' e 'JSON'. Il valore predefinito è 'avro'. | 'Avro' 'AvroDeflate' 'JSON' |
endpointUri | URL dell'endpoint di archiviazione. Deve includere il protocollo https:// | corda |
fileNameFormat | Formato del nome file per il BLOB. Il formato predefinito è {iothub}/{partition}/{AAAA}/{MM}/{DD}/{HH}/{mm}. Tutti i parametri sono obbligatori, ma possono essere riordinati. | corda |
Id | ID dell'endpoint del contenitore di archiviazione | corda |
maxChunkSizeInBytes | Numero massimo di byte per ogni BLOB scritto nell'archivio. Il valore deve essere compreso tra 10485760(10MB) e 524288000(500 MB). Il valore predefinito è 314572800(300 MB). | Int Vincoli: Valore minimo = 10485760 Valore massimo = 524288000 |
nome | Nome che identifica questo endpoint. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini e ha una lunghezza massima di 64 caratteri. I nomi seguenti sono riservati: eventi, fileNotifications, $default. I nomi degli endpoint devono essere univoci tra i tipi di endpoint. | corda Vincoli: Pattern = ^[A-Za-z0-9-._]{1,64}$ (obbligatorio) |
resourceGroup | Nome del gruppo di risorse dell'account di archiviazione. | corda |
subscriptionId | Identificatore della sottoscrizione dell'account di archiviazione. | corda |
SharedAccessSignatureAuthorizationRule
Nome | Descrizione | Valore |
---|---|---|
keyName | Nome dei criteri di accesso condiviso. | stringa (obbligatorio) |
primaryKey | Chiave primaria. | corda |
diritti | Autorizzazioni assegnate ai criteri di accesso condiviso. | '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' (obbligatorio) |
secondaryKey | Chiave secondaria. | corda |
StorageEndpointProperties
Nome | Descrizione | Valore |
---|---|---|
authenticationType | Specifica il tipo di autenticazione usato per la connessione all'account di archiviazione. | 'identityBased' 'keyBased' |
connectionString | Stringa di connessione per l'account di archiviazione di Azure in cui vengono caricati i file. | stringa (obbligatorio) |
containerName | Nome del contenitore radice in cui si caricano i file. Il contenitore non deve esistere, ma deve essere creato usando connectionString specificato. | stringa (obbligatorio) |
sasTtlAsIso8601 | Periodo di tempo per il quale l'URI di firma di accesso condiviso generato dall'hub IoT per il caricamento di file è valido. Vedere: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-upload-notification-configuration-options. | corda |