Iot Hub Resource - List By Subscription

Rufen Sie alle IoT Hubs in einem Abonnement ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Devices/IotHubs?api-version=2018-04-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
subscriptionId
path True

string

Die Abonnement-ID.

api-version
query True

string

Die Version der API.

Antworten

Name Typ Beschreibung
200 OK

IotHubDescriptionListResult

Dies ist ein synchroner Vorgang. Der Text enthält ein JSON-serialisiertes Array der Metadaten aus allen IoT Hubs im Abonnement.

Other Status Codes

ErrorDetails

DefaultErrorResponse

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

IotHubResource_ListBySubscription

Sample Request

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/IotHubs?api-version=2018-04-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
      "name": "testHub",
      "type": "Microsoft.Devices/IotHubs",
      "location": "centraluseuap",
      "tags": {},
      "etag": "AAAAAAFD6M4=",
      "properties": {
        "operationsMonitoringProperties": {
          "events": {
            "None": "None",
            "Connections": "None",
            "DeviceTelemetry": "None",
            "C2DCommands": "None",
            "DeviceIdentityOperations": "None",
            "FileUploadOperations": "None",
            "Routes": "None"
          }
        },
        "state": "Active",
        "provisioningState": "Succeeded",
        "ipFilterRules": [],
        "hostName": "iot-dps-cit-hub-1.azure-devices.net",
        "eventHubEndpoints": {
          "events": {
            "retentionTimeInDays": 1,
            "partitionCount": 2,
            "partitionIds": [
              "0",
              "1"
            ],
            "path": "iot-dps-cit-hub-1",
            "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
          },
          "operationsMonitoringEvents": {
            "retentionTimeInDays": 1,
            "partitionCount": 2,
            "partitionIds": [
              "0",
              "1"
            ],
            "path": "iot-dps-cit-hub-1-operationmonitoring",
            "endpoint": "sb://iothub-ns-iot-dps-ci-245306-76aca8e13b.servicebus.windows.net/"
          }
        },
        "routing": {
          "endpoints": {
            "serviceBusQueues": [],
            "serviceBusTopics": [],
            "eventHubs": [],
            "storageContainers": []
          },
          "routes": [],
          "fallbackRoute": {
            "name": "$fallback",
            "source": "DeviceMessages",
            "condition": "true",
            "endpointNames": [
              "events"
            ],
            "isEnabled": true
          }
        },
        "storageEndpoints": {
          "$default": {
            "sasTtlAsIso8601": "PT1H",
            "connectionString": "",
            "containerName": ""
          }
        },
        "messagingEndpoints": {
          "fileNotifications": {
            "lockDurationAsIso8601": "PT1M",
            "ttlAsIso8601": "PT1H",
            "maxDeliveryCount": 10
          }
        },
        "enableFileUploadNotifications": false,
        "cloudToDevice": {
          "maxDeliveryCount": 10,
          "defaultTtlAsIso8601": "PT1H",
          "feedback": {
            "lockDurationAsIso8601": "PT1M",
            "ttlAsIso8601": "PT1H",
            "maxDeliveryCount": 10
          }
        },
        "features": "None"
      },
      "sku": {
        "name": "S1",
        "tier": "Standard",
        "capacity": 1
      }
    }
  ]
}

Definitionen

Name Beschreibung
AccessRights

Die berechtigungen, die der SAS-Richtlinie zugewiesen sind.

Capabilities

Die Funktionen und Features, die für den IoT Hub aktiviert sind.

CloudToDeviceProperties

Die IoT Hub-Cloud-zu-Gerät-Messagingeigenschaften.

ErrorDetails

Fehlerdetails.

EventHubProperties

Die Eigenschaften des bereitgestellten Event Hub-kompatiblen Endpunkts, der vom IoT Hub verwendet wird.

FallbackRouteProperties

Die Eigenschaften der Fallbackroute. IoT Hub verwendet diese Eigenschaften, wenn Nachrichten an den Fallbackendpunkt weitergeleitet werden.

FeedbackProperties

Die Eigenschaften der Feedbackwarteschlange für Cloud-zu-Gerät-Nachrichten.

IotHubDescription

Die Beschreibung des IoT-Hubs.

IotHubDescriptionListResult

Das JSON-serialisierte Array von IotHubDescription-Objekten mit einem nächsten Link.

IotHubProperties

Die Eigenschaften eines IoT-Hubs.

IotHubSku

Der Name der SKU.

IotHubSkuInfo

Informationen zur SKU des IoT Hubs.

IotHubSkuTier

Die Abrechnungsebene für den IoT Hub.

IpFilterActionType

Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.

