次の方法で共有


Microsoft.Devices IotHubs

Bicep リソース定義

IotHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Devices/IotHubs リソースを作成するには、次の Bicep をテンプレートに追加します。

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'
  }
}

プロパティ値

ArmIdentity

名前 形容 価値
種類 リソースに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 '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

EnrichmentProperties

名前 形容 価値
endpointNames エンリッチメントがメッセージに適用されるエンドポイントの一覧。 string[] (必須)
エンリッチメント プロパティのキーまたは名前。 string (必須)
価値 エンリッチメント プロパティの値。 string (必須)

EventHubProperties

名前 形容 価値
partitionCount Event Hub と互換性のあるエンドポイントでデバイスからクラウドへのメッセージを受信するためのパーティションの数。 /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'
'Invalid'
'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 Hub からのエグレスで許可される FQDN (完全修飾ドメイン名) の一覧。 string[]
authorizationPolicies IoT ハブへの接続をセキュリティで保護するために使用できる共有アクセス ポリシー。 SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT Hub のクラウドからデバイスへのメッセージング プロパティ。 CloudToDeviceProperties
コメント IoT Hub のコメント。
disableDeviceSAS true の場合、すべてのデバイス (Edge デバイスを含むがモジュールを除く) スコープ SAS キーは認証に使用できません。 bool
disableLocalAuth true の場合、IoT ハブ スコープの SAS キーを持つ SAS トークンは認証に使用できません。 bool
disableModuleSAS true の場合、すべてのモジュール スコープ SAS キーを認証に使用できません。 bool
enableDataResidency このプロパティを true に設定すると、データ所在地が有効になり、ディザスター リカバリーが無効になります。 bool
enableFileUploadNotifications True の場合、ファイルのアップロード通知が有効になります。 bool
eventHubEndpoints Event Hub と互換性のあるエンドポイントのプロパティ。 このディクショナリに使用できる唯一のキーはイベントです。 このキーは、IoT ハブの作成または更新呼び出しを行う際にディクショナリに存在する必要があります。 IotHubPropertiesEventHubEndpoints を する
顔立ち IoT ハブで有効になっている機能。 'DeviceManagement'
'None'
ipFilterRules IP フィルター規則。 IpFilterRule[]
messagingEndpoints ファイル アップロード通知キューのメッセージング エンドポイントプロパティ。 IotHubPropertiesMessagingEndpoints
minTlsVersion このハブをサポートする TLS の最小バージョンを指定します。 1.2 より前の TLS バージョンを使用するクライアントを拒否するには、"1.2" に設定できます。
networkRuleSets IotHub のネットワーク ルール セットプロパティ NetworkRuleSetProperties
privateEndpointConnections この IotHub で作成されたプライベート エンドポイント接続 PrivateEndpointConnection[]
publicNetworkAccess パブリック ネットワークからの要求が許可されるかどうか 'Disabled'
'Enabled'
restrictOutboundNetworkAccess true の場合、IotHub からのエグレスは、allowedFqdnList 経由で構成されている許可された FQDN のみに制限されます。 bool
ルーティング IoT ハブのルーティング関連のプロパティ。 参照: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints ファイルをアップロードできる Azure Storage エンドポイントの一覧。 現在、構成できる Azure Storage アカウントは 1 つだけであり、そのキーを$defaultにする必要があります。 複数のストレージ アカウントを指定すると、エラーがスローされます。 enableFileUploadNotifications プロパティが True に設定されている場合、このプロパティの値を指定しないと、エラーがスローされます。 IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

名前 形容 価値

IotHubPropertiesMessagingEndpoints

名前 形容 価値

IotHubPropertiesStorageEndpoints

名前 形容 価値

IotHubSkuInfo

名前 形容 価値
能力 プロビジョニングされた IoT Hub ユニットの数。 /azure/azure-subscription-service-limits#iot-hub-limits を参照してください。 int
名前 SKU の名前。 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (必須)

IpFilterRule

名前 形容 価値
アクション このルールによってキャプチャされた要求に対して必要なアクション。 'Accept'
'Reject' (必須)
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

ManagedIdentity

名前 形容 価値
userAssignedIdentity ユーザー割り当て ID。

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 のマネージド ID。 armIdentity の
場所 リソースの場所。 string (必須)
名前 リソース名 string (必須)
プロパティ IotHub プロパティ IotHubProperties の
sku IotHub SKU 情報 IotHubSkuInfo (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

NetworkRuleSetIpRule

名前 形容 価値
アクション IP フィルター アクション 'Allow'
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

NetworkRuleSetProperties

名前 形容 価値
applyToBuiltInEventHubEndpoint True の場合、ネットワーク ルール セットは IotHub の BuiltIn EventHub EndPoint にも適用されます bool (必須)
defaultAction ネットワーク ルール セットの既定のアクション 'Allow'
'Deny'
ipRules IP 規則の一覧 NetworkRuleSetIpRule[] (必須)

PrivateEndpoint

名前 形容 価値

PrivateEndpointConnection

名前 形容 価値
プロパティ プライベート エンドポイント接続のプロパティ PrivateEndpointConnectionProperties (必須)

PrivateEndpointConnectionProperties

名前 形容 価値
privateEndpoint プライベート エンドポイント接続のプライベート エンドポイント プロパティ PrivateEndpoint を する
privateLinkServiceConnectionState プライベート エンドポイント接続の現在の状態 PrivateLinkServiceConnectionState (必須)

PrivateLinkServiceConnectionState

名前 形容 価値
actionsRequired プライベート エンドポイント接続に必要なアクション
形容 プライベート エンドポイント接続の現在の状態の説明 string (必須)
地位 プライベート エンドポイント接続の状態 'Approved'
'Disconnected'
'Pending'
'Rejected' (必須)

ResourceTags

名前 形容 価値

RouteProperties

名前 形容 価値
条件 ルーティング規則を適用するために評価される条件。 条件が指定されていない場合は、既定で true に評価されます。 文法については、/azure/iot-hub/iot-hub-devguide-query-language を参照してください。
endpointNames 条件を満たすメッセージがルーティングされるエンドポイントの一覧。 現在、許可されているエンドポイントは 1 つだけです。 string[] (必須)
isEnabled ルートを有効にするかどうかを指定するために使用します。 bool (必須)
名前 ルートの名前。 名前には、英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字で、一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
ルーティング規則を適用するソース (DeviceMessages など)。 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Invalid'
'TwinChangeEvents' (必須)

RoutingCosmosDBSqlApiProperties

名前 形容 価値
authenticationType Cosmos DB SQL コンテナー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
containerName Cosmos DB データベース内の Cosmos DB SQL コンテナーの名前。 string (必須)
databaseName Cosmos DB アカウント内の Cosmos DB データベースの名前。 string (必須)
endpointUri Cosmos DB アカウントの URL。 プロトコル https:// を含める必要があります string (必須)
同一性 Cosmos DB コンテナー エンドポイントのルーティングのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
partitionKeyName この Cosmos DB SQL コンテナーに関連付けられているパーティション キーの名前 (存在する場合)。 これは省略可能なパラメーターです。
partitionKeyTemplate この Cosmos DB SQL コンテナーで使用する合成パーティション キー値を生成するためのテンプレート。 テンプレートには、{iothub}、{deviceid}、{DD}、{MM}、{YYYY} のいずれかのプレースホルダーが少なくとも 1 つ含まれている必要があります。 1 つのプレースホルダーは最大で 1 回指定できますが、順序とプレースホルダー以外のコンポーネントは任意です。 このパラメーターは、PartitionKeyName が指定されている場合にのみ必要です。
primaryKey Cosmos DB アカウントの主キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
resourceGroup Cosmos DB アカウントのリソース グループの名前。
secondaryKey Cosmos DB アカウントのセカンダリ キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
subscriptionId Cosmos DB アカウントのサブスクリプション識別子。

RoutingEndpoints

名前 形容 価値
cosmosDBSqlContainers IoT Hub がルーティング規則に基づいてメッセージをルーティングする Cosmos DB コンテナー エンドポイントの一覧。 RoutingCosmosDBSqlApiProperties[]
eventHubs ルーティング規則に基づいて、IoT Hub がメッセージをルーティングする Event Hubs エンドポイントの一覧。 この一覧には、組み込みの Event Hubs エンドポイントは含まれません。 RoutingEventHubProperties[]
serviceBusQueues ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus キュー エンドポイントの一覧。 RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus トピック エンドポイントの一覧。 RoutingServiceBusTopicEndpointProperties[]
storageContainers ルーティング規則に基づいて、IoT Hub がメッセージをルーティングするストレージ コンテナー エンドポイントの一覧。 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 EnrichmentProperties[]
fallbackRoute "routes" セクションで指定された条件が満たされていない場合にフォールバック ルートとして使用されるルートのプロパティ。 これは省略可能なパラメーターです。 このプロパティがテンプレートに存在しない場合、フォールバック ルートは既定で無効になります。 FallbackRouteProperties の
ルート IoT ハブが組み込みエンドポイントとカスタム エンドポイントにメッセージをルーティングするために使用するユーザー指定のルーティング規則の一覧。 有料ハブには最大 100 個のルーティング規則が許可され、無料ハブでは最大 5 つのルーティング規則が許可されます。 RouteProperties[]

RoutingServiceBusQueueEndpointProperties

名前 形容 価値
authenticationType Service Bus キュー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus キュー エンドポイントの接続文字列。
endpointUri Service Bus キュー エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus 名前空間のキュー名
身分証明書 Service Bus キュー エンドポイントの ID
同一性 ルーティング サービス バス キュー エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 実際のキュー名と同じ名前である必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus キュー エンドポイントのリソース グループの名前。
subscriptionId Service Bus キュー エンドポイントのサブスクリプション識別子。

RoutingServiceBusTopicEndpointProperties

名前 形容 価値
authenticationType Service Bus トピック エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus トピック エンドポイントの接続文字列。
endpointUri Service Bus トピック エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus トピックのキュー名
身分証明書 Service Bus トピック エンドポイントの ID
同一性 ルーティング サービス バス トピック エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 名前は、実際のトピック名と同じである必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus トピック エンドポイントのリソース グループの名前。
subscriptionId Service Bus トピック エンドポイントのサブスクリプション識別子。

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(10 MB) から 524288000(500 MB) の間である必要があります。 既定値は 314572800(300 MB) です。 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 Storage アカウントの接続文字列。 string (必須)
containerName ファイルをアップロードするルート コンテナーの名前。 コンテナーは存在する必要はありませんが、指定された connectionString を使用して作成できる必要があります。 string (必須)
同一性 ファイルアップロード用のストレージ エンドポイントのマネージド ID プロパティ。 ManagedIdentity
sasTtlAsIso8601 IoT Hub によって生成されたファイルアップロード用の SAS URI が有効な期間。 /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options を参照してください。

クイック スタートのサンプル

次のクイック スタート サンプルでは、このリソースの種類をデプロイします。

Bicep ファイル 形容
IoT Hub と Device to Cloud Consumer Group を作成する このテンプレートを使用すると、デバイスを含む IoT Hub インスタンスをクラウドにデプロイし、クラウドからデバイス メッセージング構成に、デバイスをクラウド コンシューマー グループにデプロイできます。
IoT Hub Device Provisioning Service を作成する このテンプレートを使用すると、IoT ハブと IoT Hub Device Provisioning Service を作成し、2 つのサービスをリンクできます。
IoT Hub アカウント、インスタンス、IoT Hub の Device Update を作成する このテンプレートは、アカウントと、インスタンスをリンクするインスタンスとハブを作成します。 必要なアクセス ポリシー、ルート、およびコンシューマー グループを使用してハブを構成します。
Azure IoT Hub を含む MedTech サービスをデプロイする MedTech サービスは、複数のデバイスからデバイス データを取り込み、デバイス データを FHIR Observations に変換し、Azure Health Data Services FHIR サービスに保持するように設計された Azure Health Data Services の 1 つです。
ARM テンプレートを使用して IoT Hub を作成し、メッセージをルーティングして表示 このテンプレートを使用して、IoT Hub とストレージ アカウントをデプロイします。 ストレージにルーティングされたハブにメッセージを送信するアプリを実行し、結果を表示します。

ARM テンプレート リソース定義

IotHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Devices/IotHubs リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "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"
  }
}

