Iot Hub Resource - Update
Aktualisieren Sie vorhandene IoT Hubs-Tags.
Aktualisieren Sie ein vorhandenes IoT Hub-Tags. Um andere Felder zu aktualisieren, verwenden Sie die CreateOrUpdate-Methode
PATCH 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 |
Ressourcengruppenbezeichner. |
resource
|
path | True |
string |
Name des zu aktualisierenden iot Hubs. |
subscription
|
path | True |
string |
Die Abonnement-ID. |
api-version
|
query | True |
string |
Die Version der API. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
tags |
object |
Ressourcentags |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Iot Hub wurde erfolgreich aktualisiert |
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_Update
Beispielanforderung
Beispiel für eine Antwort
{
"id": "/subscriptions/ae24ff83-d2ca-4fc8-9717-05dae4bba489/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub",
"name": "testHub",
"type": "Microsoft.Devices/IotHubs",
"location": "centraluseuap",
"tags": {
"foo": "bar"
},
"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": {
"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
},
"systemData": {
"createdAt": "2021-01-30T00:28:38.963Z"
}
}
Definitionen
Name | Beschreibung |
---|---|
Access |
Die Berechtigungen, die der Shared Access-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 ioT hub aktiviert sind. |
Cloud |
Die Cloud-zu-Gerät-Messagingeigenschaften von IoT Hub. |
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 an Endpunkte anwendet. |
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 derzeit der IoT Hub 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 |
Der Abrechnungstarif 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 |
Netzwerkregelsatzeigenschaften von IotHub |
Private |
Die Eigenschaft des privaten Endpunkts einer privaten Endpunktverbindung |
Private |
Die private Endpunktverbindung eines IotHub |
Private |
Die Eigenschaften einer privaten Endpunktverbindung |
Private |
Der aktuelle Zustand 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 Routingeigenschaften 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 den 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. |
Tags |
Ein Container, der nur die Tags für eine Ressource enthält, sodass der Benutzer die Tags auf einer IoT Hub instance aktualisieren kann. |
AccessRights
Die Berechtigungen, die der Shared Access-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 ioT hub aktiviert sind.
Name | Typ | Beschreibung |
---|---|---|
DeviceManagement |
string |
|
None |
string |
CloudToDeviceProperties
Die Cloud-zu-Gerät-Messagingeigenschaften von IoT Hub.
Name | Typ | Beschreibung |
---|---|---|
defaultTtlAsIso8601 |
string |
Die Standardzeit 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 an Endpunkte anwendet.
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. |
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 Geräte-zu-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 |
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 Feld Etag ist nicht erforderlich. Wenn es im Antworttext angegeben wird, muss es auch als Header gemäß der normalen ETag-Konvention 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, die sich auf diese Ressource beziehen. |
|
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 derzeit der IoT Hub 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 aus Iot Hub. |
authorizationPolicies |
Die Richtlinien für den freigegebenen Zugriff, die Sie verwenden können, um eine Verbindung mit dem IoT Hub zu sichern. |
|
cloudToDevice |
Die Cloud-zu-Gerät-Messagingeigenschaften von IoT Hub. |
|
comments |
string |
IoT Hub-Kommentare. |
disableDeviceSAS |
boolean |
Wenn true, können alle sas-Bereichsschlüssel für alle Geräte (einschließlich Edgegeräte, aber mit Ausnahme von Modulen) nicht 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 alle modulbezogenen SAS-Schlüssel nicht für die Authentifizierung verwendet werden. |
enableDataResidency |
boolean |
Wenn diese Eigenschaft auf TRUE festgelegt ist, aktiviert sie die Datenresidenz, wodurch die Notfallwiederherstellung deaktiviert wird. |
enableFileUploadNotifications |
boolean |
Bei True sind Dateiuploadbenachrichtigungen aktiviert. |
eventHubEndpoints |
<string,
Event |
Die Event Hub-kompatiblen Endpunkteigenschaften. Die einzigen möglichen 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 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 |
Netzwerkregelsatzeigenschaften 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, ist der Ausgehende von IotHub nur auf die zulässigen FQDNs beschränkt, die über allowedFqdnList konfiguriert werden. |
routing |
Die Routingeigenschaften 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 denen 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 derzeit der IoT Hub 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 |
Der Abrechnungstarif für den IoT Hub. |
IotHubSkuTier
Der Abrechnungstarif 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 |
Die Anzahl der Versuche des IoT Hubs, 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
Netzwerkregelsatzeigenschaften 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 privaten Endpunktverbindung
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der Ressourcenbezeichner. |
PrivateEndpointConnection
Die private Endpunktverbindung eines IotHub
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der Ressourcenbezeichner. |
name |
string |
Der Name der Ressource. |
properties |
Die Eigenschaften einer privaten Endpunktverbindung |
|
type |
string |
Der Ressourcentyp. |
PrivateEndpointConnectionProperties
Die Eigenschaften einer privaten Endpunktverbindung
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Die Eigenschaft des privaten Endpunkts einer privaten Endpunktverbindung |
|
privateLinkServiceConnectionState |
Der aktuelle Zustand einer Verbindung mit einem privaten Endpunkt |
PrivateLinkServiceConnectionState
Der aktuelle Zustand 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 Zustand einer Verbindung mit einem privaten Endpunkt |
status |
Die status einer privaten Endpunktverbindung |
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 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 |
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 Routingeigenschaften 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 in der Vorlage nicht 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 zulässig, für kostenlose Hubs sind 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 den freigegebenen Zugriff.
Name | Typ | Beschreibung |
---|---|---|
keyName |
string |
Der Name der SAS-Richtlinie. |
primaryKey |
string |
Der primäre Schlüssel. |
rights |
Die Berechtigungen, die der Shared Access-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 mit dem angegebenen connectionString bestellbar 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. |
TagsResource
Ein Container, der nur die Tags für eine Ressource enthält, sodass der Benutzer die Tags auf einer IoT Hub instance aktualisieren kann.
Name | Typ | Beschreibung |
---|---|---|
tags |
object |
Ressourcentags |