Partilhar via


Event Routes - Get By Id

Obtém uma rota de evento. Códigos de estado:

  • 200 OK
  • 404 Não Encontrado
    • EventRouteNotFound - A rota do evento não foi encontrada.
GET https://digitaltwins-hostname/eventroutes/{id}?api-version=2023-10-31

Parâmetros do URI

Name Em Necessário Tipo Description
id
path True

string

O ID de uma rota de evento. O ID é exclusivo nas rotas de eventos 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
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.

Respostas

Name Tipo Description
200 OK

EventRoute

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

Get an event route by id

Sample Request

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

Sample Response

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

Definições

Name Description
Error

Definição de erro.

ErrorResponse

Resposta de erro.

EventRoute

Uma rota que direciona eventos de notificação e telemetria para um ponto final. Os pontos finais são um destino fora do Azure Digital Twins, como um EventHub.

InnerError

Uma descrição de erro mais específica do que a indicada 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 subestado para o código de erro HTTP.

details

Error[]

Detalhes internos do erro.

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.

EventRoute

Uma rota que direciona eventos de notificação e telemetria para um ponto final. Os pontos finais são um destino fora do Azure Digital Twins, como um EventHub.

Name Tipo Description
endpointName

string

O nome do ponto final a que esta rota de eventos está vinculada.

filter

string

Uma expressão que descreve os eventos que são encaminhados para o ponto final.

id

string

O ID da rota do evento.

InnerError

Uma descrição de erro mais específica do que a indicada 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.