Event Routes - Get By Id

Service:

Azure Digital Twins

API Version:

2023-10-31

Pobiera trasę zdarzeń. Kody stanu:

• 200 OK
• 404 — Nie znaleziono
  • EventRouteNotFound — nie można odnaleźć trasy zdarzeń.

GET https://digitaltwins-hostname/eventroutes/{id}?api-version=2023-10-31

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
id	path	True	string	Identyfikator trasy zdarzeń. Identyfikator jest unikatowy w ramach tras zdarzeń i uwzględnia wielkość liter.
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
traceparent		string	Identyfikuje żądanie w rozproszonym systemie śledzenia.
tracestate		string	Dostarcza informacje identyfikacyjne śledzenia specyficzne dla dostawcy i jest towarzyszem śledzenia rodziców.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	EventRoute	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

Get an event route by id

Sample Request

HTTP

GET https://digitaltwins-hostname/eventroutes/eventroute-001?api-version=2023-10-31

Sample Response

Status code:

200

{
  "id": "eventroute-001",
  "endpointName": "endpoint-001",
  "filter": "type = 'Microsoft.DigitalTwins.Twin.Create'"
}

Definicje

Nazwa	Opis
Error	Definicja błędu.
ErrorResponse	Odpowiedź na błąd.
EventRoute	Trasa, która kieruje zdarzenia powiadomień i telemetrii do punktu końcowego. Punkty końcowe są miejscem docelowym poza usługą Azure Digital Twins, taką jak EventHub.
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.

EventRoute

Trasa, która kieruje zdarzenia powiadomień i telemetrii do punktu końcowego. Punkty końcowe są miejscem docelowym poza usługą Azure Digital Twins, taką jak EventHub.

Nazwa	Typ	Opis
endpointName	string	Nazwa punktu końcowego, z którą jest powiązana ta trasa zdarzenia.
filter	string	Wyrażenie opisujące zdarzenia, które są kierowane do punktu końcowego.
id	string	Identyfikator trasy zdarzeń.

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.