az iot hub routing-endpoint

Verwalten benutzerdefinierter Endpunkte einer IoT Hub-Instanz.

Befehle

az iot hub routing-endpoint create

Fügen Sie Ihrem IoT Hub einen Endpunkt hinzu.

az iot hub routing-endpoint delete

Löschen Sie alle oder erwähnten Endpunkte für Ihre IoT Hub.

az iot hub routing-endpoint list

Erhalten Sie Informationen zu allen Endpunkten für Ihre IoT Hub.

az iot hub routing-endpoint show

Erhalten Sie Informationen zu erwähnten Endpunkten für Ihre IoT Hub.

az iot hub routing-endpoint create

Fügen Sie Ihrem IoT Hub einen Endpunkt hinzu.

Erstellen Sie einen neuen benutzerdefinierten Endpunkt in Ihrem IoT Hub.

az iot hub routing-endpoint create --endpoint-name
                                   --endpoint-resource-group
                                   --endpoint-subscription-id
                                   --endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}
                                   --hub-name
                                   [--auth-type {identityBased, keyBased}]
                                   [--batch-frequency]
                                   [--chunk-size]
                                   [--connection-string]
                                   [--container]
                                   [--encoding {avro, json}]
                                   [--endpoint-uri]
                                   [--entity-path]
                                   [--ff]
                                   [--identity]
                                   [--resource-group]

Beispiele

Fügen Sie einen neuen Endpunkt "E2" vom Typ EventHub zu "MyIotHub" IoT Hub hinzu.

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name E2 --endpoint-type eventhub --endpoint-resource-group {ResourceGroup} --endpoint-subscription-id {SubscriptionId} --connection-string {ConnectionString}

Fügen Sie einen neuen Endpunkt "S1" vom Typ AzureStorageContainer zu "MyIotHub" IoT Hub hinzu.

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub \
--endpoint-name S1 --endpoint-type azurestoragecontainer --endpoint-resource-group "[Resource Group]" \
--endpoint-subscription-id {SubscriptionId} --connection-string {ConnectionString} \
--container-name {ContainerName} --batch-frequency 100 --chunk-size 100 \
--ff {iothub}-{partition}-{YYYY}-{MM}-{DD}-{HH}-{mm}

Hinzufügen eines neuen identitätsbasierten EventHub-Endpunkts mit dem Namen "EventHubIdentity" und authentifizieren mithilfe einer vom Benutzer zugewiesenen verwalteten Identität

az iot hub routing-endpoint create --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name EventHubIdentity --endpoint-type eventhub --endpoint-resource-group {ResourceGroup} --endpoint-subscription-id {SubscriptionId} --auth-type identityBased --identity {userIdentityResourceId} --endpoint-uri {EventHubEndpointUri} --entity-path {EntityPath}

Erforderliche Parameter

--endpoint-name --name -n

Name des Routingendpunkts.

--endpoint-resource-group --erg -r

Ressourcengruppe des Endpunktresoure.

--endpoint-subscription-id -s

AbonnementId der Endpunktressource.

--endpoint-type --type -t

Typ des Routingendpunkts.

Zulässige Werte: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub Name.

Optionale Parameter

--auth-type

Authentifizierungstyp für den Endpunkt. Die Standardeinstellung ist keyBased.

Zulässige Werte: identityBased, keyBased
--batch-frequency -b

Anforderung der Batchfrequenz in Sekunden. Die maximale Zeit, die abgelaufen werden kann, bevor Daten in einen Blob geschrieben werden können, zwischen 60 und 720 Sekunden.

Standardwert: 300
--chunk-size -w

Anfordern der Größe von Blöcken in Megabytes(MB). Die maximale Größe von Blobs, zwischen 10 und 500 MB.

Standardwert: 300
--connection-string -c

Verbindungszeichenfolge des Routingendpunkts.

--container --container-name

Name des Speichercontainers.

--encoding

