Udostępnij za pośrednictwem

Twins - DigitalTwins SendTelemetry

  • Odwołanie
Service:
Azure Digital Twins
API Version:
2023-10-31

Wysyła dane telemetryczne w imieniu cyfrowej reprezentacji bliźniaczej. Kody stanu:

  • 204 Brak zawartości
  • 400 Nieprawidłowe żądanie
    • InvalidArgument — identyfikator cyfrowej reprezentacji bliźniaczej lub identyfikator wiadomości jest nieprawidłowy.
    • ValidationFailed — zawartość telemetrii jest nieprawidłowa.
  • 404 — Nie znaleziono
    • DigitalTwinNotFound — nie można odnaleźć cyfrowej reprezentacji bliźniaczej.
POST https://digitaltwins-hostname/digitaltwins/{id}/telemetry?api-version=2023-10-31

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
id
 path True

string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
api-version
 query True

string

Żądana wersja interfejsu API.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Message-Id True

string

Unikatowy identyfikator komunikatu (w zakresie identyfikatora cyfrowej reprezentacji bliźniaczej), który jest często używany do deduplikowania komunikatów.
Telemetry-Source-Time

string

Sygnatura czasowa RFC 3339, która identyfikuje czas pomiaru telemetrii.
traceparent

string

Identyfikuje żądanie w rozproszonym systemie śledzenia.
tracestate

string

Dostarcza informacje identyfikacyjne śledzenia specyficzne dla dostawcy i jest towarzyszem śledzenia rodziców.

Treść żądania

Nazwa Typ Opis
telemetry

object

Miary telemetrii do wysłania z cyfrowej reprezentacji bliźniaczej.

Odpowiedzi

Nazwa Typ Opis
204 No Content

Powodzenie
Other Status Codes

ErrorResponse

Odpowiedź domyślna.

Headers

x-ms-error-code: string

Zabezpieczenia

oauth2

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

Przykłady

Send telemetry

Sample Request

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



{
  "temperature": 1
}

Sample Response

Status code:
204

Definicje

Nazwa Opis
Error

Definicja błędu.
ErrorResponse

Odpowiedź na błąd.
InnerError

Bardziej szczegółowy opis błędu niż został podany przez błąd zawierający.

Error

Definicja błędu.

Nazwa Typ Opis
code

string

Kod błędu specyficzny dla usługi, który służy jako stan podrzędny kodu błędu HTTP.
details

Error[]

Szczegóły błędu wewnętrznego.
innererror

InnerError

Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message

string

Czytelna dla człowieka reprezentacja błędu.

ErrorResponse

Odpowiedź na błąd.

Nazwa Typ Opis
error

Error

Szczegóły błędu.

InnerError

Bardziej szczegółowy opis błędu niż został podany przez błąd zawierający.

Nazwa Typ Opis
code

string

Bardziej szczegółowy kod błędu niż został dostarczony przez błąd zawierający.
innererror

InnerError

Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.