Delen via


Event Routes - Add

Voegt een gebeurtenisroute toe of vervangt deze. Statuscodes:

  • 204 Geen inhoud
  • 400 Ongeldige aanvraag
    • EventRouteEndpointInvalid: het opgegeven eindpunt bestaat niet of is niet actief.
    • EventRouteFilterInvalid - Het filter voor de gebeurtenisroute is ongeldig.
    • EventRouteIdInvalid - De id van de gebeurtenisroute is ongeldig.
    • LimitExceeded: het maximum aantal toegestane gebeurtenisroutes is bereikt.
PUT https://digitaltwins-hostname/eventroutes/{id}?api-version=2023-10-31

URI-parameters

Name In Vereist Type Description
id
path True

string

De id voor een gebeurtenisroute. De id is uniek binnen gebeurtenisroutes en hoofdlettergevoelig.

api-version
query True

string

De aangevraagde API-versie.

Aanvraagkoptekst

Name Vereist Type Description
traceparent

string

Identificeert de aanvraag in een gedistribueerd traceringssysteem.

tracestate

string

Biedt leverancierspecifieke traceringsidentificatie-informatie en is een aanvulling op traceringsouder.

Aanvraagbody

Name Vereist Type Description
endpointName True

string

De naam van het eindpunt waaraan deze gebeurtenisroute is gebonden.

filter True

string

Een expressie die de gebeurtenissen beschrijft die naar het eindpunt worden gerouteerd.

Antwoorden

Name Type Description
204 No Content

Geslaagd

Other Status Codes

ErrorResponse

Standaardantwoord.

Headers

x-ms-error-code: string

Beveiliging

oauth2

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

Voorbeelden

Add an event route
Add an event route (with filter)

Add an event route

Sample Request

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

{
  "endpointName": "endpoint-001",
  "filter": "true"
}

Sample Response

Add an event route (with filter)

Sample Request

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

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

Sample Response

Definities

Name Description
Error

Foutdefinitie.

ErrorResponse

Foutreactie.

EventRoute

Een route waarmee meldingen en telemetrie-gebeurtenissen naar een eindpunt worden doorgestuurd. Eindpunten zijn een bestemming buiten Azure Digital Twins, zoals een EventHub.

InnerError

Een specifiekere foutbeschrijving dan is opgegeven door de betreffende fout.

Error

Foutdefinitie.

Name Type Description
code

string

Servicespecifieke foutcode die fungeert als de substatus voor de HTTP-foutcode.

details

Error[]

Interne foutdetails.

innererror

InnerError

Een object met specifiekere informatie dan het huidige object over de fout.

message

string

Een door mensen leesbare weergave van de fout.

ErrorResponse

Foutreactie.

Name Type Description
error

Error

De foutdetails.

EventRoute

Een route waarmee meldingen en telemetrie-gebeurtenissen naar een eindpunt worden doorgestuurd. Eindpunten zijn een bestemming buiten Azure Digital Twins, zoals een EventHub.

Name Type Description
endpointName

string

De naam van het eindpunt waaraan deze gebeurtenisroute is gebonden.

filter

string

Een expressie die de gebeurtenissen beschrijft die naar het eindpunt worden gerouteerd.

id

string

De id van de gebeurtenisroute.

InnerError

Een specifiekere foutbeschrijving dan is opgegeven door de betreffende fout.

Name Type Description
code

string

Een specifiekere foutcode dan is opgegeven door de betreffende fout.

innererror

InnerError

Een object met specifiekere informatie dan het huidige object over de fout.