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=2021-04-12Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | 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
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| If-Match |
string |
A cadeia de caracteres que representa uma ETag fraca para a configuração, de acordo com 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
| Nome | Tipo | 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 da atualização da configuração. |
| metrics |
As métricas personalizadas especificadas pelo desenvolvedor como consultas em propriedades relatadas por gêmeo. |
|
| 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 calculadas 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 gêmeo e/ou propriedades relatadas. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OK. |
|
| 201 Created |
Criado. |
Definições
| Nome | Description |
|---|---|
| Configuration |
A configuração do dispositivo hub Iot e dos módulos gêmeos. |
|
Configuration |
O conteúdo de configuração para dispositivos ou módulos em dispositivos de borda. |
|
Configuration |
As métricas de configuração para dispositivos e módulos do Hub Iot. |
Configuration
A configuração do dispositivo hub Iot e dos módulos gêmeos.
| Nome | Tipo | 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 da atualização da configuração. |
| metrics |
As métricas personalizadas especificadas pelo desenvolvedor como consultas em propriedades relatadas por gêmeo. |
|
| 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 calculadas 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 gêmeo e/ou propriedades relatadas. |
ConfigurationContent
O conteúdo de configuração para dispositivos ou módulos em dispositivos de borda.
| Nome | Tipo | Description |
|---|---|---|
| deviceContent |
object |
O conteúdo da 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.
| Nome | Tipo | Description |
|---|---|---|
| queries |
object |
Os pares chave-valor com consultas e seu identificador. |
| results |
object |
Os resultados das consultas de coleção de métricas. |