Microsoft.Devices IotHubs 2016-02-03
- najnowsze
- 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
- 2021-03-03-preview
- 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
- 2018-12-01-preview
- 2018-04-01
- 2018-01-22
- 2017-07-01
- 2017-01-19
- 2016-02-03
Definicja zasobu Bicep
Typ zasobu IotHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Devices/IotHubs, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Devices/IotHubs@2016-02-03' = {
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'
}
}
operationsMonitoringProperties: {
events: {
{customized property}: 'string'
}
}
storageEndpoints: {
{customized property}: {
connectionString: 'string'
containerName: 'string'
sasTtlAsIso8601: 'string'
}
}
}
resourcegroup: 'string'
sku: {
capacity: int
name: 'string'
}
subscriptionid: 'string'
tags: {
{customized property}: 'string'
}
}
Wartości właściwości
CloudToDeviceProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultTtlAsIso8601 | Domyślny czas wygaśnięcia komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| sprzężenie zwrotne | Właściwości kolejki opinii dla komunikatów z chmury do urządzenia. | FeedbackProperties |
| maxDeliveryCount | Maksymalna liczba dostaw komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
EventHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| partitionCount | Liczba partycji do odbierania komunikatów z urządzenia do chmury w punkcie końcowym zgodnym z centrum zdarzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
| retentionTimeInDays | Czas przechowywania komunikatów z urządzenia do chmury w dniach. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
OpinieWłaściwości
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady kolejki opinii. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu w kolejce opinii przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
IotHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| authorizationPolicies | Zasady dostępu współdzielonego, których można użyć do zabezpieczenia połączenia z centrum IoT. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Właściwości obsługi komunikatów w chmurze do urządzenia w usłudze IoT Hub. | CloudToDeviceProperties |
| Komentarze | Komentarze. | struna |
| enableFileUploadNotifications | Jeśli wartość True, powiadomienia dotyczące przekazywania plików są włączone. | Bool |
| eventHubEndpoints | Właściwości punktu końcowego zgodnego z centrum zdarzeń. Możliwe klucze do tego słownika to zdarzenia i operacjeMonitoringEvents. Oba te klucze muszą być obecne w słowniku podczas tworzenia lub aktualizowania wywołań dla centrum IoT. | IotHubPropertiesEventHubEndpoints |
| Funkcje | Możliwości i funkcje włączone dla centrum IoT Hub. | "DeviceManagement" "Brak" |
| ipFilterRules | Reguły filtrowania adresów IP. | IpFilterRule [] |
| messagingEndpoints | Właściwości punktu końcowego obsługi komunikatów dla kolejki powiadomień przekazywania pliku. | IotHubPropertiesMessagingEndpoints |
| operationsMonitoringProperties | Właściwości monitorowania operacji dla centrum IoT. Możliwe klucze do słownika to Połączenia, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations. | OperationsMonitoringProperties |
| storageEndpoints | Lista punktów końcowych usługi Azure Storage, w których można przekazywać pliki. Obecnie można skonfigurować tylko jedno konto usługi Azure Storage i musi mieć jego klucz jako $default. Określenie więcej niż jednego konta magazynu powoduje zgłoszenie błędu. Nie określono wartości dla tej właściwości, gdy właściwość enableFileUploadNotifications jest ustawiona na wartość True, co powoduje zgłoszenie błędu. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesMessagingEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesStorageEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubSkuInfo
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Liczba aprowizowania jednostek usługi IoT Hub. Zobacz: /azure/azure-subscription-service-limits#iot-hub-limits. | int (wymagane) |
| nazwa | Nazwa jednostki SKU. | "F1" "S1" "S2" "S3" (wymagane) |
IpFilterRule
| Nazwa | Opis | Wartość |
|---|---|---|
| akcja | Żądana akcja żądań przechwyconych przez tę regułę. | "Zaakceptuj" "Odrzuć" (wymagane) |
| filterName | Nazwa reguły filtru adresów IP. | ciąg (wymagany) |
| maska ip | Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły. | ciąg (wymagany) |
MessagingEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
Microsoft.Devices/IotHubs
| Nazwa | Opis | Wartość |
|---|---|---|
| etag | Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag. | struna |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości centrum IoT Hub. | IotHubProperties |
| grupa zasobów | Nazwa grupy zasobów, która zawiera centrum IoT. Nazwa grupy zasobów jednoznacznie identyfikuje grupę zasobów w ramach subskrypcji. | ciąg (wymagany) |
| Numer jednostki magazynowej | Informacje o jednostce SKU centrum IoT. | IotHubSkuInfo (wymagane) |
| subscriptionid | Identyfikator subskrypcji. | ciąg (wymagany) |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
OperationsMonitoringProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Zdarzenia | Słownik <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
OperationsMonitoringPropertiesEvents
| Nazwa | Opis | Wartość |
|---|
Tagi zasobów
| Nazwa | Opis | Wartość |
|---|
SharedAccessSignatureAuthorizationRule
| Nazwa | Opis | Wartość |
|---|---|---|
| keyName | Nazwa zasad dostępu współdzielonego. | ciąg (wymagany) |
| primaryKey | Klucz podstawowy. | struna |
| prawa | Uprawnienia przypisane do zasad dostępu współdzielonego. | "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" (wymagane) |
| secondaryKey | Klucz pomocniczy. | struna |
StorageEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionString | Parametry połączenia dla konta usługi Azure Storage, do którego są przekazywane pliki. | ciąg (wymagany) |
| containerName | Nazwa kontenera głównego, w którym są przekazywane pliki. Kontener nie musi istnieć, ale powinien być creatable przy użyciu określonego parametru connectionString. | ciąg (wymagany) |
| sasTtlAsIso8601 | Okres, dla którego identyfikator URI sygnatury dostępu współdzielonego wygenerowany przez usługę IoT Hub na potrzeby przekazywania plików jest prawidłowy. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | struna |
Przykłady z przewodnika Szybki start
W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.
| Plik Bicep | Opis |
|---|---|
| tworzenie usługi IoT Hub i grupy odbiorców urządzenia do chmury | Ten szablon umożliwia wdrożenie wystąpienia usługi IoT Hub z urządzeniem w chmurze i w chmurze w konfiguracjach obsługi komunikatów urządzeń oraz urządzenia w grupie odbiorców w chmurze. |
| tworzenie usługi IoT Hub Device Provisioning Service | Ten szablon umożliwia utworzenie centrum IoT i usługi IoT Hub Device Provisioning Oraz połączenie tych dwóch usług. |
| Tworzenie aktualizacji urządzenia dla konta usługi IoT Hub, wystąpienia, usługi IoT Hub | Ten szablon tworzy konto, wystąpienie i centrum w celu połączenia wystąpienia z nim. Konfiguruje koncentrator z niezbędnymi zasadami dostępu, trasami i grupą konsumentów. |
| Wdrażanie usługi MedTech, w tym usługi Azure IoT Hub | Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
| Tworzenie usługi IoT Hub za pomocą szablonu usługi ARM, kierowanie i wyświetlanie komunikatów | Użyj tego szablonu, aby wdrożyć usługę IoT Hub i konto magazynu. Uruchom aplikację, aby wysyłać komunikaty do centrum, które są kierowane do magazynu, a następnie wyświetlać wyniki. |
Definicja zasobu szablonu usługi ARM
Typ zasobu IotHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Devices/IotHubs, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2016-02-03",
"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"
}
},
"operationsMonitoringProperties": {
"events": {
"{customized property}": "string"
}
},
"storageEndpoints": {
"{customized property}": {
"connectionString": "string",
"containerName": "string",
"sasTtlAsIso8601": "string"
}
}
},
"resourcegroup": "string",
"sku": {
"capacity": "int",
"name": "string"
},
"subscriptionid": "string",
"tags": {
"{customized property}": "string"
}
}
Wartości właściwości
CloudToDeviceProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultTtlAsIso8601 | Domyślny czas wygaśnięcia komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| sprzężenie zwrotne | Właściwości kolejki opinii dla komunikatów z chmury do urządzenia. | FeedbackProperties |
| maxDeliveryCount | Maksymalna liczba dostaw komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
EventHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| partitionCount | Liczba partycji do odbierania komunikatów z urządzenia do chmury w punkcie końcowym zgodnym z centrum zdarzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
| retentionTimeInDays | Czas przechowywania komunikatów z urządzenia do chmury w dniach. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
OpinieWłaściwości
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady kolejki opinii. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu w kolejce opinii przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
IotHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| authorizationPolicies | Zasady dostępu współdzielonego, których można użyć do zabezpieczenia połączenia z centrum IoT. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Właściwości obsługi komunikatów w chmurze do urządzenia w usłudze IoT Hub. | CloudToDeviceProperties |
| Komentarze | Komentarze. | struna |
| enableFileUploadNotifications | Jeśli wartość True, powiadomienia dotyczące przekazywania plików są włączone. | Bool |
| eventHubEndpoints | Właściwości punktu końcowego zgodnego z centrum zdarzeń. Możliwe klucze do tego słownika to zdarzenia i operacjeMonitoringEvents. Oba te klucze muszą być obecne w słowniku podczas tworzenia lub aktualizowania wywołań dla centrum IoT. | IotHubPropertiesEventHubEndpoints |
| Funkcje | Możliwości i funkcje włączone dla centrum IoT Hub. | "DeviceManagement" "Brak" |
| ipFilterRules | Reguły filtrowania adresów IP. | IpFilterRule [] |
| messagingEndpoints | Właściwości punktu końcowego obsługi komunikatów dla kolejki powiadomień przekazywania pliku. | IotHubPropertiesMessagingEndpoints |
| operationsMonitoringProperties | Właściwości monitorowania operacji dla centrum IoT. Możliwe klucze do słownika to Połączenia, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations. | OperationsMonitoringProperties |
| storageEndpoints | Lista punktów końcowych usługi Azure Storage, w których można przekazywać pliki. Obecnie można skonfigurować tylko jedno konto usługi Azure Storage i musi mieć jego klucz jako $default. Określenie więcej niż jednego konta magazynu powoduje zgłoszenie błędu. Nie określono wartości dla tej właściwości, gdy właściwość enableFileUploadNotifications jest ustawiona na wartość True, co powoduje zgłoszenie błędu. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesMessagingEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesStorageEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubSkuInfo
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Liczba aprowizowania jednostek usługi IoT Hub. Zobacz: /azure/azure-subscription-service-limits#iot-hub-limits. | int (wymagane) |
| nazwa | Nazwa jednostki SKU. | "F1" "S1" "S2" "S3" (wymagane) |
IpFilterRule
| Nazwa | Opis | Wartość |
|---|---|---|
| akcja | Żądana akcja żądań przechwyconych przez tę regułę. | "Zaakceptuj" "Odrzuć" (wymagane) |
| filterName | Nazwa reguły filtru adresów IP. | ciąg (wymagany) |
| maska ip | Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły. | ciąg (wymagany) |
MessagingEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
Microsoft.Devices/IotHubs
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2016-02-03' |
| etag | Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag. | struna |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości centrum IoT Hub. | IotHubProperties |
| grupa zasobów | Nazwa grupy zasobów, która zawiera centrum IoT. Nazwa grupy zasobów jednoznacznie identyfikuje grupę zasobów w ramach subskrypcji. | ciąg (wymagany) |
| Numer jednostki magazynowej | Informacje o jednostce SKU centrum IoT. | IotHubSkuInfo (wymagane) |
| subscriptionid | Identyfikator subskrypcji. | ciąg (wymagany) |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | "Microsoft.Devices/IotHubs" |
OperationsMonitoringProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Zdarzenia | Słownik <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
OperationsMonitoringPropertiesEvents
| Nazwa | Opis | Wartość |
|---|
Tagi zasobów
| Nazwa | Opis | Wartość |
|---|
SharedAccessSignatureAuthorizationRule
| Nazwa | Opis | Wartość |
|---|---|---|
| keyName | Nazwa zasad dostępu współdzielonego. | ciąg (wymagany) |
| primaryKey | Klucz podstawowy. | struna |
| prawa | Uprawnienia przypisane do zasad dostępu współdzielonego. | "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" (wymagane) |
| secondaryKey | Klucz pomocniczy. | struna |
StorageEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionString | Parametry połączenia dla konta usługi Azure Storage, do którego są przekazywane pliki. | ciąg (wymagany) |
| containerName | Nazwa kontenera głównego, w którym są przekazywane pliki. Kontener nie musi istnieć, ale powinien być creatable przy użyciu określonego parametru connectionString. | ciąg (wymagany) |
| sasTtlAsIso8601 | Okres, dla którego identyfikator URI sygnatury dostępu współdzielonego wygenerowany przez usługę IoT Hub na potrzeby przekazywania plików jest prawidłowy. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | struna |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Szablon | Opis |
|---|---|
|
tworzenie środowiska płatności zgodnie z rzeczywistym użyciem (PAYG) przy użyciu usługi IoT Hub wdrażanie  |
Ten szablon umożliwia wdrożenie środowiska usługi Time Series Insights z płatnością zgodnie z rzeczywistym użyciem (PAYG), które jest skonfigurowane do korzystania ze zdarzeń z usługi IoT Hub. |
|
tworzenie usługi IoT Hub i grupy odbiorców urządzenia do chmury wdrażanie |
Ten szablon umożliwia wdrożenie wystąpienia usługi IoT Hub z urządzeniem w chmurze i w chmurze w konfiguracjach obsługi komunikatów urządzeń oraz urządzenia w grupie odbiorców w chmurze. |
|
Tworzenie symulatora usługi IOT Hub i ubuntu edge wdrażanie |
Ten szablon umożliwia utworzenie symulatora brzegowego centrum IOT i maszyny wirtualnej z systemem Ubuntu. |
|
tworzenie usługi IoT Hub Device Provisioning Service wdrażanie |
Ten szablon umożliwia utworzenie centrum IoT i usługi IoT Hub Device Provisioning Oraz połączenie tych dwóch usług. |
|
Tworzenie aktualizacji urządzenia dla konta usługi IoT Hub, wystąpienia, usługi IoT Hub wdrażanie |
Ten szablon tworzy konto, wystąpienie i centrum w celu połączenia wystąpienia z nim. Konfiguruje koncentrator z niezbędnymi zasadami dostępu, trasami i grupą konsumentów. |
|
Wdrażanie usługi MedTech, w tym usługi Azure IoT Hub wdrażanie |
Usługa MedTech jest jedną z usług Azure Health Data Services zaprojektowanych do pozyskiwania danych urządzeń z wielu urządzeń, przekształcania danych urządzenia w obserwacje FHIR, które następnie są utrwalane w usłudze FHIR usług Azure Health Data Services. |
|
Tworzenie usługi IoT Hub za pomocą szablonu usługi ARM, kierowanie i wyświetlanie komunikatów wdrażanie |
Użyj tego szablonu, aby wdrożyć usługę IoT Hub i konto magazynu. Uruchom aplikację, aby wysyłać komunikaty do centrum, które są kierowane do magazynu, a następnie wyświetlać wyniki. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu IotHubs można wdrożyć przy użyciu operacji docelowych:
- grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Devices/IotHubs, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/IotHubs@2016-02-03"
name = "string"
etag = "string"
location = "string"
resourcegroup = "string"
sku = {
capacity = int
name = "string"
}
subscriptionid = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
authorizationPolicies = [
{
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
}
]
cloudToDevice = {
defaultTtlAsIso8601 = "string"
feedback = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
maxDeliveryCount = int
}
comments = "string"
enableFileUploadNotifications = bool
eventHubEndpoints = {
{customized property} = {
partitionCount = int
retentionTimeInDays = int
}
}
features = "string"
ipFilterRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
}
]
messagingEndpoints = {
{customized property} = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
}
operationsMonitoringProperties = {
events = {
{customized property} = "string"
}
}
storageEndpoints = {
{customized property} = {
connectionString = "string"
containerName = "string"
sasTtlAsIso8601 = "string"
}
}
}
})
}
Wartości właściwości
CloudToDeviceProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| defaultTtlAsIso8601 | Domyślny czas wygaśnięcia komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| sprzężenie zwrotne | Właściwości kolejki opinii dla komunikatów z chmury do urządzenia. | FeedbackProperties |
| maxDeliveryCount | Maksymalna liczba dostaw komunikatów z chmury do urządzenia w kolejce urządzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
EventHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| partitionCount | Liczba partycji do odbierania komunikatów z urządzenia do chmury w punkcie końcowym zgodnym z centrum zdarzeń. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | Int |
| retentionTimeInDays | Czas przechowywania komunikatów z urządzenia do chmury w dniach. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | Int |
OpinieWłaściwości
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady kolejki opinii. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu w kolejce opinii przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | struna |
IotHubProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| authorizationPolicies | Zasady dostępu współdzielonego, których można użyć do zabezpieczenia połączenia z centrum IoT. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Właściwości obsługi komunikatów w chmurze do urządzenia w usłudze IoT Hub. | CloudToDeviceProperties |
| Komentarze | Komentarze. | struna |
| enableFileUploadNotifications | Jeśli wartość True, powiadomienia dotyczące przekazywania plików są włączone. | Bool |
| eventHubEndpoints | Właściwości punktu końcowego zgodnego z centrum zdarzeń. Możliwe klucze do tego słownika to zdarzenia i operacjeMonitoringEvents. Oba te klucze muszą być obecne w słowniku podczas tworzenia lub aktualizowania wywołań dla centrum IoT. | IotHubPropertiesEventHubEndpoints |
| Funkcje | Możliwości i funkcje włączone dla centrum IoT Hub. | "DeviceManagement" "Brak" |
| ipFilterRules | Reguły filtrowania adresów IP. | IpFilterRule [] |
| messagingEndpoints | Właściwości punktu końcowego obsługi komunikatów dla kolejki powiadomień przekazywania pliku. | IotHubPropertiesMessagingEndpoints |
| operationsMonitoringProperties | Właściwości monitorowania operacji dla centrum IoT. Możliwe klucze do słownika to Połączenia, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations. | OperationsMonitoringProperties |
| storageEndpoints | Lista punktów końcowych usługi Azure Storage, w których można przekazywać pliki. Obecnie można skonfigurować tylko jedno konto usługi Azure Storage i musi mieć jego klucz jako $default. Określenie więcej niż jednego konta magazynu powoduje zgłoszenie błędu. Nie określono wartości dla tej właściwości, gdy właściwość enableFileUploadNotifications jest ustawiona na wartość True, co powoduje zgłoszenie błędu. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesEventHubEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesMessagingEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubPropertiesStorageEndpoints
| Nazwa | Opis | Wartość |
|---|
IotHubSkuInfo
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Liczba aprowizowania jednostek usługi IoT Hub. Zobacz: /azure/azure-subscription-service-limits#iot-hub-limits. | int (wymagane) |
| nazwa | Nazwa jednostki SKU. | "F1" "S1" "S2" "S3" (wymagane) |
IpFilterRule
| Nazwa | Opis | Wartość |
|---|---|---|
| akcja | Żądana akcja żądań przechwyconych przez tę regułę. | "Zaakceptuj" "Odrzuć" (wymagane) |
| filterName | Nazwa reguły filtru adresów IP. | ciąg (wymagany) |
| maska ip | Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły. | ciąg (wymagany) |
MessagingEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| lockDurationAsIso8601 | Czas trwania blokady. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
| maxDeliveryCount | Liczba prób dostarczenia komunikatu przez centrum IoT Hub. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 100 |
| ttlAsIso8601 | Okres, przez który komunikat jest dostępny do użytku, zanim wygaśnie przez centrum IoT. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload. | struna |
Microsoft.Devices/IotHubs
| Nazwa | Opis | Wartość |
|---|---|---|
| etag | Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag. | struna |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości centrum IoT Hub. | IotHubProperties |
| grupa zasobów | Nazwa grupy zasobów, która zawiera centrum IoT. Nazwa grupy zasobów jednoznacznie identyfikuje grupę zasobów w ramach subskrypcji. | ciąg (wymagany) |
| Numer jednostki magazynowej | Informacje o jednostce SKU centrum IoT. | IotHubSkuInfo (wymagane) |
| subscriptionid | Identyfikator subskrypcji. | ciąg (wymagany) |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.Devices/IotHubs@2016-02-03" |
OperationsMonitoringProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| Zdarzenia | Słownik <OperationMonitoringLevel> | OperationsMonitoringPropertiesEvents |
OperationsMonitoringPropertiesEvents
| Nazwa | Opis | Wartość |
|---|
Tagi zasobów
| Nazwa | Opis | Wartość |
|---|
SharedAccessSignatureAuthorizationRule
| Nazwa | Opis | Wartość |
|---|---|---|
| keyName | Nazwa zasad dostępu współdzielonego. | ciąg (wymagany) |
| primaryKey | Klucz podstawowy. | struna |
| prawa | Uprawnienia przypisane do zasad dostępu współdzielonego. | "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" (wymagane) |
| secondaryKey | Klucz pomocniczy. | struna |
StorageEndpointProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionString | Parametry połączenia dla konta usługi Azure Storage, do którego są przekazywane pliki. | ciąg (wymagany) |
| containerName | Nazwa kontenera głównego, w którym są przekazywane pliki. Kontener nie musi istnieć, ale powinien być creatable przy użyciu określonego parametru connectionString. | ciąg (wymagany) |
| sasTtlAsIso8601 | Okres, dla którego identyfikator URI sygnatury dostępu współdzielonego wygenerowany przez usługę IoT Hub na potrzeby przekazywania plików jest prawidłowy. Zobacz: /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | struna |