Configuration - Create Or Update

Service:

IoT Hub

API Version:

2020-05-31-preview

Cria ou atualiza uma configuração no Hub IoT para a gestão automática de dispositivos/módulos. Não é possível atualizar o identificador de configuração e o Conteúdo.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
id	path	True	string	O identificador exclusivo da configuração.
api-version	query	True	string	Versão da API.

Cabeçalho do Pedido

Name	Necessário	Tipo	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	Tipo	Description
content	ConfigurationContent	O conteúdo da configuração.
createdTimeUtc	string	A data e hora de criação da configuração.
etag	string	O ETag da configuração.
id	string	O identificador exclusivo da configuração.
labels	object	Os pares chave-valor utilizados para descrever a configuração.
lastUpdatedTimeUtc	string	A data e hora da atualização da configuração.
metrics	ConfigurationMetrics	As métricas personalizadas especificadas pelo programador como consultas relativas a propriedades comunicadas de duplos.
priority	integer	O número de prioridade atribuído à configuração.
schemaVersion	string	A versão de esquema da configuração.
systemMetrics	ConfigurationMetrics	As métricas de sistema calculadas pelo Hub IoT que não podem ser personalizadas.
targetCondition	string	A consulta utilizada para definir os dispositivos ou módulos visados. A consulta baseia-se em etiquetas de duplos e/ou propriedades reportadas.

Respostas

Name	Tipo	Description
200 OK	Configuration	OK.
201 Created	Configuration	Criado.

Definições

Name	Description
Configuration	A configuração para dispositivos Iot Hub e módulos duplos.
ConfigurationContent	O conteúdo de configuração para dispositivos ou módulos em dispositivos edge.
ConfigurationMetrics	As métricas de configuração para dispositivos e módulos do Hub Iot.

Configuration

A configuração para dispositivos Iot Hub e módulos duplos.

Name	Tipo	Description
content	ConfigurationContent	O conteúdo da configuração.
createdTimeUtc	string	A data e hora de criação da configuração.
etag	string	O ETag da configuração.
id	string	O identificador exclusivo da configuração.
labels	object	Os pares chave-valor utilizados para descrever a configuração.
lastUpdatedTimeUtc	string	A data e hora da atualização da configuração.
metrics	ConfigurationMetrics	As métricas personalizadas especificadas pelo programador como consultas relativas a propriedades comunicadas de duplos.
priority	integer	O número de prioridade atribuído à configuração.
schemaVersion	string	A versão de esquema da configuração.
systemMetrics	ConfigurationMetrics	As métricas de sistema calculadas pelo Hub IoT que não podem ser personalizadas.
targetCondition	string	A consulta utilizada para definir os dispositivos ou módulos visados. A consulta baseia-se em etiquetas de duplos e/ou propriedades reportadas.

ConfigurationContent

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

Name	Tipo	Description
deviceContent	object	O conteúdo de configuração do dispositivo.
moduleContent	object	O conteúdo de configuração do módulo.
modulesContent	object	Os conteúdos de configuração dos módulos.

ConfigurationMetrics

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

Name	Tipo	Description
queries	object	O chave-valor emparelha com as consultas e o identificador.
results	object	Os resultados das consultas da coleção de métricas.