Udostępnij przez

Endpoint Resolution - Resolve

Usługa:
Workload Development
Wersja interfejsu API:
v1

Rozwiązywanie problemu z punktem końcowym dla danej usługi wywoływanej przez usługę Microsoft Fabric
Rozwiązuje punkt końcowy dla danej usługi wywoływanej przez usługę Microsoft Fabric na podstawie regionu dzierżawy i regionu obszaru roboczego. Sieć szkieletowa udostępnia zestaw właściwości kontekstu i zwraca odpowiedni adres URL punktu końcowego usługi oraz czas wygaśnięcia (TTL).

Interfejs API rozpoznawania punktów końcowych ma kluczowe znaczenie dla usług, które wymagają dynamicznego określania punktu końcowego na podstawie kontekstu operacyjnego. Dzięki temu można zoptymalizować routing i zgodność regionalną.

Aby rozwiązać problem z punktem końcowym, sieć szkieletowa wyśle żądanie POST z wymaganymi właściwościami kontekstu w treści żądania. Odpowiedź będzie zawierać rozpoznany adres URL i jego czas wygaśnięcia, który wskazuje, jak długo adres URL jest uznawany za prawidłowy.

Aby zapoznać się z przykładowymi przykładami implementacji i użycia, zobacz przykładowy kod rozwiązania punktu końcowego .

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

Nagłówek żądania

Nazwa Wymagane Typ Opis
ActivityId True

string

Unikatowy identyfikator korelowania żądania z systemem, gdy użytkownik wchodzi w interakcję z obciążeniem.
RequestId True

string

Globalnie unikatowy identyfikator, który ułatwia usłudze Fabric skorelowanie żądania z naszymi dziennikami. Podaj ten identyfikator podczas zgłaszania problemu.
Authorization True

string

Nagłówek autoryzacji podwójnego tokenu, który umożliwia obciążeniu weryfikowanie źródła żądania, podawanie kontekstu użytkownika i wywoływanie innych usług. Ten nagłówek ma następujący format: SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token".

Treść żądania

Nazwa Wymagane Typ Opis
context True

EndpointResolutionContextProperty[]

Tablica właściwości kontekstu dla rozpoznawania punktów końcowych.

Odpowiedzi

Nazwa Typ Opis
200 OK

EndpointResolutionResponse

Odpowiedź na rozwiązanie punktu końcowego
Other Status Codes

ErrorResponse

W przypadku warunków błędów obciążenie powinno zwrócić odpowiedni kod stanu błędu HTTP (4xx, 5xx) ze szczegółowymi informacjami o błędzie w treści odpowiedzi.

Definicje

Nazwa Opis
EndpointResolutionContextProperty

Definiuje właściwość kontekstu używaną w rozwiązaniu punktu końcowego. Ta właściwość musi być określona w manifeście obciążenia, aby zapewnić poprawne określenie punktu końcowego przez sieć szkieletową.
EndpointResolutionContextPropertyName

Nazwa właściwości kontekstu rozpoznawania punktu końcowego.
EndpointResolutionRequest
EndpointResolutionResponse
ErrorExtendedInformation

Rozszerzone informacje o błędzie.
ErrorResponse

Odpowiedź na błąd.
ErrorSource

Źródło błędu.
NameValuePair

Para name-value.

EndpointResolutionContextProperty

Objekt

Definiuje właściwość kontekstu używaną w rozwiązaniu punktu końcowego. Ta właściwość musi być określona w manifeście obciążenia, aby zapewnić poprawne określenie punktu końcowego przez sieć szkieletową.

Nazwa Typ Opis
name

EndpointResolutionContextPropertyName

Nazwa właściwości kontekstu.
value

string

Wartość właściwości kontekstu.

EndpointResolutionContextPropertyName

Wyliczanie

Nazwa właściwości kontekstu rozpoznawania punktu końcowego.

Wartość Opis
EndpointName
TenantRegion
WorkspaceRegion
TenantId

EndpointResolutionRequest

Objekt
Nazwa Typ Opis
context

EndpointResolutionContextProperty[]

Tablica właściwości kontekstu dla rozpoznawania punktów końcowych.

EndpointResolutionResponse

Objekt
Nazwa Typ Opis
ttlInMinutes

integer (int32)

Czas wygaśnięcia w minutach dla rozpoznanych adresów URL.
url

string

Rozpoznany adres URL usługi.

ErrorExtendedInformation

Objekt

Rozszerzone informacje o błędzie.

Nazwa Typ Opis
additionalParameters

NameValuePair[]

Lista dodatkowych parametrów specyficznych dla błędu.
errorCode

string

Kod błędu.
message

string

Komunikat o błędzie.
messageParameters

string[]

Lista parametrów formatowania zlokalizowanego komunikatu.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Kod błędu.
isPermanent

boolean

Wskazuje, czy błąd jest trwały, czy można ponowić operację.
message

string

Komunikat o błędzie.
messageParameters

string[]

Lista parametrów formatowania zlokalizowanego komunikatu.
moreDetails

ErrorExtendedInformation[]

Lista dodatkowych szczegółów błędu.
source

ErrorSource

Źródło błędu.

ErrorSource

Wyliczanie

Źródło błędu.

Wartość Opis
System
User
External

NameValuePair

Objekt

Para name-value.

Nazwa Typ Opis
name

string

Nazwa.
value

string

Wartość.