IpFilterRule

Die IP-Filterregeln für den IoT Hub.

MessagingEndpointProperties

Die Eigenschaften der Messagingendpunkte, die von diesem IoT Hub verwendet werden.

OperationsMonitoringProperties

Die Betriebsüberwachungseigenschaften für den IoT Hub. Die möglichen Schlüssel für das Wörterbuch sind Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods.

RouteProperties

Die Eigenschaften einer Routingregel, die Ihr IoT Hub verwendet, um Nachrichten an Endpunkte weiterzuleiten.

RoutingEndpoints

Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur ein benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig.

RoutingEventHubProperties

Die Eigenschaften im Zusammenhang mit einem Event Hub-Endpunkt.

RoutingProperties

Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

RoutingServiceBusQueueEndpointProperties

Die Eigenschaften im Zusammenhang mit Service Bus-Warteschlangenendpunkttypen.

RoutingServiceBusTopicEndpointProperties

Die Eigenschaften im Zusammenhang mit Service Bus-Themenendpunkttypen.

RoutingSource

Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages.

RoutingStorageContainerProperties

Die Eigenschaften im Zusammenhang mit einem Speichercontainerendpunkt.

SharedAccessSignatureAuthorizationRule

Die Eigenschaften einer IoT Hub-Richtlinie für freigegebenen Zugriff.

StorageEndpointProperties

Die Eigenschaften des Azure Storage-Endpunkts für den Dateiupload.

AccessRights

Die berechtigungen, die der SAS-Richtlinie zugewiesen sind.

Name Typ Beschreibung
DeviceConnect

string

RegistryRead

string

RegistryRead, DeviceConnect

string

RegistryRead, RegistryWrite

string

RegistryRead, RegistryWrite, DeviceConnect

string

RegistryRead, RegistryWrite, ServiceConnect

string

RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect

string

RegistryRead, ServiceConnect

string

RegistryRead, ServiceConnect, DeviceConnect

string

RegistryWrite

string

RegistryWrite, DeviceConnect

string

RegistryWrite, ServiceConnect

string

RegistryWrite, ServiceConnect, DeviceConnect

string

ServiceConnect

string

ServiceConnect, DeviceConnect

string

Capabilities

Die Funktionen und Features, die für den IoT Hub aktiviert sind.

Name Typ Beschreibung
DeviceManagement

string

None

string

CloudToDeviceProperties

Die IoT Hub-Cloud-zu-Gerät-Messagingeigenschaften.

Name Typ Beschreibung
defaultTtlAsIso8601

string

Die Standardlaufzeit für Cloud-zu-Gerät-Nachrichten in der Gerätewarteschlange. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

feedback

FeedbackProperties

Die Eigenschaften der Feedbackwarteschlange für Cloud-zu-Gerät-Nachrichten.

maxDeliveryCount

integer

Die maximale Übermittlungsanzahl für Cloud-zu-Gerät-Nachrichten in der Gerätewarteschlange. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

ErrorDetails

Fehlerdetails.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

string

Die Fehlerdetails.

httpStatusCode

string

Der HTTP-Statuscode.

message

string

Die Fehlermeldung.

EventHubProperties

Die Eigenschaften des bereitgestellten Event Hub-kompatiblen Endpunkts, der vom IoT Hub verwendet wird.

Name Typ Beschreibung
endpoint

string

Der Event Hub-kompatible Endpunkt.

partitionCount

integer

Die Anzahl der Partitionen zum Empfangen von Device-to-Cloud-Nachrichten im Event Hub-kompatiblen Endpunkt. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages.

partitionIds

string[]

Die Partitions-IDs im Event Hub-kompatiblen Endpunkt.

path

string

Der Event Hub-kompatible Name.

retentionTimeInDays

integer

Die Aufbewahrungszeit für Geräte-zu-Cloud-Nachrichten in Tagen. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages

FallbackRouteProperties

Die Eigenschaften der Fallbackroute. IoT Hub verwendet diese Eigenschaften, wenn Nachrichten an den Fallbackendpunkt weitergeleitet werden.

Name Typ Beschreibung
condition

string

Die Bedingung, die ausgewertet wird, um die Fallbackroute anzuwenden. Wenn die Bedingung nicht bereitgestellt wird, wird sie standardmäßig auf true ausgewertet. Informationen zur Grammatik finden Sie unter: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language

endpointNames

string[]

Die Liste der Endpunkte, an die die Nachrichten weitergeleitet werden, die die Bedingung erfüllen. Derzeit ist nur 1 Endpunkt zulässig.

isEnabled

boolean

