Endpoint Resolution - Resolve

Tjänst:

Workload Development

API-version:

v1

Lösa en slutpunkt för en viss tjänst som anropas av Microsoft Fabric
Löser slutpunkten för en viss tjänst som anropas av Microsoft Fabric baserat på klientorganisationens region och arbetsyteregion. Fabric tillhandahåller en uppsättning kontextegenskaper och returnerar lämplig tjänstslutpunkts-URL och dess time-to-live (TTL).

API:et för slutpunktsmatchning är avgörande för tjänster som kräver dynamisk slutpunktsbestämning baserat på driftkontext. Detta möjliggör optimerad routning och regional efterlevnad.

För att lösa en slutpunkt skickar Fabric en POST-begäran med de nödvändiga kontextegenskaperna i begärandetexten. Svaret innehåller den lösta URL:en och dess TTL, vilket anger hur länge URL:en anses vara giltig.

Exempel på exempel på implementering och användning finns i exempelkoden Slutpunktsmatchning.

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

Begärandehuvud

Name	Obligatorisk	Typ	Description
ActivityId	True	string	Ett unikt ID för att korrelera begäran med systemet när en användare interagerar med din arbetsbelastning.
RequestId	True	string	Ett globalt unikt ID som hjälper Fabric att korrelera din begäran med våra loggar. Ange det här ID:t när du rapporterar ett problem.
Authorization	True	string	Ett auktoriseringshuvud med dubbla token som gör att arbetsbelastningen kan verifiera begärans ursprung, tillhandahålla användarkontext och anropa andra tjänster. Den här rubriken har följande format: SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token".

Begärandetext

Name	Obligatorisk	Typ	Description
context	True	EndpointResolutionContextProperty[]	Matris med kontextegenskaper för slutpunktsmatchning.

Svar

Name	Typ	Description
200 OK	EndpointResolutionResponse	Svar på slutpunktsmatchning
Other Status Codes	ErrorResponse	För feltillstånd ska arbetsbelastningen returnera en lämplig HTTP-felstatuskod (4xx, 5xx) med detaljerad felinformation i svarstexten.

Definitioner

Name	Description
EndpointResolutionContextProperty	Definierar en kontextegenskap som används i slutpunktsmatchning. Den här egenskapen måste anges i arbetsbelastningsmanifestet för att säkerställa korrekt slutpunktsbestämning av Infrastrukturresurser.
EndpointResolutionContextPropertyName	Namnet på egenskapen för slutpunktsmatchningskontexten.
EndpointResolutionRequest
EndpointResolutionResponse
ErrorExtendedInformation	Den utökade felinformationen.
ErrorResponse	Felsvaret.
ErrorSource	Källan till felet.
NameValuePair	Ett namn/värde-par.

EndpointResolutionContextProperty

Objekt

Definierar en kontextegenskap som används i slutpunktsmatchning. Den här egenskapen måste anges i arbetsbelastningsmanifestet för att säkerställa korrekt slutpunktsbestämning av Infrastrukturresurser.

Name	Typ	Description
name	EndpointResolutionContextPropertyName	Namnet på kontextegenskapen.
value	string	Värdet för kontextegenskapen.

EndpointResolutionContextPropertyName

Uppräkning

Namnet på egenskapen för slutpunktsmatchningskontexten.

Värde	Description
EndpointName
TenantRegion
WorkspaceRegion
TenantId

EndpointResolutionRequest

Objekt

Name	Typ	Description
context	EndpointResolutionContextProperty[]	Matris med kontextegenskaper för slutpunktsmatchning.

EndpointResolutionResponse

Objekt

Name	Typ	Description
ttlInMinutes	integer (int32)	Tid att leva i minuter för den lösta URL:en.
url	string	Den lösta URL:en för tjänsten.

ErrorExtendedInformation

Objekt

Den utökade felinformationen.

Name	Typ	Description
additionalParameters	NameValuePair[]	En lista över ytterligare parametrar som är specifika för felet.
errorCode	string	Felkoden.
message	string	Felmeddelandet.
messageParameters	string[]	En lista med parametrar för formatering av ett lokaliserat meddelande.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	Felkoden.
isPermanent	boolean	Anger om felet är permanent eller om åtgärden kan utföras igen.
message	string	Felmeddelandet.
messageParameters	string[]	En lista med parametrar för formatering av ett lokaliserat meddelande.
moreDetails	ErrorExtendedInformation[]	En lista med ytterligare felinformation.
source	ErrorSource	Felkällan.

ErrorSource

Uppräkning

Källan till felet.

Värde	Description
System
User
External

NameValuePair

Objekt

Ett namn/värde-par.

Name	Typ	Description
name	string	Namnet.
value	string	Värdet.