Aracılığıyla paylaş


Microsoft.Devices IotHubs

Bicep kaynak tanımı

IotHubs kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Devices/IotHubs kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Devices/IotHubs@2023-06-30' = {
  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
    enableDataResidency: 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: {
        cosmosDBSqlContainers: [
          {
            authenticationType: 'string'
            containerName: 'string'
            databaseName: 'string'
            endpointUri: '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'
  }
}

Özellik değerleri

ArmIdentity

Ad Açıklama Değer
tür Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem örtük olarak oluşturulmuş bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır. 'Hiçbiri'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities <ArmUserIdentity> sözlüğü ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Ad Açıklama Değer

ArmUseridentity

Ad Açıklama Değer

CloudToDeviceProperties

Ad Açıklama Değer
defaultTtlAsIso8601 Cihaz kuyruğundaki buluttan cihaza iletiler için varsayılan yaşam süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
geri besleme Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri. FeedbackProperties
maxDeliveryCount Cihaz kuyruğundaki buluttan cihaza iletiler için en yüksek teslim sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100

EnrichmentProperties

Ad Açıklama Değer
endpointNames zenginleştirmenin iletiye uygulandığı uç noktaların listesi. string[] (gerekli)
anahtar Zenginleştirme özelliğinin anahtarı veya adı. dize (gerekli)
değer Zenginleştirme özelliğinin değeri. dize (gerekli)

EventHubProperties

Ad Açıklama Değer
partitionCount Event Hub ile uyumlu uç noktada cihazdan buluta iletileri almaya yönelik bölüm sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Cihazdan buluta iletilerin saklama süresi (gün olarak). Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Ad Açıklama Değer
koşul Geri dönüş yolunu uygulamak için değerlendirilen koşul. Koşul sağlanmazsa varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca 1 uç noktaya izin verilir. string[] (gerekli)
isEnabled Geri dönüş yolunun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi
kaynak Yönlendirme kuralının uygulanacağı kaynak. Örneğin, DeviceMessages 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

FeedbackProperties

Ad Açıklama Değer
lockDurationAsIso8601 Geri bildirim kuyruğunun kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
maxDeliveryCount IoT hub'ının geri bildirim kuyruğunda ileti göndermeyi deneme sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi

IotHubProperties

Ad Açıklama Değer
allowedFqdnList Iot Hub'dan çıkış için izin verilen FQDN'lerin (Tam Etki Alanı Adı) listesi. string[]
authorizationPolicies IoT hub'ına bir bağlantının güvenliğini sağlamak için kullanabileceğiniz paylaşılan erişim ilkeleri. SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT hub buluttan cihaza mesajlaşma özellikleri. CloudToDeviceProperties
Yorum IoT hub açıklamaları. dizgi
disableDeviceSAS Doğruysa, tüm cihazlar (Edge cihazları dahil ancak modüller hariç) kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
disableLocalAuth Doğruysa, Iot hub'ı kapsamlı SAS anahtarları olan SAS belirteçleri kimlik doğrulaması için kullanılamaz. Bool
disableModuleSAS True ise, tüm modül kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
enableDataResidency True olarak ayarlandığında bu özellik, veri yerleşimini etkinleştirerek olağanüstü durum kurtarmayı devre dışı bırakır. Bool
enableFileUploadNotifications True ise, dosya yükleme bildirimleri etkinleştirilir. Bool
eventHubEndpoints Event Hub uyumlu uç nokta özellikleri. Bu sözlüğün tek olası anahtarları olaylardır. Bu anahtarın, IoT hub'ı için oluşturma veya güncelleştirme çağrıları yapılırken sözlükte mevcut olması gerekir. IotHubPropertiesEventHubEndpoints
Özellik IoT hub'ı için etkinleştirilen özellikler ve özellikler. 'DeviceManagement'
'Hiçbiri'
ipFilterRules IP filtresi kuralları. IpFilterRule[]
messagingEndpoints Dosya karşıya yükleme bildirim kuyruğu için mesajlaşma uç noktası özellikleri. IotHubPropertiesMessagingEndpoints
minTlsVersion Bu hub için destek için en düşük TLS sürümünü belirtir. 1.2'nin altındaki BIR TLS sürümünü kullanan istemcilerin reddedilmesi için "1.2" olarak ayarlanabilir. dizgi
networkRuleSets IotHub'ın Ağ Kuralı Kümesi Özellikleri NetworkRuleSetProperties
privateEndpointConnections Bu IotHub'da oluşturulan özel uç nokta bağlantıları PrivateEndpointConnection[]
publicNetworkAccess Genel Ağdan gelen isteklere izin verilip verilmeyeceği 'Devre Dışı'
'Etkin'
restrictOutboundNetworkAccess Doğruysa, IotHub'dan çıkış yalnızca allowedFqdnList aracılığıyla yapılandırılan izin verilen FQDN'lerle kısıtlanır. Bool
Yönlendirme IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Dosyaları karşıya yükleyebileceğiniz Azure Depolama uç noktalarının listesi. Şu anda yalnızca bir Azure Depolama hesabı yapılandırabilirsiniz ve bu hesabın anahtarı $default olmalıdır. Birden fazla depolama hesabı belirtilmesi hataya neden olur. enableFileUploadNotifications özelliği True olarak ayarlandığında bu özellik için bir değer belirtilmemesi bir hatanın alınmasına neden olur. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Ad Açıklama Değer

IotHubPropertiesMessagingEndpoints

Ad Açıklama Değer

IotHubPropertiesStorageEndpoints

Ad Açıklama Değer

IotHubSkuInfo

Ad Açıklama Değer
kapasite Sağlanan IoT Hub birimi sayısı. Bkz. /azure/azure-subscription-service-limits#iot-hub-limits. Int
ad SKU'nun adı. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (gerekli)

IpFilterRule

Ad Açıklama Değer
eylem Bu kural tarafından yakalanan istekler için istenen eylem. 'Kabul Et'
'Reddet' (gerekli)
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

ManagedIdentity

Ad Açıklama Değer
userAssignedIdentity Kullanıcı tarafından atanan kimlik. dizgi

MessagingEndpointProperties

Ad Açıklama Değer
lockDurationAsIso8601 Kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi
maxDeliveryCount IoT hub'ının ileti teslim etmeye çalışma sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi

Microsoft.Devices/IotHubs

Ad Açıklama Değer
etag Etag alanı gerekli değildir. Yanıt gövdesinde sağlanıyorsa, normal ETag kuralına göre üst bilgi olarak da sağlanmalıdır. dizgi
kimlik IotHub için yönetilen kimlikler. armidentity
yer Kaynak konumu. dize (gerekli)
ad Kaynak adı dize (gerekli)
Özellikler IotHub özellikleri IotHubProperties
Sku IotHub SKU bilgileri IotHubSkuInfo (gerekli)
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

NetworkRuleSetIpRule

Ad Açıklama Değer
eylem IP Filtresi Eylemi 'İzin Ver'
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

NetworkRuleSetProperties

Ad Açıklama Değer
applyToBuiltInEventHubEndpoint True ise Ağ Kuralı Kümesi, IotHub'ın BuiltIn EventHub EndPoint'ine de uygulanır bool (gerekli)
defaultAction Ağ Kuralı Kümesi için Varsayılan Eylem 'İzin Ver'
'Reddet'
ipRules IP Kuralları Listesi NetworkRuleSetIpRule[] (gerekli)

PrivateEndpoint

Ad Açıklama Değer

PrivateEndpointConnection

Ad Açıklama Değer
Özellikler Özel uç nokta bağlantısının özellikleri PrivateEndpointConnectionProperties (gerekli)

PrivateEndpointConnectionProperties

Ad Açıklama Değer
privateEndpoint Özel uç nokta bağlantısının özel uç nokta özelliği PrivateEndpoint
privateLinkServiceConnectionState Özel uç nokta bağlantısının geçerli durumu PrivateLinkServiceConnectionState (gerekli)

PrivateLinkServiceConnectionState

Ad Açıklama Değer
actionsRequired Özel uç nokta bağlantısı için gereken eylemler dizgi
Açıklama Özel uç nokta bağlantısının geçerli durumunun açıklaması dize (gerekli)
durum Özel uç nokta bağlantısının durumu 'Onaylandı'
'Bağlantısı Kesildi'
'Beklemede'
'Reddedildi' (gerekli)

ResourceTags

Ad Açıklama Değer

RouteProperties

Ad Açıklama Değer
koşul Yönlendirme kuralını uygulamak için değerlendirilen koşul. Koşul sağlanmazsa, varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca bir uç noktaya izin verilir. string[] (gerekli)
isEnabled Bir yolun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
kaynak DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak. 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

RoutingCosmosDBSqlApiProperties

Ad Açıklama Değer
authenticationType Cosmos DB sql kapsayıcı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
containerName Cosmos DB veritabanındaki cosmos DB sql kapsayıcısının adı. dize (gerekli)
databaseName Cosmos DB hesabındaki cosmos DB veritabanının adı. dize (gerekli)
endpointUri Cosmos DB hesabının URL'si. Protokol https:// içermelidir dize (gerekli)
kimlik Cosmos DB kapsayıcı uç noktasını yönlendirmenin yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
partitionKeyName Varsa, bu cosmos DB sql kapsayıcısıyla ilişkili bölüm anahtarının adı. Bu isteğe bağlı bir parametredir. dizgi
partitionKeyTemplate Bu cosmos DB sql kapsayıcısıyla kullanılmak üzere yapay bölüm anahtarı değeri oluşturmaya yönelik şablon. Şablon şu yer tutuculardan en az birini içermelidir: {iothub}, {deviceid}, {DD}, {MM}ve {YYYY}. Herhangi bir yer tutucu en fazla bir kez belirtilebilir, ancak sıra ve yer tutucu olmayan bileşenler rastgeledir. Bu parametre yalnızca PartitionKeyName belirtilirse gereklidir. dizgi
primaryKey Cosmos DB hesabının birincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
resourceGroup Cosmos DB hesabının kaynak grubunun adı. dizgi
secondaryKey Cosmos DB hesabının ikincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
subscriptionId Cosmos DB hesabının abonelik tanımlayıcısı. dizgi

RoutingEndpoints

Ad Açıklama Değer
cosmosDBSqlContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Cosmos DB kapsayıcı uç noktalarının listesi. RoutingCosmosDBSqlApiProperties[]
eventHubs IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Event Hubs uç noktalarının listesi. Bu liste, yerleşik Event Hubs uç noktasını içermez. RoutingEventHubProperties[]
serviceBusQueues IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Service Bus kuyruğu uç noktalarının listesi. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Service Bus konu uç noktalarının listesi. RoutingServiceBusTopicEndpointProperties[]
storageContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren depolama kapsayıcısı uç noktalarının listesi. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Ad Açıklama Değer
authenticationType Olay hub'ı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Olay hub'ı uç noktasının bağlantı dizesi. dizgi
endpointUri Olay hub'ı uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Olay hub'ı ad alanındaki olay hub'ı adı dizgi
Kimliği Olay hub'ı uç noktasının kimliği dizgi
kimlik Yönlendirme olay hub'ı uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Olay hub'ı uç noktasının kaynak grubunun adı. dizgi
subscriptionId Olay hub'ı uç noktasının abonelik tanımlayıcısı. dizgi

RoutingProperties

Ad Açıklama Değer
Bitiş noktası IoT hub'ınızın yönlendirme kurallarına göre iletileri yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir. RoutingEndpoints
zenginleştirmeler IoT hub'ının yerleşik ve özel uç noktalara teslim edilecek iletiler için geçerli olduğu, kullanıcı tarafından sağlanan zenginleştirmelerin listesi. Bkz. https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute 'routes' bölümünde belirtilen koşullardan hiçbiri karşılanmadığında geri dönüş yolu olarak kullanılan yolun özellikleri. Bu isteğe bağlı bir parametredir. Bu özellik şablonda olmadığında, geri dönüş yolu varsayılan olarak devre dışı bırakılır. FallbackRouteProperties
Yol IoT hub'ının iletileri yerleşik ve özel uç noktalara yönlendirmek için kullandığı kullanıcı tarafından sağlanan yönlendirme kurallarının listesi. Ücretli hub'lar için en fazla 100 yönlendirme kuralına ve ücretsiz hub'lar için en fazla 5 yönlendirme kuralına izin verilir. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus kuyruğu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus kuyruğu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus kuyruğu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus ad alanında kuyruk adı dizgi
Kimliği Service Bus kuyruğu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu kuyruğu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek kuyruk adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus kuyruğu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus kuyruğu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingServiceBusTopicEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus konu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus konu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus konu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus konusunda kuyruk adı dizgi
Kimliği Service Bus konu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu konu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek konu adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus konu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus konu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingStorageContainerProperties

Ad Açıklama Değer
authenticationType Depolama uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
batchFrequencyInSeconds Blobların depolama alanına yazıldığı zaman aralığı. Değer 60 ile 720 saniye arasında olmalıdır. Varsayılan değer 300 saniyedir. Int

Kısıtlama -ları:
En düşük değer = 60
Maksimum değer = 720
connectionString Depolama hesabının bağlantı dizesi. dizgi
containerName Depolama hesabındaki depolama kapsayıcısının adı. dize (gerekli)
Kodlama Bloblara iletileri seri hale getirmek için kullanılan kodlama. Desteklenen değerler :'avro', 'avrodeflate' ve 'JSON'. Varsayılan değer :'avro'. 'Avro'
'AvroDeflate'
'JSON'
endpointUri Depolama uç noktasının URL'si. Protokol https:// içermelidir dizgi
fileNameFormat Blob için dosya adı biçimi. Varsayılan biçim: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Tüm parametreler zorunlu olsa da yeniden sıralanabilir. dizgi
Kimliği Depolama kapsayıcısı uç noktasının kimliği dizgi
kimlik Yönlendirme depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
maxChunkSizeInBytes Depolama alanına yazılan her blob için en fazla bayt sayısı. Değer 10485760(10 MB) ile 524288000(500 MB) arasında olmalıdır. Varsayılan değer 314572800(300 MB) değeridir. Int

Kısıtlama -ları:
En düşük değer = 10485760
En yüksek değer = 524288000
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Depolama hesabının kaynak grubunun adı. dizgi
subscriptionId Depolama hesabının abonelik tanımlayıcısı. dizgi

SharedAccessSignatureAuthorizationRule

Ad Açıklama Değer
keyName Paylaşılan erişim ilkesinin adı. dize (gerekli)
primaryKey Birincil anahtar. dizgi
haklar Paylaşılan erişim ilkesine atanan izinler. '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' (gerekli)
secondaryKey İkincil anahtar. dizgi

StorageEndpointProperties

Ad Açıklama Değer
authenticationType Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. 'identityBased'
'keyBased'
connectionString Dosyaların karşıya yüklendiği Azure Depolama hesabının bağlantı dizesi. dize (gerekli)
containerName Dosyaları karşıya yüklediğiniz kök kapsayıcının adı. Kapsayıcının mevcut olması gerekmez, ancak belirtilen connectionString kullanılarak oluşturulabilir olmalıdır. dize (gerekli)
kimlik Dosya yükleme için depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
sasTtlAsIso8601 IoT Hub tarafından dosya yükleme için oluşturulan SAS URI'sinin geçerli olduğu süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. dizgi

Hızlı başlangıç örnekleri

Aşağıdaki hızlı başlangıç örnekleri bu kaynak türünü dağıtır.

Bicep Dosyası Açıklama
Buluta IoT Hub ve Cihaz Oluşturma tüketici grubu Bu şablon, bir IoT Hub örneğini buluttan buluta ve buluttan cihaza mesajlaşma yapılandırmalarını ve bir cihazı bulut tüketici grubuna dağıtmanızı sağlar.
IoT Hub Cihazı Sağlama Hizmeti oluşturma Bu şablon bir IoT hub'ı ve ioT Hub Cihazı Sağlama Hizmeti oluşturmanızı ve iki hizmeti birbirine bağlamanızı sağlar.
IoT Hub hesabı, örneği, IoT Hub için Cihaz Güncelleştirmesi Oluşturma Bu şablon bir hesap ve örneği bağlamak için bir örnek ve hub oluşturur. Hub'ı gerekli erişim ilkeleri, yollar ve tüketici grubuyla yapılandırıyor.
Azure IoT Hub dahil olmak üzere MedTech hizmetini dağıtma MedTech hizmeti, birden çok cihazdan cihaz verilerini almak, cihaz verilerini FHIR Gözlemleri'ne dönüştürmek ve daha sonra Azure Health Data Services FHIR hizmetinde kalıcı hale getirmek için tasarlanmış Azure Health Veri Hizmetlerinden biridir.
IoT Hub oluşturmak, iletileri yönlendirmek ve görüntülemek için ARM şablonunu kullanma IoT Hub ve depolama hesabı dağıtmak için bu şablonu kullanın. Depolama alanına yönlendirilen hub'a ileti göndermek için bir uygulama çalıştırın ve ardından sonuçları görüntüleyin.

ARM şablonu kaynak tanımı

IotHubs kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Devices/IotHubs kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Devices/IotHubs",
  "apiVersion": "2023-06-30",
  "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",
    "enableDataResidency": "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": {
        "cosmosDBSqlContainers": [
          {
            "authenticationType": "string",
            "containerName": "string",
            "databaseName": "string",
            "endpointUri": "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"
  }
}

Özellik değerleri

ArmIdentity

Ad Açıklama Değer
tür Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem örtük olarak oluşturulmuş bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır. 'Hiçbiri'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities <ArmUserIdentity> sözlüğü ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Ad Açıklama Değer

ArmUseridentity

Ad Açıklama Değer

CloudToDeviceProperties

Ad Açıklama Değer
defaultTtlAsIso8601 Cihaz kuyruğundaki buluttan cihaza iletiler için varsayılan yaşam süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
geri besleme Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri. FeedbackProperties
maxDeliveryCount Cihaz kuyruğundaki buluttan cihaza iletiler için en yüksek teslim sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100

EnrichmentProperties

Ad Açıklama Değer
endpointNames zenginleştirmenin iletiye uygulandığı uç noktaların listesi. string[] (gerekli)
anahtar Zenginleştirme özelliğinin anahtarı veya adı. dize (gerekli)
değer Zenginleştirme özelliğinin değeri. dize (gerekli)

EventHubProperties

Ad Açıklama Değer
partitionCount Event Hub ile uyumlu uç noktada cihazdan buluta iletileri almaya yönelik bölüm sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Cihazdan buluta iletilerin saklama süresi (gün olarak). Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Ad Açıklama Değer
koşul Geri dönüş yolunu uygulamak için değerlendirilen koşul. Koşul sağlanmazsa varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca 1 uç noktaya izin verilir. string[] (gerekli)
isEnabled Geri dönüş yolunun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi
kaynak Yönlendirme kuralının uygulanacağı kaynak. Örneğin, DeviceMessages 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

FeedbackProperties

Ad Açıklama Değer
lockDurationAsIso8601 Geri bildirim kuyruğunun kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
maxDeliveryCount IoT hub'ının geri bildirim kuyruğunda ileti göndermeyi deneme sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi

IotHubProperties

Ad Açıklama Değer
allowedFqdnList Iot Hub'dan çıkış için izin verilen FQDN'lerin (Tam Etki Alanı Adı) listesi. string[]
authorizationPolicies IoT hub'ına bir bağlantının güvenliğini sağlamak için kullanabileceğiniz paylaşılan erişim ilkeleri. SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT hub buluttan cihaza mesajlaşma özellikleri. CloudToDeviceProperties
Yorum IoT hub açıklamaları. dizgi
disableDeviceSAS Doğruysa, tüm cihazlar (Edge cihazları dahil ancak modüller hariç) kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
disableLocalAuth Doğruysa, Iot hub'ı kapsamlı SAS anahtarları olan SAS belirteçleri kimlik doğrulaması için kullanılamaz. Bool
disableModuleSAS True ise, tüm modül kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
enableDataResidency True olarak ayarlandığında bu özellik, veri yerleşimini etkinleştirerek olağanüstü durum kurtarmayı devre dışı bırakır. Bool
enableFileUploadNotifications True ise, dosya yükleme bildirimleri etkinleştirilir. Bool
eventHubEndpoints Event Hub uyumlu uç nokta özellikleri. Bu sözlüğün tek olası anahtarları olaylardır. Bu anahtarın, IoT hub'ı için oluşturma veya güncelleştirme çağrıları yapılırken sözlükte mevcut olması gerekir. IotHubPropertiesEventHubEndpoints
Özellik IoT hub'ı için etkinleştirilen özellikler ve özellikler. 'DeviceManagement'
'Hiçbiri'
ipFilterRules IP filtresi kuralları. IpFilterRule[]
messagingEndpoints Dosya karşıya yükleme bildirim kuyruğu için mesajlaşma uç noktası özellikleri. IotHubPropertiesMessagingEndpoints
minTlsVersion Bu hub için destek için en düşük TLS sürümünü belirtir. 1.2'nin altındaki BIR TLS sürümünü kullanan istemcilerin reddedilmesi için "1.2" olarak ayarlanabilir. dizgi
networkRuleSets IotHub'ın Ağ Kuralı Kümesi Özellikleri NetworkRuleSetProperties
privateEndpointConnections Bu IotHub'da oluşturulan özel uç nokta bağlantıları PrivateEndpointConnection[]
publicNetworkAccess Genel Ağdan gelen isteklere izin verilip verilmeyeceği 'Devre Dışı'
'Etkin'
restrictOutboundNetworkAccess Doğruysa, IotHub'dan çıkış yalnızca allowedFqdnList aracılığıyla yapılandırılan izin verilen FQDN'lerle kısıtlanır. Bool
Yönlendirme IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Dosyaları karşıya yükleyebileceğiniz Azure Depolama uç noktalarının listesi. Şu anda yalnızca bir Azure Depolama hesabı yapılandırabilirsiniz ve bu hesabın anahtarı $default olmalıdır. Birden fazla depolama hesabı belirtilmesi hataya neden olur. enableFileUploadNotifications özelliği True olarak ayarlandığında bu özellik için bir değer belirtilmemesi bir hatanın alınmasına neden olur. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Ad Açıklama Değer

IotHubPropertiesMessagingEndpoints

Ad Açıklama Değer

IotHubPropertiesStorageEndpoints

Ad Açıklama Değer

IotHubSkuInfo

Ad Açıklama Değer
kapasite Sağlanan IoT Hub birimi sayısı. Bkz. /azure/azure-subscription-service-limits#iot-hub-limits. Int
ad SKU'nun adı. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (gerekli)

IpFilterRule

Ad Açıklama Değer
eylem Bu kural tarafından yakalanan istekler için istenen eylem. 'Kabul Et'
'Reddet' (gerekli)
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

ManagedIdentity

Ad Açıklama Değer
userAssignedIdentity Kullanıcı tarafından atanan kimlik. dizgi

MessagingEndpointProperties

Ad Açıklama Değer
lockDurationAsIso8601 Kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi
maxDeliveryCount IoT hub'ının ileti teslim etmeye çalışma sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi

Microsoft.Devices/IotHubs

Ad Açıklama Değer
apiVersion API sürümü '2023-06-30'
etag Etag alanı gerekli değildir. Yanıt gövdesinde sağlanıyorsa, normal ETag kuralına göre üst bilgi olarak da sağlanmalıdır. dizgi
kimlik IotHub için yönetilen kimlikler. armidentity
yer Kaynak konumu. dize (gerekli)
ad Kaynak adı dize (gerekli)
Özellikler IotHub özellikleri IotHubProperties
Sku IotHub SKU bilgileri IotHubSkuInfo (gerekli)
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
tür Kaynak türü 'Microsoft.Devices/IotHubs'

NetworkRuleSetIpRule

Ad Açıklama Değer
eylem IP Filtresi Eylemi 'İzin Ver'
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

NetworkRuleSetProperties

Ad Açıklama Değer
applyToBuiltInEventHubEndpoint True ise Ağ Kuralı Kümesi, IotHub'ın BuiltIn EventHub EndPoint'ine de uygulanır bool (gerekli)
defaultAction Ağ Kuralı Kümesi için Varsayılan Eylem 'İzin Ver'
'Reddet'
ipRules IP Kuralları Listesi NetworkRuleSetIpRule[] (gerekli)

PrivateEndpoint

Ad Açıklama Değer

PrivateEndpointConnection

Ad Açıklama Değer
Özellikler Özel uç nokta bağlantısının özellikleri PrivateEndpointConnectionProperties (gerekli)

PrivateEndpointConnectionProperties

Ad Açıklama Değer
privateEndpoint Özel uç nokta bağlantısının özel uç nokta özelliği PrivateEndpoint
privateLinkServiceConnectionState Özel uç nokta bağlantısının geçerli durumu PrivateLinkServiceConnectionState (gerekli)

PrivateLinkServiceConnectionState

Ad Açıklama Değer
actionsRequired Özel uç nokta bağlantısı için gereken eylemler dizgi
Açıklama Özel uç nokta bağlantısının geçerli durumunun açıklaması dize (gerekli)
durum Özel uç nokta bağlantısının durumu 'Onaylandı'
'Bağlantısı Kesildi'
'Beklemede'
'Reddedildi' (gerekli)

ResourceTags

Ad Açıklama Değer

RouteProperties

Ad Açıklama Değer
koşul Yönlendirme kuralını uygulamak için değerlendirilen koşul. Koşul sağlanmazsa, varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca bir uç noktaya izin verilir. string[] (gerekli)
isEnabled Bir yolun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
kaynak DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak. 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

RoutingCosmosDBSqlApiProperties

Ad Açıklama Değer
authenticationType Cosmos DB sql kapsayıcı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
containerName Cosmos DB veritabanındaki cosmos DB sql kapsayıcısının adı. dize (gerekli)
databaseName Cosmos DB hesabındaki cosmos DB veritabanının adı. dize (gerekli)
endpointUri Cosmos DB hesabının URL'si. Protokol https:// içermelidir dize (gerekli)
kimlik Cosmos DB kapsayıcı uç noktasını yönlendirmenin yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
partitionKeyName Varsa, bu cosmos DB sql kapsayıcısıyla ilişkili bölüm anahtarının adı. Bu isteğe bağlı bir parametredir. dizgi
partitionKeyTemplate Bu cosmos DB sql kapsayıcısıyla kullanılmak üzere yapay bölüm anahtarı değeri oluşturmaya yönelik şablon. Şablon şu yer tutuculardan en az birini içermelidir: {iothub}, {deviceid}, {DD}, {MM}ve {YYYY}. Herhangi bir yer tutucu en fazla bir kez belirtilebilir, ancak sıra ve yer tutucu olmayan bileşenler rastgeledir. Bu parametre yalnızca PartitionKeyName belirtilirse gereklidir. dizgi
primaryKey Cosmos DB hesabının birincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
resourceGroup Cosmos DB hesabının kaynak grubunun adı. dizgi
secondaryKey Cosmos DB hesabının ikincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
subscriptionId Cosmos DB hesabının abonelik tanımlayıcısı. dizgi

RoutingEndpoints

Ad Açıklama Değer
cosmosDBSqlContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Cosmos DB kapsayıcı uç noktalarının listesi. RoutingCosmosDBSqlApiProperties[]
eventHubs IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Event Hubs uç noktalarının listesi. Bu liste, yerleşik Event Hubs uç noktasını içermez. RoutingEventHubProperties[]
serviceBusQueues IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Service Bus kuyruğu uç noktalarının listesi. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Service Bus konu uç noktalarının listesi. RoutingServiceBusTopicEndpointProperties[]
storageContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren depolama kapsayıcısı uç noktalarının listesi. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Ad Açıklama Değer
authenticationType Olay hub'ı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Olay hub'ı uç noktasının bağlantı dizesi. dizgi
endpointUri Olay hub'ı uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Olay hub'ı ad alanındaki olay hub'ı adı dizgi
Kimliği Olay hub'ı uç noktasının kimliği dizgi
kimlik Yönlendirme olay hub'ı uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Olay hub'ı uç noktasının kaynak grubunun adı. dizgi
subscriptionId Olay hub'ı uç noktasının abonelik tanımlayıcısı. dizgi

RoutingProperties

Ad Açıklama Değer
Bitiş noktası IoT hub'ınızın yönlendirme kurallarına göre iletileri yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir. RoutingEndpoints
zenginleştirmeler IoT hub'ının yerleşik ve özel uç noktalara teslim edilecek iletiler için geçerli olduğu, kullanıcı tarafından sağlanan zenginleştirmelerin listesi. Bkz. https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute 'routes' bölümünde belirtilen koşullardan hiçbiri karşılanmadığında geri dönüş yolu olarak kullanılan yolun özellikleri. Bu isteğe bağlı bir parametredir. Bu özellik şablonda olmadığında, geri dönüş yolu varsayılan olarak devre dışı bırakılır. FallbackRouteProperties
Yol IoT hub'ının iletileri yerleşik ve özel uç noktalara yönlendirmek için kullandığı kullanıcı tarafından sağlanan yönlendirme kurallarının listesi. Ücretli hub'lar için en fazla 100 yönlendirme kuralına ve ücretsiz hub'lar için en fazla 5 yönlendirme kuralına izin verilir. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus kuyruğu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus kuyruğu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus kuyruğu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus ad alanında kuyruk adı dizgi
Kimliği Service Bus kuyruğu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu kuyruğu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek kuyruk adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus kuyruğu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus kuyruğu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingServiceBusTopicEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus konu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus konu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus konu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus konusunda kuyruk adı dizgi
Kimliği Service Bus konu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu konu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek konu adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus konu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus konu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingStorageContainerProperties

Ad Açıklama Değer
authenticationType Depolama uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
batchFrequencyInSeconds Blobların depolama alanına yazıldığı zaman aralığı. Değer 60 ile 720 saniye arasında olmalıdır. Varsayılan değer 300 saniyedir. Int

Kısıtlama -ları:
En düşük değer = 60
Maksimum değer = 720
connectionString Depolama hesabının bağlantı dizesi. dizgi
containerName Depolama hesabındaki depolama kapsayıcısının adı. dize (gerekli)
Kodlama Bloblara iletileri seri hale getirmek için kullanılan kodlama. Desteklenen değerler :'avro', 'avrodeflate' ve 'JSON'. Varsayılan değer :'avro'. 'Avro'
'AvroDeflate'
'JSON'
endpointUri Depolama uç noktasının URL'si. Protokol https:// içermelidir dizgi
fileNameFormat Blob için dosya adı biçimi. Varsayılan biçim: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Tüm parametreler zorunlu olsa da yeniden sıralanabilir. dizgi
Kimliği Depolama kapsayıcısı uç noktasının kimliği dizgi
kimlik Yönlendirme depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
maxChunkSizeInBytes Depolama alanına yazılan her blob için en fazla bayt sayısı. Değer 10485760(10 MB) ile 524288000(500 MB) arasında olmalıdır. Varsayılan değer 314572800(300 MB) değeridir. Int

Kısıtlama -ları:
En düşük değer = 10485760
En yüksek değer = 524288000
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Depolama hesabının kaynak grubunun adı. dizgi
subscriptionId Depolama hesabının abonelik tanımlayıcısı. dizgi

SharedAccessSignatureAuthorizationRule

Ad Açıklama Değer
keyName Paylaşılan erişim ilkesinin adı. dize (gerekli)
primaryKey Birincil anahtar. dizgi
haklar Paylaşılan erişim ilkesine atanan izinler. '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' (gerekli)
secondaryKey İkincil anahtar. dizgi

StorageEndpointProperties

Ad Açıklama Değer
authenticationType Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. 'identityBased'
'keyBased'
connectionString Dosyaların karşıya yüklendiği Azure Depolama hesabının bağlantı dizesi. dize (gerekli)
containerName Dosyaları karşıya yüklediğiniz kök kapsayıcının adı. Kapsayıcının mevcut olması gerekmez, ancak belirtilen connectionString kullanılarak oluşturulabilir olmalıdır. dize (gerekli)
kimlik Dosya yükleme için depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
sasTtlAsIso8601 IoT Hub tarafından dosya yükleme için oluşturulan SAS URI'sinin geçerli olduğu süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. dizgi

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon Açıklama
IoT Hub ile Kullandıkça Öde (PAYG) Ortamı Oluşturma

Azure 'a dağıtma
Bu şablon, IoT Hub'dan gelen olayları kullanacak şekilde yapılandırılmış kullandıkça öde (PAYG) Time Series Insights ortamı dağıtmanızı sağlar.
Buluta IoT Hub ve Cihaz Oluşturma tüketici grubu

Azure 'a dağıtma
Bu şablon, bir IoT Hub örneğini buluttan buluta ve buluttan cihaza mesajlaşma yapılandırmalarını ve bir cihazı bulut tüketici grubuna dağıtmanızı sağlar.
IOT Hub ve Ubuntu edge simülatörü oluşturma

Azure 'a dağıtma
Bu şablon bir IOT Hub'ı ve Sanal Makine Ubuntu edge simülatörü oluşturur.
IoT Hub Cihazı Sağlama Hizmeti oluşturma

Azure 'a dağıtma
Bu şablon bir IoT hub'ı ve ioT Hub Cihazı Sağlama Hizmeti oluşturmanızı ve iki hizmeti birbirine bağlamanızı sağlar.
IoT Hub hesabı, örneği, IoT Hub için Cihaz Güncelleştirmesi Oluşturma

Azure 'a dağıtma
Bu şablon bir hesap ve örneği bağlamak için bir örnek ve hub oluşturur. Hub'ı gerekli erişim ilkeleri, yollar ve tüketici grubuyla yapılandırıyor.
Azure IoT Hub dahil olmak üzere MedTech hizmetini dağıtma

Azure 'a dağıtma
MedTech hizmeti, birden çok cihazdan cihaz verilerini almak, cihaz verilerini FHIR Gözlemleri'ne dönüştürmek ve daha sonra Azure Health Data Services FHIR hizmetinde kalıcı hale getirmek için tasarlanmış Azure Health Veri Hizmetlerinden biridir.
IoT Hub oluşturmak, iletileri yönlendirmek ve görüntülemek için ARM şablonunu kullanma

Azure 'a dağıtma
IoT Hub ve depolama hesabı dağıtmak için bu şablonu kullanın. Depolama alanına yönlendirilen hub'a ileti göndermek için bir uygulama çalıştırın ve ardından sonuçları görüntüleyin.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

IotHubs kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Devices/IotHubs kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/IotHubs@2023-06-30"
  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
      enableDataResidency = 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 = {
          cosmosDBSqlContainers = [
            {
              authenticationType = "string"
              containerName = "string"
              databaseName = "string"
              endpointUri = "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"
  }
}

Özellik değerleri

ArmIdentity

Ad Açıklama Değer
tür Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem örtük olarak oluşturulmuş bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır. 'Hiçbiri'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities <ArmUserIdentity> sözlüğü ArmIdentityUserAssignedIdentities

ArmIdentityUserAssignedIdentities

Ad Açıklama Değer

ArmUseridentity

Ad Açıklama Değer

CloudToDeviceProperties

Ad Açıklama Değer
defaultTtlAsIso8601 Cihaz kuyruğundaki buluttan cihaza iletiler için varsayılan yaşam süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
geri besleme Buluttan cihaza iletiler için geri bildirim kuyruğunun özellikleri. FeedbackProperties
maxDeliveryCount Cihaz kuyruğundaki buluttan cihaza iletiler için en yüksek teslim sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100

EnrichmentProperties

Ad Açıklama Değer
endpointNames zenginleştirmenin iletiye uygulandığı uç noktaların listesi. string[] (gerekli)
anahtar Zenginleştirme özelliğinin anahtarı veya adı. dize (gerekli)
değer Zenginleştirme özelliğinin değeri. dize (gerekli)

EventHubProperties

Ad Açıklama Değer
partitionCount Event Hub ile uyumlu uç noktada cihazdan buluta iletileri almaya yönelik bölüm sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. Int
retentionTimeInDays Cihazdan buluta iletilerin saklama süresi (gün olarak). Bkz. /azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages Int

FallbackRouteProperties

Ad Açıklama Değer
koşul Geri dönüş yolunu uygulamak için değerlendirilen koşul. Koşul sağlanmazsa varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca 1 uç noktaya izin verilir. string[] (gerekli)
isEnabled Geri dönüş yolunun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi
kaynak Yönlendirme kuralının uygulanacağı kaynak. Örneğin, DeviceMessages 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

FeedbackProperties

Ad Açıklama Değer
lockDurationAsIso8601 Geri bildirim kuyruğunun kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi
maxDeliveryCount IoT hub'ının geri bildirim kuyruğunda ileti göndermeyi deneme sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. dizgi

IotHubProperties

Ad Açıklama Değer
allowedFqdnList Iot Hub'dan çıkış için izin verilen FQDN'lerin (Tam Etki Alanı Adı) listesi. string[]
authorizationPolicies IoT hub'ına bir bağlantının güvenliğini sağlamak için kullanabileceğiniz paylaşılan erişim ilkeleri. SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT hub buluttan cihaza mesajlaşma özellikleri. CloudToDeviceProperties
Yorum IoT hub açıklamaları. dizgi
disableDeviceSAS Doğruysa, tüm cihazlar (Edge cihazları dahil ancak modüller hariç) kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
disableLocalAuth Doğruysa, Iot hub'ı kapsamlı SAS anahtarları olan SAS belirteçleri kimlik doğrulaması için kullanılamaz. Bool
disableModuleSAS True ise, tüm modül kapsamlı SAS anahtarları kimlik doğrulaması için kullanılamaz. Bool
enableDataResidency True olarak ayarlandığında bu özellik, veri yerleşimini etkinleştirerek olağanüstü durum kurtarmayı devre dışı bırakır. Bool
enableFileUploadNotifications True ise, dosya yükleme bildirimleri etkinleştirilir. Bool
eventHubEndpoints Event Hub uyumlu uç nokta özellikleri. Bu sözlüğün tek olası anahtarları olaylardır. Bu anahtarın, IoT hub'ı için oluşturma veya güncelleştirme çağrıları yapılırken sözlükte mevcut olması gerekir. IotHubPropertiesEventHubEndpoints
Özellik IoT hub'ı için etkinleştirilen özellikler ve özellikler. 'DeviceManagement'
'Hiçbiri'
ipFilterRules IP filtresi kuralları. IpFilterRule[]
messagingEndpoints Dosya karşıya yükleme bildirim kuyruğu için mesajlaşma uç noktası özellikleri. IotHubPropertiesMessagingEndpoints
minTlsVersion Bu hub için destek için en düşük TLS sürümünü belirtir. 1.2'nin altındaki BIR TLS sürümünü kullanan istemcilerin reddedilmesi için "1.2" olarak ayarlanabilir. dizgi
networkRuleSets IotHub'ın Ağ Kuralı Kümesi Özellikleri NetworkRuleSetProperties
privateEndpointConnections Bu IotHub'da oluşturulan özel uç nokta bağlantıları PrivateEndpointConnection[]
publicNetworkAccess Genel Ağdan gelen isteklere izin verilip verilmeyeceği 'Devre Dışı'
'Etkin'
restrictOutboundNetworkAccess Doğruysa, IotHub'dan çıkış yalnızca allowedFqdnList aracılığıyla yapılandırılan izin verilen FQDN'lerle kısıtlanır. Bool
Yönlendirme IoT hub'ının yönlendirmeyle ilgili özellikleri. Bkz. /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints Dosyaları karşıya yükleyebileceğiniz Azure Depolama uç noktalarının listesi. Şu anda yalnızca bir Azure Depolama hesabı yapılandırabilirsiniz ve bu hesabın anahtarı $default olmalıdır. Birden fazla depolama hesabı belirtilmesi hataya neden olur. enableFileUploadNotifications özelliği True olarak ayarlandığında bu özellik için bir değer belirtilmemesi bir hatanın alınmasına neden olur. IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

Ad Açıklama Değer

IotHubPropertiesMessagingEndpoints

Ad Açıklama Değer

IotHubPropertiesStorageEndpoints

Ad Açıklama Değer

IotHubSkuInfo

Ad Açıklama Değer
kapasite Sağlanan IoT Hub birimi sayısı. Bkz. /azure/azure-subscription-service-limits#iot-hub-limits. Int
ad SKU'nun adı. 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (gerekli)

IpFilterRule

Ad Açıklama Değer
eylem Bu kural tarafından yakalanan istekler için istenen eylem. 'Kabul Et'
'Reddet' (gerekli)
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

ManagedIdentity

Ad Açıklama Değer
userAssignedIdentity Kullanıcı tarafından atanan kimlik. dizgi

MessagingEndpointProperties

Ad Açıklama Değer
lockDurationAsIso8601 Kilit süresi. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi
maxDeliveryCount IoT hub'ının ileti teslim etmeye çalışma sayısı. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 100
ttlAsIso8601 IoT hub'ı tarafından süresi dolmadan önce iletinin kullanılabilmesi için gereken süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload. dizgi

Microsoft.Devices/IotHubs

Ad Açıklama Değer
etag Etag alanı gerekli değildir. Yanıt gövdesinde sağlanıyorsa, normal ETag kuralına göre üst bilgi olarak da sağlanmalıdır. dizgi
kimlik IotHub için yönetilen kimlikler. armidentity
yer Kaynak konumu. dize (gerekli)
ad Kaynak adı dize (gerekli)
Özellikler IotHub özellikleri IotHubProperties
Sku IotHub SKU bilgileri IotHubSkuInfo (gerekli)
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
tür Kaynak türü "Microsoft.Devices/IotHubs@2023-06-30"

NetworkRuleSetIpRule

Ad Açıklama Değer
eylem IP Filtresi Eylemi 'İzin Ver'
filterName IP filtresi kuralının adı. dize (gerekli)
ipMask Kural için CIDR gösteriminde IP adresi aralığını içeren bir dize. dize (gerekli)

NetworkRuleSetProperties

Ad Açıklama Değer
applyToBuiltInEventHubEndpoint True ise Ağ Kuralı Kümesi, IotHub'ın BuiltIn EventHub EndPoint'ine de uygulanır bool (gerekli)
defaultAction Ağ Kuralı Kümesi için Varsayılan Eylem 'İzin Ver'
'Reddet'
ipRules IP Kuralları Listesi NetworkRuleSetIpRule[] (gerekli)

PrivateEndpoint

Ad Açıklama Değer

PrivateEndpointConnection

Ad Açıklama Değer
Özellikler Özel uç nokta bağlantısının özellikleri PrivateEndpointConnectionProperties (gerekli)

PrivateEndpointConnectionProperties

Ad Açıklama Değer
privateEndpoint Özel uç nokta bağlantısının özel uç nokta özelliği PrivateEndpoint
privateLinkServiceConnectionState Özel uç nokta bağlantısının geçerli durumu PrivateLinkServiceConnectionState (gerekli)

PrivateLinkServiceConnectionState

Ad Açıklama Değer
actionsRequired Özel uç nokta bağlantısı için gereken eylemler dizgi
Açıklama Özel uç nokta bağlantısının geçerli durumunun açıklaması dize (gerekli)
durum Özel uç nokta bağlantısının durumu 'Onaylandı'
'Bağlantısı Kesildi'
'Beklemede'
'Reddedildi' (gerekli)

ResourceTags

Ad Açıklama Değer

RouteProperties

Ad Açıklama Değer
koşul Yönlendirme kuralını uygulamak için değerlendirilen koşul. Koşul sağlanmazsa, varsayılan olarak true olarak değerlendirilir. Dil bilgisi için bkz. /azure/iot-hub/iot-hub-devguide-query-language dizgi
endpointNames Koşulu karşılayan iletilerin yönlendirildiği uç noktaların listesi. Şu anda yalnızca bir uç noktaya izin verilir. string[] (gerekli)
isEnabled Bir yolun etkinleştirilip etkinleştirilmediğini belirtmek için kullanılır. bool (gerekli)
ad Yolun adı. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir, en fazla 64 karakter uzunluğundadır ve benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
kaynak DeviceMessages gibi yönlendirme kuralının uygulanacağı kaynak. 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Geçersiz'
'TwinChangeEvents' (gerekli)

RoutingCosmosDBSqlApiProperties

Ad Açıklama Değer
authenticationType Cosmos DB sql kapsayıcı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
containerName Cosmos DB veritabanındaki cosmos DB sql kapsayıcısının adı. dize (gerekli)
databaseName Cosmos DB hesabındaki cosmos DB veritabanının adı. dize (gerekli)
endpointUri Cosmos DB hesabının URL'si. Protokol https:// içermelidir dize (gerekli)
kimlik Cosmos DB kapsayıcı uç noktasını yönlendirmenin yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
partitionKeyName Varsa, bu cosmos DB sql kapsayıcısıyla ilişkili bölüm anahtarının adı. Bu isteğe bağlı bir parametredir. dizgi
partitionKeyTemplate Bu cosmos DB sql kapsayıcısıyla kullanılmak üzere yapay bölüm anahtarı değeri oluşturmaya yönelik şablon. Şablon şu yer tutuculardan en az birini içermelidir: {iothub}, {deviceid}, {DD}, {MM}ve {YYYY}. Herhangi bir yer tutucu en fazla bir kez belirtilebilir, ancak sıra ve yer tutucu olmayan bileşenler rastgeledir. Bu parametre yalnızca PartitionKeyName belirtilirse gereklidir. dizgi
primaryKey Cosmos DB hesabının birincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
resourceGroup Cosmos DB hesabının kaynak grubunun adı. dizgi
secondaryKey Cosmos DB hesabının ikincil anahtarı. dizgi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
subscriptionId Cosmos DB hesabının abonelik tanımlayıcısı. dizgi

RoutingEndpoints

Ad Açıklama Değer
cosmosDBSqlContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Cosmos DB kapsayıcı uç noktalarının listesi. RoutingCosmosDBSqlApiProperties[]
eventHubs IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Event Hubs uç noktalarının listesi. Bu liste, yerleşik Event Hubs uç noktasını içermez. RoutingEventHubProperties[]
serviceBusQueues IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren Service Bus kuyruğu uç noktalarının listesi. RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics IoT hub'ının yönlendirme kurallarına göre iletileri yönlendirdığı Service Bus konu uç noktalarının listesi. RoutingServiceBusTopicEndpointProperties[]
storageContainers IoT hub'ının yönlendirme kurallarına göre iletileri yönlendiren depolama kapsayıcısı uç noktalarının listesi. RoutingStorageContainerProperties[]

RoutingEventHubProperties

Ad Açıklama Değer
authenticationType Olay hub'ı uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Olay hub'ı uç noktasının bağlantı dizesi. dizgi
endpointUri Olay hub'ı uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Olay hub'ı ad alanındaki olay hub'ı adı dizgi
Kimliği Olay hub'ı uç noktasının kimliği dizgi
kimlik Yönlendirme olay hub'ı uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Olay hub'ı uç noktasının kaynak grubunun adı. dizgi
subscriptionId Olay hub'ı uç noktasının abonelik tanımlayıcısı. dizgi

RoutingProperties

Ad Açıklama Değer
Bitiş noktası IoT hub'ınızın yönlendirme kurallarına göre iletileri yönlendirdiği özel uç noktalarla ilgili özellikler. Ücretli hub'lar için tüm uç nokta türlerinde en fazla 10 özel uç noktaya izin verilir ve ücretsiz hub'lar için tüm uç nokta türlerinde yalnızca 1 özel uç noktaya izin verilir. RoutingEndpoints
zenginleştirmeler IoT hub'ının yerleşik ve özel uç noktalara teslim edilecek iletiler için geçerli olduğu, kullanıcı tarafından sağlanan zenginleştirmelerin listesi. Bkz. https://aka.ms/telemetryoneventgrid EnrichmentProperties[]
fallbackRoute 'routes' bölümünde belirtilen koşullardan hiçbiri karşılanmadığında geri dönüş yolu olarak kullanılan yolun özellikleri. Bu isteğe bağlı bir parametredir. Bu özellik şablonda olmadığında, geri dönüş yolu varsayılan olarak devre dışı bırakılır. FallbackRouteProperties
Yol IoT hub'ının iletileri yerleşik ve özel uç noktalara yönlendirmek için kullandığı kullanıcı tarafından sağlanan yönlendirme kurallarının listesi. Ücretli hub'lar için en fazla 100 yönlendirme kuralına ve ücretsiz hub'lar için en fazla 5 yönlendirme kuralına izin verilir. RouteProperties[]

RoutingServiceBusQueueEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus kuyruğu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus kuyruğu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus kuyruğu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus ad alanında kuyruk adı dizgi
Kimliği Service Bus kuyruğu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu kuyruğu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek kuyruk adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus kuyruğu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus kuyruğu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingServiceBusTopicEndpointProperties

Ad Açıklama Değer
authenticationType Service Bus konu uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
connectionString Service Bus konu uç noktasının bağlantı dizesi. dizgi
endpointUri Service Bus konu uç noktasının URL'si. Protokol sb:// içermelidir dizgi
entityPath Service Bus konusunda kuyruk adı dizgi
Kimliği Service Bus konu uç noktasının kimliği dizgi
kimlik Yönlendirme hizmeti veri yolu konu uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. Adın gerçek konu adıyla aynı olması gerekmez. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Service Bus konu uç noktasının kaynak grubunun adı. dizgi
subscriptionId Service Bus konu uç noktasının abonelik tanımlayıcısı. dizgi

RoutingStorageContainerProperties

Ad Açıklama Değer
authenticationType Depolama uç noktasında kimlik doğrulaması yapmak için kullanılan yöntem 'identityBased'
'keyBased'
batchFrequencyInSeconds Blobların depolama alanına yazıldığı zaman aralığı. Değer 60 ile 720 saniye arasında olmalıdır. Varsayılan değer 300 saniyedir. Int

Kısıtlama -ları:
En düşük değer = 60
Maksimum değer = 720
connectionString Depolama hesabının bağlantı dizesi. dizgi
containerName Depolama hesabındaki depolama kapsayıcısının adı. dize (gerekli)
Kodlama Bloblara iletileri seri hale getirmek için kullanılan kodlama. Desteklenen değerler :'avro', 'avrodeflate' ve 'JSON'. Varsayılan değer :'avro'. 'Avro'
'AvroDeflate'
'JSON'
endpointUri Depolama uç noktasının URL'si. Protokol https:// içermelidir dizgi
fileNameFormat Blob için dosya adı biçimi. Varsayılan biçim: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}. Tüm parametreler zorunlu olsa da yeniden sıralanabilir. dizgi
Kimliği Depolama kapsayıcısı uç noktasının kimliği dizgi
kimlik Yönlendirme depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
maxChunkSizeInBytes Depolama alanına yazılan her blob için en fazla bayt sayısı. Değer 10485760(10 MB) ile 524288000(500 MB) arasında olmalıdır. Varsayılan değer 314572800(300 MB) değeridir. Int

Kısıtlama -ları:
En düşük değer = 10485760
En yüksek değer = 524288000
ad Bu uç noktayı tanımlayan ad. Ad yalnızca alfasayısal karakterler, nokta, alt çizgi, kısa çizgi içerebilir ve en fazla 64 karakter uzunluğunda olabilir. Aşağıdaki adlar ayrılmıştır: olaylar, fileNotifications, $default. Uç nokta adları, uç nokta türleri arasında benzersiz olmalıdır. dizgi

Kısıtlama -ları:
Desen = ^[A-Za-z0-9-._]{1,64}$ (gerekli)
resourceGroup Depolama hesabının kaynak grubunun adı. dizgi
subscriptionId Depolama hesabının abonelik tanımlayıcısı. dizgi

SharedAccessSignatureAuthorizationRule

Ad Açıklama Değer
keyName Paylaşılan erişim ilkesinin adı. dize (gerekli)
primaryKey Birincil anahtar. dizgi
haklar Paylaşılan erişim ilkesine atanan izinler. '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' (gerekli)
secondaryKey İkincil anahtar. dizgi

StorageEndpointProperties

Ad Açıklama Değer
authenticationType Depolama hesabına bağlanmak için kullanılan kimlik doğrulama türünü belirtir. 'identityBased'
'keyBased'
connectionString Dosyaların karşıya yüklendiği Azure Depolama hesabının bağlantı dizesi. dize (gerekli)
containerName Dosyaları karşıya yüklediğiniz kök kapsayıcının adı. Kapsayıcının mevcut olması gerekmez, ancak belirtilen connectionString kullanılarak oluşturulabilir olmalıdır. dize (gerekli)
kimlik Dosya yükleme için depolama uç noktasının yönetilen kimlik özellikleri. ManagedIdentity
sasTtlAsIso8601 IoT Hub tarafından dosya yükleme için oluşturulan SAS URI'sinin geçerli olduğu süre. Bkz. /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. dizgi