Wird verwendet, um anzugeben, ob die Fallbackroute aktiviert ist.

name

string

Der Name der Route. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten, hat eine maximale Länge von 64 Zeichen und muss eindeutig sein.

source

RoutingSource

Die Quelle, auf die die Routingregel angewendet werden soll. Beispiel: DeviceMessages

FeedbackProperties

Die Eigenschaften der Feedbackwarteschlange für Cloud-zu-Gerät-Nachrichten.

Name Typ Beschreibung
lockDurationAsIso8601

string

Die Sperrdauer für die Feedbackwarteschlange. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

maxDeliveryCount

integer

Die Anzahl der Versuche des IoT Hubs, eine Nachricht in der Feedbackwarteschlange zu übermitteln. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

ttlAsIso8601

string

Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT Hub abgelaufen ist. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages.

IotHubDescription

Die Beschreibung des IoT-Hubs.

Name Typ Beschreibung
etag

string

Das Etag-Feld ist nicht erforderlich. Wenn es im Antworttext angegeben wird, muss er gemäß der normalen ETag-Konvention auch als Header bereitgestellt werden.

id

string

Der Ressourcenbezeichner.

location

string

Der Ressourcenspeicherort.

name

string

Der Name der Ressource.

properties

IotHubProperties

IotHub-Eigenschaften

sku

IotHubSkuInfo

Informationen zur IotHub-SKU

tags

object

Die Ressourcentags.

type

string

Der Ressourcentyp.

IotHubDescriptionListResult

Das JSON-serialisierte Array von IotHubDescription-Objekten mit einem nächsten Link.

Name Typ Beschreibung
nextLink

string

Der nächste Link.

value

IotHubDescription[]

Das Array von IotHubDescription-Objekten.

IotHubProperties

Die Eigenschaften eines IoT-Hubs.

Name Typ Beschreibung
authorizationPolicies

SharedAccessSignatureAuthorizationRule[]

Die Shared Access-Richtlinien, die Sie verwenden können, um eine Verbindung mit dem IoT Hub zu sichern.

cloudToDevice

CloudToDeviceProperties

Die IoT Hub-Cloud-zu-Gerät-Messagingeigenschaften.

comments

string

IoT Hub-Kommentare.

enableFileUploadNotifications

boolean

True gibt an, dass Benachrichtigungen zum Hochladen von Dateien aktiviert sind.

eventHubEndpoints

<string,  EventHubProperties>

Die Event Hub-kompatiblen Endpunkteigenschaften. Die möglichen Schlüssel für dieses Wörterbuch sind Events und operationsMonitoringEvents. Beide Schlüssel müssen im Wörterbuch vorhanden sein, während Sie Aufrufe zum Erstellen oder Aktualisieren des IoT-Hubs ausführen.

features

Capabilities

Die Funktionen und Features, die für den IoT Hub aktiviert sind.

hostName

string

Der Name des Hosts.

ipFilterRules

IpFilterRule[]

Die IP-Filterregeln.

messagingEndpoints

<string,  MessagingEndpointProperties>

Die Messagingendpunkteigenschaften für die Dateiuploadbenachrichtigungswarteschlange.

operationsMonitoringProperties

OperationsMonitoringProperties

Die Betriebsüberwachungseigenschaften für den IoT Hub. Die möglichen Schlüssel für das Wörterbuch sind Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods.

provisioningState

string

Der Bereitstellungsstatus.

routing

RoutingProperties

Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

state

string

Der Hubstatus.

storageEndpoints

<string,  StorageEndpointProperties>

Die Liste der Azure Storage-Endpunkte, an die Sie Dateien hochladen können. Derzeit können Sie nur ein Azure Storage-Konto konfigurieren, dessen Schlüssel als $default muss. Wenn Sie mehrere Speicherkonten angeben, wird ein Fehler ausgelöst. Wenn sie keinen Wert für diese Eigenschaft angeben, wenn die enableFileUploadNotifications-Eigenschaft auf True festgelegt ist, wird ein Fehler ausgelöst.

IotHubSku

Der Name der SKU.

Name Typ Beschreibung
B1

string

B2

string

B3

string

F1

string

S1

string

S2

string

S3

string

IotHubSkuInfo

Informationen zur SKU des IoT Hubs.

Name Typ Beschreibung
capacity

integer

Die Anzahl der bereitgestellten IoT Hub Einheiten. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits.

name

IotHubSku

Der Name der SKU.

tier

IotHubSkuTier

Die Abrechnungsebene für den IoT Hub.

IotHubSkuTier

Die Abrechnungsebene für den IoT Hub.

Name Typ Beschreibung
Basic

string

Free

