Endpoint Resolution - Resolve

서비스:

Workload Development

API 버전:

v1

Microsoft Fabric에서 호출한 지정된 서비스에 대한 엔드포인트 확인
테넌트의 지역 및 작업 영역 지역에 따라 Microsoft Fabric에서 호출한 지정된 서비스에 대한 엔드포인트를 확인합니다. Fabric은 컨텍스트 속성 집합을 제공하고 적절한 서비스 엔드포인트 URL과 TTL(Time-to-Live)을 반환합니다.

엔드포인트 확인 API는 운영 컨텍스트에 따라 동적 엔드포인트를 결정해야 하는 서비스에 매우 중요합니다. 이렇게 하면 최적화된 라우팅 및 지역 규정 준수가 가능합니다.

엔드포인트를 해결하기 위해 Fabric은 요청 본문에 필요한 컨텍스트 속성을 사용하여 POST 요청을 보냅니다. 응답에는 URL이 유효한 것으로 간주되는 기간을 나타내는 확인된 URL 및 해당 TTL이 포함됩니다.

샘플 구현 및 사용 예제는 엔드포인트 확인 샘플 코드참조하세요.

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

요청 헤더

Name	필수	형식	Description
ActivityId	True	string	사용자가 워크로드와 상호 작용할 때 요청과 시스템의 상관 관계를 지정하기 위한 고유 ID입니다.
RequestId	True	string	패브릭이 요청을 로그와 상호 연결하는 데 도움이 되는 전역적으로 고유한 ID입니다. 문제를 보고할 때 이 ID를 제공합니다.
Authorization	True	string	워크로드가 요청 원본의 유효성을 검사하고, 사용자 컨텍스트를 제공하고, 다른 서비스를 호출할 수 있도록 하는 이중 토큰 권한 부여 헤더입니다. 이 헤더의 형식은 SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token".

요청 본문

Name	필수	형식	Description
context	True	EndpointResolutionContextProperty[]	엔드포인트 확인을 위한 컨텍스트 속성의 배열입니다.

응답

Name	형식	Description
200 OK	EndpointResolutionResponse	엔드포인트 확인 응답
Other Status Codes	ErrorResponse	오류 조건의 경우 워크로드는 응답 본문에 자세한 오류 정보가 포함된 적절한 HTTP 오류 상태 코드(4xx, 5xx)를 반환해야 합니다.

정의

Name	Description
EndpointResolutionContextProperty	엔드포인트 확인에 사용되는 컨텍스트 속성을 정의합니다. Fabric에서 올바른 엔드포인트를 확인하려면 워크로드 매니페스트에 이 속성을 지정해야 합니다.
EndpointResolutionContextPropertyName	엔드포인트 확인 컨텍스트에 대한 속성의 이름입니다.
EndpointResolutionRequest
EndpointResolutionResponse
ErrorExtendedInformation	확장된 오류 정보입니다.
ErrorResponse	오류 응답입니다.
ErrorSource	오류의 소스입니다.
NameValuePair	이름-값 쌍입니다.

EndpointResolutionContextProperty

Object

엔드포인트 확인에 사용되는 컨텍스트 속성을 정의합니다. Fabric에서 올바른 엔드포인트를 확인하려면 워크로드 매니페스트에 이 속성을 지정해야 합니다.

Name	형식	Description
name	EndpointResolutionContextPropertyName	컨텍스트 속성의 이름입니다.
value	string	컨텍스트 속성의 값입니다.

EndpointResolutionContextPropertyName

열거형

엔드포인트 확인 컨텍스트에 대한 속성의 이름입니다.

값	Description
EndpointName
TenantRegion
WorkspaceRegion
TenantId

EndpointResolutionRequest

Object

Name	형식	Description
context	EndpointResolutionContextProperty[]	엔드포인트 확인을 위한 컨텍스트 속성의 배열입니다.

EndpointResolutionResponse

Object

Name	형식	Description
ttlInMinutes	integer (int32)	확인된 URL에 대한 시간(분)입니다.
url	string	서비스의 확인된 URL입니다.

ErrorExtendedInformation

Object

확장된 오류 정보입니다.

Name	형식	Description
additionalParameters	NameValuePair[]	오류와 관련된 추가 매개 변수 목록입니다.
errorCode	string	오류 코드입니다.
message	string	오류 메시지입니다.
messageParameters	string[]	지역화된 메시지의 서식을 지정하기 위한 매개 변수 목록입니다.

ErrorResponse

Object

오류 응답입니다.

Name	형식	Description
errorCode	string	오류 코드입니다.
isPermanent	boolean	오류가 영구적인지 아니면 작업을 다시 시도 할 수 있는지 여부를 나타냅니다.
message	string	오류 메시지입니다.
messageParameters	string[]	지역화된 메시지의 서식을 지정하기 위한 매개 변수 목록입니다.
moreDetails	ErrorExtendedInformation[]	추가 오류 세부 정보 목록입니다.
source	ErrorSource	오류 원본입니다.

ErrorSource

열거형

오류의 소스입니다.

값	Description
System
User
External

NameValuePair

Object

이름-값 쌍입니다.

Name	형식	Description
name	string	이름입니다.
value	string	값입니다.