プロパティ値

ArmIdentity

名前 形容 価値
種類 リソースに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 '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

EnrichmentProperties

名前 形容 価値
endpointNames エンリッチメントがメッセージに適用されるエンドポイントの一覧。 string[] (必須)
エンリッチメント プロパティのキーまたは名前。 string (必須)
価値 エンリッチメント プロパティの値。 string (必須)

EventHubProperties

名前 形容 価値
partitionCount Event Hub と互換性のあるエンドポイントでデバイスからクラウドへのメッセージを受信するためのパーティションの数。 /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'
'Invalid'
'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 Hub からのエグレスで許可される FQDN (完全修飾ドメイン名) の一覧。 string[]
authorizationPolicies IoT ハブへの接続をセキュリティで保護するために使用できる共有アクセス ポリシー。 SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT Hub のクラウドからデバイスへのメッセージング プロパティ。 CloudToDeviceProperties
コメント IoT Hub のコメント。
disableDeviceSAS true の場合、すべてのデバイス (Edge デバイスを含むがモジュールを除く) スコープ SAS キーは認証に使用できません。 bool
disableLocalAuth true の場合、IoT ハブ スコープの SAS キーを持つ SAS トークンは認証に使用できません。 bool
disableModuleSAS true の場合、すべてのモジュール スコープ SAS キーを認証に使用できません。 bool
enableDataResidency このプロパティを true に設定すると、データ所在地が有効になり、ディザスター リカバリーが無効になります。 bool
enableFileUploadNotifications True の場合、ファイルのアップロード通知が有効になります。 bool
eventHubEndpoints Event Hub と互換性のあるエンドポイントのプロパティ。 このディクショナリに使用できる唯一のキーはイベントです。 このキーは、IoT ハブの作成または更新呼び出しを行う際にディクショナリに存在する必要があります。 IotHubPropertiesEventHubEndpoints を する
顔立ち IoT ハブで有効になっている機能。 'DeviceManagement'
'None'
ipFilterRules IP フィルター規則。 IpFilterRule[]
messagingEndpoints ファイル アップロード通知キューのメッセージング エンドポイントプロパティ。 IotHubPropertiesMessagingEndpoints
minTlsVersion このハブをサポートする TLS の最小バージョンを指定します。 1.2 より前の TLS バージョンを使用するクライアントを拒否するには、"1.2" に設定できます。
networkRuleSets IotHub のネットワーク ルール セットプロパティ NetworkRuleSetProperties
privateEndpointConnections この IotHub で作成されたプライベート エンドポイント接続 PrivateEndpointConnection[]
publicNetworkAccess パブリック ネットワークからの要求が許可されるかどうか 'Disabled'
'Enabled'
restrictOutboundNetworkAccess true の場合、IotHub からのエグレスは、allowedFqdnList 経由で構成されている許可された FQDN のみに制限されます。 bool
ルーティング IoT ハブのルーティング関連のプロパティ。 参照: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints ファイルをアップロードできる Azure Storage エンドポイントの一覧。 現在、構成できる Azure Storage アカウントは 1 つだけであり、そのキーを$defaultにする必要があります。 複数のストレージ アカウントを指定すると、エラーがスローされます。 enableFileUploadNotifications プロパティが True に設定されている場合、このプロパティの値を指定しないと、エラーがスローされます。 IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

