Microsoft.Devices IotHubs 2019-03-22-preview
- последние
- 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
Определение ресурсов Bicep
Тип ресурса IotHubs можно развернуть с помощью операций, предназначенных для следующих целей:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Devices/IotHubs, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.Devices/IotHubs@2019-03-22-preview' = {
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'
deviceStreams: {
streamingEndpoints: [
'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'
}
}
routing: {
endpoints: {
eventHubs: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusQueues: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
serviceBusTopics: [
{
connectionString: 'string'
name: 'string'
resourceGroup: 'string'
subscriptionId: 'string'
}
]
storageContainers: [
{
batchFrequencyInSeconds: int
connectionString: 'string'
containerName: 'string'
encoding: 'string'
fileNameFormat: '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}: {
connectionString: 'string'
containerName: 'string'
sasTtlAsIso8601: 'string'
}
}
}
sku: {
capacity: int
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
Значения свойств
CloudToDeviceProperties
| Имя | Описание | Ценность |
|---|---|---|
| defaultTtlAsIso8601 | Время ожидания по умолчанию для сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| обратная связь | Свойства очереди отзывов для сообщений из облака на устройство. | отзывов |
| maxDeliveryCount | Максимальное количество доставки сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
ОбогащениеProperties
| Имя | Описание | Ценность |
|---|---|---|
| endpointNames | Список конечных точек, для которых применяется обогащение к сообщению. | string[] (обязательно) |
| ключ | Ключ или имя свойства обогащения. | строка (обязательно) |
| ценность | Значение свойства обогащения. | строка (обязательно) |
EventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| partitionCount | Количество секций для получения сообщений, совместимых с устройством в облаке, в конечной точке, совместимой с Концентратором событий. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | int |
| retentionTimeInDays | Время хранения сообщений в облако в днях. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | int |
FallbackRouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое вычисляется для применения резервного маршрута. Если условие не указано, оно будет иметь значение true по умолчанию. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, на которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешено только 1 конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения резервного маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна |
| источник | Источник, к которому применяется правило маршрутизации. Например, DeviceMessages | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
FeedbackProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки для очереди отзывов. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в очередь отзывов в центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
IotHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| authorizationPolicies | Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Свойства обмена сообщениями центра Интернета вещей между устройствами. | CloudToDeviceProperties |
| Комментарии | Комментарии центра Интернета вещей. | струна |
| deviceStreams | Устройства передают свойства iothub. | IotHubPropertiesDeviceStreams |
| enableFileUploadNotifications | Если задано значение True, уведомления о отправке файлов включены. | bool |
| eventHubEndpoints | Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. | IotHubPropertiesEventHubEndpoints |
| Функции | Возможности и функции, включенные для Центра Интернета вещей. | DeviceManagement "Нет" |
| ipFilterRules | Правила фильтрации IP-адресов. | IpFilterRule[] |
| messagingEndpoints | Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. | IotHubPropertiesMessagingEndpoints |
| маршрутизация | Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging | МаршрутизацияProperties |
| storageEndpoints | Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
| Имя | Описание | Ценность |
|---|---|---|
| streamingEndpoints | Список конечных точек потоков устройств. | string[] |
IotHubPropertiesEventHubEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesMessagingEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesStorageEndpoints
| Имя | Описание | Ценность |
|---|
IotHubSkuInfo
| Имя | Описание | Ценность |
|---|---|---|
| способность | Количество подготовленных единиц Центра Интернета вещей. См. статью /azure/azure-subscription-service-limits#iot-hub-limits. | int |
| имя | Имя номера SKU. | "B1" "B2" "B3" "F1" 'S1' 'S2' "S3" (обязательно) |
IpFilterRule
| Имя | Описание | Ценность |
|---|---|---|
| действие | Требуемое действие для запросов, захваченных этим правилом. | "Принять" "Отклонить" (обязательно) |
| FilterName | Имя правила фильтрации IP-адресов. | строка (обязательно) |
| ipMask | Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. | строка (обязательно) |
MessagingEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в Центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
Microsoft.Devices/IotHubs
| Имя | Описание | Ценность |
|---|---|---|
| etag | Поле Etag не требуется. Если он указан в тексте ответа, он также должен быть предоставлен в качестве заголовка для обычного соглашения ETag. | струна |
| местоположение | Расположение ресурса. | строка (обязательно) |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства IotHub | IotHubProperties |
| SKU | Сведения об SKU IotHub | IotHubSkuInfo (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
ResourceTags
| Имя | Описание | Ценность |
|---|
RouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| источник | Источник, к которому применяется правило маршрутизации, например DeviceMessages. | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
МаршрутизацияEndpoints
| Имя | Описание | Ценность |
|---|---|---|
| eventHubs | Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. | RoutingEventHubProperties[] |
| serviceBusQueues | Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusQueueEndpointProperties[] |
| serviceBusTopics | Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusTopicEndpointProperties[] |
| storageContainers | Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingStorageContainerProperties[] |
МаршрутизацияEventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки концентратора событий. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки концентратора событий. | струна |
| subscriptionId | Идентификатор подписки конечной точки концентратора событий. | струна |
МаршрутизацияProperties
| Имя | Описание | Ценность |
|---|---|---|
| Конечные точки | Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. | МаршрутизацияEndpoints |
| обогащения | Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/iotmsgenrich | Обогащение[] |
| резервный каналRoute | Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. | FallbackRouteProperties |
| Маршруты | Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки очереди служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки очереди служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки очереди служебной шины. | струна |
RoutingServiceBusTopicEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки раздела служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки раздела служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки раздела служебной шины. | струна |
МаршрутизацияStorageContainerProperties
| Имя | Описание | Ценность |
|---|---|---|
| batchFrequencyInSeconds | Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. | int Ограничения целостности: Минимальное значение = 60 Максимальное значение = 720 |
| connectionString | Строка подключения учетной записи хранения. | строка (обязательно) |
| containerName | Имя контейнера хранилища в учетной записи хранения. | строка (обязательно) |
| кодировка | Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. | "Avro" AvroDeflate JSON |
| fileNameFormat | Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. | струна |
| maxChunkSizeInBytes | Максимальное количество байтов для каждого большого двоичного объекта, записанного в хранилище. Значение должно быть между 10485760(10 МБ) и 524288000(500 МБ). Значение по умолчанию — 314572800(300 МБ). | int Ограничения целостности: Минимальное значение = 10485760 Максимальное значение = 524288000 |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов учетной записи хранения. | струна |
| subscriptionId | Идентификатор подписки учетной записи хранения. | струна |
SharedAccessSignatureAuthorizationRule
| Имя | Описание | Ценность |
|---|---|---|
| keyName | Имя политики общего доступа. | строка (обязательно) |
| primaryKey | Первичный ключ. | струна |
| права | Разрешения, назначенные политике общего доступа. | 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 (обязательно) |
| secondaryKey | Вторичный ключ. | струна |
StorageEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. | строка (обязательно) |
| containerName | Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. | строка (обязательно) |
| sasTtlAsIso8601 | Период времени, для которого допустимы URI SAS, созданный Центром Интернета вещей для отправки файлов. См. статью /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | струна |
Примеры краткого руководства
Следующие примеры краткого руководства по развертыванию этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| Создание Центра Интернета вещей и устройства для облачной группы потребителей | Этот шаблон позволяет развернуть экземпляр Центра Интернета вещей с устройством в облаке и облаке в конфигурации обмена сообщениями устройств и устройством в облачной группе потребителей. |
| создание службы подготовки устройств Центра Интернета вещей | Этот шаблон позволяет создать центр Интернета вещей и службу подготовки устройств Центра Интернета вещей и связать две службы. |
| создание учетной записи Центра Интернета вещей, экземпляра, центра Интернета вещей | Этот шаблон создает учетную запись и экземпляр и концентратор для связывания экземпляра. Он настраивает концентратор с необходимыми политиками доступа, маршрутами и группой потребителей. |
| Развертывание службы MedTech, включая Центра Интернета вещей Azure | Служба MedTech — это одна из служб azure Health Data Services, предназначенных для приема данных устройства с нескольких устройств, преобразования данных устройства в наблюдения FHIR, которые затем сохраняются в службе FHIR служб данных Azure Health. |
| Использование шаблона ARM для создания Центра Интернета вещей, маршрутизации и просмотра сообщений | Используйте этот шаблон для развертывания Центра Интернета вещей и учетной записи хранения. Запустите приложение для отправки сообщений в концентратор, который направляется в хранилище, а затем просмотрите результаты. |
Определение ресурса шаблона ARM
Тип ресурса IotHubs можно развернуть с помощью операций, предназначенных для следующих целей:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Devices/IotHubs, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2019-03-22-preview",
"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",
"deviceStreams": {
"streamingEndpoints": [ "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"
}
},
"routing": {
"endpoints": {
"eventHubs": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusQueues": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"serviceBusTopics": [
{
"connectionString": "string",
"name": "string",
"resourceGroup": "string",
"subscriptionId": "string"
}
],
"storageContainers": [
{
"batchFrequencyInSeconds": "int",
"connectionString": "string",
"containerName": "string",
"encoding": "string",
"fileNameFormat": "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}": {
"connectionString": "string",
"containerName": "string",
"sasTtlAsIso8601": "string"
}
}
},
"sku": {
"capacity": "int",
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
Значения свойств
CloudToDeviceProperties
| Имя | Описание | Ценность |
|---|---|---|
| defaultTtlAsIso8601 | Время ожидания по умолчанию для сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| обратная связь | Свойства очереди отзывов для сообщений из облака на устройство. | отзывов |
| maxDeliveryCount | Максимальное количество доставки сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
ОбогащениеProperties
| Имя | Описание | Ценность |
|---|---|---|
| endpointNames | Список конечных точек, для которых применяется обогащение к сообщению. | string[] (обязательно) |
| ключ | Ключ или имя свойства обогащения. | строка (обязательно) |
| ценность | Значение свойства обогащения. | строка (обязательно) |
EventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| partitionCount | Количество секций для получения сообщений, совместимых с устройством в облаке, в конечной точке, совместимой с Концентратором событий. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | int |
| retentionTimeInDays | Время хранения сообщений в облако в днях. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | int |
FallbackRouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое вычисляется для применения резервного маршрута. Если условие не указано, оно будет иметь значение true по умолчанию. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, на которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешено только 1 конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения резервного маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна |
| источник | Источник, к которому применяется правило маршрутизации. Например, DeviceMessages | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
FeedbackProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки для очереди отзывов. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в очередь отзывов в центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
IotHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| authorizationPolicies | Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Свойства обмена сообщениями центра Интернета вещей между устройствами. | CloudToDeviceProperties |
| Комментарии | Комментарии центра Интернета вещей. | струна |
| deviceStreams | Устройства передают свойства iothub. | IotHubPropertiesDeviceStreams |
| enableFileUploadNotifications | Если задано значение True, уведомления о отправке файлов включены. | bool |
| eventHubEndpoints | Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. | IotHubPropertiesEventHubEndpoints |
| Функции | Возможности и функции, включенные для Центра Интернета вещей. | DeviceManagement "Нет" |
| ipFilterRules | Правила фильтрации IP-адресов. | IpFilterRule[] |
| messagingEndpoints | Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. | IotHubPropertiesMessagingEndpoints |
| маршрутизация | Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging | МаршрутизацияProperties |
| storageEndpoints | Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
| Имя | Описание | Ценность |
|---|---|---|
| streamingEndpoints | Список конечных точек потоков устройств. | string[] |
IotHubPropertiesEventHubEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesMessagingEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesStorageEndpoints
| Имя | Описание | Ценность |
|---|
IotHubSkuInfo
| Имя | Описание | Ценность |
|---|---|---|
| способность | Количество подготовленных единиц Центра Интернета вещей. См. статью /azure/azure-subscription-service-limits#iot-hub-limits. | int |
| имя | Имя номера SKU. | "B1" "B2" "B3" "F1" 'S1' 'S2' "S3" (обязательно) |
IpFilterRule
| Имя | Описание | Ценность |
|---|---|---|
| действие | Требуемое действие для запросов, захваченных этим правилом. | "Принять" "Отклонить" (обязательно) |
| FilterName | Имя правила фильтрации IP-адресов. | строка (обязательно) |
| ipMask | Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. | строка (обязательно) |
MessagingEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в Центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
Microsoft.Devices/IotHubs
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | '2019-03-22-preview' |
| etag | Поле Etag не требуется. Если он указан в тексте ответа, он также должен быть предоставлен в качестве заголовка для обычного соглашения ETag. | струна |
| местоположение | Расположение ресурса. | строка (обязательно) |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства IotHub | IotHubProperties |
| SKU | Сведения об SKU IotHub | IotHubSkuInfo (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
| тип | Тип ресурса | "Microsoft.Devices/IotHubs" |
ResourceTags
| Имя | Описание | Ценность |
|---|
RouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| источник | Источник, к которому применяется правило маршрутизации, например DeviceMessages. | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
МаршрутизацияEndpoints
| Имя | Описание | Ценность |
|---|---|---|
| eventHubs | Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. | RoutingEventHubProperties[] |
| serviceBusQueues | Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusQueueEndpointProperties[] |
| serviceBusTopics | Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusTopicEndpointProperties[] |
| storageContainers | Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingStorageContainerProperties[] |
МаршрутизацияEventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки концентратора событий. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки концентратора событий. | струна |
| subscriptionId | Идентификатор подписки конечной точки концентратора событий. | струна |
МаршрутизацияProperties
| Имя | Описание | Ценность |
|---|---|---|
| Конечные точки | Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. | МаршрутизацияEndpoints |
| обогащения | Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/iotmsgenrich | Обогащение[] |
| резервный каналRoute | Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. | FallbackRouteProperties |
| Маршруты | Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки очереди служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки очереди служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки очереди служебной шины. | струна |
RoutingServiceBusTopicEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки раздела служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки раздела служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки раздела служебной шины. | струна |
МаршрутизацияStorageContainerProperties
| Имя | Описание | Ценность |
|---|---|---|
| batchFrequencyInSeconds | Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. | int Ограничения целостности: Минимальное значение = 60 Максимальное значение = 720 |
| connectionString | Строка подключения учетной записи хранения. | строка (обязательно) |
| containerName | Имя контейнера хранилища в учетной записи хранения. | строка (обязательно) |
| кодировка | Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. | "Avro" AvroDeflate JSON |
| fileNameFormat | Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. | струна |
| maxChunkSizeInBytes | Максимальное количество байтов для каждого большого двоичного объекта, записанного в хранилище. Значение должно быть между 10485760(10 МБ) и 524288000(500 МБ). Значение по умолчанию — 314572800(300 МБ). | int Ограничения целостности: Минимальное значение = 10485760 Максимальное значение = 524288000 |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов учетной записи хранения. | струна |
| subscriptionId | Идентификатор подписки учетной записи хранения. | струна |
SharedAccessSignatureAuthorizationRule
| Имя | Описание | Ценность |
|---|---|---|
| keyName | Имя политики общего доступа. | строка (обязательно) |
| primaryKey | Первичный ключ. | струна |
| права | Разрешения, назначенные политике общего доступа. | 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 (обязательно) |
| secondaryKey | Вторичный ключ. | струна |
StorageEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. | строка (обязательно) |
| containerName | Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. | строка (обязательно) |
| sasTtlAsIso8601 | Период времени, для которого допустимы URI SAS, созданный Центром Интернета вещей для отправки файлов. См. статью /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | струна |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
создать среду pay as you go (PAYG) с помощью центра Интернета вещей развертывание  |
Этот шаблон позволяет развернуть среду аналитики временных рядов с оплатой по мере использования (PAYG), настроенную для использования событий из Центра Интернета вещей. |
|
Создание Центра Интернета вещей и устройства для облачной группы потребителей развертывание |
Этот шаблон позволяет развернуть экземпляр Центра Интернета вещей с устройством в облаке и облаке в конфигурации обмена сообщениями устройств и устройством в облачной группе потребителей. |
|
Создание симулятора IOT Hub и Ubuntu edge развертывание |
Этот шаблон создает симулятор IOT Hub и Виртуальной машины Ubuntu edge. |
|
создание службы подготовки устройств Центра Интернета вещей развертывание |
Этот шаблон позволяет создать центр Интернета вещей и службу подготовки устройств Центра Интернета вещей и связать две службы. |
|
создание учетной записи Центра Интернета вещей, экземпляра, центра Интернета вещей развертывание |
Этот шаблон создает учетную запись и экземпляр и концентратор для связывания экземпляра. Он настраивает концентратор с необходимыми политиками доступа, маршрутами и группой потребителей. |
|
Развертывание службы MedTech, включая Центра Интернета вещей Azure развертывание |
Служба MedTech — это одна из служб azure Health Data Services, предназначенных для приема данных устройства с нескольких устройств, преобразования данных устройства в наблюдения FHIR, которые затем сохраняются в службе FHIR служб данных Azure Health. |
|
Использование шаблона ARM для создания Центра Интернета вещей, маршрутизации и просмотра сообщений развертывание |
Используйте этот шаблон для развертывания Центра Интернета вещей и учетной записи хранения. Запустите приложение для отправки сообщений в концентратор, который направляется в хранилище, а затем просмотрите результаты. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса IotHubs можно развернуть с помощью операций, предназначенных для следующих целей:
- групп ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Devices/IotHubs, добавьте следующий terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/IotHubs@2019-03-22-preview"
name = "string"
etag = "string"
location = "string"
sku = {
capacity = int
name = "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"
deviceStreams = {
streamingEndpoints = [
"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"
}
}
routing = {
endpoints = {
eventHubs = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusQueues = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
serviceBusTopics = [
{
connectionString = "string"
name = "string"
resourceGroup = "string"
subscriptionId = "string"
}
]
storageContainers = [
{
batchFrequencyInSeconds = int
connectionString = "string"
containerName = "string"
encoding = "string"
fileNameFormat = "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} = {
connectionString = "string"
containerName = "string"
sasTtlAsIso8601 = "string"
}
}
}
})
}
Значения свойств
CloudToDeviceProperties
| Имя | Описание | Ценность |
|---|---|---|
| defaultTtlAsIso8601 | Время ожидания по умолчанию для сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| обратная связь | Свойства очереди отзывов для сообщений из облака на устройство. | отзывов |
| maxDeliveryCount | Максимальное количество доставки сообщений из облака в очередь устройств. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
ОбогащениеProperties
| Имя | Описание | Ценность |
|---|---|---|
| endpointNames | Список конечных точек, для которых применяется обогащение к сообщению. | string[] (обязательно) |
| ключ | Ключ или имя свойства обогащения. | строка (обязательно) |
| ценность | Значение свойства обогащения. | строка (обязательно) |
EventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| partitionCount | Количество секций для получения сообщений, совместимых с устройством в облаке, в конечной точке, совместимой с Концентратором событий. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. | int |
| retentionTimeInDays | Время хранения сообщений в облако в днях. См. статью /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages | int |
FallbackRouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое вычисляется для применения резервного маршрута. Если условие не указано, оно будет иметь значение true по умолчанию. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, на которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешено только 1 конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения резервного маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна |
| источник | Источник, к которому применяется правило маршрутизации. Например, DeviceMessages | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
FeedbackProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки для очереди отзывов. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в очередь отзывов в центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. | струна |
IotHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| authorizationPolicies | Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. | SharedAccessSignatureAuthorizationRule[] |
| cloudToDevice | Свойства обмена сообщениями центра Интернета вещей между устройствами. | CloudToDeviceProperties |
| Комментарии | Комментарии центра Интернета вещей. | струна |
| deviceStreams | Устройства передают свойства iothub. | IotHubPropertiesDeviceStreams |
| enableFileUploadNotifications | Если задано значение True, уведомления о отправке файлов включены. | bool |
| eventHubEndpoints | Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. | IotHubPropertiesEventHubEndpoints |
| Функции | Возможности и функции, включенные для Центра Интернета вещей. | DeviceManagement "Нет" |
| ipFilterRules | Правила фильтрации IP-адресов. | IpFilterRule[] |
| messagingEndpoints | Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. | IotHubPropertiesMessagingEndpoints |
| маршрутизация | Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging | МаршрутизацияProperties |
| storageEndpoints | Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
| Имя | Описание | Ценность |
|---|---|---|
| streamingEndpoints | Список конечных точек потоков устройств. | string[] |
IotHubPropertiesEventHubEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesMessagingEndpoints
| Имя | Описание | Ценность |
|---|
IotHubPropertiesStorageEndpoints
| Имя | Описание | Ценность |
|---|
IotHubSkuInfo
| Имя | Описание | Ценность |
|---|---|---|
| способность | Количество подготовленных единиц Центра Интернета вещей. См. статью /azure/azure-subscription-service-limits#iot-hub-limits. | int |
| имя | Имя номера SKU. | "B1" "B2" "B3" "F1" 'S1' 'S2' "S3" (обязательно) |
IpFilterRule
| Имя | Описание | Ценность |
|---|---|---|
| действие | Требуемое действие для запросов, захваченных этим правилом. | "Принять" "Отклонить" (обязательно) |
| FilterName | Имя правила фильтрации IP-адресов. | строка (обязательно) |
| ipMask | Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. | строка (обязательно) |
MessagingEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| lockDurationAsIso8601 | Длительность блокировки. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
| maxDeliveryCount | Количество попыток доставки сообщения в Центре Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 100 |
| ttlAsIso8601 | Период времени, в течение которого сообщение доступно для использования до истечения срока действия Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-file-upload. | струна |
Microsoft.Devices/IotHubs
| Имя | Описание | Ценность |
|---|---|---|
| etag | Поле Etag не требуется. Если он указан в тексте ответа, он также должен быть предоставлен в качестве заголовка для обычного соглашения ETag. | струна |
| местоположение | Расположение ресурса. | строка (обязательно) |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства IotHub | IotHubProperties |
| SKU | Сведения об SKU IotHub | IotHubSkuInfo (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. |
| тип | Тип ресурса | "Microsoft.Devices/IotHubs@2019-03-22-preview" |
ResourceTags
| Имя | Описание | Ценность |
|---|
RouteProperties
| Имя | Описание | Ценность |
|---|---|---|
| состояние | Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language | струна |
| endpointNames | Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. | string[] (обязательно) |
| isEnabled | Используется для указания включения маршрута. | bool (обязательно) |
| имя | Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| источник | Источник, к которому применяется правило маршрутизации, например DeviceMessages. | DeviceJobLifecycleEvents DeviceLifecycleEvents DeviceMessages "Недопустимый" TwinChangeEvents (обязательно) |
МаршрутизацияEndpoints
| Имя | Описание | Ценность |
|---|---|---|
| eventHubs | Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. | RoutingEventHubProperties[] |
| serviceBusQueues | Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusQueueEndpointProperties[] |
| serviceBusTopics | Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingServiceBusTopicEndpointProperties[] |
| storageContainers | Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. | RoutingStorageContainerProperties[] |
МаршрутизацияEventHubProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки концентратора событий. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки концентратора событий. | струна |
| subscriptionId | Идентификатор подписки конечной точки концентратора событий. | струна |
МаршрутизацияProperties
| Имя | Описание | Ценность |
|---|---|---|
| Конечные точки | Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. | МаршрутизацияEndpoints |
| обогащения | Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/iotmsgenrich | Обогащение[] |
| резервный каналRoute | Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. | FallbackRouteProperties |
| Маршруты | Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки очереди служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки очереди служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки очереди служебной шины. | струна |
RoutingServiceBusTopicEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения конечной точки раздела служебной шины. | строка (обязательно) |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов конечной точки раздела служебной шины. | струна |
| subscriptionId | Идентификатор подписки конечной точки раздела служебной шины. | струна |
МаршрутизацияStorageContainerProperties
| Имя | Описание | Ценность |
|---|---|---|
| batchFrequencyInSeconds | Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. | int Ограничения целостности: Минимальное значение = 60 Максимальное значение = 720 |
| connectionString | Строка подключения учетной записи хранения. | строка (обязательно) |
| containerName | Имя контейнера хранилища в учетной записи хранения. | строка (обязательно) |
| кодировка | Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. | "Avro" AvroDeflate JSON |
| fileNameFormat | Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. | струна |
| maxChunkSizeInBytes | Максимальное количество байтов для каждого большого двоичного объекта, записанного в хранилище. Значение должно быть между 10485760(10 МБ) и 524288000(500 МБ). Значение по умолчанию — 314572800(300 МБ). | int Ограничения целостности: Минимальное значение = 10485760 Максимальное значение = 524288000 |
| имя | Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. | струна Ограничения целостности: Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно) |
| resourceGroup | Имя группы ресурсов учетной записи хранения. | струна |
| subscriptionId | Идентификатор подписки учетной записи хранения. | струна |
SharedAccessSignatureAuthorizationRule
| Имя | Описание | Ценность |
|---|---|---|
| keyName | Имя политики общего доступа. | строка (обязательно) |
| primaryKey | Первичный ключ. | струна |
| права | Разрешения, назначенные политике общего доступа. | 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 (обязательно) |
| secondaryKey | Вторичный ключ. | струна |
StorageEndpointProperties
| Имя | Описание | Ценность |
|---|---|---|
| connectionString | Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. | строка (обязательно) |
| containerName | Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. | строка (обязательно) |
| sasTtlAsIso8601 | Период времени, для которого допустимы URI SAS, созданный Центром Интернета вещей для отправки файлов. См. статью /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. | струна |