Configuration - Create Or Update

Cria ou atualiza uma configuração no Hub IoT para gerenciamento automático de dispositivo/módulo. 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 de URI

Name In Required Type Description
id
path True
  • string

O identificador exclusivo da configuração.

api-version
query True
  • string

Versão da API.

Cabeçalho da solicitação

Name Required Type Description
If-Match
  • string

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

Corpo da solicitação

Name Type Description
content

O conteúdo da configuração.

createdTimeUtc
  • string

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

etag
  • string

A ETag da configuração.

id
  • string

O identificador exclusivo da configuração.

labels
  • object

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

lastUpdatedTimeUtc
  • string

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

metrics

As métricas personalizadas especificadas pelo desenvolvedor como consultas em Propriedades relatadas de entrelaçamento.

priority
  • integer

O número de prioridade atribuído à configuração.

schemaVersion
  • string

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

systemMetrics

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

targetCondition
  • string

A consulta usada para definir os dispositivos ou módulos de destino. A consulta é baseada em marcas de entrelaçamento e/ou Propriedades relatadas.

Respostas

Name Type Description
200 OK

OK.

201 Created

Criado.

Definições

Configuration

A configuração do dispositivo e do módulo gêmeos do Hub IOT.

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 do Hub IOT.

Configuration

A configuração do dispositivo e do módulo gêmeos do Hub IOT.

Name Type Description
content

O conteúdo da configuração.

createdTimeUtc
  • string

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

etag
  • string

A ETag da configuração.

id
  • string

O identificador exclusivo da configuração.

labels
  • object

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

lastUpdatedTimeUtc
  • string

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

metrics

As métricas personalizadas especificadas pelo desenvolvedor como consultas em Propriedades relatadas de entrelaçamento.

priority
  • integer

O número de prioridade atribuído à configuração.

schemaVersion
  • string

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

systemMetrics

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

targetCondition
  • string

A consulta usada para definir os dispositivos ou módulos de destino. A consulta é baseada em marcas de entrelaçamento e/ou Propriedades relatadas.

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 do Hub IOT.

Name Type Description
queries
  • object

Os pares chave-valor com consultas e seu identificador.

results
  • object

Os resultados das consultas de coleta de métricas.