Iot Hub Resource - Get
Rufen Sie die nicht sicherheitsbezogenen Metadaten eines IoT-Hubs ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2023-06-30
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die den IoT Hub enthält. |
resource
|
path | True |
string |
Der Name des IoT-Hubs. |
subscription
|
path | True |
string |
Die Abonnement-ID. |
api-version
|
query | True |
string |
Die Version der API. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Text enthält alle nicht sicherheitsrelevanten Eigenschaften des IoT-Hubs. Sicherheitsbezogene Eigenschaften sind auf NULL festgelegt. |
|
Other Status Codes |
DefaultErrorResponse |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
IotHubResource_Get
Beispielanforderung
Beispiel für eine Antwort
{
"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": {
"state": "Active",
"provisioningState": "Succeeded",
"ipFilterRules": [
{
"filterName": "rule1",
"action": "Accept",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Accept",
"ipMask": "157.55.59.128/25"
}
],
"networkRuleSets": {
"defaultAction": "Deny",
"applyToBuiltInEventHubEndpoint": true,
"ipRules": [
{
"filterName": "rule1",
"action": "Allow",
"ipMask": "131.117.159.53"
},
{
"filterName": "rule2",
"action": "Allow",
"ipMask": "157.55.59.128/25"
}
]
},
"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/"
}
},
"routing": {
"endpoints": {
"serviceBusQueues": [],
"serviceBusTopics": [],
"eventHubs": [],
"storageContainers": []
},
"routes": [],
"fallbackRoute": {
"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",
"locations": [
{
"location": "West US",
"role": "primary"
},
{
"location": "East US",
"role": "secondary"
}
],
"minTlsVersion": "1.2"
},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
},
"systemData": {
"createdAt": "2021-01-30T00:28:38.963Z"
}
}
Definitionen
Name | Beschreibung |
---|---|
Access |
Die berechtigungen, die der SAS-Richtlinie zugewiesen sind. |
Arm |
|
Arm |
|
Authentication |
Gibt den Authentifizierungstyp an, der zum Herstellen einer Verbindung mit dem Speicherkonto verwendet wird. |
authentication |
Methode zur Authentifizierung beim Service Bus-Warteschlangenendpunkt |
Capabilities |
Die Funktionen und Features, die für den IoT Hub aktiviert sind. |
Cloud |
Die IoT Hub-Cloud-zu-Gerät-Messagingeigenschaften. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Default |
Standardaktion für Den Netzwerkregelsatz |
Enrichment |
Die Eigenschaften einer Anreicherung, die Ihr IoT Hub auf Nachrichten anwendet, die an Endpunkte übermittelt werden. |
Error |
Fehlerdetails. |
Event |
Die Eigenschaften des bereitgestellten Event Hub-kompatiblen Endpunkts, der vom IoT Hub verwendet wird. |
Fallback |
Die Eigenschaften der Fallbackroute. IoT Hub verwendet diese Eigenschaften, wenn Nachrichten an den Fallbackendpunkt weitergeleitet werden. |
Feedback |
Die Eigenschaften der Feedbackwarteschlange für Cloud-zu-Gerät-Nachrichten. |
Iot |
Die Beschreibung des IoT-Hubs. |
Iot |
Öffentliche Darstellung eines der Standorte, an denen eine Ressource bereitgestellt wird. |
Iot |
Die Eigenschaften eines IoT-Hubs. |
Iot |
Die Rolle der Region kann entweder primär oder sekundär sein. In der primären Region wird der IoT Hub derzeit bereitgestellt. Die sekundäre Region ist die gekoppelte Azure-Notfallwiederherstellung (DR) und auch die Region, in die der IoT Hub ein Failover durchführen kann. |
Iot |
Der Name der SKU. |
Iot |
Informationen zur SKU des IoT Hubs. |
Iot |
Die Abrechnungsebene für den IoT Hub. |
Ip |
Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden. |
Ip |
Die IP-Filterregeln für den IoT Hub. |
Managed |
Die Eigenschaften der verwalteten Identität. |
Messaging |
Die Eigenschaften der Messagingendpunkte, die von diesem IoT Hub verwendet werden. |
Network |
IP-Filteraktion |
Network |
IP-Regel, die als Teil des Netzwerkregelsatzes angewendet werden soll |
Network |
Eigenschaften des Netzwerkregelsatzes von IotHub |
Private |
Die Eigenschaft des privaten Endpunkts einer Verbindung mit einem privaten Endpunkt |
Private |
Die Private Endpunktverbindung einer IotHub-Instanz |
Private |
Die Eigenschaften einer Verbindung mit einem privaten Endpunkt |
Private |
Der aktuelle Status einer Verbindung mit einem privaten Endpunkt |
Private |
Die status einer Verbindung mit einem privaten Endpunkt |
Public |
Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind |
Resource |
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. |
Route |
Die Eigenschaften einer Routingregel, die Ihr IoT Hub verwendet, um Nachrichten an Endpunkte weiterzuleiten. |
Routing |
Die Eigenschaften im Zusammenhang mit einem sql-Containerendpunkt von Cosmos DB. |
Routing |
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. |
Routing |
Die Eigenschaften im Zusammenhang mit einem Event Hub-Endpunkt. |
Routing |
Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
Routing |
Die Eigenschaften im Zusammenhang mit Service Bus-Warteschlangenendpunkttypen. |
Routing |
Die Eigenschaften im Zusammenhang mit Service Bus-Themenendpunkttypen. |
Routing |
Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages. |
Routing |
Die Eigenschaften im Zusammenhang mit einem Speichercontainerendpunkt. |
Shared |
Die Eigenschaften einer IoT Hub-Richtlinie für freigegebenen Zugriff. |
Storage |
Die Eigenschaften des Azure Storage-Endpunkts für den Dateiupload. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
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 |
ArmIdentity
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Prinzipal-ID |
tenantId |
string |
Mandanten-ID |
type |
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. |
|
userAssignedIdentities |
<string,
Arm |
ArmUserIdentity
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
|
principalId |
string |
AuthenticationType
Gibt den Authentifizierungstyp an, der zum Herstellen einer Verbindung mit dem Speicherkonto verwendet wird.
Name | Typ | Beschreibung |
---|---|---|
identityBased |
string |
|
keyBased |
string |
authenticationType
Methode zur Authentifizierung beim Service Bus-Warteschlangenendpunkt
Name | Typ | Beschreibung |
---|---|---|
identityBased |
string |
|
keyBased |
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 |
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. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Standardaktion für Den Netzwerkregelsatz
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
|
Deny |
string |
EnrichmentProperties
Die Eigenschaften einer Anreicherung, die Ihr IoT Hub auf Nachrichten anwendet, die an Endpunkte übermittelt werden.
Name | Typ | Beschreibung |
---|---|---|
endpointNames |
string[] |
Die Liste der Endpunkte, für die die Anreicherung auf die Nachricht angewendet wird. |
key |
string |
Der Schlüssel oder Name für die Anreicherungseigenschaft. |
value |
string |
Der Wert für die Anreicherungseigenschaft. |
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 als 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 ein 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 |
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 |
Gibt an, wie oft der IoT Hub versucht, 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. |
identity |
Die verwalteten Identitäten für IotHub. |
|
location |
string |
Der Ressourcenspeicherort. |
name |
string |
Der Name der Ressource. |
properties |
IotHub-Eigenschaften |
|
sku |
Informationen zur IotHub-SKU |
|
systemData |
Die Systemmetadaten zu dieser Ressource. |
|
tags |
object |
Die Ressourcentags. |
type |
string |
Der Ressourcentyp. |
IotHubLocationDescription
Öffentliche Darstellung eines der Standorte, an denen eine Ressource bereitgestellt wird.
Name | Typ | Beschreibung |
---|---|---|
location |
string |
Der Name der Azure-Region |
role |
Die Rolle der Region kann entweder primär oder sekundär sein. In der primären Region wird der IoT Hub derzeit bereitgestellt. Die sekundäre Region ist die gekoppelte Azure-Notfallwiederherstellung (DR) und auch die Region, in die der IoT Hub ein Failover durchführen kann. |
IotHubProperties
Die Eigenschaften eines IoT-Hubs.
Name | Typ | Beschreibung |
---|---|---|
allowedFqdnList |
string[] |
Liste der zulässigen FQDNs (vollqualifizierter Domänenname) für ausgehenden Datenverkehr von Iot Hub. |
authorizationPolicies |
Die Shared Access-Richtlinien, die Sie verwenden können, um eine Verbindung mit dem IoT Hub zu sichern. |
|
cloudToDevice |
Die IoT Hub-Cloud-zu-Gerät-Messagingeigenschaften. |
|
comments |
string |
IoT Hub-Kommentare. |
disableDeviceSAS |
boolean |
Wenn true, können nicht alle SAS-Bereichsschlüssel für Geräte (einschließlich Edgegeräte, aber mit Ausnahme von Modulen) für die Authentifizierung verwendet werden. |
disableLocalAuth |
boolean |
Wenn true, können SAS-Token mit iot hub-bereichsbezogenen SAS-Schlüsseln nicht für die Authentifizierung verwendet werden. |
disableModuleSAS |
boolean |
Wenn true, können nicht alle modulbezogenen SAS-Schlüssel für die Authentifizierung verwendet werden. |
enableDataResidency |
boolean |
Wenn diese Eigenschaft auf TRUE festgelegt ist, wird die Datenresidenz aktiviert, wodurch die Notfallwiederherstellung deaktiviert wird. |
enableFileUploadNotifications |
boolean |
True gibt an, dass Benachrichtigungen zum Hochladen von Dateien aktiviert sind. |
eventHubEndpoints |
<string,
Event |
Die Event Hub-kompatiblen Endpunkteigenschaften. Der einzige mögliche Schlüssel für dieses Wörterbuch sind Ereignisse. Dieser Schlüssel muss im Wörterbuch vorhanden sein, während Erstellungs- oder Aktualisierungsaufrufe für den IoT Hub ausgeführt werden. |
features |
Die Funktionen und Features, die für den IoT Hub aktiviert sind. |
|
hostName |
string |
Der Name des Hosts. |
ipFilterRules |
Die IP-Filterregeln. |
|
locations |
Primärer und sekundärer Standort für iot Hub |
|
messagingEndpoints |
<string,
Messaging |
Die Messagingendpunkteigenschaften für die Dateiuploadbenachrichtigungswarteschlange. |
minTlsVersion |
string |
Gibt die TLS-Mindestversion an, die für diesen Hub unterstützt werden soll. Kann auf "1.2" festgelegt werden, damit Clients, die eine TLS-Version unter 1.2 verwenden, abgelehnt werden. |
networkRuleSets |
Eigenschaften des Netzwerkregelsatzes von IotHub |
|
privateEndpointConnections |
Private Endpunktverbindungen, die auf diesem IotHub erstellt wurden |
|
provisioningState |
string |
Der Bereitstellungsstatus. |
publicNetworkAccess |
Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind |
|
restrictOutboundNetworkAccess |
boolean |
Wenn true, wird der ausgehende Datenverkehr von IotHub nur auf die zulässigen FQDNs beschränkt, die über allowedFqdnList konfiguriert sind. |
routing |
Die routingbezogenen Eigenschaften des IoT-Hubs. Siehe: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
|
state |
string |
Der Hubstatus. |
storageEndpoints |
<string,
Storage |
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. |
IotHubReplicaRoleType
Die Rolle der Region kann entweder primär oder sekundär sein. In der primären Region wird der IoT Hub derzeit bereitgestellt. Die sekundäre Region ist die gekoppelte Azure-Notfallwiederherstellung (DR) und auch die Region, in die der IoT Hub ein Failover durchführen kann.
Name | Typ | Beschreibung |
---|---|---|
primary |
string |
|
secondary |
string |
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 |
Der Name der SKU. |
|
tier |
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 |
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. |
ManagedIdentity
Die Eigenschaften der verwalteten Identität.
Name | Typ | Beschreibung |
---|---|---|
userAssignedIdentity |
string |
Die vom Benutzer zugewiesene Identität. |
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. |
NetworkRuleIPAction
IP-Filteraktion
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
NetworkRuleSetIpRule
IP-Regel, die als Teil des Netzwerkregelsatzes angewendet werden soll
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
action | Allow |
IP-Filteraktion |
|
filterName |
string |
Name der IP-Filterregel. |
|
ipMask |
string |
Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält. |
NetworkRuleSetProperties
Eigenschaften des Netzwerkregelsatzes von IotHub
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
applyToBuiltInEventHubEndpoint |
boolean |
Bei True wird der Netzwerkregelsatz auch auf BuiltIn EventHub EndPoint von IotHub angewendet. |
|
defaultAction | Deny |
Standardaktion für Den Netzwerkregelsatz |
|
ipRules |
Liste der IP-Regeln |
PrivateEndpoint
Die Eigenschaft des privaten Endpunkts einer Verbindung mit einem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der Ressourcenbezeichner. |
PrivateEndpointConnection
Die Private Endpunktverbindung einer IotHub-Instanz
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der Ressourcenbezeichner. |
name |
string |
Der Name der Ressource. |
properties |
Die Eigenschaften einer Verbindung mit einem privaten Endpunkt |
|
type |
string |
Der Ressourcentyp. |
PrivateEndpointConnectionProperties
Die Eigenschaften einer Verbindung mit einem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Die Eigenschaft des privaten Endpunkts einer Verbindung mit einem privaten Endpunkt |
|
privateLinkServiceConnectionState |
Der aktuelle Status einer Verbindung mit einem privaten Endpunkt |
PrivateLinkServiceConnectionState
Der aktuelle Status einer Verbindung mit einem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Für eine Verbindung mit einem privaten Endpunkt erforderliche Aktionen |
description |
string |
Die Beschreibung für den aktuellen Status einer Verbindung mit einem privaten Endpunkt |
status |
Die status einer Verbindung mit einem privaten Endpunkt |
PrivateLinkServiceConnectionStatus
Die status einer Verbindung mit einem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PublicNetworkAccess
Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ResourceIdentityType
Der Identitätstyp, der für die Ressource verwendet wird. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
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 standardmäßig 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 |
Die Quelle, auf die die Routingregel angewendet werden soll, z. B. DeviceMessages. |
RoutingCosmosDBSqlApiProperties
Die Eigenschaften im Zusammenhang mit einem sql-Containerendpunkt von Cosmos DB.
Name | Typ | Beschreibung |
---|---|---|
authenticationType |
Methode zur Authentifizierung beim sql-Containerendpunkt von Cosmos DB |
|
containerName |
string |
Der Name des cosmos DB-SQL-Containers in der cosmos DB-Datenbank. |
databaseName |
string |
Der Name der cosmos DB-Datenbank im cosmos DB-Konto. |
endpointUri |
string |
Die URL des cosmos DB-Kontos. Es muss das Protokoll enthalten https:// |
id |
string |
ID des sql-Containerendpunkts von Cosmos DB |
identity |
Eigenschaften der verwalteten Identität des Routings des Cosmos DB-Containerendpunkts. |
|
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: events, fileNotifications, $default. Endpunktnamen müssen für alle Endpunkttypen eindeutig sein. |
partitionKeyName |
string |
Der Name des Partitionsschlüssels, der diesem Cosmos DB-SQL-Container zugeordnet ist, sofern vorhanden. Dies ist ein optionaler Parameter. |
partitionKeyTemplate |
string |
Die Vorlage zum Generieren eines synthetischen Partitionsschlüsselwerts für die Verwendung mit diesem cosmos DB-SQL-Container. Die Vorlage muss mindestens einen der folgenden Platzhalter enthalten: {iothub}, {deviceid}, {DD}, {MM} und {YYYY}. Jeder Platzhalter kann höchstens einmal angegeben werden, aber Die Komponenten der Reihenfolge und nicht des Platzhalters sind beliebig. Dieser Parameter ist nur erforderlich, wenn PartitionKeyName angegeben ist. |
primaryKey |
string |
Der Primärschlüssel des cosmos DB-Kontos. |
resourceGroup |
string |
Der Name der Ressourcengruppe des cosmos DB-Kontos. |
secondaryKey |
string |
Der sekundäre Schlüssel des cosmos DB-Kontos. |
subscriptionId |
string |
Der Abonnementbezeichner des cosmos DB-Kontos. |
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 |
---|---|---|
cosmosDBSqlContainers |
Die Liste der Cosmos DB-Containerendpunkte, an die IoT Hub Nachrichten basierend auf den Routingregeln weiterleitet. |
|
eventHubs |
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 |
Die Liste der Service Bus-Warteschlangenendpunkte, an die IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet. |
|
serviceBusTopics |
Die Liste der Service Bus-Themenendpunkte, an die der IoT Hub die Nachrichten basierend auf den Routingregeln weiterleitet. |
|
storageContainers |
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 |
---|---|---|
authenticationType |
Methode zur Authentifizierung beim Event Hub-Endpunkt |
|
connectionString |
string |
Die Verbindungszeichenfolge des Event Hub-Endpunkts. |
endpointUri |
string |
Die URL des Event Hub-Endpunkts. Es muss das Protokoll enthalten sb:// |
entityPath |
string |
Event Hub-Name im Event Hub-Namespace |
id |
string |
ID des Event Hub-Endpunkts |
identity |
Eigenschaften der verwalteten Identität des Routing-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: events, 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 |
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. |
|
enrichments |
Die Liste der vom Benutzer bereitgestellten Anreicherungen, die der IoT Hub auf Nachrichten anwendet, die an integrierte und benutzerdefinierte Endpunkte übermittelt werden sollen. Siehe: https://aka.ms/telemetryoneventgrid |
|
fallbackRoute |
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 in der Vorlage vorhanden ist, ist die Fallbackroute standardmäßig deaktiviert. |
|
routes |
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 |
---|---|---|
authenticationType |
Methode zur Authentifizierung beim Service Bus-Warteschlangenendpunkt |
|
connectionString |
string |
Die Verbindungszeichenfolge des Service Bus-Warteschlangenendpunkts. |
endpointUri |
string |
Die URL des Service Bus-Warteschlangenendpunkts. Es muss das Protokoll enthalten sb:// |
entityPath |
string |
Warteschlangenname im Service Bus-Namespace |
id |
string |
ID des Service Bus-Warteschlangenendpunkts |
identity |
Verwaltete Identitätseigenschaften des Routingdienstbus-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: events, 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 |
---|---|---|
authenticationType |
Methode zur Authentifizierung beim Service Bus-Themenendpunkt |
|
connectionString |
string |
Die Verbindungszeichenfolge des Service Bus-Themenendpunkts. |
endpointUri |
string |
Die URL des Service Bus-Themenendpunkts. Es muss das Protokoll enthalten sb:// |
entityPath |
string |
Warteschlangenname im Service Bus-Thema |
id |
string |
ID des Service Bus-Themenendpunkts |
identity |
Verwaltete Identitätseigenschaften des Routing-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: events, 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 |
---|---|---|
DeviceConnectionStateEvents |
string |
|
DeviceJobLifecycleEvents |
string |
|
DeviceLifecycleEvents |
string |
|
DeviceMessages |
string |
|
Invalid |
string |
|
TwinChangeEvents |
string |
RoutingStorageContainerProperties
Die Eigenschaften im Zusammenhang mit einem Speichercontainerendpunkt.
Name | Typ | Beschreibung |
---|---|---|
authenticationType |
Methode zur Authentifizierung beim Speicherendpunkt |
|
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 |
Die Verbindungszeichenfolge des Speicherkontos. |
containerName |
string |
Der Name des Speichercontainers im Speicherkonto. |
encoding |
enum:
|
Codierung, die zum Serialisieren von Nachrichten in Blobs verwendet wird. Unterstützte Werte sind "avro", "avrodeflate" und "JSON". Der Standardwert ist "avro". |
endpointUri |
string |
Die URL des Speicherendpunkts. Es muss das Protokoll enthalten https:// |
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 angeordnet werden. |
id |
string |
ID des Speichercontainerendpunkts |
identity |
Verwaltete Identitätseigenschaften des Routingspeicherendpunkts. |
|
maxChunkSizeInBytes |
integer |
Maximale Anzahl von Bytes für jedes in den Speicher geschriebene Blob. Der Wert sollte zwischen 10485760(10MB) und 524288000(500MB) liegen. Der Standardwert ist 314572800(300MB). |
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: events, 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 |
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 |
---|---|---|
authenticationType |
Gibt den Authentifizierungstyp an, der zum Herstellen einer Verbindung mit dem Speicherkonto verwendet wird. |
|
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. |
identity |
Eigenschaften der verwalteten Identität des Speicherendpunkts für den Dateiupload. |
|
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. |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |