Partilhar via


Twins - DigitalTwins SendComponentTelemetry

Envia telemetria em nome de um componente num duplo digital. Códigos de estado:

  • 204 Sem Conteúdo
  • 400 Pedido Incorreto
    • InvalidArgument – o ID do duplo digital, o ID da mensagem ou o caminho do componente são inválidos.
    • ValidationFailed - O conteúdo de telemetria é inválido.
  • 404 Não Encontrado
    • DigitalTwinNotFound - O duplo digital não foi encontrado.
    • ComponentNotFound - O caminho do componente não foi encontrado.
POST https://digitaltwins-hostname/digitaltwins/{id}/components/{componentPath}/telemetry?api-version=2023-10-31

Parâmetros do URI

Name Em Necessário Tipo Description
componentPath
path True

string

O nome do componente DTDL.

id
path True

string

O ID do duplo digital. O ID é exclusivo no serviço e sensível às maiúsculas e minúsculas.

api-version
query True

string

A versão da API pedida.

Cabeçalho do Pedido

Name Necessário Tipo Description
Message-Id True

string

Um identificador de mensagem exclusivo (no âmbito do ID do duplo digital) que é frequentemente utilizado para anular a duplicação de mensagens.

Telemetry-Source-Time

string

Um carimbo de data/hora RFC 3339 que identifica a hora em que a telemetria foi medida.

traceparent

string

Identifica o pedido num sistema de rastreio distribuído.

tracestate

string

Fornece informações de identificação de rastreio específicas do fornecedor e é um complemento para o traceparent.

Corpo do Pedido

Name Tipo Description
telemetry

object

As medições de telemetria a enviar a partir do componente do duplo digital.

Respostas

Name Tipo Description
204 No Content

Com êxito

Other Status Codes

ErrorResponse

Resposta predefinida.

Headers

x-ms-error-code: string

Segurança

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

Exemplos

Send telemetry in a component

Sample Request

POST https://digitaltwins-hostname/digitaltwins/myTwinId/components/myComponent/telemetry?api-version=2023-10-31



{
  "temperature": 1
}

Sample Response

Definições

Name Description
Error

Definição de erro.

ErrorResponse

Resposta de erro.

InnerError

Uma descrição de erro mais específica do que a fornecida pelo erro que contém.

Error

Definição de erro.

Name Tipo Description
code

string

Código de erro específico do serviço que serve como o subtatus para o código de erro HTTP.

details

Error[]

Detalhes de erro internos.

innererror

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

message

string

Uma representação legível por humanos do erro.

ErrorResponse

Resposta de erro.

Name Tipo Description
error

Error

Os detalhes do erro.

InnerError

Uma descrição de erro mais específica do que a fornecida pelo erro que contém.

Name Tipo Description
code

string

Um código de erro mais específico do que o fornecido pelo erro que contém.

innererror

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.