Configuration - Create Or Update
Hiermee wordt een configuratie op de IoT Hub gemaakt of bijgewerkt voor automatisch apparaat-/modulebeheer. Configuratie-id en inhoud kunnen niet worden bijgewerkt.
PUT https://fully-qualified-iothubname.azure-devices.net/configurations/{id}?api-version=2021-04-12
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
id
|
path | True |
string |
De unieke id van de configuratie. |
api-version
|
query | True |
string |
Versie van de API. |
Aanvraagkoptekst
Name | Vereist | Type | Description |
---|---|---|---|
If-Match |
string |
De tekenreeks die een zwakke ETag voor de configuratie vertegenwoordigt, volgens RFC7232. Dit moet niet worden ingesteld bij het maken van een configuratie, maar kan worden ingesteld bij het bijwerken van een configuratie. |
Aanvraagbody
Name | Type | Description |
---|---|---|
content |
De inhoud van de configuratie. |
|
createdTimeUtc |
string |
De aanmaakdatum en -tijd van de configuratie. |
etag |
string |
De ETag van de configuratie. |
id |
string |
De unieke id van de configuratie. |
labels |
object |
De sleutel-waardeparen die worden gebruikt om de configuratie te beschrijven. |
lastUpdatedTimeUtc |
string |
De updatedatum en -tijd van de configuratie. |
metrics |
De aangepaste metrische gegevens die door de ontwikkelaar zijn opgegeven als query's op gerapporteerde eigenschappen van dubbels. |
|
priority |
integer |
Het prioriteitsnummer dat is toegewezen aan de configuratie. |
schemaVersion |
string |
De schemaversie van de configuratie. |
systemMetrics |
De metrische systeemgegevens die zijn berekend door de IoT Hub die niet kunnen worden aangepast. |
|
targetCondition |
string |
De query die wordt gebruikt om de doelapparaten of modules te definiëren. De query is gebaseerd op dubbeltags en/of gerapporteerde eigenschappen. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK. |
|
201 Created |
Gemaakt. |
Definities
Name | Description |
---|---|
Configuration |
De configuratie voor IoT Hub-apparaat- en moduledubbels. |
Configuration |
De configuratie-inhoud voor apparaten of modules op edge-apparaten. |
Configuration |
De metrische configuratiegegevens voor IoT Hub-apparaten en -modules. |
Configuration
De configuratie voor IoT Hub-apparaat- en moduledubbels.
Name | Type | Description |
---|---|---|
content |
De inhoud van de configuratie. |
|
createdTimeUtc |
string |
De aanmaakdatum en -tijd van de configuratie. |
etag |
string |
De ETag van de configuratie. |
id |
string |
De unieke id van de configuratie. |
labels |
object |
De sleutel-waardeparen die worden gebruikt om de configuratie te beschrijven. |
lastUpdatedTimeUtc |
string |
De updatedatum en -tijd van de configuratie. |
metrics |
De aangepaste metrische gegevens die door de ontwikkelaar zijn opgegeven als query's op gerapporteerde eigenschappen van dubbels. |
|
priority |
integer |
Het prioriteitsnummer dat is toegewezen aan de configuratie. |
schemaVersion |
string |
De schemaversie van de configuratie. |
systemMetrics |
De metrische systeemgegevens die zijn berekend door de IoT Hub die niet kunnen worden aangepast. |
|
targetCondition |
string |
De query die wordt gebruikt om de doelapparaten of modules te definiëren. De query is gebaseerd op dubbeltags en/of gerapporteerde eigenschappen. |
ConfigurationContent
De configuratie-inhoud voor apparaten of modules op edge-apparaten.
Name | Type | Description |
---|---|---|
deviceContent |
object |
De inhoud van de apparaatconfiguratie. |
moduleContent |
object |
De inhoud van de moduleconfiguratie. |
modulesContent |
object |
De inhoud van de moduleconfiguratie. |
ConfigurationMetrics
De metrische configuratiegegevens voor IoT Hub-apparaten en -modules.
Name | Type | Description |
---|---|---|
queries |
object |
De sleutel-waarde wordt gekoppeld aan query's en hun id. |
results |
object |
De resultaten van de query's voor het verzamelen van metrische gegevens. |