名前 形容 価値

IotHubPropertiesMessagingEndpoints

名前 形容 価値

IotHubPropertiesStorageEndpoints

名前 形容 価値

IotHubSkuInfo

名前 形容 価値
能力 プロビジョニングされた IoT Hub ユニットの数。 /azure/azure-subscription-service-limits#iot-hub-limits を参照してください。 int
名前 SKU の名前。 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (必須)

IpFilterRule

名前 形容 価値
アクション このルールによってキャプチャされた要求に対して必要なアクション。 'Accept'
'Reject' (必須)
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

ManagedIdentity

名前 形容 価値
userAssignedIdentity ユーザー割り当て ID。

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 のバージョン '2023-06-30'
etag Etag フィールドは 必要ありません。 応答本文で指定する場合は、通常の ETag 規則に従ってヘッダーとしても指定する必要があります。
同一性 IotHub のマネージド ID。 armIdentity の
場所 リソースの場所。 string (必須)
名前 リソース名 string (必須)
プロパティ IotHub プロパティ IotHubProperties の
sku IotHub SKU 情報 IotHubSkuInfo (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
種類 リソースの種類 'Microsoft.Devices/IotHubs'

NetworkRuleSetIpRule

名前 形容 価値
アクション IP フィルター アクション 'Allow'
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

NetworkRuleSetProperties

名前 形容 価値
applyToBuiltInEventHubEndpoint True の場合、ネットワーク ルール セットは IotHub の BuiltIn EventHub EndPoint にも適用されます bool (必須)
defaultAction ネットワーク ルール セットの既定のアクション 'Allow'
'Deny'
ipRules IP 規則の一覧 NetworkRuleSetIpRule[] (必須)

PrivateEndpoint

名前 形容 価値

PrivateEndpointConnection

名前 形容 価値
プロパティ プライベート エンドポイント接続のプロパティ PrivateEndpointConnectionProperties (必須)

PrivateEndpointConnectionProperties

名前 形容 価値
privateEndpoint プライベート エンドポイント接続のプライベート エンドポイント プロパティ PrivateEndpoint を する
privateLinkServiceConnectionState プライベート エンドポイント接続の現在の状態 PrivateLinkServiceConnectionState (必須)

PrivateLinkServiceConnectionState

名前 形容 価値
actionsRequired プライベート エンドポイント接続に必要なアクション
形容 プライベート エンドポイント接続の現在の状態の説明 string (必須)
地位 プライベート エンドポイント接続の状態 'Approved'
'Disconnected'
'Pending'
'Rejected' (必須)

ResourceTags

名前 形容 価値

RouteProperties

名前 形容 価値
条件 ルーティング規則を適用するために評価される条件。 条件が指定されていない場合は、既定で true に評価されます。 文法については、/azure/iot-hub/iot-hub-devguide-query-language を参照してください。
endpointNames 条件を満たすメッセージがルーティングされるエンドポイントの一覧。 現在、許可されているエンドポイントは 1 つだけです。 string[] (必須)
isEnabled ルートを有効にするかどうかを指定するために使用します。 bool (必須)
名前 ルートの名前。 名前には、英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字で、一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
ルーティング規則を適用するソース (DeviceMessages など)。 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Invalid'
'TwinChangeEvents' (必須)

RoutingCosmosDBSqlApiProperties

名前 形容 価値
authenticationType Cosmos DB SQL コンテナー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
containerName Cosmos DB データベース内の Cosmos DB SQL コンテナーの名前。 string (必須)
databaseName Cosmos DB アカウント内の Cosmos DB データベースの名前。 string (必須)
endpointUri Cosmos DB アカウントの URL。 プロトコル https:// を含める必要があります string (必須)
同一性 Cosmos DB コンテナー エンドポイントのルーティングのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
partitionKeyName この Cosmos DB SQL コンテナーに関連付けられているパーティション キーの名前 (存在する場合)。 これは省略可能なパラメーターです。
partitionKeyTemplate この Cosmos DB SQL コンテナーで使用する合成パーティション キー値を生成するためのテンプレート。 テンプレートには、{iothub}、{deviceid}、{DD}、{MM}、{YYYY} のいずれかのプレースホルダーが少なくとも 1 つ含まれている必要があります。 1 つのプレースホルダーは最大で 1 回指定できますが、順序とプレースホルダー以外のコンポーネントは任意です。 このパラメーターは、PartitionKeyName が指定されている場合にのみ必要です。
primaryKey Cosmos DB アカウントの主キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
resourceGroup Cosmos DB アカウントのリソース グループの名前。
secondaryKey Cosmos DB アカウントのセカンダリ キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
subscriptionId Cosmos DB アカウントのサブスクリプション識別子。

RoutingEndpoints

名前 形容 価値
cosmosDBSqlContainers IoT Hub がルーティング規則に基づいてメッセージをルーティングする Cosmos DB コンテナー エンドポイントの一覧。 RoutingCosmosDBSqlApiProperties[]
eventHubs ルーティング規則に基づいて、IoT Hub がメッセージをルーティングする Event Hubs エンドポイントの一覧。 この一覧には、組み込みの Event Hubs エンドポイントは含まれません。 RoutingEventHubProperties[]
serviceBusQueues ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus キュー エンドポイントの一覧。 RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus トピック エンドポイントの一覧。 RoutingServiceBusTopicEndpointProperties[]
storageContainers ルーティング規則に基づいて、IoT Hub がメッセージをルーティングするストレージ コンテナー エンドポイントの一覧。 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 EnrichmentProperties[]
fallbackRoute "routes" セクションで指定された条件が満たされていない場合にフォールバック ルートとして使用されるルートのプロパティ。 これは省略可能なパラメーターです。 このプロパティがテンプレートに存在しない場合、フォールバック ルートは既定で無効になります。 FallbackRouteProperties の
ルート IoT ハブが組み込みエンドポイントとカスタム エンドポイントにメッセージをルーティングするために使用するユーザー指定のルーティング規則の一覧。 有料ハブには最大 100 個のルーティング規則が許可され、無料ハブでは最大 5 つのルーティング規則が許可されます。 RouteProperties[]

RoutingServiceBusQueueEndpointProperties

名前 形容 価値
authenticationType Service Bus キュー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus キュー エンドポイントの接続文字列。
endpointUri Service Bus キュー エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus 名前空間のキュー名
身分証明書 Service Bus キュー エンドポイントの ID
同一性 ルーティング サービス バス キュー エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 実際のキュー名と同じ名前である必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus キュー エンドポイントのリソース グループの名前。
subscriptionId Service Bus キュー エンドポイントのサブスクリプション識別子。

RoutingServiceBusTopicEndpointProperties

名前 形容 価値
authenticationType Service Bus トピック エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus トピック エンドポイントの接続文字列。
endpointUri Service Bus トピック エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus トピックのキュー名
身分証明書 Service Bus トピック エンドポイントの ID
同一性 ルーティング サービス バス トピック エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 名前は、実際のトピック名と同じである必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus トピック エンドポイントのリソース グループの名前。
subscriptionId Service Bus トピック エンドポイントのサブスクリプション識別子。

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(10 MB) から 524288000(500 MB) の間である必要があります。 既定値は 314572800(300 MB) です。 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 Storage アカウントの接続文字列。 string (必須)
containerName ファイルをアップロードするルート コンテナーの名前。 コンテナーは存在する必要はありませんが、指定された connectionString を使用して作成できる必要があります。 string (必須)
同一性 ファイルアップロード用のストレージ エンドポイントのマネージド ID プロパティ。 ManagedIdentity
sasTtlAsIso8601 IoT Hub によって生成されたファイルアップロード用の SAS URI が有効な期間。 /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options を参照してください。

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
IoT Hub を使用して従量課金制 (PAYG) 環境を作成する

Azure にデプロイする
このテンプレートを使用すると、IoT Hub からのイベントを使用するように構成された従量課金制 (PAYG) Time Series Insights 環境をデプロイできます。
IoT Hub と Device to Cloud Consumer Group を作成する

Azure にデプロイする
このテンプレートを使用すると、デバイスを含む IoT Hub インスタンスをクラウドにデプロイし、クラウドからデバイス メッセージング構成に、デバイスをクラウド コンシューマー グループにデプロイできます。
IoT Hub と Ubuntu エッジ シミュレーター を作成する

Azure にデプロイする
このテンプレートでは、IOT ハブと仮想マシン Ubuntu エッジ シミュレーターが作成されます。
IoT Hub Device Provisioning Service を作成する

Azure にデプロイする
このテンプレートを使用すると、IoT ハブと IoT Hub Device Provisioning Service を作成し、2 つのサービスをリンクできます。
IoT Hub アカウント、インスタンス、IoT Hub の Device Update を作成する

Azure にデプロイする
このテンプレートは、アカウントと、インスタンスをリンクするインスタンスとハブを作成します。 必要なアクセス ポリシー、ルート、およびコンシューマー グループを使用してハブを構成します。
Azure IoT Hub を含む MedTech サービスをデプロイする

Azure にデプロイする
MedTech サービスは、複数のデバイスからデバイス データを取り込み、デバイス データを FHIR Observations に変換し、Azure Health Data Services FHIR サービスに保持するように設計された Azure Health Data Services の 1 つです。
ARM テンプレートを使用して IoT Hub を作成し、メッセージをルーティングして表示

Azure にデプロイする
このテンプレートを使用して、IoT Hub とストレージ アカウントをデプロイします。 ストレージにルーティングされたハブにメッセージを送信するアプリを実行し、結果を表示します。

Terraform (AzAPI プロバイダー) リソース定義

IotHubs リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Devices/IotHubs リソースを作成するには、次の Terraform をテンプレートに追加します。

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"
  }
}

プロパティ値

ArmIdentity

名前 形容 価値
種類 リソースに使用される ID の種類。 型 'SystemAssigned, UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。 型 'None' は、サービスからすべての ID を削除します。 '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

EnrichmentProperties

名前 形容 価値
endpointNames エンリッチメントがメッセージに適用されるエンドポイントの一覧。 string[] (必須)
エンリッチメント プロパティのキーまたは名前。 string (必須)
価値 エンリッチメント プロパティの値。 string (必須)

EventHubProperties

名前 形容 価値
partitionCount Event Hub と互換性のあるエンドポイントでデバイスからクラウドへのメッセージを受信するためのパーティションの数。 /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'
'Invalid'
'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 Hub からのエグレスで許可される FQDN (完全修飾ドメイン名) の一覧。 string[]
authorizationPolicies IoT ハブへの接続をセキュリティで保護するために使用できる共有アクセス ポリシー。 SharedAccessSignatureAuthorizationRule[]
cloudToDevice IoT Hub のクラウドからデバイスへのメッセージング プロパティ。 CloudToDeviceProperties
コメント IoT Hub のコメント。
disableDeviceSAS true の場合、すべてのデバイス (Edge デバイスを含むがモジュールを除く) スコープ SAS キーは認証に使用できません。 bool
disableLocalAuth true の場合、IoT ハブ スコープの SAS キーを持つ SAS トークンは認証に使用できません。 bool
disableModuleSAS true の場合、すべてのモジュール スコープ SAS キーを認証に使用できません。 bool
enableDataResidency このプロパティを true に設定すると、データ所在地が有効になり、ディザスター リカバリーが無効になります。 bool
enableFileUploadNotifications True の場合、ファイルのアップロード通知が有効になります。 bool
eventHubEndpoints Event Hub と互換性のあるエンドポイントのプロパティ。 このディクショナリに使用できる唯一のキーはイベントです。 このキーは、IoT ハブの作成または更新呼び出しを行う際にディクショナリに存在する必要があります。 IotHubPropertiesEventHubEndpoints を する
顔立ち IoT ハブで有効になっている機能。 'DeviceManagement'
'None'
ipFilterRules IP フィルター規則。 IpFilterRule[]
messagingEndpoints ファイル アップロード通知キューのメッセージング エンドポイントプロパティ。 IotHubPropertiesMessagingEndpoints
minTlsVersion このハブをサポートする TLS の最小バージョンを指定します。 1.2 より前の TLS バージョンを使用するクライアントを拒否するには、"1.2" に設定できます。
networkRuleSets IotHub のネットワーク ルール セットプロパティ NetworkRuleSetProperties
privateEndpointConnections この IotHub で作成されたプライベート エンドポイント接続 PrivateEndpointConnection[]
publicNetworkAccess パブリック ネットワークからの要求が許可されるかどうか 'Disabled'
'Enabled'
restrictOutboundNetworkAccess true の場合、IotHub からのエグレスは、allowedFqdnList 経由で構成されている許可された FQDN のみに制限されます。 bool
ルーティング IoT ハブのルーティング関連のプロパティ。 参照: /azure/iot-hub/iot-hub-devguide-messaging RoutingProperties
storageEndpoints ファイルをアップロードできる Azure Storage エンドポイントの一覧。 現在、構成できる Azure Storage アカウントは 1 つだけであり、そのキーを$defaultにする必要があります。 複数のストレージ アカウントを指定すると、エラーがスローされます。 enableFileUploadNotifications プロパティが True に設定されている場合、このプロパティの値を指定しないと、エラーがスローされます。 IotHubPropertiesStorageEndpoints

