Iot Hub Resource - Get
Haal de niet-beveiligingsgerelateerde metagegevens van een IoT-hub op.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2023-06-30
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep die de IoT-hub bevat. |
resource
|
path | True |
string |
De naam van de IoT-hub. |
subscription
|
path | True |
string |
De abonnement-ID. |
api-version
|
query | True |
string |
De versie van de API. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De hoofdtekst bevat alle niet-beveiligingseigenschappen van de IoT-hub. Beveiligingsgerelateerde eigenschappen worden ingesteld op null. |
|
Other Status Codes |
DefaultErrorResponse |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
IotHubResource_Get
Voorbeeldaanvraag
Voorbeeldrespons
{
"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"
}
}
Definities
Name | Description |
---|---|
Access |
De machtigingen die zijn toegewezen aan het beleid voor gedeelde toegang. |
Arm |
|
Arm |
|
Authentication |
Hiermee geeft u het verificatietype op dat wordt gebruikt voor het maken van verbinding met het opslagaccount. |
authentication |
Methode die wordt gebruikt voor verificatie op basis van het eindpunt van de Service Bus-wachtrij |
Capabilities |
De mogelijkheden en functies die zijn ingeschakeld voor de IoT-hub. |
Cloud |
De eigenschappen voor cloud-naar-apparaat-berichten van IoT Hub. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Default |
Standaardactie voor netwerkregelset |
Enrichment |
De eigenschappen van een verrijking die uw IoT-hub toepast op berichten die aan eindpunten worden geleverd. |
Error |
Foutdetails. |
Event |
De eigenschappen van het ingerichte Event Hub-compatibele eindpunt dat wordt gebruikt door de IoT-hub. |
Fallback |
De eigenschappen van de terugvalroute. IoT Hub gebruikt deze eigenschappen wanneer berichten worden gerouteerd naar het terugvaleindpunt. |
Feedback |
De eigenschappen van de feedbackwachtrij voor cloud-naar-apparaat-berichten. |
Iot |
De beschrijving van de IoT-hub. |
Iot |
Openbare weergave van een van de locaties waar een resource is ingericht. |
Iot |
De eigenschappen van een IoT-hub. |
Iot |
De rol van de regio kan primair of secundair zijn. De primaire regio is waar de IoT-hub momenteel is ingericht. De secundaire regio is de gekoppelde azure-regio voor herstel na noodgevallen en ook de regio waarnaar de IoT-hub een failover kan uitvoeren. |
Iot |
De naam van de SKU. |
Iot |
Informatie over de SKU van de IoT-hub. |
Iot |
De factureringslaag voor de IoT-hub. |
Ip |
De gewenste actie voor aanvragen die door deze regel zijn vastgelegd. |
Ip |
De IP-filterregels voor de IoT-hub. |
Managed |
De eigenschappen van de beheerde identiteit. |
Messaging |
De eigenschappen van de berichteneindpunten die door deze IoT-hub worden gebruikt. |
Network |
IP-filteractie |
Network |
IP-regel die moet worden toegepast als onderdeel van de netwerkregelset |
Network |
Eigenschappen van set netwerkregels van IotHub |
Private |
De eigenschap privé-eindpunt van een privé-eindpuntverbinding |
Private |
De privé-eindpuntverbinding van een IotHub |
Private |
De eigenschappen van een privé-eindpuntverbinding |
Private |
De huidige status van een privé-eindpuntverbinding |
Private |
De status van een privé-eindpuntverbinding |
Public |
Of aanvragen van openbaar netwerk zijn toegestaan |
Resource |
Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten uit de service verwijderd. |
Route |
De eigenschappen van een routeringsregel die door uw IoT-hub wordt gebruikt om berichten naar eindpunten te routeren. |
Routing |
De eigenschappen met betrekking tot een cosmos DB SQL-containereindpunt. |
Routing |
De eigenschappen met betrekking tot de aangepaste eindpunten waarnaar uw IoT-hub berichten routeert op basis van de routeringsregels. Er zijn maximaal 10 aangepaste eindpunten toegestaan voor alle eindpunttypen voor betaalde hubs en slechts 1 aangepast eindpunt is toegestaan voor alle eindpunttypen voor gratis hubs. |
Routing |
De eigenschappen met betrekking tot een Event Hub-eindpunt. |
Routing |
De routeringsgerelateerde eigenschappen van de IoT-hub. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
Routing |
De eigenschappen met betrekking tot eindpunttypen van de Service Bus-wachtrij. |
Routing |
De eigenschappen met betrekking tot eindpunttypen voor Service Bus-onderwerpen. |
Routing |
De bron waarop de regel voor doorsturen moet worden toegepast, zoals DeviceMessages. |
Routing |
De eigenschappen met betrekking tot een eindpunt van een opslagcontainer. |
Shared |
De eigenschappen van een gedeeld toegangsbeleid voor IoT Hub. |
Storage |
De eigenschappen van het Azure Storage-eindpunt voor het uploaden van bestanden. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
AccessRights
De machtigingen die zijn toegewezen aan het beleid voor gedeelde toegang.
Waarde | Description |
---|---|
DeviceConnect | |
RegistryRead | |
RegistryRead, DeviceConnect | |
RegistryRead, RegistryWrite | |
RegistryRead, RegistryWrite, DeviceConnect | |
RegistryRead, RegistryWrite, ServiceConnect | |
RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect | |
RegistryRead, ServiceConnect | |
RegistryRead, ServiceConnect, DeviceConnect | |
RegistryWrite | |
RegistryWrite, DeviceConnect | |
RegistryWrite, ServiceConnect | |
RegistryWrite, ServiceConnect, DeviceConnect | |
ServiceConnect | |
ServiceConnect, DeviceConnect |
ArmIdentity
Name | Type | Description |
---|---|---|
principalId |
string |
Principal-id |
tenantId |
string |
Tenant-id |
type |
Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten uit de service verwijderd. |
|
userAssignedIdentities |
<string,
Arm |
ArmUserIdentity
Name | Type | Description |
---|---|---|
clientId |
string |
|
principalId |
string |
AuthenticationType
Hiermee geeft u het verificatietype op dat wordt gebruikt voor het maken van verbinding met het opslagaccount.
Waarde | Description |
---|---|
identityBased | |
keyBased |
authenticationType
Methode die wordt gebruikt voor verificatie op basis van het eindpunt van de Service Bus-wachtrij
Waarde | Description |
---|---|
identityBased | |
keyBased |
Capabilities
De mogelijkheden en functies die zijn ingeschakeld voor de IoT-hub.
Waarde | Description |
---|---|
DeviceManagement | |
None |
CloudToDeviceProperties
De eigenschappen voor cloud-naar-apparaat-berichten van IoT Hub.
Name | Type | Description |
---|---|---|
defaultTtlAsIso8601 |
string (duration) |
De standaardtijd voor live voor cloud-naar-apparaat-berichten in de apparaatwachtrij. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
feedback |
De eigenschappen van de feedbackwachtrij voor cloud-naar-apparaat-berichten. |
|
maxDeliveryCount |
integer (int32) minimum: 1maximum: 100 |
Het maximale aantal bezorgingen voor cloud-naar-apparaat-berichten in de apparaatwachtrij. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Waarde | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DefaultAction
Standaardactie voor netwerkregelset
Waarde | Description |
---|---|
Allow | |
Deny |
EnrichmentProperties
De eigenschappen van een verrijking die uw IoT-hub toepast op berichten die aan eindpunten worden geleverd.
Name | Type | Description |
---|---|---|
endpointNames |
string[] |
De lijst met eindpunten waarvoor de verrijking wordt toegepast op het bericht. |
key |
string |
De sleutel of naam voor de verrijkingseigenschap. |
value |
string |
De waarde voor de verrijkingseigenschap. |
ErrorDetails
Foutdetails.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
details |
string |
De foutdetails. |
httpStatusCode |
string |
De HTTP-statuscode. |
message |
string |
Het foutbericht. |
EventHubProperties
De eigenschappen van het ingerichte Event Hub-compatibele eindpunt dat wordt gebruikt door de IoT-hub.
Name | Type | Description |
---|---|---|
endpoint |
string |
Het event hub-compatibele eindpunt. |
partitionCount |
integer (int32) |
Het aantal partities voor het ontvangen van apparaat-naar-cloud-berichten in het event hub-compatibele eindpunt. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages. |
partitionIds |
string[] |
De partitie-id's in het event hub-compatibele eindpunt. |
path |
string |
De naam die compatibel is met Event Hub. |
retentionTimeInDays |
integer (int64) |
De bewaartijd voor apparaat-naar-cloud-berichten in dagen. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#device-to-cloud-messages |
FallbackRouteProperties
De eigenschappen van de terugvalroute. IoT Hub gebruikt deze eigenschappen wanneer berichten worden gerouteerd naar het terugvaleindpunt.
Name | Type | Description |
---|---|---|
condition |
string |
De voorwaarde die wordt geëvalueerd om de terugvalroute toe te passen. Als de voorwaarde niet is opgegeven, wordt standaard geëvalueerd of waar is. Zie voor grammatica: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames |
string[] |
De lijst met eindpunten waarnaar de berichten waaraan de voorwaarde voldoet, worden doorgestuurd. Momenteel is slechts één eindpunt toegestaan. |
isEnabled |
boolean |
Wordt gebruikt om op te geven of de terugvalroute is ingeschakeld. |
name |
string |
De naam van de route. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes bevatten, mag maximaal 64 tekens lang zijn en moet uniek zijn. |
source |
De bron waarop de regel voor doorsturen moet worden toegepast. Bijvoorbeeld DeviceMessages |
FeedbackProperties
De eigenschappen van de feedbackwachtrij voor cloud-naar-apparaat-berichten.
Name | Type | Description |
---|---|---|
lockDurationAsIso8601 |
string (duration) |
De vergrendelingsduur voor de feedbackwachtrij. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
maxDeliveryCount |
integer (int32) minimum: 1maximum: 100 |
Het aantal keren dat de IoT-hub een bericht probeert te bezorgen in de feedbackwachtrij. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
ttlAsIso8601 |
string (duration) |
De periode waarvoor een bericht beschikbaar is om te gebruiken voordat het is verlopen door de IoT-hub. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging#cloud-to-device-messages. |
IotHubDescription
De beschrijving van de IoT-hub.
Name | Type | Description |
---|---|---|
etag |
string |
Het veld Etag is niet vereist. Als deze is opgegeven in de hoofdtekst van het antwoord, moet deze ook worden opgegeven als een header volgens de normale ETag-conventie. |
id |
string |
De resource-id. |
identity |
De beheerde identiteiten voor de IotHub. |
|
location |
string |
De resourcelocatie. |
name |
string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$ |
De resourcenaam. |
properties |
IotHub-eigenschappen |
|
sku |
IotHub-SKU-gegevens |
|
systemData |
De systeemmetagegevens met betrekking tot deze resource. |
|
tags |
object |
De resourcetags. |
type |
string |
Het resourcetype. |
IotHubLocationDescription
Openbare weergave van een van de locaties waar een resource is ingericht.
Name | Type | Description |
---|---|---|
location |
string |
De naam van de Azure-regio |
role |
De rol van de regio kan primair of secundair zijn. De primaire regio is waar de IoT-hub momenteel is ingericht. De secundaire regio is de gekoppelde azure-regio voor herstel na noodgevallen en ook de regio waarnaar de IoT-hub een failover kan uitvoeren. |
IotHubProperties
De eigenschappen van een IoT-hub.
Name | Type | Description |
---|---|---|
allowedFqdnList |
string[] |
Lijst met toegestane FQDN's (Fully Qualified Domain Name) voor uitgaand verkeer van IoT Hub. |
authorizationPolicies |
Het beleid voor gedeelde toegang dat u kunt gebruiken om een verbinding met de IoT-hub te beveiligen. |
|
cloudToDevice |
De eigenschappen voor cloud-naar-apparaat-berichten van IoT Hub. |
|
comments |
string |
Opmerkingen bij IoT Hub. |
disableDeviceSAS |
boolean |
Indien waar, kunnen alle apparaten (inclusief Edge-apparaten, maar met uitzondering van modules) sas-sleutels binnen het bereik niet worden gebruikt voor verificatie. |
disableLocalAuth |
boolean |
Indien waar, kunnen SAS-tokens met sas-sleutels met ioT-bereik niet worden gebruikt voor verificatie. |
disableModuleSAS |
boolean |
Indien waar, kunnen alle SAS-sleutels met modulebereik niet worden gebruikt voor verificatie. |
enableDataResidency |
boolean |
Met deze eigenschap wanneer deze is ingesteld op true, wordt gegevenslocatie ingeschakeld, waardoor herstel na noodgevallen wordt uitgeschakeld. |
enableFileUploadNotifications |
boolean |
Indien waar, worden meldingen voor het uploaden van bestanden ingeschakeld. |
eventHubEndpoints |
<string,
Event |
De eigenschappen van het Event Hub-compatibele eindpunt. De enige mogelijke sleutels voor deze woordenlijst zijn gebeurtenissen. Deze sleutel moet aanwezig zijn in de woordenlijst tijdens het maken of bijwerken van aanroepen voor de IoT-hub. |
features |
De mogelijkheden en functies die zijn ingeschakeld voor de IoT-hub. |
|
hostName |
string |
De naam van de host. |
ipFilterRules |
De IP-filterregels. |
|
locations |
Primaire en secundaire locatie voor ioT-hub |
|
messagingEndpoints |
<string,
Messaging |
De eigenschappen van het berichteindpunt voor de meldingswachtrij voor het uploaden van bestanden. |
minTlsVersion |
string |
Hiermee geeft u de minimale TLS-versie op die moet worden ondersteund voor deze hub. Kan worden ingesteld op '1.2' om clients te hebben die een TLS-versie lager dan 1.2 gebruiken om te worden geweigerd. |
networkRuleSets |
Eigenschappen van set netwerkregels van IotHub |
|
privateEndpointConnections |
Privé-eindpuntverbindingen die zijn gemaakt op deze IotHub |
|
provisioningState |
string |
De inrichtingsstatus. |
publicNetworkAccess |
Of aanvragen van openbaar netwerk zijn toegestaan |
|
restrictOutboundNetworkAccess |
boolean |
Indien waar, worden uitgaand verkeer van IotHub beperkt tot alleen de toegestane FQDN's die zijn geconfigureerd via allowedFqdnList. |
routing |
De routeringsgerelateerde eigenschappen van de IoT-hub. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging |
|
state |
string |
De hubstatus. |
storageEndpoints |
<string,
Storage |
De lijst met Azure Storage-eindpunten waar u bestanden kunt uploaden. Op dit moment kunt u slechts één Azure Storage-account configureren en dat moet de sleutel hebben als $default. Als u meer dan één opslagaccount opgeeft, wordt er een fout gegenereerd. Als de eigenschap enableFileUploadNotifications is ingesteld op True, wordt er geen waarde opgegeven voor deze eigenschap. Er wordt een fout gegenereerd. |
IotHubReplicaRoleType
De rol van de regio kan primair of secundair zijn. De primaire regio is waar de IoT-hub momenteel is ingericht. De secundaire regio is de gekoppelde azure-regio voor herstel na noodgevallen en ook de regio waarnaar de IoT-hub een failover kan uitvoeren.
Waarde | Description |
---|---|
primary | |
secondary |
IotHubSku
De naam van de SKU.
Waarde | Description |
---|---|
B1 | |
B2 | |
B3 | |
F1 | |
S1 | |
S2 | |
S3 |
IotHubSkuInfo
Informatie over de SKU van de IoT-hub.
Name | Type | Description |
---|---|---|
capacity |
integer (int64) |
Het aantal ingerichte IoT Hub-eenheden. Zie: https://docs.microsoft.com/azure/azure-subscription-service-limits#iot-hub-limits. |
name |
De naam van de SKU. |
|
tier |
De factureringslaag voor de IoT-hub. |
IotHubSkuTier
De factureringslaag voor de IoT-hub.
Waarde | Description |
---|---|
Basic | |
Free | |
Standard |
IpFilterActionType
De gewenste actie voor aanvragen die door deze regel zijn vastgelegd.
Waarde | Description |
---|---|
Accept | |
Reject |
IpFilterRule
De IP-filterregels voor de IoT-hub.
Name | Type | Description |
---|---|---|
action |
De gewenste actie voor aanvragen die door deze regel zijn vastgelegd. |
|
filterName |
string |
De naam van de IP-filterregel. |
ipMask |
string |
Een tekenreeks die het IP-adresbereik in CIDR-notatie voor de regel bevat. |
ManagedIdentity
De eigenschappen van de beheerde identiteit.
Name | Type | Description |
---|---|---|
userAssignedIdentity |
string |
De door de gebruiker toegewezen identiteit. |
MessagingEndpointProperties
De eigenschappen van de berichteneindpunten die door deze IoT-hub worden gebruikt.
Name | Type | Description |
---|---|---|
lockDurationAsIso8601 |
string (duration) |
De duur van de vergrendeling. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
maxDeliveryCount |
integer (int32) minimum: 1maximum: 100 |
Het aantal keren dat de IoT-hub een bericht probeert te bezorgen. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
ttlAsIso8601 |
string (duration) |
De periode waarvoor een bericht beschikbaar is om te gebruiken voordat het is verlopen door de IoT-hub. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload. |
NetworkRuleIPAction
IP-filteractie
Waarde | Description |
---|---|
Allow |
NetworkRuleSetIpRule
IP-regel die moet worden toegepast als onderdeel van de netwerkregelset
Name | Type | Default value | Description |
---|---|---|---|
action | Allow |
IP-filteractie |
|
filterName |
string |
Naam van de IP-filterregel. |
|
ipMask |
string |
Een tekenreeks die het IP-adresbereik in CIDR-notatie voor de regel bevat. |
NetworkRuleSetProperties
Eigenschappen van set netwerkregels van IotHub
Name | Type | Default value | Description |
---|---|---|---|
applyToBuiltInEventHubEndpoint |
boolean |
Indien waar, wordt de netwerkregelset ook toegepast op builtIn EventHub EndPoint van IotHub |
|
defaultAction | Deny |
Standaardactie voor netwerkregelset |
|
ipRules |
Lijst met IP-regels |
PrivateEndpoint
De eigenschap privé-eindpunt van een privé-eindpuntverbinding
Name | Type | Description |
---|---|---|
id |
string |
De resource-id. |
PrivateEndpointConnection
De privé-eindpuntverbinding van een IotHub
Name | Type | Description |
---|---|---|
id |
string |
De resource-id. |
name |
string |
De resourcenaam. |
properties |
De eigenschappen van een privé-eindpuntverbinding |
|
type |
string |
Het resourcetype. |
PrivateEndpointConnectionProperties
De eigenschappen van een privé-eindpuntverbinding
Name | Type | Description |
---|---|---|
privateEndpoint |
De eigenschap privé-eindpunt van een privé-eindpuntverbinding |
|
privateLinkServiceConnectionState |
De huidige status van een privé-eindpuntverbinding |
PrivateLinkServiceConnectionState
De huidige status van een privé-eindpuntverbinding
Name | Type | Description |
---|---|---|
actionsRequired |
string |
Acties die vereist zijn voor een privé-eindpuntverbinding |
description |
string |
De beschrijving voor de huidige status van een privé-eindpuntverbinding |
status |
De status van een privé-eindpuntverbinding |
PrivateLinkServiceConnectionStatus
De status van een privé-eindpuntverbinding
Waarde | Description |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
PublicNetworkAccess
Of aanvragen van openbaar netwerk zijn toegestaan
Waarde | Description |
---|---|
Disabled | |
Enabled |
ResourceIdentityType
Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten uit de service verwijderd.
Waarde | Description |
---|---|
None | |
SystemAssigned | |
SystemAssigned, UserAssigned | |
UserAssigned |
RouteProperties
De eigenschappen van een routeringsregel die door uw IoT-hub wordt gebruikt om berichten naar eindpunten te routeren.
Name | Type | Description |
---|---|---|
condition |
string |
De voorwaarde die wordt geëvalueerd om de routeringsregel toe te passen. Als er geen voorwaarde is opgegeven, wordt standaard geëvalueerd of waar is. Zie voor grammatica: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames |
string[] |
De lijst met eindpunten waarnaar berichten die voldoen aan de voorwaarde, worden gerouteerd. Op dit moment is slechts één eindpunt toegestaan. |
isEnabled |
boolean |
Wordt gebruikt om op te geven of een route is ingeschakeld. |
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam van de route. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes bevatten, mag maximaal 64 tekens lang zijn en moet uniek zijn. |
source |
De bron waarop de regel voor doorsturen moet worden toegepast, zoals DeviceMessages. |
RoutingCosmosDBSqlApiProperties
De eigenschappen met betrekking tot een cosmos DB SQL-containereindpunt.
Name | Type | Description |
---|---|---|
authenticationType |
Methode die wordt gebruikt voor verificatie op basis van het cosmos DB SQL-containereindpunt |
|
containerName |
string |
De naam van de cosmos DB SQL-container in de cosmos DB-database. |
databaseName |
string |
De naam van de cosmos DB-database in het cosmos DB-account. |
endpointUri |
string (uri) |
De URL van het Cosmos DB-account. Het moet het protocol bevatten https:// |
id |
string |
Id van het cosmos DB SQL-containereindpunt |
identity |
Eigenschappen van beheerde identiteit van het routeren van cosmos DB-containereindpunt. |
|
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam die dit eindpunt identificeert. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes en maximaal 64 tekens bevatten. De volgende namen zijn gereserveerd: gebeurtenissen, fileNotifications, $default. Eindpuntnamen moeten uniek zijn voor eindpunttypen. |
partitionKeyName |
string |
De naam van de partitiesleutel die is gekoppeld aan deze cosmos DB SQL-container als deze bestaat. Dit is een optionele parameter. |
partitionKeyTemplate |
string |
De sjabloon voor het genereren van een synthetische partitiesleutelwaarde voor gebruik met deze cosmos DB SQL-container. De sjabloon moet ten minste een van de volgende tijdelijke aanduidingen bevatten: {iothub}, {deviceid}, {DD}, {MM} en {JJJJ}. Elke tijdelijke aanduiding kan maximaal één keer worden opgegeven, maar volgorde en niet-tijdelijke aanduidingen zijn willekeurig. Deze parameter is alleen vereist als PartitionKeyName is opgegeven. |
primaryKey |
string |
De primaire sleutel van het Cosmos DB-account. |
resourceGroup |
string |
De naam van de resourcegroep van het Cosmos DB-account. |
secondaryKey |
string |
De secundaire sleutel van het cosmos DB-account. |
subscriptionId |
string |
De abonnements-id van het cosmos DB-account. |
RoutingEndpoints
De eigenschappen met betrekking tot de aangepaste eindpunten waarnaar uw IoT-hub berichten routeert op basis van de routeringsregels. Er zijn maximaal 10 aangepaste eindpunten toegestaan voor alle eindpunttypen voor betaalde hubs en slechts 1 aangepast eindpunt is toegestaan voor alle eindpunttypen voor gratis hubs.
Name | Type | Description |
---|---|---|
cosmosDBSqlContainers |
De lijst met Cosmos DB-containereindpunten waarnaar IoT Hub berichten routeert op basis van de routeringsregels. |
|
eventHubs |
De lijst met Event Hubs-eindpunten waarnaar IoT Hub berichten routeert op basis van de routeringsregels. Deze lijst bevat niet het ingebouwde Event Hubs-eindpunt. |
|
serviceBusQueues |
De lijst met Service Bus-wachtrijeindpunten waarnaar ioT Hub de berichten routeert op basis van de routeringsregels. |
|
serviceBusTopics |
De lijst met Service Bus-onderwerpeindpunten waarnaar de IoT-hub de berichten routeert, op basis van de routeringsregels. |
|
storageContainers |
De lijst met opslagcontainereindpunten waarnaar IoT Hub berichten routeert op basis van de routeringsregels. |
RoutingEventHubProperties
De eigenschappen met betrekking tot een Event Hub-eindpunt.
Name | Type | Description |
---|---|---|
authenticationType |
Methode die wordt gebruikt voor verificatie op basis van het Event Hub-eindpunt |
|
connectionString |
string |
De verbindingsreeks van het Event Hub-eindpunt. |
endpointUri |
string |
De URL van het Event Hub-eindpunt. Het moet het protocol sb:// bevatten |
entityPath |
string |
Event Hub-naam in de Event Hub-naamruimte |
id |
string |
Id van het Event Hub-eindpunt |
identity |
Eigenschappen van beheerde identiteit van het eindpunt van de Event Hub routeren. |
|
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam die dit eindpunt identificeert. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes en maximaal 64 tekens bevatten. De volgende namen zijn gereserveerd: gebeurtenissen, fileNotifications, $default. Eindpuntnamen moeten uniek zijn voor eindpunttypen. |
resourceGroup |
string |
De naam van de resourcegroep van het Event Hub-eindpunt. |
subscriptionId |
string |
De abonnements-id van het Event Hub-eindpunt. |
RoutingProperties
De routeringsgerelateerde eigenschappen van de IoT-hub. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messaging
Name | Type | Description |
---|---|---|
endpoints |
De eigenschappen met betrekking tot de aangepaste eindpunten waarnaar uw IoT-hub berichten routeert op basis van de routeringsregels. Er zijn maximaal 10 aangepaste eindpunten toegestaan voor alle eindpunttypen voor betaalde hubs en slechts 1 aangepast eindpunt is toegestaan voor alle eindpunttypen voor gratis hubs. |
|
enrichments |
De lijst met door de gebruiker geleverde verrijkingen die de IoT-hub toepast op berichten die moeten worden geleverd aan ingebouwde en aangepaste eindpunten. Zie: https://aka.ms/telemetryoneventgrid |
|
fallbackRoute |
De eigenschappen van de route die wordt gebruikt als een terugvalroute wanneer aan geen van de voorwaarden in de sectie Routes wordt voldaan. Dit is een optionele parameter. Wanneer deze eigenschap niet aanwezig is in de sjabloon, is de terugvalroute standaard uitgeschakeld. |
|
routes |
De lijst met door de gebruiker verstrekte routeringsregels die door de IoT-hub worden gebruikt om berichten te routeren naar ingebouwde en aangepaste eindpunten. Er zijn maximaal 100 routeringsregels toegestaan voor betaalde hubs en er zijn maximaal 5 routeringsregels toegestaan voor gratis hubs. |
RoutingServiceBusQueueEndpointProperties
De eigenschappen met betrekking tot eindpunttypen van de Service Bus-wachtrij.
Name | Type | Description |
---|---|---|
authenticationType |
Methode die wordt gebruikt voor verificatie op basis van het eindpunt van de Service Bus-wachtrij |
|
connectionString |
string |
De verbindingsreeks van het service bus-wachtrijeindpunt. |
endpointUri |
string |
De URL van het service bus-wachtrijeindpunt. Het moet het protocol sb:// bevatten |
entityPath |
string |
Wachtrijnaam in de Service Bus-naamruimte |
id |
string |
Id van het service bus-wachtrijeindpunt |
identity |
Eigenschappen van beheerde identiteit van het eindpunt van de service bus-wachtrij. |
|
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam die dit eindpunt identificeert. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes en maximaal 64 tekens bevatten. De volgende namen zijn gereserveerd: gebeurtenissen, fileNotifications, $default. Eindpuntnamen moeten uniek zijn voor eindpunttypen. De naam hoeft niet hetzelfde te zijn als de werkelijke wachtrijnaam. |
resourceGroup |
string |
De naam van de resourcegroep van het service bus-wachtrijeindpunt. |
subscriptionId |
string |
De abonnements-id van het service bus-wachtrijeindpunt. |
RoutingServiceBusTopicEndpointProperties
De eigenschappen met betrekking tot eindpunttypen voor Service Bus-onderwerpen.
Name | Type | Description |
---|---|---|
authenticationType |
Methode die wordt gebruikt voor verificatie op basis van het service bus-onderwerpeindpunt |
|
connectionString |
string |
De verbindingsreeks van het service bus-onderwerpeindpunt. |
endpointUri |
string |
De URL van het service bus-onderwerpeindpunt. Het moet het protocol sb:// bevatten |
entityPath |
string |
Wachtrijnaam in het Service Bus-onderwerp |
id |
string |
Id van het service bus-onderwerpeindpunt |
identity |
Beheerde identiteiteigenschappen van het eindpunt van het routeren van Service Bus-onderwerp. |
|
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam die dit eindpunt identificeert. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes en maximaal 64 tekens bevatten. De volgende namen zijn gereserveerd: gebeurtenissen, fileNotifications, $default. Eindpuntnamen moeten uniek zijn voor eindpunttypen. De naam hoeft niet hetzelfde te zijn als de werkelijke onderwerpnaam. |
resourceGroup |
string |
De naam van de resourcegroep van het service bus-onderwerpeindpunt. |
subscriptionId |
string |
De abonnements-id van het service bus-onderwerpeindpunt. |
RoutingSource
De bron waarop de regel voor doorsturen moet worden toegepast, zoals DeviceMessages.
Waarde | Description |
---|---|
DeviceConnectionStateEvents | |
DeviceJobLifecycleEvents | |
DeviceLifecycleEvents | |
DeviceMessages | |
Invalid | |
TwinChangeEvents |
RoutingStorageContainerProperties
De eigenschappen met betrekking tot een eindpunt van een opslagcontainer.
Name | Type | Description |
---|---|---|
authenticationType |
Methode die wordt gebruikt voor verificatie op basis van het opslageindpunt |
|
batchFrequencyInSeconds |
integer (int32) minimum: 60maximum: 720 |
Tijdsinterval waarmee blobs naar de opslag worden geschreven. De waarde moet tussen 60 en 720 seconden zijn. De standaardwaarde is 300 seconden. |
connectionString |
string |
De verbindingsreeks van het opslagaccount. |
containerName |
string |
De naam van de opslagcontainer in het opslagaccount. |
encoding |
enum:
|
Codering die wordt gebruikt voor het serialiseren van berichten naar blobs. Ondersteunde waarden zijn 'avro', 'avrodeflate' en 'JSON'. De standaardwaarde is 'avro'. |
endpointUri |
string |
De URL van het opslageindpunt. Het moet het protocol bevatten https:// |
fileNameFormat |
string |
Bestandsnaamindeling voor de blob. De standaardindeling is {iothub}/{partition}/{JJJJ}/{MM}/{DD}/{HH}/{mm}. Alle parameters zijn verplicht, maar kunnen opnieuw worden gerangschikt. |
id |
string |
Id van het eindpunt van de opslagcontainer |
identity |
Eigenschappen van beheerde identiteit van eindpunt voor routeringsopslag. |
|
maxChunkSizeInBytes |
integer (int32) minimum: 10485760maximum: 524288000 |
Maximum aantal bytes voor elke blob die naar de opslag is geschreven. De waarde moet tussen 10485760(10 MB) en 524288000 (500 MB) zijn. De standaardwaarde is 314572800(300 MB). |
name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
De naam die dit eindpunt identificeert. De naam mag alleen alfanumerieke tekens, punten, onderstrepingstekens, afbreekstreepjes en maximaal 64 tekens bevatten. De volgende namen zijn gereserveerd: gebeurtenissen, fileNotifications, $default. Eindpuntnamen moeten uniek zijn voor eindpunttypen. |
resourceGroup |
string |
De naam van de resourcegroep van het opslagaccount. |
subscriptionId |
string |
De abonnements-id van het opslagaccount. |
SharedAccessSignatureAuthorizationRule
De eigenschappen van een gedeeld toegangsbeleid voor IoT Hub.
Name | Type | Description |
---|---|---|
keyName |
string |
De naam van het beleid voor gedeelde toegang. |
primaryKey |
string |
De primaire sleutel. |
rights |
De machtigingen die zijn toegewezen aan het beleid voor gedeelde toegang. |
|
secondaryKey |
string |
De secundaire sleutel. |
StorageEndpointProperties
De eigenschappen van het Azure Storage-eindpunt voor het uploaden van bestanden.
Name | Type | Description |
---|---|---|
authenticationType |
Hiermee geeft u het verificatietype op dat wordt gebruikt voor het maken van verbinding met het opslagaccount. |
|
connectionString |
string |
De verbindingsreeks voor het Azure Storage-account waarnaar bestanden worden geüpload. |
containerName |
string |
De naam van de hoofdcontainer waar u bestanden uploadt. De container hoeft niet te bestaan, maar moet worden gemaakt met behulp van de connectionString opgegeven. |
identity |
Eigenschappen van beheerde identiteit van opslageindpunt voor het uploaden van bestanden. |
|
sasTtlAsIso8601 |
string (duration) |
De periode waarvoor de SAS-URI die is gegenereerd door IoT Hub voor het uploaden van bestanden, is geldig. Zie: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-file-upload#file-upload-notification-configuration-options. |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string (date-time) |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |