Endpoint Resolution - Resolve

Tjeneste:

Workload Development

API-versjon:

v1

Løse et endepunkt for en gitt tjeneste kalt av Microsoft Fabric
Løser endepunktet for en gitt tjeneste kalt av Microsoft Fabric basert på leierens område og arbeidsområde. Fabric gir et sett med kontekstegenskaper og returnerer riktig url-adresse for tjenesteendepunkt og dens tid-til-live (TTL).

Endpoint Resolution API er avgjørende for tjenester som krever dynamisk endepunktavklaring basert på driftskontekst. Dette gjør det mulig for optimalisert ruting og regional overholdelse.

For å løse et endepunkt sender Fabric en POST-forespørsel med de nødvendige kontekstegenskapene i forespørselsteksten. Svaret vil inneholde den løste URL-adressen og TTL-en, som angir hvor lenge nettadressen anses som gyldig.

Hvis du vil ha eksempler på eksempel på implementering og bruk, kan du se Eksempelkode for endepunktløsning.

POST https://workload.contoso.com/workload-api-path-placeholder/resolve-api-path-placeholder

Topptekst for forespørsel

Navn	Obligatorisk	Type	Beskrivelse
ActivityId	True	string	En unik ID for å korrelere forespørselen med systemet når en bruker samhandler med arbeidsbelastningen.
RequestId	True	string	En globalt unik ID som hjelper Fabric med å koordinere forespørselen din med loggene våre. Oppgi denne ID-en når du rapporterer et problem.
Authorization	True	string	Et autorisasjonshode med to tokener som gjør det mulig for arbeidsbelastningen å validere forespørselens opprinnelse, gi brukerkontekst og ringe andre tjenester. Denne toppteksten har følgende format: SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token".

Brødtekst for forespørsel

Navn	Obligatorisk	Type	Beskrivelse
context	True	EndpointResolutionContextProperty[]	Matrise med kontekstegenskaper for endepunktoppløsning.

Svar

Navn	Type	Beskrivelse
200 OK	EndpointResolutionResponse	Svar på endepunktoppløsning
Other Status Codes	ErrorResponse	For feilforhold bør arbeidsbelastningen returnere en passende HTTP-feilstatuskode (4xx, 5xx) med detaljert feilinformasjon i svarteksten.

Definisjoner

Navn	Beskrivelse
EndpointResolutionContextProperty	Definerer en kontekstegenskap som brukes i endepunktoppløsning. Denne egenskapen må angis i arbeidsbelastningsmanifestet for å sikre riktig endepunktavgjørelse av Fabric.
EndpointResolutionContextPropertyName	Navnet på egenskapen for endepunktoppløsningskontekst.
EndpointResolutionRequest
EndpointResolutionResponse
ErrorExtendedInformation	Den utvidede feilinformasjonen.
ErrorResponse	Feilsvaret.
ErrorSource	Kilden til feilen.
NameValuePair	Et navneverdipar.

EndpointResolutionContextProperty

Object

Definerer en kontekstegenskap som brukes i endepunktoppløsning. Denne egenskapen må angis i arbeidsbelastningsmanifestet for å sikre riktig endepunktavgjørelse av Fabric.

Navn	Type	Beskrivelse
name	EndpointResolutionContextPropertyName	Navnet på kontekstegenskapen.
value	string	Verdien for kontekstegenskapen.

EndpointResolutionContextPropertyName

Opplisting

Navnet på egenskapen for endepunktoppløsningskontekst.

Verdi	Beskrivelse
EndpointName
TenantId
TenantRegion
WorkspaceRegion

EndpointResolutionRequest

Object

Navn	Type	Beskrivelse
context	EndpointResolutionContextProperty[]	Matrise med kontekstegenskaper for endepunktoppløsning.

EndpointResolutionResponse

Object

Navn	Type	Beskrivelse
ttlInMinutes	integer int32	Tid for å leve i minutter for den løste URL-adressen.
url	string	Den løste URL-adressen for tjenesten.

ErrorExtendedInformation

Object

Den utvidede feilinformasjonen.

Navn	Type	Beskrivelse
additionalParameters	NameValuePair[]	En liste over flere parametere som er spesifikke for feilen.
errorCode	string	Feilkoden.
message	string	Feilmeldingen.
messageParameters	string[]	En liste over parametere som formaterer en lokalisert melding.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	Feilkoden.
isPermanent	boolean	Angir om feilen er permanent eller operasjonen kan prøves på nytt.
message	string	Feilmeldingen.
messageParameters	string[]	En liste over parametere som formaterer en lokalisert melding.
moreDetails	ErrorExtendedInformation[]	En liste over flere feildetaljer.
source	ErrorSource	Feilkilden.

ErrorSource

Opplisting

Kilden til feilen.

Verdi	Beskrivelse
External
System
User

NameValuePair

Object

Et navneverdipar.

Navn	Type	Beskrivelse
name	string	Navnet.
value	string	Verdien.