你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Microsoft.Devices IotHubs 2022-04-30-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@2022-04-30-preview' = {
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'
deviceStreams: {
streamingEndpoints: [
'string'
]
}
disableDeviceSAS: bool
disableLocalAuth: bool
disableModuleSAS: bool
enableDataResidency: bool
enableFileUploadNotifications: bool
encryption: {
keySource: 'string'
keyVaultProperties: [
{
identity: {
userAssignedIdentity: 'string'
}
keyIdentifier: 'string'
}
]
}
eventHubEndpoints: {
{customized property}: {
partitionCount: int
retentionTimeInDays: int
}
}
features: 'string'
ipFilterRules: [
{
action: 'string'
filterName: 'string'
ipMask: 'string'
}
]
messagingEndpoints: {
{customized property}: {
lockDurationAsIso8601: 'string'
maxDeliveryCount: int
ttlAsIso8601: 'string'
}
}
minTlsVersion: 'string'
networkRuleSets: {
applyToBuiltInEventHubEndpoint: bool
defaultAction: 'string'
ipRules: [
{
action: 'string'
filterName: 'string'
ipMask: 'string'
}
]
}
privateEndpointConnections: [
{
properties: {
privateEndpoint: {}
privateLinkServiceConnectionState: {
actionsRequired: 'string'
description: 'string'
status: 'string'
}
}
}
]
publicNetworkAccess: 'string'
restrictOutboundNetworkAccess: bool
rootCertificate: {
enableRootCertificateV2: bool
}
routing: {
endpoints: {
cosmosDBSqlCollections: [
{
authenticationType: 'string'
collectionName: 'string'
databaseName: 'string'
endpointUri: 'string'
id: 'string'
identity: {
userAssignedIdentity: 'string'
}
name: 'string'
partitionKeyName: 'string'
partitionKeyTemplate: 'string'
primaryKey: 'string'
resourceGroup: 'string'
secondaryKey: 'string'
subscriptionId: 'string'
}
]
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”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。 | “None” “SystemAssigned” “SystemAssigned,UserAssigned” “UserAssigned” |
userAssignedIdentities | <ArmUserIdentity> 字典 | ArmIdentityUserAssignedIdentities |
ArmIdentityUserAssignedIdentities
名字 | 描述 | 价值 |
---|
ArmUserIdentity
名字 | 描述 | 价值 |
---|
CloudToDeviceProperties
名字 | 描述 | 价值 |
---|---|---|
defaultTtlAsIso8601 | 设备队列中云到设备消息的默认生存时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
反馈 | 云到设备消息的反馈队列的属性。 | FeedbackProperties |
maxDeliveryCount | 设备队列中云到设备消息的最大传递计数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
EncryptionPropertiesDescription
名字 | 描述 | 价值 |
---|---|---|
keySource | 密钥的源。 | 字符串 |
keyVaultProperties | KeyVault 密钥的属性。 | KeyVaultKeyProperties[] |
EnrichmentProperties
名字 | 描述 | 价值 |
---|---|---|
endpointNames | 将扩充应用到消息的终结点列表。 | string[] (必需) |
钥匙 | 扩充属性的键或名称。 | string (必需) |
价值 | 扩充属性的值。 | 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” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
FeedbackProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 反馈队列的锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
maxDeliveryCount | IoT 中心尝试在反馈队列上传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
IotHubProperties
名字 | 描述 | 价值 |
---|---|---|
allowedFqdnList | 从 Iot 中心传出允许的 FQDN(完全限定域名)列表。 | string[] |
authorizationPolicies | 可用于保护与 IoT 中心的连接的共享访问策略。 | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | IoT 中心云到设备的消息传送属性。 | CloudToDeviceProperties |
评论 | IoT 中心注释。 | 字符串 |
deviceStreams | 设备流式传输 iothub 的属性。 | IotHubPropertiesDeviceStreams |
disableDeviceSAS | 如果为 true,则不能使用所有设备(包括 Edge 设备但不包括模块)范围的 SAS 密钥进行身份验证。 | bool |
disableLocalAuth | 如果为 true,则无法将具有 Iot 中心范围的 SAS 密钥的 SAS 令牌用于身份验证。 | bool |
disableModuleSAS | 如果为 true,则不能使用所有模块范围的 SAS 密钥进行身份验证。 | bool |
enableDataResidency | 如果设置为 true,则此属性将启用数据驻留,从而禁用灾难恢复。 | bool |
enableFileUploadNotifications | 如果为 True,则启用文件上传通知。 | bool |
加密 | IoT 中心的加密属性。 | EncryptionPropertiesDescription |
eventHubEndpoints | 与事件中心兼容的终结点属性。 此字典的唯一可能键是事件。 在对 IoT 中心进行创建或更新调用时,此密钥必须存在于字典中。 | IotHubPropertiesEventHubEndpoints |
特征 | 为 IoT 中心启用的功能和功能。 | “DeviceManagement” “None” |
ipFilterRules | IP 筛选器规则。 | IpFilterRule[] |
messagingEndpoints | 文件上传通知队列的消息传送终结点属性。 | IotHubPropertiesMessagingEndpoints |
minTlsVersion | 指定要支持此中心的最低 TLS 版本。 可以设置为“1.2”,让使用低于 1.2 的 TLS 版本的客户端被拒绝。 | 字符串 |
networkRuleSets | IotHub 的网络规则集属性 | NetworkRuleSetProperties |
privateEndpointConnections | 在此 IotHub 上创建的专用终结点连接 | PrivateEndpointConnection[] |
publicNetworkAccess | 是否允许来自公用网络的请求 | “Disabled” “Enabled” |
restrictOutboundNetworkAccess | 如果为 true,则来自 IotHub 的出口将仅限于通过 allowedFqdnList 配置的允许 FQDN。 | bool |
rootCertificate | 此属性存储根证书相关信息 | RootCertificateProperties |
路由 | IoT 中心的路由相关属性。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | 可在其中上传文件的 Azure 存储终结点列表。 目前只能配置一个 Azure 存储帐户,并且必须将其密钥作为$default。 指定多个存储帐户会导致引发错误。 当 enableFileUploadNotifications 属性设置为 True 时,不指定此属性的值,将导致引发错误。 | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
名字 | 描述 | 价值 |
---|---|---|
streamingEndpoints | 设备流终结点的列表。 | string[] |
IotHubPropertiesEventHubEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesMessagingEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesStorageEndpoints
名字 | 描述 | 价值 |
---|
IotHubSkuInfo
名字 | 描述 | 价值 |
---|---|---|
能力 | 预配的 IoT 中心单元数。 请参阅:/azure/azure-subscription-service-limits#iot-hub-limits。 | int |
名字 | SKU 的名称。 | “B1” “B2” “B3” “F1” “S1” 'S2' “S3”(必需) |
IpFilterRule
名字 | 描述 | 价值 |
---|---|---|
行动 | 此规则捕获的请求的所需操作。 | “Accept” “拒绝”(必需) |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
KeyVaultKeyProperties
名字 | 描述 | 价值 |
---|---|---|
身份 | KeyVault 密钥的托管标识属性。 | ManagedIdentity |
keyIdentifier | 密钥的标识符。 | 字符串 |
ManagedIdentity
名字 | 描述 | 价值 |
---|---|---|
userAssignedIdentity | 用户分配的标识。 | 字符串 |
MessagingEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
maxDeliveryCount | IoT 中心尝试传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
Microsoft.Devices/IotHubs
名字 | 描述 | 价值 |
---|---|---|
etag | Etag 字段 不需要。 如果在响应正文中提供,则还必须根据正常的 ETag 约定将其作为标头提供。 | 字符串 |
身份 | IotHub 的托管标识。 | ArmIdentity |
位置 | 资源位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | IotHub 属性 | IotHubProperties |
sku | IotHub SKU 信息 | IotHubSkuInfo (必需) |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
NetworkRuleSetIpRule
名字 | 描述 | 价值 |
---|---|---|
行动 | IP 筛选器操作 | “允许” |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
NetworkRuleSetProperties
名字 | 描述 | 价值 |
---|---|---|
applyToBuiltInEventHubEndpoint | 如果为 True,则网络规则集也应用于 IotHub 的 BuiltIn EventHub EndPoint | bool (必需) |
defaultAction | 网络规则集的默认操作 | “允许” “拒绝” |
ipRules | IP 规则列表 | NetworkRuleSetIpRule[] (必需) |
PrivateEndpoint
名字 | 描述 | 价值 |
---|
PrivateEndpointConnection
名字 | 描述 | 价值 |
---|---|---|
性能 | 专用终结点连接的属性 | PrivateEndpointConnectionProperties(必需) |
PrivateEndpointConnectionProperties
名字 | 描述 | 价值 |
---|---|---|
privateEndpoint | 专用终结点连接的专用终结点属性 | PrivateEndpoint |
privateLinkServiceConnectionState | 专用终结点连接的当前状态 | PrivateLinkServiceConnectionState (必需) |
PrivateLinkServiceConnectionState
名字 | 描述 | 价值 |
---|---|---|
actionsRequired | 专用终结点连接所需的操作 | 字符串 |
描述 | 专用终结点连接的当前状态说明 | string (必需) |
地位 | 专用终结点连接的状态 | “已批准” “Disconnected” “Pending” “已拒绝”(必需) |
ResourceTags
名字 | 描述 | 价值 |
---|
RootCertificateProperties
名字 | 描述 | 价值 |
---|---|---|
enableRootCertificateV2 | 当设置为 true 时,中心将使用 G2 证书;虽然它设置为 false,但中心使用巴尔的摩证书。 | bool |
RouteProperties
名字 | 描述 | 价值 |
---|---|---|
条件 | 评估为应用路由规则的条件。 如果未提供任何条件,则默认情况下计算结果为 true。 有关语法,请参阅:/azure/iot-hub/iot-hub-devguide-query-language | 字符串 |
endpointNames | 路由满足条件的消息的终结点列表。 目前只允许一个终结点。 | string[] (必需) |
isEnabled | 用于指定是否启用路由。 | bool (必需) |
名字 | 路由的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符,并且必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
源 | 要应用路由规则的源,例如 DeviceMessages。 | “DeviceConnectionStateEvents” “DeviceJobLifecycleEvents” “DeviceLifecycleEvents” “DeviceMessages” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
RoutingCosmosDBSqlApiProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于对 cosmos DB sql 集合终结点进行身份验证的方法 | “identityBased” “keyBased” |
collectionName | cosmos DB 数据库中 cosmos DB sql 集合的名称。 | string (必需) |
databaseName | cosmos DB 帐户中的 cosmos DB 数据库的名称。 | string (必需) |
endpointUri | cosmos DB 帐户的 URL。 它必须包括协议 https:// | string (必需) |
id | cosmos DB sql 集合终结点的 ID | 字符串 |
身份 | 路由 cosmos DB 集合终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
partitionKeyName | 与此 cosmos DB sql 集合关联的分区键的名称(如果存在)。 这是一个可选参数。 | 字符串 |
partitionKeyTemplate | 用于生成用于此 cosmos DB sql 集合的合成分区键值的模板。 模板必须至少包含以下占位符之一:{iothub}、{deviceid}、{DD}、{MM}和 {YYYY}。 最多可以指定一个占位符,但顺序和非占位符组件是任意的。 仅当指定 PartitionKeyName 时,此参数才是必需的。 | 字符串 |
primaryKey | cosmos DB 帐户的主键。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
resourceGroup | cosmos DB 帐户的资源组的名称。 | 字符串 |
secondaryKey | cosmos DB 帐户的辅助密钥。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
subscriptionId | cosmos DB 帐户的订阅标识符。 | 字符串 |
RoutingEndpoints
名字 | 描述 | 价值 |
---|---|---|
cosmosDBSqlCollections | IoT 中心根据路由规则将消息路由到的 Cosmos DB 集合终结点列表。 | RoutingCosmosDBSqlApiProperties[] |
eventHubs | IoT 中心根据路由规则将消息路由到的事件中心终结点列表。 此列表不包括内置事件中心终结点。 | RoutingEventHubProperties[] |
serviceBusQueues | IoT 中心根据路由规则将消息路由到的服务总线队列终结点列表。 | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | IoT 中心根据路由规则将消息路由到的服务总线主题终结点列表。 | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | IoT 中心根据路由规则将消息路由到的存储容器终结点列表。 | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对事件中心终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 事件中心终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 事件中心终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 事件中心命名空间上的事件中心名称 | 字符串 |
id | 事件中心终结点的 ID | 字符串 |
身份 | 路由事件中心终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 事件中心终结点的资源组的名称。 | 字符串 |
subscriptionId | 事件中心终结点的订阅标识符。 | 字符串 |
RoutingProperties
名字 | 描述 | 价值 |
---|---|---|
端点 | 与 IoT 中心基于路由规则路由消息的自定义终结点相关的属性。 在付费中心的所有终结点类型中最多允许 10 个自定义终结点,并且免费中心的所有终结点类型只允许 1 个自定义终结点。 | RoutingEndpoints |
扩充 | IoT 中心应用于要传递到内置终结点和自定义终结点的消息的用户提供的扩充列表。 请参阅:https://aka.ms/telemetryoneventgrid | 扩充属性[] |
fallbackRoute | 当“路由”部分中指定的任何条件均未满足时,用作回退路由的路由的属性。 这是一个可选参数。 如果未设置此属性,则不符合“路由”部分中指定的任何条件的消息将路由到内置事件中心终结点。 | FallbackRouteProperties |
路线 | IoT 中心用来将消息路由到内置终结点和自定义终结点的用户提供的路由规则列表。 付费中心最多允许 100 个路由规则,最多允许 5 个路由规则用于免费中心。 | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线队列终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线队列终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线队列终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线命名空间上的队列名称 | 字符串 |
id | 服务总线队列终结点的 ID | 字符串 |
身份 | 路由服务总线队列终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际队列名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线队列终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线队列终结点的订阅标识符。 | 字符串 |
RoutingServiceBusTopicEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线主题终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线主题终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线主题终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线主题上的队列名称 | 字符串 |
id | 服务总线主题终结点的 ID | 字符串 |
身份 | 路由服务总线主题终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际主题名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线主题终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线主题终结点的订阅标识符。 | 字符串 |
RoutingStorageContainerProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对存储终结点进行身份验证的方法 | “identityBased” “keyBased” |
batchFrequencyInSeconds | Blob 写入存储的时间间隔。 值应介于 60 到 720 秒之间。 默认值为 300 秒。 | int 约束: 最小值 = 60 最大值 = 720 |
connectionString | 存储帐户的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
containerName | 存储帐户中的存储容器的名称。 | string (必需) |
编码 | 用于将消息序列化为 Blob 的编码。 支持的值为“avro”、“avrodeflate”和“JSON”。 默认值为“avro”。 | “Avro” “AvroDeflate” “JSON” |
endpointUri | 存储终结点的 URL。 它必须包括协议 https:// | 字符串 |
fileNameFormat | Blob 的文件名格式。 默认格式为 {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}。 所有参数都是必需参数,但可以重新排序。 | 字符串 |
id | 存储容器终结点的 ID | 字符串 |
身份 | 路由存储终结点的托管标识属性。 | ManagedIdentity |
maxChunkSizeInBytes | 写入存储的每个 Blob 的最大字节数。 值应介于 10485760(10MB) 和 524288000(500MB) 之间。 默认值为 314572800(300MB)。 | int 约束: 最小值 = 10485760 最大值 = 524288000 |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 存储帐户的资源组的名称。 | 字符串 |
subscriptionId | 存储帐户的订阅标识符。 | 字符串 |
SharedAccessSignatureAuthorizationRule
名字 | 描述 | 价值 |
---|---|---|
keyName | 共享访问策略的名称。 | string (必需) |
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 存储帐户的连接字符串。 | string (必需) |
containerName | 上传文件的根容器的名称。 容器不需要存在,但应使用指定的 connectionString 进行创建。 | string (必需) |
身份 | 用于文件上传的存储终结点的托管标识属性。 | ManagedIdentity |
sasTtlAsIso8601 | IoT 中心为文件上传生成的 SAS URI 有效的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options。 | 字符串 |
快速入门示例
以下快速入门示例部署此资源类型。
Bicep 文件 | 描述 |
---|---|
创建 IoT 中心和设备到云使用者组 | 使用此模板,可将设备部署到云和云到设备消息配置以及设备到云使用者组的 IoT 中心实例。 |
创建 IoT 中心设备预配服务 | 使用此模板可以创建 IoT 中心和 IoT 中心设备预配服务,并将这两个服务链接在一起。 |
为 IoT 中心帐户、实例、IoT 中心 创建设备更新 | 此模板创建一个帐户和一个实例和一个用于链接实例的中心。 它使用必要的访问策略、路由和使用者组配置中心。 |
部署 MedTech 服务,包括 Azure IoT 中心 | MedTech 服务是一项 Azure Health Data Services,旨在从多个设备引入设备数据,将设备数据转换为 FHIR 观察,然后保存在 Azure Health Data Services FHIR 服务中。 |
使用 ARM 模板创建 IoT 中心、路由和查看消息 | 使用此模板部署 IoT 中心和存储帐户。 运行应用以将消息发送到路由到存储的中心,然后查看结果。 |
ARM 模板资源定义
可以使用目标操作部署 IotHubs 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.Devices/IotHubs 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.Devices/IotHubs",
"apiVersion": "2022-04-30-preview",
"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",
"deviceStreams": {
"streamingEndpoints": [ "string" ]
},
"disableDeviceSAS": "bool",
"disableLocalAuth": "bool",
"disableModuleSAS": "bool",
"enableDataResidency": "bool",
"enableFileUploadNotifications": "bool",
"encryption": {
"keySource": "string",
"keyVaultProperties": [
{
"identity": {
"userAssignedIdentity": "string"
},
"keyIdentifier": "string"
}
]
},
"eventHubEndpoints": {
"{customized property}": {
"partitionCount": "int",
"retentionTimeInDays": "int"
}
},
"features": "string",
"ipFilterRules": [
{
"action": "string",
"filterName": "string",
"ipMask": "string"
}
],
"messagingEndpoints": {
"{customized property}": {
"lockDurationAsIso8601": "string",
"maxDeliveryCount": "int",
"ttlAsIso8601": "string"
}
},
"minTlsVersion": "string",
"networkRuleSets": {
"applyToBuiltInEventHubEndpoint": "bool",
"defaultAction": "string",
"ipRules": [
{
"action": "string",
"filterName": "string",
"ipMask": "string"
}
]
},
"privateEndpointConnections": [
{
"properties": {
"privateEndpoint": {
},
"privateLinkServiceConnectionState": {
"actionsRequired": "string",
"description": "string",
"status": "string"
}
}
}
],
"publicNetworkAccess": "string",
"restrictOutboundNetworkAccess": "bool",
"rootCertificate": {
"enableRootCertificateV2": "bool"
},
"routing": {
"endpoints": {
"cosmosDBSqlCollections": [
{
"authenticationType": "string",
"collectionName": "string",
"databaseName": "string",
"endpointUri": "string",
"id": "string",
"identity": {
"userAssignedIdentity": "string"
},
"name": "string",
"partitionKeyName": "string",
"partitionKeyTemplate": "string",
"primaryKey": "string",
"resourceGroup": "string",
"secondaryKey": "string",
"subscriptionId": "string"
}
],
"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”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。 | “None” “SystemAssigned” “SystemAssigned,UserAssigned” “UserAssigned” |
userAssignedIdentities | <ArmUserIdentity> 字典 | ArmIdentityUserAssignedIdentities |
ArmIdentityUserAssignedIdentities
名字 | 描述 | 价值 |
---|
ArmUserIdentity
名字 | 描述 | 价值 |
---|
CloudToDeviceProperties
名字 | 描述 | 价值 |
---|---|---|
defaultTtlAsIso8601 | 设备队列中云到设备消息的默认生存时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
反馈 | 云到设备消息的反馈队列的属性。 | FeedbackProperties |
maxDeliveryCount | 设备队列中云到设备消息的最大传递计数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
EncryptionPropertiesDescription
名字 | 描述 | 价值 |
---|---|---|
keySource | 密钥的源。 | 字符串 |
keyVaultProperties | KeyVault 密钥的属性。 | KeyVaultKeyProperties[] |
EnrichmentProperties
名字 | 描述 | 价值 |
---|---|---|
endpointNames | 将扩充应用到消息的终结点列表。 | string[] (必需) |
钥匙 | 扩充属性的键或名称。 | string (必需) |
价值 | 扩充属性的值。 | 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” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
FeedbackProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 反馈队列的锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
maxDeliveryCount | IoT 中心尝试在反馈队列上传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
IotHubProperties
名字 | 描述 | 价值 |
---|---|---|
allowedFqdnList | 从 Iot 中心传出允许的 FQDN(完全限定域名)列表。 | string[] |
authorizationPolicies | 可用于保护与 IoT 中心的连接的共享访问策略。 | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | IoT 中心云到设备的消息传送属性。 | CloudToDeviceProperties |
评论 | IoT 中心注释。 | 字符串 |
deviceStreams | 设备流式传输 iothub 的属性。 | IotHubPropertiesDeviceStreams |
disableDeviceSAS | 如果为 true,则不能使用所有设备(包括 Edge 设备但不包括模块)范围的 SAS 密钥进行身份验证。 | bool |
disableLocalAuth | 如果为 true,则无法将具有 Iot 中心范围的 SAS 密钥的 SAS 令牌用于身份验证。 | bool |
disableModuleSAS | 如果为 true,则不能使用所有模块范围的 SAS 密钥进行身份验证。 | bool |
enableDataResidency | 如果设置为 true,则此属性将启用数据驻留,从而禁用灾难恢复。 | bool |
enableFileUploadNotifications | 如果为 True,则启用文件上传通知。 | bool |
加密 | IoT 中心的加密属性。 | EncryptionPropertiesDescription |
eventHubEndpoints | 与事件中心兼容的终结点属性。 此字典的唯一可能键是事件。 在对 IoT 中心进行创建或更新调用时,此密钥必须存在于字典中。 | IotHubPropertiesEventHubEndpoints |
特征 | 为 IoT 中心启用的功能和功能。 | “DeviceManagement” “None” |
ipFilterRules | IP 筛选器规则。 | IpFilterRule[] |
messagingEndpoints | 文件上传通知队列的消息传送终结点属性。 | IotHubPropertiesMessagingEndpoints |
minTlsVersion | 指定要支持此中心的最低 TLS 版本。 可以设置为“1.2”,让使用低于 1.2 的 TLS 版本的客户端被拒绝。 | 字符串 |
networkRuleSets | IotHub 的网络规则集属性 | NetworkRuleSetProperties |
privateEndpointConnections | 在此 IotHub 上创建的专用终结点连接 | PrivateEndpointConnection[] |
publicNetworkAccess | 是否允许来自公用网络的请求 | “Disabled” “Enabled” |
restrictOutboundNetworkAccess | 如果为 true,则来自 IotHub 的出口将仅限于通过 allowedFqdnList 配置的允许 FQDN。 | bool |
rootCertificate | 此属性存储根证书相关信息 | RootCertificateProperties |
路由 | IoT 中心的路由相关属性。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | 可在其中上传文件的 Azure 存储终结点列表。 目前只能配置一个 Azure 存储帐户,并且必须将其密钥作为$default。 指定多个存储帐户会导致引发错误。 当 enableFileUploadNotifications 属性设置为 True 时,不指定此属性的值,将导致引发错误。 | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
名字 | 描述 | 价值 |
---|---|---|
streamingEndpoints | 设备流终结点的列表。 | string[] |
IotHubPropertiesEventHubEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesMessagingEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesStorageEndpoints
名字 | 描述 | 价值 |
---|
IotHubSkuInfo
名字 | 描述 | 价值 |
---|---|---|
能力 | 预配的 IoT 中心单元数。 请参阅:/azure/azure-subscription-service-limits#iot-hub-limits。 | int |
名字 | SKU 的名称。 | “B1” “B2” “B3” “F1” “S1” 'S2' “S3”(必需) |
IpFilterRule
名字 | 描述 | 价值 |
---|---|---|
行动 | 此规则捕获的请求的所需操作。 | “Accept” “拒绝”(必需) |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
KeyVaultKeyProperties
名字 | 描述 | 价值 |
---|---|---|
身份 | KeyVault 密钥的托管标识属性。 | ManagedIdentity |
keyIdentifier | 密钥的标识符。 | 字符串 |
ManagedIdentity
名字 | 描述 | 价值 |
---|---|---|
userAssignedIdentity | 用户分配的标识。 | 字符串 |
MessagingEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
maxDeliveryCount | IoT 中心尝试传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
Microsoft.Devices/IotHubs
名字 | 描述 | 价值 |
---|---|---|
apiVersion | API 版本 | '2022-04-30-preview' |
etag | Etag 字段 不需要。 如果在响应正文中提供,则还必须根据正常的 ETag 约定将其作为标头提供。 | 字符串 |
身份 | IotHub 的托管标识。 | ArmIdentity |
位置 | 资源位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | IotHub 属性 | IotHubProperties |
sku | IotHub SKU 信息 | IotHubSkuInfo (必需) |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
类型 | 资源类型 | “Microsoft.Devices/IotHubs” |
NetworkRuleSetIpRule
名字 | 描述 | 价值 |
---|---|---|
行动 | IP 筛选器操作 | “允许” |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
NetworkRuleSetProperties
名字 | 描述 | 价值 |
---|---|---|
applyToBuiltInEventHubEndpoint | 如果为 True,则网络规则集也应用于 IotHub 的 BuiltIn EventHub EndPoint | bool (必需) |
defaultAction | 网络规则集的默认操作 | “允许” “拒绝” |
ipRules | IP 规则列表 | NetworkRuleSetIpRule[] (必需) |
PrivateEndpoint
名字 | 描述 | 价值 |
---|
PrivateEndpointConnection
名字 | 描述 | 价值 |
---|---|---|
性能 | 专用终结点连接的属性 | PrivateEndpointConnectionProperties(必需) |
PrivateEndpointConnectionProperties
名字 | 描述 | 价值 |
---|---|---|
privateEndpoint | 专用终结点连接的专用终结点属性 | PrivateEndpoint |
privateLinkServiceConnectionState | 专用终结点连接的当前状态 | PrivateLinkServiceConnectionState (必需) |
PrivateLinkServiceConnectionState
名字 | 描述 | 价值 |
---|---|---|
actionsRequired | 专用终结点连接所需的操作 | 字符串 |
描述 | 专用终结点连接的当前状态说明 | string (必需) |
地位 | 专用终结点连接的状态 | “已批准” “Disconnected” “Pending” “已拒绝”(必需) |
ResourceTags
名字 | 描述 | 价值 |
---|
RootCertificateProperties
名字 | 描述 | 价值 |
---|---|---|
enableRootCertificateV2 | 当设置为 true 时,中心将使用 G2 证书;虽然它设置为 false,但中心使用巴尔的摩证书。 | bool |
RouteProperties
名字 | 描述 | 价值 |
---|---|---|
条件 | 评估为应用路由规则的条件。 如果未提供任何条件,则默认情况下计算结果为 true。 有关语法,请参阅:/azure/iot-hub/iot-hub-devguide-query-language | 字符串 |
endpointNames | 路由满足条件的消息的终结点列表。 目前只允许一个终结点。 | string[] (必需) |
isEnabled | 用于指定是否启用路由。 | bool (必需) |
名字 | 路由的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符,并且必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
源 | 要应用路由规则的源,例如 DeviceMessages。 | “DeviceConnectionStateEvents” “DeviceJobLifecycleEvents” “DeviceLifecycleEvents” “DeviceMessages” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
RoutingCosmosDBSqlApiProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于对 cosmos DB sql 集合终结点进行身份验证的方法 | “identityBased” “keyBased” |
collectionName | cosmos DB 数据库中 cosmos DB sql 集合的名称。 | string (必需) |
databaseName | cosmos DB 帐户中的 cosmos DB 数据库的名称。 | string (必需) |
endpointUri | cosmos DB 帐户的 URL。 它必须包括协议 https:// | string (必需) |
id | cosmos DB sql 集合终结点的 ID | 字符串 |
身份 | 路由 cosmos DB 集合终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
partitionKeyName | 与此 cosmos DB sql 集合关联的分区键的名称(如果存在)。 这是一个可选参数。 | 字符串 |
partitionKeyTemplate | 用于生成用于此 cosmos DB sql 集合的合成分区键值的模板。 模板必须至少包含以下占位符之一:{iothub}、{deviceid}、{DD}、{MM}和 {YYYY}。 最多可以指定一个占位符,但顺序和非占位符组件是任意的。 仅当指定 PartitionKeyName 时,此参数才是必需的。 | 字符串 |
primaryKey | cosmos DB 帐户的主键。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
resourceGroup | cosmos DB 帐户的资源组的名称。 | 字符串 |
secondaryKey | cosmos DB 帐户的辅助密钥。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
subscriptionId | cosmos DB 帐户的订阅标识符。 | 字符串 |
RoutingEndpoints
名字 | 描述 | 价值 |
---|---|---|
cosmosDBSqlCollections | IoT 中心根据路由规则将消息路由到的 Cosmos DB 集合终结点列表。 | RoutingCosmosDBSqlApiProperties[] |
eventHubs | IoT 中心根据路由规则将消息路由到的事件中心终结点列表。 此列表不包括内置事件中心终结点。 | RoutingEventHubProperties[] |
serviceBusQueues | IoT 中心根据路由规则将消息路由到的服务总线队列终结点列表。 | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | IoT 中心根据路由规则将消息路由到的服务总线主题终结点列表。 | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | IoT 中心根据路由规则将消息路由到的存储容器终结点列表。 | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对事件中心终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 事件中心终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 事件中心终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 事件中心命名空间上的事件中心名称 | 字符串 |
id | 事件中心终结点的 ID | 字符串 |
身份 | 路由事件中心终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 事件中心终结点的资源组的名称。 | 字符串 |
subscriptionId | 事件中心终结点的订阅标识符。 | 字符串 |
RoutingProperties
名字 | 描述 | 价值 |
---|---|---|
端点 | 与 IoT 中心基于路由规则路由消息的自定义终结点相关的属性。 在付费中心的所有终结点类型中最多允许 10 个自定义终结点,并且免费中心的所有终结点类型只允许 1 个自定义终结点。 | RoutingEndpoints |
扩充 | IoT 中心应用于要传递到内置终结点和自定义终结点的消息的用户提供的扩充列表。 请参阅:https://aka.ms/telemetryoneventgrid | 扩充属性[] |
fallbackRoute | 当“路由”部分中指定的任何条件均未满足时,用作回退路由的路由的属性。 这是一个可选参数。 如果未设置此属性,则不符合“路由”部分中指定的任何条件的消息将路由到内置事件中心终结点。 | FallbackRouteProperties |
路线 | IoT 中心用来将消息路由到内置终结点和自定义终结点的用户提供的路由规则列表。 付费中心最多允许 100 个路由规则,最多允许 5 个路由规则用于免费中心。 | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线队列终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线队列终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线队列终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线命名空间上的队列名称 | 字符串 |
id | 服务总线队列终结点的 ID | 字符串 |
身份 | 路由服务总线队列终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际队列名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线队列终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线队列终结点的订阅标识符。 | 字符串 |
RoutingServiceBusTopicEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线主题终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线主题终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线主题终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线主题上的队列名称 | 字符串 |
id | 服务总线主题终结点的 ID | 字符串 |
身份 | 路由服务总线主题终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际主题名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线主题终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线主题终结点的订阅标识符。 | 字符串 |
RoutingStorageContainerProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对存储终结点进行身份验证的方法 | “identityBased” “keyBased” |
batchFrequencyInSeconds | Blob 写入存储的时间间隔。 值应介于 60 到 720 秒之间。 默认值为 300 秒。 | int 约束: 最小值 = 60 最大值 = 720 |
connectionString | 存储帐户的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
containerName | 存储帐户中的存储容器的名称。 | string (必需) |
编码 | 用于将消息序列化为 Blob 的编码。 支持的值为“avro”、“avrodeflate”和“JSON”。 默认值为“avro”。 | “Avro” “AvroDeflate” “JSON” |
endpointUri | 存储终结点的 URL。 它必须包括协议 https:// | 字符串 |
fileNameFormat | Blob 的文件名格式。 默认格式为 {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}。 所有参数都是必需参数,但可以重新排序。 | 字符串 |
id | 存储容器终结点的 ID | 字符串 |
身份 | 路由存储终结点的托管标识属性。 | ManagedIdentity |
maxChunkSizeInBytes | 写入存储的每个 Blob 的最大字节数。 值应介于 10485760(10MB) 和 524288000(500MB) 之间。 默认值为 314572800(300MB)。 | int 约束: 最小值 = 10485760 最大值 = 524288000 |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 存储帐户的资源组的名称。 | 字符串 |
subscriptionId | 存储帐户的订阅标识符。 | 字符串 |
SharedAccessSignatureAuthorizationRule
名字 | 描述 | 价值 |
---|---|---|
keyName | 共享访问策略的名称。 | string (必需) |
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 存储帐户的连接字符串。 | string (必需) |
containerName | 上传文件的根容器的名称。 容器不需要存在,但应使用指定的 connectionString 进行创建。 | string (必需) |
身份 | 用于文件上传的存储终结点的托管标识属性。 | ManagedIdentity |
sasTtlAsIso8601 | IoT 中心为文件上传生成的 SAS URI 有效的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options。 | 字符串 |
快速入门模板
以下快速入门模板部署此资源类型。
模板 | 描述 |
---|---|
使用 IoT 中心创建即用即付(PAYG)环境 |
使用此模板,可以部署配置为使用 IoT 中心的事件的即用即付(PAYG)时序见解环境。 |
创建 IoT 中心和设备到云使用者组 |
使用此模板,可将设备部署到云和云到设备消息配置以及设备到云使用者组的 IoT 中心实例。 |
创建 IOT 中心和 Ubuntu 边缘模拟器 |
此模板创建 IOT 中心和虚拟机 Ubuntu 边缘模拟器。 |
创建 IoT 中心设备预配服务 |
使用此模板可以创建 IoT 中心和 IoT 中心设备预配服务,并将这两个服务链接在一起。 |
为 IoT 中心帐户、实例、IoT 中心 创建设备更新 |
此模板创建一个帐户和一个实例和一个用于链接实例的中心。 它使用必要的访问策略、路由和使用者组配置中心。 |
部署 MedTech 服务,包括 Azure IoT 中心 |
MedTech 服务是一项 Azure Health Data Services,旨在从多个设备引入设备数据,将设备数据转换为 FHIR 观察,然后保存在 Azure Health Data Services FHIR 服务中。 |
使用 ARM 模板创建 IoT 中心、路由和查看消息 |
使用此模板部署 IoT 中心和存储帐户。 运行应用以将消息发送到路由到存储的中心,然后查看结果。 |
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署 IotHubs 资源类型:
- 资源组
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.Devices/IotHubs 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/IotHubs@2022-04-30-preview"
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"
deviceStreams = {
streamingEndpoints = [
"string"
]
}
disableDeviceSAS = bool
disableLocalAuth = bool
disableModuleSAS = bool
enableDataResidency = bool
enableFileUploadNotifications = bool
encryption = {
keySource = "string"
keyVaultProperties = [
{
identity = {
userAssignedIdentity = "string"
}
keyIdentifier = "string"
}
]
}
eventHubEndpoints = {
{customized property} = {
partitionCount = int
retentionTimeInDays = int
}
}
features = "string"
ipFilterRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
}
]
messagingEndpoints = {
{customized property} = {
lockDurationAsIso8601 = "string"
maxDeliveryCount = int
ttlAsIso8601 = "string"
}
}
minTlsVersion = "string"
networkRuleSets = {
applyToBuiltInEventHubEndpoint = bool
defaultAction = "string"
ipRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
}
]
}
privateEndpointConnections = [
{
properties = {
privateEndpoint = {
}
privateLinkServiceConnectionState = {
actionsRequired = "string"
description = "string"
status = "string"
}
}
}
]
publicNetworkAccess = "string"
restrictOutboundNetworkAccess = bool
rootCertificate = {
enableRootCertificateV2 = bool
}
routing = {
endpoints = {
cosmosDBSqlCollections = [
{
authenticationType = "string"
collectionName = "string"
databaseName = "string"
endpointUri = "string"
id = "string"
identity = {
userAssignedIdentity = "string"
}
name = "string"
partitionKeyName = "string"
partitionKeyTemplate = "string"
primaryKey = "string"
resourceGroup = "string"
secondaryKey = "string"
subscriptionId = "string"
}
]
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”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从服务中删除任何标识。 | “None” “SystemAssigned” “SystemAssigned,UserAssigned” “UserAssigned” |
userAssignedIdentities | <ArmUserIdentity> 字典 | ArmIdentityUserAssignedIdentities |
ArmIdentityUserAssignedIdentities
名字 | 描述 | 价值 |
---|
ArmUserIdentity
名字 | 描述 | 价值 |
---|
CloudToDeviceProperties
名字 | 描述 | 价值 |
---|---|---|
defaultTtlAsIso8601 | 设备队列中云到设备消息的默认生存时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
反馈 | 云到设备消息的反馈队列的属性。 | FeedbackProperties |
maxDeliveryCount | 设备队列中云到设备消息的最大传递计数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
EncryptionPropertiesDescription
名字 | 描述 | 价值 |
---|---|---|
keySource | 密钥的源。 | 字符串 |
keyVaultProperties | KeyVault 密钥的属性。 | KeyVaultKeyProperties[] |
EnrichmentProperties
名字 | 描述 | 价值 |
---|---|---|
endpointNames | 将扩充应用到消息的终结点列表。 | string[] (必需) |
钥匙 | 扩充属性的键或名称。 | string (必需) |
价值 | 扩充属性的值。 | 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” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
FeedbackProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 反馈队列的锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
maxDeliveryCount | IoT 中心尝试在反馈队列上传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages。 | 字符串 |
IotHubProperties
名字 | 描述 | 价值 |
---|---|---|
allowedFqdnList | 从 Iot 中心传出允许的 FQDN(完全限定域名)列表。 | string[] |
authorizationPolicies | 可用于保护与 IoT 中心的连接的共享访问策略。 | SharedAccessSignatureAuthorizationRule[] |
cloudToDevice | IoT 中心云到设备的消息传送属性。 | CloudToDeviceProperties |
评论 | IoT 中心注释。 | 字符串 |
deviceStreams | 设备流式传输 iothub 的属性。 | IotHubPropertiesDeviceStreams |
disableDeviceSAS | 如果为 true,则不能使用所有设备(包括 Edge 设备但不包括模块)范围的 SAS 密钥进行身份验证。 | bool |
disableLocalAuth | 如果为 true,则无法将具有 Iot 中心范围的 SAS 密钥的 SAS 令牌用于身份验证。 | bool |
disableModuleSAS | 如果为 true,则不能使用所有模块范围的 SAS 密钥进行身份验证。 | bool |
enableDataResidency | 如果设置为 true,则此属性将启用数据驻留,从而禁用灾难恢复。 | bool |
enableFileUploadNotifications | 如果为 True,则启用文件上传通知。 | bool |
加密 | IoT 中心的加密属性。 | EncryptionPropertiesDescription |
eventHubEndpoints | 与事件中心兼容的终结点属性。 此字典的唯一可能键是事件。 在对 IoT 中心进行创建或更新调用时,此密钥必须存在于字典中。 | IotHubPropertiesEventHubEndpoints |
特征 | 为 IoT 中心启用的功能和功能。 | “DeviceManagement” “None” |
ipFilterRules | IP 筛选器规则。 | IpFilterRule[] |
messagingEndpoints | 文件上传通知队列的消息传送终结点属性。 | IotHubPropertiesMessagingEndpoints |
minTlsVersion | 指定要支持此中心的最低 TLS 版本。 可以设置为“1.2”,让使用低于 1.2 的 TLS 版本的客户端被拒绝。 | 字符串 |
networkRuleSets | IotHub 的网络规则集属性 | NetworkRuleSetProperties |
privateEndpointConnections | 在此 IotHub 上创建的专用终结点连接 | PrivateEndpointConnection[] |
publicNetworkAccess | 是否允许来自公用网络的请求 | “Disabled” “Enabled” |
restrictOutboundNetworkAccess | 如果为 true,则来自 IotHub 的出口将仅限于通过 allowedFqdnList 配置的允许 FQDN。 | bool |
rootCertificate | 此属性存储根证书相关信息 | RootCertificateProperties |
路由 | IoT 中心的路由相关属性。 请参阅:/azure/iot-hub/iot-hub-devguide-messaging | RoutingProperties |
storageEndpoints | 可在其中上传文件的 Azure 存储终结点列表。 目前只能配置一个 Azure 存储帐户,并且必须将其密钥作为$default。 指定多个存储帐户会导致引发错误。 当 enableFileUploadNotifications 属性设置为 True 时,不指定此属性的值,将导致引发错误。 | IotHubPropertiesStorageEndpoints |
IotHubPropertiesDeviceStreams
名字 | 描述 | 价值 |
---|---|---|
streamingEndpoints | 设备流终结点的列表。 | string[] |
IotHubPropertiesEventHubEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesMessagingEndpoints
名字 | 描述 | 价值 |
---|
IotHubPropertiesStorageEndpoints
名字 | 描述 | 价值 |
---|
IotHubSkuInfo
名字 | 描述 | 价值 |
---|---|---|
能力 | 预配的 IoT 中心单元数。 请参阅:/azure/azure-subscription-service-limits#iot-hub-limits。 | int |
名字 | SKU 的名称。 | “B1” “B2” “B3” “F1” “S1” 'S2' “S3”(必需) |
IpFilterRule
名字 | 描述 | 价值 |
---|---|---|
行动 | 此规则捕获的请求的所需操作。 | “Accept” “拒绝”(必需) |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
KeyVaultKeyProperties
名字 | 描述 | 价值 |
---|---|---|
身份 | KeyVault 密钥的托管标识属性。 | ManagedIdentity |
keyIdentifier | 密钥的标识符。 | 字符串 |
ManagedIdentity
名字 | 描述 | 价值 |
---|---|---|
userAssignedIdentity | 用户分配的标识。 | 字符串 |
MessagingEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
lockDurationAsIso8601 | 锁定持续时间。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
maxDeliveryCount | IoT 中心尝试传递消息的次数。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | int 约束: 最小值 = 1 最大值 = 100 |
ttlAsIso8601 | 消息在 IoT 中心过期之前可供使用的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload。 | 字符串 |
Microsoft.Devices/IotHubs
名字 | 描述 | 价值 |
---|---|---|
etag | Etag 字段 不需要。 如果在响应正文中提供,则还必须根据正常的 ETag 约定将其作为标头提供。 | 字符串 |
身份 | IotHub 的托管标识。 | ArmIdentity |
位置 | 资源位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | IotHub 属性 | IotHubProperties |
sku | IotHub SKU 信息 | IotHubSkuInfo (必需) |
标签 | 资源标记 | 标记名称和值的字典。 |
类型 | 资源类型 | “Microsoft.Devices/IotHubs@2022-04-30-preview” |
NetworkRuleSetIpRule
名字 | 描述 | 价值 |
---|---|---|
行动 | IP 筛选器操作 | “允许” |
filterName | IP 筛选器规则的名称。 | string (必需) |
ipMask | 一个字符串,其中包含规则的 CIDR 表示法中的 IP 地址范围。 | string (必需) |
NetworkRuleSetProperties
名字 | 描述 | 价值 |
---|---|---|
applyToBuiltInEventHubEndpoint | 如果为 True,则网络规则集也应用于 IotHub 的 BuiltIn EventHub EndPoint | bool (必需) |
defaultAction | 网络规则集的默认操作 | “允许” “拒绝” |
ipRules | IP 规则列表 | NetworkRuleSetIpRule[] (必需) |
PrivateEndpoint
名字 | 描述 | 价值 |
---|
PrivateEndpointConnection
名字 | 描述 | 价值 |
---|---|---|
性能 | 专用终结点连接的属性 | PrivateEndpointConnectionProperties(必需) |
PrivateEndpointConnectionProperties
名字 | 描述 | 价值 |
---|---|---|
privateEndpoint | 专用终结点连接的专用终结点属性 | PrivateEndpoint |
privateLinkServiceConnectionState | 专用终结点连接的当前状态 | PrivateLinkServiceConnectionState (必需) |
PrivateLinkServiceConnectionState
名字 | 描述 | 价值 |
---|---|---|
actionsRequired | 专用终结点连接所需的操作 | 字符串 |
描述 | 专用终结点连接的当前状态说明 | string (必需) |
地位 | 专用终结点连接的状态 | “已批准” “Disconnected” “Pending” “已拒绝”(必需) |
ResourceTags
名字 | 描述 | 价值 |
---|
RootCertificateProperties
名字 | 描述 | 价值 |
---|---|---|
enableRootCertificateV2 | 当设置为 true 时,中心将使用 G2 证书;虽然它设置为 false,但中心使用巴尔的摩证书。 | bool |
RouteProperties
名字 | 描述 | 价值 |
---|---|---|
条件 | 评估为应用路由规则的条件。 如果未提供任何条件,则默认情况下计算结果为 true。 有关语法,请参阅:/azure/iot-hub/iot-hub-devguide-query-language | 字符串 |
endpointNames | 路由满足条件的消息的终结点列表。 目前只允许一个终结点。 | string[] (必需) |
isEnabled | 用于指定是否启用路由。 | bool (必需) |
名字 | 路由的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符,并且必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
源 | 要应用路由规则的源,例如 DeviceMessages。 | “DeviceConnectionStateEvents” “DeviceJobLifecycleEvents” “DeviceLifecycleEvents” “DeviceMessages” “DigitalTwinChangeEvents” “Invalid” “MqttBrokerMessages” “TwinChangeEvents”(必需) |
RoutingCosmosDBSqlApiProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于对 cosmos DB sql 集合终结点进行身份验证的方法 | “identityBased” “keyBased” |
collectionName | cosmos DB 数据库中 cosmos DB sql 集合的名称。 | string (必需) |
databaseName | cosmos DB 帐户中的 cosmos DB 数据库的名称。 | string (必需) |
endpointUri | cosmos DB 帐户的 URL。 它必须包括协议 https:// | string (必需) |
id | cosmos DB sql 集合终结点的 ID | 字符串 |
身份 | 路由 cosmos DB 集合终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
partitionKeyName | 与此 cosmos DB sql 集合关联的分区键的名称(如果存在)。 这是一个可选参数。 | 字符串 |
partitionKeyTemplate | 用于生成用于此 cosmos DB sql 集合的合成分区键值的模板。 模板必须至少包含以下占位符之一:{iothub}、{deviceid}、{DD}、{MM}和 {YYYY}。 最多可以指定一个占位符,但顺序和非占位符组件是任意的。 仅当指定 PartitionKeyName 时,此参数才是必需的。 | 字符串 |
primaryKey | cosmos DB 帐户的主键。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
resourceGroup | cosmos DB 帐户的资源组的名称。 | 字符串 |
secondaryKey | cosmos DB 帐户的辅助密钥。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
subscriptionId | cosmos DB 帐户的订阅标识符。 | 字符串 |
RoutingEndpoints
名字 | 描述 | 价值 |
---|---|---|
cosmosDBSqlCollections | IoT 中心根据路由规则将消息路由到的 Cosmos DB 集合终结点列表。 | RoutingCosmosDBSqlApiProperties[] |
eventHubs | IoT 中心根据路由规则将消息路由到的事件中心终结点列表。 此列表不包括内置事件中心终结点。 | RoutingEventHubProperties[] |
serviceBusQueues | IoT 中心根据路由规则将消息路由到的服务总线队列终结点列表。 | RoutingServiceBusQueueEndpointProperties[] |
serviceBusTopics | IoT 中心根据路由规则将消息路由到的服务总线主题终结点列表。 | RoutingServiceBusTopicEndpointProperties[] |
storageContainers | IoT 中心根据路由规则将消息路由到的存储容器终结点列表。 | RoutingStorageContainerProperties[] |
RoutingEventHubProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对事件中心终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 事件中心终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 事件中心终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 事件中心命名空间上的事件中心名称 | 字符串 |
id | 事件中心终结点的 ID | 字符串 |
身份 | 路由事件中心终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 事件中心终结点的资源组的名称。 | 字符串 |
subscriptionId | 事件中心终结点的订阅标识符。 | 字符串 |
RoutingProperties
名字 | 描述 | 价值 |
---|---|---|
端点 | 与 IoT 中心基于路由规则路由消息的自定义终结点相关的属性。 在付费中心的所有终结点类型中最多允许 10 个自定义终结点,并且免费中心的所有终结点类型只允许 1 个自定义终结点。 | RoutingEndpoints |
扩充 | IoT 中心应用于要传递到内置终结点和自定义终结点的消息的用户提供的扩充列表。 请参阅:https://aka.ms/telemetryoneventgrid | 扩充属性[] |
fallbackRoute | 当“路由”部分中指定的任何条件均未满足时,用作回退路由的路由的属性。 这是一个可选参数。 如果未设置此属性,则不符合“路由”部分中指定的任何条件的消息将路由到内置事件中心终结点。 | FallbackRouteProperties |
路线 | IoT 中心用来将消息路由到内置终结点和自定义终结点的用户提供的路由规则列表。 付费中心最多允许 100 个路由规则,最多允许 5 个路由规则用于免费中心。 | RouteProperties[] |
RoutingServiceBusQueueEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线队列终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线队列终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线队列终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线命名空间上的队列名称 | 字符串 |
id | 服务总线队列终结点的 ID | 字符串 |
身份 | 路由服务总线队列终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际队列名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线队列终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线队列终结点的订阅标识符。 | 字符串 |
RoutingServiceBusTopicEndpointProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对服务总线主题终结点进行身份验证的方法 | “identityBased” “keyBased” |
connectionString | 服务总线主题终结点的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
endpointUri | 服务总线主题终结点的 URL。 它必须包括协议 sb:// | 字符串 |
entityPath | 服务总线主题上的队列名称 | 字符串 |
id | 服务总线主题终结点的 ID | 字符串 |
身份 | 路由服务总线主题终结点的托管标识属性。 | ManagedIdentity |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 该名称不需要与实际主题名称相同。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 服务总线主题终结点的资源组的名称。 | 字符串 |
subscriptionId | 服务总线主题终结点的订阅标识符。 | 字符串 |
RoutingStorageContainerProperties
名字 | 描述 | 价值 |
---|---|---|
authenticationType | 用于针对存储终结点进行身份验证的方法 | “identityBased” “keyBased” |
batchFrequencyInSeconds | Blob 写入存储的时间间隔。 值应介于 60 到 720 秒之间。 默认值为 300 秒。 | int 约束: 最小值 = 60 最大值 = 720 |
connectionString | 存储帐户的连接字符串。 | 字符串 约束: 敏感值。 以安全参数的形式传入。 |
containerName | 存储帐户中的存储容器的名称。 | string (必需) |
编码 | 用于将消息序列化为 Blob 的编码。 支持的值为“avro”、“avrodeflate”和“JSON”。 默认值为“avro”。 | “Avro” “AvroDeflate” “JSON” |
endpointUri | 存储终结点的 URL。 它必须包括协议 https:// | 字符串 |
fileNameFormat | Blob 的文件名格式。 默认格式为 {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}。 所有参数都是必需参数,但可以重新排序。 | 字符串 |
id | 存储容器终结点的 ID | 字符串 |
身份 | 路由存储终结点的托管标识属性。 | ManagedIdentity |
maxChunkSizeInBytes | 写入存储的每个 Blob 的最大字节数。 值应介于 10485760(10MB) 和 524288000(500MB) 之间。 默认值为 314572800(300MB)。 | int 约束: 最小值 = 10485760 最大值 = 524288000 |
名字 | 标识此终结点的名称。 该名称只能包含字母数字字符、句点、下划线、连字符,最大长度为 64 个字符。 保留以下名称:事件、fileNotifications、$default。 终结点名称在终结点类型中必须是唯一的。 | 字符串 约束: 模式 = ^[A-Za-z0-9-._]{1,64}$ (必需) |
resourceGroup | 存储帐户的资源组的名称。 | 字符串 |
subscriptionId | 存储帐户的订阅标识符。 | 字符串 |
SharedAccessSignatureAuthorizationRule
名字 | 描述 | 价值 |
---|---|---|
keyName | 共享访问策略的名称。 | string (必需) |
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 存储帐户的连接字符串。 | string (必需) |
containerName | 上传文件的根容器的名称。 容器不需要存在,但应使用指定的 connectionString 进行创建。 | string (必需) |
身份 | 用于文件上传的存储终结点的托管标识属性。 | ManagedIdentity |
sasTtlAsIso8601 | IoT 中心为文件上传生成的 SAS URI 有效的时间段。 请参阅:/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options。 | 字符串 |