string

Standard

string

IpFilterActionType

Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.

Name Typ Beschreibung
Accept

string

Reject

string

IpFilterRule

Die IP-Filterregeln für den IoT Hub.

Name Typ Beschreibung
action

IpFilterActionType

Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.

filterName

string

Der Name der IP-Filterregel.

ipMask

string

Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält.

MessagingEndpointProperties

Die Eigenschaften der Messagingendpunkte, die von diesem IoT Hub verwendet werden.

Name Typ Beschreibung
lockDurationAsIso8601

string

Die Sperrdauer. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

maxDeliveryCount

integer

Gibt an, wie oft der IoT Hub versucht, eine Nachricht zu übermitteln. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

ttlAsIso8601

string

Der Zeitraum, für den eine Nachricht verwendet werden kann, bevor sie vom IoT Hub abgelaufen ist. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload.

OperationsMonitoringProperties

Die Betriebsüberwachungseigenschaften für den IoT Hub. Die möglichen Schlüssel für das Wörterbuch sind Connections, DeviceTelemetry, C2DCommands, DeviceIdentityOperations, FileUploadOperations, Routes, D2CTwinOperations, C2DTwinOperations, TwinQueries, JobsOperations, DirectMethods.

Name Typ Beschreibung
events

object

RouteProperties

Die Eigenschaften einer Routingregel, die Ihr IoT Hub verwendet, um Nachrichten an Endpunkte weiterzuleiten.

Name Typ Beschreibung
condition

string

Die Bedingung, die ausgewertet wird, um die Routingregel anzuwenden. Wenn keine Bedingung angegeben wird, wird sie standardmäßig auf true ausgewertet. Informationen zur Grammatik finden Sie unter: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language

endpointNames

string[]

Die Liste der Endpunkte, an die Nachrichten weitergeleitet werden, die die Bedingung erfüllen. Derzeit ist nur ein Endpunkt zulässig.

isEnabled

boolean

Wird verwendet, um anzugeben, ob eine Route aktiviert ist.

name

string

Der Name der Route. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten, hat eine maximale Länge von 64 Zeichen und muss eindeutig sein.

source

RoutingSource

Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages.

RoutingEndpoints

Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur ein benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig.

Name Typ Beschreibung
eventHubs

RoutingEventHubProperties[]

Die Liste der Event Hubs-Endpunkte, an die IoT Hub-Nachrichten basierend auf den Routingregeln weiterleitet. Diese Liste enthält nicht den integrierten Event Hubs-Endpunkt.

serviceBusQueues

RoutingServiceBusQueueEndpointProperties[]

Die Liste der Service Bus-Warteschlangenendpunkte, an die IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet.

serviceBusTopics

RoutingServiceBusTopicEndpointProperties[]

Die Liste der Service Bus-Themenendpunkte, an die der IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet.

storageContainers

RoutingStorageContainerProperties[]

Die Liste der Speichercontainerendpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet.

RoutingEventHubProperties

Die Eigenschaften im Zusammenhang mit einem Event Hub-Endpunkt.

Name Typ Beschreibung
connectionString

string

Die Verbindungszeichenfolge des Event Hub-Endpunkts.

name

string

Der Name, der diesen Endpunkt identifiziert. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten und hat eine maximale Länge von 64 Zeichen. Die folgenden Namen sind reserviert: ereignisse, operationsMonitoringEvents, fileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein.

resourceGroup

string

Der Name der Ressourcengruppe des Event Hub-Endpunkts.

subscriptionId

string

Der Abonnementbezeichner des Event Hub-Endpunkts.

RoutingProperties

Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging

Name Typ Beschreibung
endpoints

RoutingEndpoints

Die Eigenschaften im Zusammenhang mit den benutzerdefinierten Endpunkten, an die Ihr IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. Maximal 10 benutzerdefinierte Endpunkte sind für alle Endpunkttypen für kostenpflichtige Hubs zulässig, und nur ein benutzerdefinierter Endpunkt ist für alle Endpunkttypen für kostenlose Hubs zulässig.

fallbackRoute

FallbackRouteProperties

Die Eigenschaften der Route, die als Fallbackroute verwendet wird, wenn keine der im Abschnitt "routen" angegebenen Bedingungen erfüllt ist. Dies ist ein optionaler Parameter. Wenn diese Eigenschaft nicht festgelegt ist, werden die Nachrichten, die keine der im Abschnitt "routen" angegebenen Bedingungen erfüllen, an den integrierten eventhub-Endpunkt weitergeleitet.

routes

RouteProperties[]

Die Liste der vom Benutzer bereitgestellten Routingregeln, die der IoT Hub verwendet, um Nachrichten an integrierte und benutzerdefinierte Endpunkte weiterzuleiten. Für kostenpflichtige Hubs sind maximal 100 Routingregeln und für kostenlose Hubs maximal 5 Routingregeln zulässig.

RoutingServiceBusQueueEndpointProperties

Die Eigenschaften im Zusammenhang mit Service Bus-Warteschlangenendpunkttypen.

Name Typ Beschreibung
connectionString

string

Die Verbindungszeichenfolge des Service Bus-Warteschlangenendpunkts.

name

string

Der Name, der diesen Endpunkt identifiziert. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten und hat eine maximale Länge von 64 Zeichen. Die folgenden Namen sind reserviert: ereignisse, operationsMonitoringEvents, fileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Warteschlangennamen identisch sein.

resourceGroup

string

Der Name der Ressourcengruppe des Service Bus-Warteschlangenendpunkts.

subscriptionId

string

Der Abonnementbezeichner des Service Bus-Warteschlangenendpunkts.

RoutingServiceBusTopicEndpointProperties

Die Eigenschaften im Zusammenhang mit Service Bus-Themenendpunkttypen.

Name Typ Beschreibung
connectionString

string

Die Verbindungszeichenfolge des Service Bus-Themenendpunkts.

name

string

Der Name, der diesen Endpunkt identifiziert. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten und hat eine maximale Länge von 64 Zeichen. Die folgenden Namen sind reserviert: ereignisse, operationsMonitoringEvents, fileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. Der Name muss nicht mit dem tatsächlichen Themennamen identisch sein.

resourceGroup

string

Der Name der Ressourcengruppe des Service Bus-Themenendpunkts.

subscriptionId

string

Der Abonnementbezeichner des Service Bus-Themenendpunkts.

RoutingSource

Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages.

Name Typ Beschreibung
DeviceJobLifecycleEvents

string

DeviceLifecycleEvents

string

DeviceMessages

string

Invalid

string

TwinChangeEvents

string

RoutingStorageContainerProperties

Die Eigenschaften im Zusammenhang mit einem Speichercontainerendpunkt.

Name Typ Beschreibung
batchFrequencyInSeconds

integer

Zeitintervall, in dem Blobs in den Speicher geschrieben werden. Der Wert sollte zwischen 60 und 720 Sekunden betragen. Der Standardwert ist 300 Sekunden.

connectionString

string

Der Verbindungszeichenfolge des Speicherkontos.

containerName

string

Der Name des Speichercontainers im Speicherkonto.

encoding

string

Codierung, die zum Serialisieren von Nachrichten in Blobs verwendet wird. Unterstützte Werte sind "avro" und "avroDeflate". Der Standardwert ist "avro".

fileNameFormat

string

Dateinamenformat für das Blob. Das Standardformat ist {iothub}/{partition}/{JJJJ}/{MM}/{DD}/{HH}/{mm}. Alle Parameter sind obligatorisch, können aber neu sortiert werden.

maxChunkSizeInBytes

integer

Maximale Anzahl von Bytes für jedes Blob, das in den Speicher geschrieben wurde. Der Wert sollte zwischen 10485760(10 MB) und 524288000(500 MB) liegen. Der Standardwert ist 314572800(300 MB).

name

string

Der Name, der diesen Endpunkt identifiziert. Der Name darf nur alphanumerische Zeichen, Punkte, Unterstriche, Bindestriche enthalten und hat eine maximale Länge von 64 Zeichen. Die folgenden Namen sind reserviert: ereignisse, operationsMonitoringEvents, fileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein.

resourceGroup

string

Der Name der Ressourcengruppe des Speicherkontos.

subscriptionId

string

Der Abonnementbezeichner des Speicherkontos.

SharedAccessSignatureAuthorizationRule

Die Eigenschaften einer IoT Hub-Richtlinie für freigegebenen Zugriff.

Name Typ Beschreibung
keyName

string

Der Name der SAS-Richtlinie.

primaryKey

string

Der primäre Schlüssel.

rights

AccessRights

Die berechtigungen, die der SAS-Richtlinie zugewiesen sind.

secondaryKey

string

Der sekundäre Schlüssel.

StorageEndpointProperties

Die Eigenschaften des Azure Storage-Endpunkts für den Dateiupload.

Name Typ Beschreibung
connectionString

string

Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden.

containerName

string

Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte aber mithilfe der angegebenen connectionString-Instanz erstellbar sein.

sasTtlAsIso8601

string

Der Zeitraum, für den der von IoT Hub für den Dateiupload generierte SAS-URI gültig ist. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options.