Delen via


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

ConfigurationContent

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

ConfigurationMetrics

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

ConfigurationMetrics

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

Configuration

OK.

201 Created

Configuration

Gemaakt.

Definities

Name Description
Configuration

De configuratie voor IoT Hub-apparaat- en moduledubbels.

ConfigurationContent

De configuratie-inhoud voor apparaten of modules op edge-apparaten.

ConfigurationMetrics

De metrische configuratiegegevens voor IoT Hub-apparaten en -modules.

Configuration

De configuratie voor IoT Hub-apparaat- en moduledubbels.

Name Type Description
content

ConfigurationContent

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

ConfigurationMetrics

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

ConfigurationMetrics

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.