Configuration - Create Or Update

Cria ou atualiza uma configuração no Hub IoT para gestão automática de dispositivos/módulos. O identificador de configuração e o conteúdo não podem ser atualizados.

PUT https://fully-qualified-iothubname.azure-devices.net/configurations/{id}?api-version=2020-05-31-preview

Parâmetros do URI

Name In Required Type Description
id
path True
  • string

O identificador único da configuração.

api-version
query True
  • string

Versão da Api.

Cabeçalho do Pedido

Name Required Type Description
If-Match
  • string

A cadeia que representa um ETag fraco para a configuração, de acordo com RFC7232. Isto não deve ser definido ao criar uma configuração, mas pode ser definido ao atualizar uma configuração.

Corpo do Pedido

Name Type Description
content

O conteúdo da configuração.

createdTimeUtc
  • string

A data de criação e a hora da configuração.

etag
  • string

O ETag da configuração.

id
  • string

O identificador único da configuração.

labels
  • object

Os pares de valor-chave usados para descrever a configuração.

lastUpdatedTimeUtc
  • string

A data de atualização e a hora da configuração.

metrics

As métricas personalizadas especificadas pelo desenvolvedor como consultas contra propriedades duplas reportadas.

priority
  • integer

O número prioritário atribuído à configuração.

schemaVersion
  • string

A versão do esquema da configuração.

systemMetrics

As métricas do sistema computadas pelo IoT Hub que não podem ser personalizadas.

targetCondition
  • string

A consulta utilizada para definir os dispositivos ou módulos direcionados. A consulta baseia-se em etiquetas gémeas e/ou propriedades reportadas.

Respostas

Name Type Description
200 OK

OK.

201 Created

Criado.

Definições

Configuration

A configuração para iot hub dispositivo e gémeos módulos.

ConfigurationContent

O conteúdo de configuração para dispositivos ou módulos em dispositivos de borda.

ConfigurationMetrics

As métricas de configuração para dispositivos e módulos Iot Hub.

Configuration

A configuração para iot hub dispositivo e gémeos módulos.

Name Type Description
content

O conteúdo da configuração.

createdTimeUtc
  • string

A data de criação e a hora da configuração.

etag
  • string

O ETag da configuração.

id
  • string

O identificador único da configuração.

labels
  • object

Os pares de valor-chave usados para descrever a configuração.

lastUpdatedTimeUtc
  • string

A data de atualização e a hora da configuração.

metrics

As métricas personalizadas especificadas pelo desenvolvedor como consultas contra propriedades duplas reportadas.

priority
  • integer

O número prioritário atribuído à configuração.

schemaVersion
  • string

A versão do esquema da configuração.

systemMetrics

As métricas do sistema computadas pelo IoT Hub que não podem ser personalizadas.

targetCondition
  • string

A consulta utilizada para definir os dispositivos ou módulos direcionados. A consulta baseia-se em etiquetas gémeas e/ou propriedades reportadas.

ConfigurationContent

O conteúdo de configuração para dispositivos ou módulos em dispositivos de borda.

Name Type Description
deviceContent
  • object

O conteúdo de configuração do dispositivo.

moduleContent
  • object

O conteúdo de configuração do módulo.

modulesContent
  • object

O conteúdo de configuração dos módulos.

ConfigurationMetrics

As métricas de configuração para dispositivos e módulos Iot Hub.

Name Type Description
queries
  • object

Os pares de valores-chave com consultas e o seu identificador.

results
  • object

Os resultados das consultas de recolha de métricas.