IotHubPropertiesEventHubEndpoints

名前 形容 価値

IotHubPropertiesMessagingEndpoints

名前 形容 価値

IotHubPropertiesStorageEndpoints

名前 形容 価値

IotHubSkuInfo

名前 形容 価値
能力 プロビジョニングされた IoT Hub ユニットの数。 /azure/azure-subscription-service-limits#iot-hub-limits を参照してください。 int
名前 SKU の名前。 'B1'
'B2'
'B3'
'F1'
'S1'
'S2'
'S3' (必須)

IpFilterRule

名前 形容 価値
アクション このルールによってキャプチャされた要求に対して必要なアクション。 'Accept'
'Reject' (必須)
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

ManagedIdentity

名前 形容 価値
userAssignedIdentity ユーザー割り当て ID。

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 のマネージド ID。 armIdentity の
場所 リソースの場所。 string (必須)
名前 リソース名 string (必須)
プロパティ IotHub プロパティ IotHubProperties の
sku IotHub SKU 情報 IotHubSkuInfo (必須)
タグ リソース タグ タグ名と値のディクショナリ。
種類 リソースの種類 "Microsoft.Devices/IotHubs@2023-06-30"

NetworkRuleSetIpRule

名前 形容 価値
アクション IP フィルター アクション 'Allow'
filterName IP フィルター規則の名前。 string (必須)
ipMask 規則の IP アドレス範囲を CIDR 表記で含む文字列。 string (必須)

NetworkRuleSetProperties

名前 形容 価値
applyToBuiltInEventHubEndpoint True の場合、ネットワーク ルール セットは IotHub の BuiltIn EventHub EndPoint にも適用されます bool (必須)
defaultAction ネットワーク ルール セットの既定のアクション 'Allow'
'Deny'
ipRules IP 規則の一覧 NetworkRuleSetIpRule[] (必須)

PrivateEndpoint

名前 形容 価値

PrivateEndpointConnection

名前 形容 価値
プロパティ プライベート エンドポイント接続のプロパティ PrivateEndpointConnectionProperties (必須)

PrivateEndpointConnectionProperties

名前 形容 価値
privateEndpoint プライベート エンドポイント接続のプライベート エンドポイント プロパティ PrivateEndpoint を する
privateLinkServiceConnectionState プライベート エンドポイント接続の現在の状態 PrivateLinkServiceConnectionState (必須)

PrivateLinkServiceConnectionState

名前 形容 価値
actionsRequired プライベート エンドポイント接続に必要なアクション
形容 プライベート エンドポイント接続の現在の状態の説明 string (必須)
地位 プライベート エンドポイント接続の状態 'Approved'
'Disconnected'
'Pending'
'Rejected' (必須)

ResourceTags

名前 形容 価値

RouteProperties

名前 形容 価値
条件 ルーティング規則を適用するために評価される条件。 条件が指定されていない場合は、既定で true に評価されます。 文法については、/azure/iot-hub/iot-hub-devguide-query-language を参照してください。
endpointNames 条件を満たすメッセージがルーティングされるエンドポイントの一覧。 現在、許可されているエンドポイントは 1 つだけです。 string[] (必須)
isEnabled ルートを有効にするかどうかを指定するために使用します。 bool (必須)
名前 ルートの名前。 名前には、英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字で、一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
ルーティング規則を適用するソース (DeviceMessages など)。 'DeviceConnectionStateEvents'
'DeviceJobLifecycleEvents'
'DeviceLifecycleEvents'
'DeviceMessages'
'Invalid'
'TwinChangeEvents' (必須)

RoutingCosmosDBSqlApiProperties

名前 形容 価値
authenticationType Cosmos DB SQL コンテナー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
containerName Cosmos DB データベース内の Cosmos DB SQL コンテナーの名前。 string (必須)
databaseName Cosmos DB アカウント内の Cosmos DB データベースの名前。 string (必須)
endpointUri Cosmos DB アカウントの URL。 プロトコル https:// を含める必要があります string (必須)
同一性 Cosmos DB コンテナー エンドポイントのルーティングのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
partitionKeyName この Cosmos DB SQL コンテナーに関連付けられているパーティション キーの名前 (存在する場合)。 これは省略可能なパラメーターです。
partitionKeyTemplate この Cosmos DB SQL コンテナーで使用する合成パーティション キー値を生成するためのテンプレート。 テンプレートには、{iothub}、{deviceid}、{DD}、{MM}、{YYYY} のいずれかのプレースホルダーが少なくとも 1 つ含まれている必要があります。 1 つのプレースホルダーは最大で 1 回指定できますが、順序とプレースホルダー以外のコンポーネントは任意です。 このパラメーターは、PartitionKeyName が指定されている場合にのみ必要です。
primaryKey Cosmos DB アカウントの主キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
resourceGroup Cosmos DB アカウントのリソース グループの名前。
secondaryKey Cosmos DB アカウントのセカンダリ キー。

制約:
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
subscriptionId Cosmos DB アカウントのサブスクリプション識別子。

RoutingEndpoints

名前 形容 価値
cosmosDBSqlContainers IoT Hub がルーティング規則に基づいてメッセージをルーティングする Cosmos DB コンテナー エンドポイントの一覧。 RoutingCosmosDBSqlApiProperties[]
eventHubs ルーティング規則に基づいて、IoT Hub がメッセージをルーティングする Event Hubs エンドポイントの一覧。 この一覧には、組み込みの Event Hubs エンドポイントは含まれません。 RoutingEventHubProperties[]
serviceBusQueues ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus キュー エンドポイントの一覧。 RoutingServiceBusQueueEndpointProperties[]
serviceBusTopics ルーティング規則に基づいて、IoT ハブがメッセージをルーティングする Service Bus トピック エンドポイントの一覧。 RoutingServiceBusTopicEndpointProperties[]
storageContainers ルーティング規則に基づいて、IoT Hub がメッセージをルーティングするストレージ コンテナー エンドポイントの一覧。 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 EnrichmentProperties[]
fallbackRoute "routes" セクションで指定された条件が満たされていない場合にフォールバック ルートとして使用されるルートのプロパティ。 これは省略可能なパラメーターです。 このプロパティがテンプレートに存在しない場合、フォールバック ルートは既定で無効になります。 FallbackRouteProperties の
ルート IoT ハブが組み込みエンドポイントとカスタム エンドポイントにメッセージをルーティングするために使用するユーザー指定のルーティング規則の一覧。 有料ハブには最大 100 個のルーティング規則が許可され、無料ハブでは最大 5 つのルーティング規則が許可されます。 RouteProperties[]

RoutingServiceBusQueueEndpointProperties

名前 形容 価値
authenticationType Service Bus キュー エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus キュー エンドポイントの接続文字列。
endpointUri Service Bus キュー エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus 名前空間のキュー名
身分証明書 Service Bus キュー エンドポイントの ID
同一性 ルーティング サービス バス キュー エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 実際のキュー名と同じ名前である必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus キュー エンドポイントのリソース グループの名前。
subscriptionId Service Bus キュー エンドポイントのサブスクリプション識別子。

RoutingServiceBusTopicEndpointProperties

名前 形容 価値
authenticationType Service Bus トピック エンドポイントに対する認証に使用されるメソッド 'identityBased'
'keyBased'
connectionString Service Bus トピック エンドポイントの接続文字列。
endpointUri Service Bus トピック エンドポイントの URL。 プロトコル sb:// を含める必要があります
entityPath Service Bus トピックのキュー名
身分証明書 Service Bus トピック エンドポイントの ID
同一性 ルーティング サービス バス トピック エンドポイントのマネージド ID プロパティ。 ManagedIdentity
名前 このエンドポイントを識別する名前。 名前には英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字です。 予約されている名前は、イベント、fileNotifications、$defaultです。 エンドポイント名は、エンドポイントの種類間で一意である必要があります。 名前は、実際のトピック名と同じである必要はありません。

制約:
パターン = ^[A-Za-z0-9-._]{1,64}$ (必須)
resourceGroup Service Bus トピック エンドポイントのリソース グループの名前。
subscriptionId Service Bus トピック エンドポイントのサブスクリプション識別子。

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(10 MB) から 524288000(500 MB) の間である必要があります。 既定値は 314572800(300 MB) です。 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 Storage アカウントの接続文字列。 string (必須)
containerName ファイルをアップロードするルート コンテナーの名前。 コンテナーは存在する必要はありませんが、指定された connectionString を使用して作成できる必要があります。 string (必須)
同一性 ファイルアップロード用のストレージ エンドポイントのマネージド ID プロパティ。 ManagedIdentity
sasTtlAsIso8601 IoT Hub によって生成されたファイルアップロード用の SAS URI が有効な期間。 /azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options を参照してください。