Codierungsformat für den Container. Standardwert: AVRO. Beachten Sie, dass dieses Feld nur für Blobcontainerendpunkte anwendbar ist.

Zulässige Werte: avro, json
--endpoint-uri

Der URI der Endpunktressource.

--entity-path

Der Entitätspfad der Endpunktressource.

--ff --file-name-format

Dateinamenformat für das Blob. Das Dateinamenformat muss {iothub}, {partition}, {YYYY}, {MM}, {DD}, {HH} und {mm} Felder enthalten. Alle Parameter sind obligatorisch, können jedoch mit oder ohne Trennzeichen neu angeordnet werden.

Standardwert: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
--identity

Verwenden Sie eine vom System zugewiesene oder vom Benutzer zugewiesene verwaltete Identität für die Endpunktauthentifizierung. Verwenden Sie "[system]", um auf die vom System zugewiesene Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene Identität zu verweisen. Wenn Sie --auth-type ohne diesen Parameter verwenden, wird die verwaltete Identität des Systems angenommen.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az iot hub routing-endpoint delete

Löschen Sie alle oder erwähnten Endpunkte für Ihre IoT Hub.

Löschen Sie einen Endpunkt für Ihre IoT Hub. Es wird empfohlen, alle Routen an den Endpunkt zu löschen, bevor Sie den Endpunkt löschen.

az iot hub routing-endpoint delete [--endpoint-name]
                                   [--endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}]
                                   [--hub-name]
                                   [--ids]
                                   [--resource-group]

Beispiele

Löschen Sie endpunkt "E2" aus "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-name E2

Löschen Sie alle Endpunkte des Typs "EventHub" aus "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub --endpoint-type eventhub

Löschen Sie alle Endpunkte aus "MyIotHub" IoT Hub.

az iot hub routing-endpoint delete --resource-group MyResourceGroup --hub-name MyIotHub

Optionale Parameter

--endpoint-name --name -n

Name des Routingendpunkts.

--endpoint-type --type -t

Typ des Routingendpunkts.

Zulässige Werte: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az iot hub routing-endpoint list

Erhalten Sie Informationen zu allen Endpunkten für Ihre IoT Hub.

Erhalten Sie Informationen zu allen Endpunkten in Ihrem IoT Hub. Sie können auch angeben, welchen Endpunkttyp Sie informieren möchten.

az iot hub routing-endpoint list [--endpoint-type {azurestoragecontainer, eventhub, servicebusqueue, servicebustopic}]
                                 [--hub-name]
                                 [--ids]
                                 [--resource-group]

Beispiele

Rufen Sie alle Endpunkte von "MyIotHub" IoT Hub ab.

az iot hub routing-endpoint list -g MyResourceGroup --hub-name MyIotHub

Rufen Sie alle Endpunkte des Typs "EventHub" aus "MyIotHub" IoT Hub ab.

az iot hub routing-endpoint list -g MyResourceGroup --hub-name MyIotHub --endpoint-type eventhub

Optionale Parameter

--endpoint-type --type -t

Typ des Routingendpunkts.

Zulässige Werte: azurestoragecontainer, eventhub, servicebusqueue, servicebustopic
--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az iot hub routing-endpoint show

Erhalten Sie Informationen zu erwähnten Endpunkten für Ihre IoT Hub.

Erhalten Sie Informationen zu einem bestimmten Endpunkt in Ihrem IoT Hub.

az iot hub routing-endpoint show --endpoint-name
                                 [--hub-name]
                                 [--ids]
                                 [--resource-group]

Beispiele

Rufen Sie eine Endpunktinformationen von "MyIotHub" IoT Hub ab.

az iot hub routing-endpoint show --resource-group MyResourceGroup --hub-name MyIotHub \
--endpoint-name {endpointName}

Erforderliche Parameter

--endpoint-name --name -n

Name des Routingendpunkts.

Optionale Parameter

--hub-name

IoT Hub Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.