Microsoft.Devices IotHubs 2021-07-01

Определение ресурсов Bicep

Тип ресурса IotHubs можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Devices/IotHubs, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Devices/IotHubs@2021-07-01' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    cloudToDevice: {
      defaultTtlAsIso8601: 'string'
      feedback: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
      maxDeliveryCount: int
    }
    comments: 'string'
    disableDeviceSAS: bool
    disableLocalAuth: bool
    disableModuleSAS: bool
    enableFileUploadNotifications: bool
    eventHubEndpoints: {
      {customized property}: {
        partitionCount: int
        retentionTimeInDays: int
      }
    }
    features: 'string'
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
      }
    ]
    messagingEndpoints: {
      {customized property}: {
        lockDurationAsIso8601: 'string'
        maxDeliveryCount: int
        ttlAsIso8601: 'string'
      }
    }
    minTlsVersion: 'string'
    networkRuleSets: {
      applyToBuiltInEventHubEndpoint: bool
      defaultAction: 'string'
      ipRules: [
        {
          action: 'string'
          filterName: 'string'
          ipMask: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    restrictOutboundNetworkAccess: bool
    routing: {
      endpoints: {
        eventHubs: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusQueues: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        serviceBusTopics: [
          {
            authenticationType: 'string'
            connectionString: 'string'
            endpointUri: 'string'
            entityPath: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
        storageContainers: [
          {
            authenticationType: 'string'
            batchFrequencyInSeconds: int
            connectionString: 'string'
            containerName: 'string'
            encoding: 'string'
            endpointUri: 'string'
            fileNameFormat: 'string'
            id: 'string'
            identity: {
              userAssignedIdentity: 'string'
            }
            maxChunkSizeInBytes: int
            name: 'string'
            resourceGroup: 'string'
            subscriptionId: 'string'
          }
        ]
      }
      enrichments: [
        {
          endpointNames: [
            'string'
          ]
          key: 'string'
          value: 'string'
        }
      ]
      fallbackRoute: {
        condition: 'string'
        endpointNames: [
          'string'
        ]
        isEnabled: bool
        name: 'string'
        source: 'string'
      }
      routes: [
        {
          condition: 'string'
          endpointNames: [
            'string'
          ]
          isEnabled: bool
          name: 'string'
          source: 'string'
        }
      ]
    }
    storageEndpoints: {
      {customized property}: {
        authenticationType: 'string'
        connectionString: 'string'
        containerName: 'string'
        identity: {
          userAssignedIdentity: 'string'
        }
        sasTtlAsIso8601: 'string'
      }
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

ArmIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Словарь <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Имя Описание Ценность

ArmUserIdentity

Имя Описание Ценность

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 DeviceConnectionStateEvents
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

Имя Описание Ценность
allowedFqdnList Список разрешенных полных доменных имен (полное доменное имя) для исходящего трафика из Центра Iot. string[]
authorizationPolicies Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Свойства обмена сообщениями центра Интернета вещей между устройствами. CloudToDeviceProperties
Комментарии Комментарии центра Интернета вещей. струна
disableDeviceSAS Если значение true, все устройства (включая пограничные устройства, кроме модулей), ограниченные ключи SAS нельзя использовать для проверки подлинности. bool
disableLocalAuth Если значение true, маркеры SAS с ключами SAS с областью действия центра Iot нельзя использовать для проверки подлинности. bool
disableModuleSAS Если задано значение true, для проверки подлинности нельзя использовать все ключи SAS с областью действия модуля. bool
enableFileUploadNotifications Если задано значение True, уведомления о отправке файлов включены. bool
eventHubEndpoints Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. IotHubPropertiesEventHubEndpoints
Функции Возможности и функции, включенные для Центра Интернета вещей. DeviceManagement
"Нет"
ipFilterRules Правила фильтрации IP-адресов. IpFilterRule[]
messagingEndpoints Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. IotHubPropertiesMessagingEndpoints
minTlsVersion Указывает минимальную версию TLS для поддержки этого концентратора. Можно задать значение "1.2", чтобы клиенты, использующие версию TLS ниже 1.2, отклонялись. струна
networkRuleSets Свойства набора правил сети IotHub NetworkRuleSetProperties
privateEndpointConnections Подключения к частной конечной точке, созданные на этом IotHub PrivateEndpointConnection[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
restrictOutboundNetworkAccess Если значение true, исходящие данные из IotHub будут ограничены только разрешенными полными доменными именами, настроенными с помощью allowFqdnList. bool
маршрутизация Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging МаршрутизацияProperties
storageEndpoints Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. IotHubPropertiesStorageEndpoints

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 для правила. строка (обязательно)

ManagedIdentity

Имя Описание Ценность
userAssignedIdentity Назначаемое пользователем удостоверение. струна

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. ArmIdentity
местоположение Расположение ресурса. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства IotHub IotHubProperties
SKU Сведения об SKU IotHub IotHubSkuInfo (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

NetworkRuleSetIpRule

Имя Описание Ценность
действие Действие ФИЛЬТРА IP "Разрешить"
FilterName Имя правила фильтрации IP-адресов. строка (обязательно)
ipMask Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. строка (обязательно)

NetworkRuleSetProperties

Имя Описание Ценность
applyToBuiltInEventHubEndpoint Если значение true, то набор правил сети также применяется к Встроенной точке событий EventHub iotHub bool (обязательно)
defaultAction Действие по умолчанию для набора правил сети "Разрешить"
"Запретить"
ipRules Список правил IP-адресов NetworkRuleSetIpRule[] (обязательно)

PrivateEndpoint

Имя Описание Ценность

PrivateEndpointConnection

Имя Описание Ценность
свойства Свойства подключения частной конечной точки PrivateEndpointConnectionProperties (обязательно)

PrivateEndpointConnectionProperties

Имя Описание Ценность
privateEndpoint Свойство частной конечной точки подключения частной конечной точки PrivateEndpoint
privateLinkServiceConnectionState Текущее состояние подключения к частной конечной точке PrivateLinkServiceConnectionState (обязательно)

PrivateLinkServiceConnectionState

Имя Описание Ценность
actionsRequired Действия, необходимые для подключения частной конечной точки струна
описание Описание текущего состояния подключения частной конечной точки строка (обязательно)
статус Состояние подключения частной конечной точки "Утверждено"
"Отключено"
"Ожидание"
"Отклонено" (обязательно)

ResourceTags

Имя Описание Ценность

RouteProperties

Имя Описание Ценность
состояние Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language струна
endpointNames Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. string[] (обязательно)
isEnabled Используется для указания включения маршрута. bool (обязательно)
имя Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
источник Источник, к которому применяется правило маршрутизации, например DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
DeviceLifecycleEvents
DeviceMessages
"Недопустимый"
TwinChangeEvents (обязательно)

МаршрутизацияEndpoints

Имя Описание Ценность
eventHubs Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. RoutingEventHubProperties[]
serviceBusQueues Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusTopicEndpointProperties[]
storageContainers Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingStorageContainerProperties[]

МаршрутизацияEventHubProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке концентратора событий IdentityBased
KeyBased
connectionString Строка подключения конечной точки концентратора событий. струна
endpointUri URL-адрес конечной точки концентратора событий. Он должен включать протокол sb:// струна
entityPath Имя концентратора событий в пространстве имен концентратора событий струна
идентификатор Идентификатор конечной точки концентратора событий струна
тождество Свойства управляемого удостоверения конечной точки концентратора событий маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки концентратора событий. струна
subscriptionId Идентификатор подписки конечной точки концентратора событий. струна

МаршрутизацияProperties

Имя Описание Ценность
Конечные точки Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. МаршрутизацияEndpoints
обогащения Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/telemetryoneventgrid Обогащение[]
резервный каналRoute Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. FallbackRouteProperties
Маршруты Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке очереди служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки очереди служебной шины. струна
endpointUri URL-адрес конечной точки очереди служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в пространстве имен служебной шины струна
идентификатор Идентификатор конечной точки очереди служебной шины струна
тождество Свойства управляемого удостоверения конечной точки очереди служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки очереди служебной шины. струна
subscriptionId Идентификатор подписки конечной точки очереди служебной шины. струна

RoutingServiceBusTopicEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке раздела служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки раздела служебной шины. струна
endpointUri URL-адрес конечной точки раздела служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в разделе служебной шины струна
идентификатор Идентификатор конечной точки раздела служебной шины струна
тождество Свойства управляемого удостоверения конечной точки раздела служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки раздела служебной шины. струна
subscriptionId Идентификатор подписки конечной точки раздела служебной шины. струна

МаршрутизацияStorageContainerProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке хранилища IdentityBased
KeyBased
batchFrequencyInSeconds Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. int

Ограничения целостности:
Минимальное значение = 60
Максимальное значение = 720
connectionString Строка подключения учетной записи хранения. струна
containerName Имя контейнера хранилища в учетной записи хранения. строка (обязательно)
кодировка Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. "Avro"
AvroDeflate
JSON
endpointUri URL-адрес конечной точки хранилища. Он должен включать протокол https:// струна
fileNameFormat Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. струна
идентификатор Идентификатор конечной точки контейнера хранилища струна
тождество Свойства управляемого удостоверения конечной точки хранилища маршрутизации. ManagedIdentity
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

Имя Описание Ценность
authenticationType Указывает тип проверки подлинности, используемый для подключения к учетной записи хранения. IdentityBased
KeyBased
connectionString Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. строка (обязательно)
containerName Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. строка (обязательно)
тождество Свойства управляемого удостоверения конечной точки хранилища для отправки файлов. ManagedIdentity
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": "2021-07-01",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "cloudToDevice": {
      "defaultTtlAsIso8601": "string",
      "feedback": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      },
      "maxDeliveryCount": "int"
    },
    "comments": "string",
    "disableDeviceSAS": "bool",
    "disableLocalAuth": "bool",
    "disableModuleSAS": "bool",
    "enableFileUploadNotifications": "bool",
    "eventHubEndpoints": {
      "{customized property}": {
        "partitionCount": "int",
        "retentionTimeInDays": "int"
      }
    },
    "features": "string",
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string"
      }
    ],
    "messagingEndpoints": {
      "{customized property}": {
        "lockDurationAsIso8601": "string",
        "maxDeliveryCount": "int",
        "ttlAsIso8601": "string"
      }
    },
    "minTlsVersion": "string",
    "networkRuleSets": {
      "applyToBuiltInEventHubEndpoint": "bool",
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "string",
          "filterName": "string",
          "ipMask": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "restrictOutboundNetworkAccess": "bool",
    "routing": {
      "endpoints": {
        "eventHubs": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusQueues": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "serviceBusTopics": [
          {
            "authenticationType": "string",
            "connectionString": "string",
            "endpointUri": "string",
            "entityPath": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ],
        "storageContainers": [
          {
            "authenticationType": "string",
            "batchFrequencyInSeconds": "int",
            "connectionString": "string",
            "containerName": "string",
            "encoding": "string",
            "endpointUri": "string",
            "fileNameFormat": "string",
            "id": "string",
            "identity": {
              "userAssignedIdentity": "string"
            },
            "maxChunkSizeInBytes": "int",
            "name": "string",
            "resourceGroup": "string",
            "subscriptionId": "string"
          }
        ]
      },
      "enrichments": [
        {
          "endpointNames": [ "string" ],
          "key": "string",
          "value": "string"
        }
      ],
      "fallbackRoute": {
        "condition": "string",
        "endpointNames": [ "string" ],
        "isEnabled": "bool",
        "name": "string",
        "source": "string"
      },
      "routes": [
        {
          "condition": "string",
          "endpointNames": [ "string" ],
          "isEnabled": "bool",
          "name": "string",
          "source": "string"
        }
      ]
    },
    "storageEndpoints": {
      "{customized property}": {
        "authenticationType": "string",
        "connectionString": "string",
        "containerName": "string",
        "identity": {
          "userAssignedIdentity": "string"
        },
        "sasTtlAsIso8601": "string"
      }
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

ArmIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Словарь <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Имя Описание Ценность

ArmUserIdentity

Имя Описание Ценность

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 DeviceConnectionStateEvents
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

Имя Описание Ценность
allowedFqdnList Список разрешенных полных доменных имен (полное доменное имя) для исходящего трафика из Центра Iot. string[]
authorizationPolicies Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Свойства обмена сообщениями центра Интернета вещей между устройствами. CloudToDeviceProperties
Комментарии Комментарии центра Интернета вещей. струна
disableDeviceSAS Если значение true, все устройства (включая пограничные устройства, кроме модулей), ограниченные ключи SAS нельзя использовать для проверки подлинности. bool
disableLocalAuth Если значение true, маркеры SAS с ключами SAS с областью действия центра Iot нельзя использовать для проверки подлинности. bool
disableModuleSAS Если задано значение true, для проверки подлинности нельзя использовать все ключи SAS с областью действия модуля. bool
enableFileUploadNotifications Если задано значение True, уведомления о отправке файлов включены. bool
eventHubEndpoints Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. IotHubPropertiesEventHubEndpoints
Функции Возможности и функции, включенные для Центра Интернета вещей. DeviceManagement
"Нет"
ipFilterRules Правила фильтрации IP-адресов. IpFilterRule[]
messagingEndpoints Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. IotHubPropertiesMessagingEndpoints
minTlsVersion Указывает минимальную версию TLS для поддержки этого концентратора. Можно задать значение "1.2", чтобы клиенты, использующие версию TLS ниже 1.2, отклонялись. струна
networkRuleSets Свойства набора правил сети IotHub NetworkRuleSetProperties
privateEndpointConnections Подключения к частной конечной точке, созданные на этом IotHub PrivateEndpointConnection[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
restrictOutboundNetworkAccess Если значение true, исходящие данные из IotHub будут ограничены только разрешенными полными доменными именами, настроенными с помощью allowFqdnList. bool
маршрутизация Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging МаршрутизацияProperties
storageEndpoints Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. IotHubPropertiesStorageEndpoints

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 для правила. строка (обязательно)

ManagedIdentity

Имя Описание Ценность
userAssignedIdentity Назначаемое пользователем удостоверение. струна

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 '2021-07-01'
etag Поле Etag не требуется. Если он указан в тексте ответа, он также должен быть предоставлен в качестве заголовка для обычного соглашения ETag. струна
тождество Управляемые удостоверения для IotHub. ArmIdentity
местоположение Расположение ресурса. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства IotHub IotHubProperties
SKU Сведения об SKU IotHub IotHubSkuInfo (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.Devices/IotHubs"

NetworkRuleSetIpRule

Имя Описание Ценность
действие Действие ФИЛЬТРА IP "Разрешить"
FilterName Имя правила фильтрации IP-адресов. строка (обязательно)
ipMask Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. строка (обязательно)

NetworkRuleSetProperties

Имя Описание Ценность
applyToBuiltInEventHubEndpoint Если значение true, то набор правил сети также применяется к Встроенной точке событий EventHub iotHub bool (обязательно)
defaultAction Действие по умолчанию для набора правил сети "Разрешить"
"Запретить"
ipRules Список правил IP-адресов NetworkRuleSetIpRule[] (обязательно)

PrivateEndpoint

Имя Описание Ценность

PrivateEndpointConnection

Имя Описание Ценность
свойства Свойства подключения частной конечной точки PrivateEndpointConnectionProperties (обязательно)

PrivateEndpointConnectionProperties

Имя Описание Ценность
privateEndpoint Свойство частной конечной точки подключения частной конечной точки PrivateEndpoint
privateLinkServiceConnectionState Текущее состояние подключения к частной конечной точке PrivateLinkServiceConnectionState (обязательно)

PrivateLinkServiceConnectionState

Имя Описание Ценность
actionsRequired Действия, необходимые для подключения частной конечной точки струна
описание Описание текущего состояния подключения частной конечной точки строка (обязательно)
статус Состояние подключения частной конечной точки "Утверждено"
"Отключено"
"Ожидание"
"Отклонено" (обязательно)

ResourceTags

Имя Описание Ценность

RouteProperties

Имя Описание Ценность
состояние Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language струна
endpointNames Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. string[] (обязательно)
isEnabled Используется для указания включения маршрута. bool (обязательно)
имя Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
источник Источник, к которому применяется правило маршрутизации, например DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
DeviceLifecycleEvents
DeviceMessages
"Недопустимый"
TwinChangeEvents (обязательно)

МаршрутизацияEndpoints

Имя Описание Ценность
eventHubs Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. RoutingEventHubProperties[]
serviceBusQueues Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusTopicEndpointProperties[]
storageContainers Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingStorageContainerProperties[]

МаршрутизацияEventHubProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке концентратора событий IdentityBased
KeyBased
connectionString Строка подключения конечной точки концентратора событий. струна
endpointUri URL-адрес конечной точки концентратора событий. Он должен включать протокол sb:// струна
entityPath Имя концентратора событий в пространстве имен концентратора событий струна
идентификатор Идентификатор конечной точки концентратора событий струна
тождество Свойства управляемого удостоверения конечной точки концентратора событий маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки концентратора событий. струна
subscriptionId Идентификатор подписки конечной точки концентратора событий. струна

МаршрутизацияProperties

Имя Описание Ценность
Конечные точки Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. МаршрутизацияEndpoints
обогащения Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/telemetryoneventgrid Обогащение[]
резервный каналRoute Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. FallbackRouteProperties
Маршруты Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке очереди служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки очереди служебной шины. струна
endpointUri URL-адрес конечной точки очереди служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в пространстве имен служебной шины струна
идентификатор Идентификатор конечной точки очереди служебной шины струна
тождество Свойства управляемого удостоверения конечной точки очереди служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки очереди служебной шины. струна
subscriptionId Идентификатор подписки конечной точки очереди служебной шины. струна

RoutingServiceBusTopicEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке раздела служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки раздела служебной шины. струна
endpointUri URL-адрес конечной точки раздела служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в разделе служебной шины струна
идентификатор Идентификатор конечной точки раздела служебной шины струна
тождество Свойства управляемого удостоверения конечной точки раздела служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки раздела служебной шины. струна
subscriptionId Идентификатор подписки конечной точки раздела служебной шины. струна

МаршрутизацияStorageContainerProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке хранилища IdentityBased
KeyBased
batchFrequencyInSeconds Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. int

Ограничения целостности:
Минимальное значение = 60
Максимальное значение = 720
connectionString Строка подключения учетной записи хранения. струна
containerName Имя контейнера хранилища в учетной записи хранения. строка (обязательно)
кодировка Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. "Avro"
AvroDeflate
JSON
endpointUri URL-адрес конечной точки хранилища. Он должен включать протокол https:// струна
fileNameFormat Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. струна
идентификатор Идентификатор конечной точки контейнера хранилища струна
тождество Свойства управляемого удостоверения конечной точки хранилища маршрутизации. ManagedIdentity
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

Имя Описание Ценность
authenticationType Указывает тип проверки подлинности, используемый для подключения к учетной записи хранения. IdentityBased
KeyBased
connectionString Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. строка (обязательно)
containerName Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. строка (обязательно)
тождество Свойства управляемого удостоверения конечной точки хранилища для отправки файлов. ManagedIdentity
sasTtlAsIso8601 Период времени, для которого допустимы URI SAS, созданный Центром Интернета вещей для отправки файлов. См. статью /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. струна

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создать среду pay as you go (PAYG) с помощью центра Интернета вещей

развертывание в Azure
Этот шаблон позволяет развернуть среду аналитики временных рядов с оплатой по мере использования (PAYG), настроенную для использования событий из Центра Интернета вещей.
Создание Центра Интернета вещей и устройства для облачной группы потребителей

развертывание в Azure
Этот шаблон позволяет развернуть экземпляр Центра Интернета вещей с устройством в облаке и облаке в конфигурации обмена сообщениями устройств и устройством в облачной группе потребителей.
Создание симулятора IOT Hub и Ubuntu edge

развертывание в Azure
Этот шаблон создает симулятор IOT Hub и Виртуальной машины Ubuntu edge.
создание службы подготовки устройств Центра Интернета вещей

развертывание в Azure
Этот шаблон позволяет создать центр Интернета вещей и службу подготовки устройств Центра Интернета вещей и связать две службы.
создание учетной записи Центра Интернета вещей, экземпляра, центра Интернета вещей

развертывание в Azure
Этот шаблон создает учетную запись и экземпляр и концентратор для связывания экземпляра. Он настраивает концентратор с необходимыми политиками доступа, маршрутами и группой потребителей.
Развертывание службы MedTech, включая Центра Интернета вещей Azure

развертывание в Azure
Служба MedTech — это одна из служб azure Health Data Services, предназначенных для приема данных устройства с нескольких устройств, преобразования данных устройства в наблюдения FHIR, которые затем сохраняются в службе FHIR служб данных Azure Health.
Использование шаблона ARM для создания Центра Интернета вещей, маршрутизации и просмотра сообщений

развертывание в Azure
Используйте этот шаблон для развертывания Центра Интернета вещей и учетной записи хранения. Запустите приложение для отправки сообщений в концентратор, который направляется в хранилище, а затем просмотрите результаты.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса IotHubs можно развернуть с помощью операций, предназначенных для следующих целей:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Devices/IotHubs, добавьте следующий terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2021-07-01"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      allowedFqdnList = [
        "string"
      ]
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      cloudToDevice = {
        defaultTtlAsIso8601 = "string"
        feedback = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
        maxDeliveryCount = int
      }
      comments = "string"
      disableDeviceSAS = bool
      disableLocalAuth = bool
      disableModuleSAS = bool
      enableFileUploadNotifications = bool
      eventHubEndpoints = {
        {customized property} = {
          partitionCount = int
          retentionTimeInDays = int
        }
      }
      features = "string"
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
        }
      ]
      messagingEndpoints = {
        {customized property} = {
          lockDurationAsIso8601 = "string"
          maxDeliveryCount = int
          ttlAsIso8601 = "string"
        }
      }
      minTlsVersion = "string"
      networkRuleSets = {
        applyToBuiltInEventHubEndpoint = bool
        defaultAction = "string"
        ipRules = [
          {
            action = "string"
            filterName = "string"
            ipMask = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      restrictOutboundNetworkAccess = bool
      routing = {
        endpoints = {
          eventHubs = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusQueues = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          serviceBusTopics = [
            {
              authenticationType = "string"
              connectionString = "string"
              endpointUri = "string"
              entityPath = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
          storageContainers = [
            {
              authenticationType = "string"
              batchFrequencyInSeconds = int
              connectionString = "string"
              containerName = "string"
              encoding = "string"
              endpointUri = "string"
              fileNameFormat = "string"
              id = "string"
              identity = {
                userAssignedIdentity = "string"
              }
              maxChunkSizeInBytes = int
              name = "string"
              resourceGroup = "string"
              subscriptionId = "string"
            }
          ]
        }
        enrichments = [
          {
            endpointNames = [
              "string"
            ]
            key = "string"
            value = "string"
          }
        ]
        fallbackRoute = {
          condition = "string"
          endpointNames = [
            "string"
          ]
          isEnabled = bool
          name = "string"
          source = "string"
        }
        routes = [
          {
            condition = "string"
            endpointNames = [
              "string"
            ]
            isEnabled = bool
            name = "string"
            source = "string"
          }
        ]
      }
      storageEndpoints = {
        {customized property} = {
          authenticationType = "string"
          connectionString = "string"
          containerName = "string"
          identity = {
            userAssignedIdentity = "string"
          }
          sasTtlAsIso8601 = "string"
        }
      }
    }
  })
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Значения свойств

ArmIdentity

Имя Описание Ценность
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
userAssignedIdentities Словарь <ArmUserIdentity> ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Имя Описание Ценность

ArmUserIdentity

Имя Описание Ценность

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 DeviceConnectionStateEvents
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

Имя Описание Ценность
allowedFqdnList Список разрешенных полных доменных имен (полное доменное имя) для исходящего трафика из Центра Iot. string[]
authorizationPolicies Политики общего доступа, которые можно использовать для защиты подключения к Центру Интернета вещей. SharedAccessSignatureAuthorizationRule[]
cloudToDevice Свойства обмена сообщениями центра Интернета вещей между устройствами. CloudToDeviceProperties
Комментарии Комментарии центра Интернета вещей. струна
disableDeviceSAS Если значение true, все устройства (включая пограничные устройства, кроме модулей), ограниченные ключи SAS нельзя использовать для проверки подлинности. bool
disableLocalAuth Если значение true, маркеры SAS с ключами SAS с областью действия центра Iot нельзя использовать для проверки подлинности. bool
disableModuleSAS Если задано значение true, для проверки подлинности нельзя использовать все ключи SAS с областью действия модуля. bool
enableFileUploadNotifications Если задано значение True, уведомления о отправке файлов включены. bool
eventHubEndpoints Свойства конечной точки, совместимой с Концентратором событий. Единственными возможными ключами этого словаря являются события. Этот ключ должен присутствовать в словаре при создании или обновлении вызовов центра Интернета вещей. IotHubPropertiesEventHubEndpoints
Функции Возможности и функции, включенные для Центра Интернета вещей. DeviceManagement
"Нет"
ipFilterRules Правила фильтрации IP-адресов. IpFilterRule[]
messagingEndpoints Свойства конечной точки обмена сообщениями для очереди уведомлений о отправке файла. IotHubPropertiesMessagingEndpoints
minTlsVersion Указывает минимальную версию TLS для поддержки этого концентратора. Можно задать значение "1.2", чтобы клиенты, использующие версию TLS ниже 1.2, отклонялись. струна
networkRuleSets Свойства набора правил сети IotHub NetworkRuleSetProperties
privateEndpointConnections Подключения к частной конечной точке, созданные на этом IotHub PrivateEndpointConnection[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
restrictOutboundNetworkAccess Если значение true, исходящие данные из IotHub будут ограничены только разрешенными полными доменными именами, настроенными с помощью allowFqdnList. bool
маршрутизация Связанные с маршрутизацией свойства Центра Интернета вещей. См. статью /azure/iot-hub/iot-hub-devguide-messaging МаршрутизацияProperties
storageEndpoints Список конечных точек службы хранилища Azure, где можно отправлять файлы. В настоящее время можно настроить только одну учетную запись хранения Azure и ее ключ как $default. Указание нескольких учетных записей хранения приводит к возникновению ошибки. Не указывая значение этого свойства, если для свойства enableFileUploadNotifications задано значение True, возникает ошибка. IotHubPropertiesStorageEndpoints

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 для правила. строка (обязательно)

ManagedIdentity

Имя Описание Ценность
userAssignedIdentity Назначаемое пользователем удостоверение. струна

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. ArmIdentity
местоположение Расположение ресурса. строка (обязательно)
имя Имя ресурса строка (обязательно)
свойства Свойства IotHub IotHubProperties
SKU Сведения об SKU IotHub IotHubSkuInfo (обязательно)
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.Devices/IotHubs@2021-07-01"

NetworkRuleSetIpRule

Имя Описание Ценность
действие Действие ФИЛЬТРА IP "Разрешить"
FilterName Имя правила фильтрации IP-адресов. строка (обязательно)
ipMask Строка, содержащая диапазон IP-адресов в нотации CIDR для правила. строка (обязательно)

NetworkRuleSetProperties

Имя Описание Ценность
applyToBuiltInEventHubEndpoint Если значение true, то набор правил сети также применяется к Встроенной точке событий EventHub iotHub bool (обязательно)
defaultAction Действие по умолчанию для набора правил сети "Разрешить"
"Запретить"
ipRules Список правил IP-адресов NetworkRuleSetIpRule[] (обязательно)

PrivateEndpoint

Имя Описание Ценность

PrivateEndpointConnection

Имя Описание Ценность
свойства Свойства подключения частной конечной точки PrivateEndpointConnectionProperties (обязательно)

PrivateEndpointConnectionProperties

Имя Описание Ценность
privateEndpoint Свойство частной конечной точки подключения частной конечной точки PrivateEndpoint
privateLinkServiceConnectionState Текущее состояние подключения к частной конечной точке PrivateLinkServiceConnectionState (обязательно)

PrivateLinkServiceConnectionState

Имя Описание Ценность
actionsRequired Действия, необходимые для подключения частной конечной точки струна
описание Описание текущего состояния подключения частной конечной точки строка (обязательно)
статус Состояние подключения частной конечной точки "Утверждено"
"Отключено"
"Ожидание"
"Отклонено" (обязательно)

ResourceTags

Имя Описание Ценность

RouteProperties

Имя Описание Ценность
состояние Условие, которое оценивается для применения правила маршрутизации. Если условие не указано, оно по умолчанию оценивается как true. Сведения о грамматике см. в статье /azure/iot-hub/iot-hub-devguide-query-language струна
endpointNames Список конечных точек, в которые направляются сообщения, удовлетворяющие условию. В настоящее время разрешена только одна конечная точка. string[] (обязательно)
isEnabled Используется для указания включения маршрута. bool (обязательно)
имя Имя маршрута. Имя может включать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы, максимальную длину 64 символов и должны быть уникальными. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
источник Источник, к которому применяется правило маршрутизации, например DeviceMessages. DeviceConnectionStateEvents
DeviceJobLifecycleEvents
DeviceLifecycleEvents
DeviceMessages
"Недопустимый"
TwinChangeEvents (обязательно)

МаршрутизацияEndpoints

Имя Описание Ценность
eventHubs Список конечных точек Центров событий, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. Этот список не включает встроенную конечную точку Центров событий. RoutingEventHubProperties[]
serviceBusQueues Список конечных точек очереди служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics Список конечных точек раздела служебной шины, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingServiceBusTopicEndpointProperties[]
storageContainers Список конечных точек контейнера хранилища, в которые Центр Интернета вещей направляет сообщения на основе правил маршрутизации. RoutingStorageContainerProperties[]

МаршрутизацияEventHubProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке концентратора событий IdentityBased
KeyBased
connectionString Строка подключения конечной точки концентратора событий. струна
endpointUri URL-адрес конечной точки концентратора событий. Он должен включать протокол sb:// струна
entityPath Имя концентратора событий в пространстве имен концентратора событий струна
идентификатор Идентификатор конечной точки концентратора событий струна
тождество Свойства управляемого удостоверения конечной точки концентратора событий маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки концентратора событий. струна
subscriptionId Идентификатор подписки конечной точки концентратора событий. струна

МаршрутизацияProperties

Имя Описание Ценность
Конечные точки Свойства, связанные с пользовательскими конечными точками, в которые центр Интернета вещей направляет сообщения на основе правил маршрутизации. Допускается не более 10 пользовательских конечных точек во всех типах конечных точек для платных центров, и для всех типов конечных точек для бесплатных центров разрешено только 1 пользовательская конечная точка. МаршрутизацияEndpoints
обогащения Список предоставленных пользователем обогащений, которые центр Интернета вещей применяет к сообщениям, которые будут доставлены во встроенные и пользовательские конечные точки. См. https://aka.ms/telemetryoneventgrid Обогащение[]
резервный каналRoute Свойства маршрута, который используется в качестве резервного маршрута, если ни одно из условий, указанных в разделе "маршруты", не выполняется. Это необязательный параметр. Если это свойство не задано, сообщения, которые не соответствуют каким-либо условиям, указанным в разделе "маршруты", направляются в встроенную конечную точку eventhub. FallbackRouteProperties
Маршруты Список правил маршрутизации, предоставляемых пользователем, которые центр Интернета вещей использует для маршрутизации сообщений в встроенные и пользовательские конечные точки. Для платных центров разрешено не более 100 правил маршрутизации, а для бесплатных центров разрешено не более 5 правил маршрутизации. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке очереди служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки очереди служебной шины. струна
endpointUri URL-адрес конечной точки очереди служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в пространстве имен служебной шины струна
идентификатор Идентификатор конечной точки очереди служебной шины струна
тождество Свойства управляемого удостоверения конечной точки очереди служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем очереди. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки очереди служебной шины. струна
subscriptionId Идентификатор подписки конечной точки очереди служебной шины. струна

RoutingServiceBusTopicEndpointProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке раздела служебной шины IdentityBased
KeyBased
connectionString Строка подключения конечной точки раздела служебной шины. струна
endpointUri URL-адрес конечной точки раздела служебной шины. Он должен включать протокол sb:// струна
entityPath Имя очереди в разделе служебной шины струна
идентификатор Идентификатор конечной точки раздела служебной шины струна
тождество Свойства управляемого удостоверения конечной точки раздела служебной шины маршрутизации. ManagedIdentity
имя Имя, определяющее эту конечную точку. Имя может содержать только буквенно-цифровые символы, точки, символы подчеркивания, дефисы и имеет максимальную длину 64 символов. Следующие имена зарезервированы: события, fileNotifications, $default. Имена конечных точек должны быть уникальными для типов конечных точек. Имя не должно совпадать с фактическим именем раздела. струна

Ограничения целостности:
Pattern = ^[A-Za-z0-9-._]{1,64}$ (обязательно)
resourceGroup Имя группы ресурсов конечной точки раздела служебной шины. струна
subscriptionId Идентификатор подписки конечной точки раздела служебной шины. струна

МаршрутизацияStorageContainerProperties

Имя Описание Ценность
authenticationType Метод, используемый для проверки подлинности в конечной точке хранилища IdentityBased
KeyBased
batchFrequencyInSeconds Интервал времени записи больших двоичных объектов в хранилище. Значение должно составлять от 60 до 720 секунд. Значение по умолчанию — 300 секунд. int

Ограничения целостности:
Минимальное значение = 60
Максимальное значение = 720
connectionString Строка подключения учетной записи хранения. струна
containerName Имя контейнера хранилища в учетной записи хранения. строка (обязательно)
кодировка Кодировка, используемая для сериализации сообщений в большие двоичные объекты. Поддерживаемые значения: avro, avrodeflate и JSON. Значение по умолчанию — avro. "Avro"
AvroDeflate
JSON
endpointUri URL-адрес конечной точки хранилища. Он должен включать протокол https:// струна
fileNameFormat Формат имени файла для большого двоичного объекта. Формат по умолчанию — {iothub}/{partition}/{ГГГГ}/{MM}/{DD}/{HH}/{mm}. Все параметры являются обязательными, но могут быть переупорядочены. струна
идентификатор Идентификатор конечной точки контейнера хранилища струна
тождество Свойства управляемого удостоверения конечной точки хранилища маршрутизации. ManagedIdentity
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

Имя Описание Ценность
authenticationType Указывает тип проверки подлинности, используемый для подключения к учетной записи хранения. IdentityBased
KeyBased
connectionString Строка подключения для учетной записи хранения Azure, в которую отправляются файлы. строка (обязательно)
containerName Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString. строка (обязательно)
тождество Свойства управляемого удостоверения конечной точки хранилища для отправки файлов. ManagedIdentity
sasTtlAsIso8601 Период времени, для которого допустимы URI SAS, созданный Центром Интернета вещей для отправки файлов. См. статью /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. струна