Endpoint Resolution - Resolve
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 |
워크로드가 요청 원본의 유효성을 검사하고, 사용자 컨텍스트를 제공하고, 다른 서비스를 호출할 수 있도록 하는 이중 토큰 권한 부여 헤더입니다. 이 헤더의 형식은 |
요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| context | True |
엔드포인트 확인을 위한 컨텍스트 속성의 배열입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
엔드포인트 확인 응답 |
|
| Other Status Codes |
오류 조건의 경우 워크로드는 응답 본문에 자세한 오류 정보가 포함된 적절한 HTTP 오류 상태 코드(4xx, 5xx)를 반환해야 합니다. |
정의
| Name | Description |
|---|---|
|
Endpoint |
엔드포인트 확인에 사용되는 컨텍스트 속성을 정의합니다. Fabric에서 올바른 엔드포인트를 확인하려면 워크로드 매니페스트에 이 속성을 지정해야 합니다. |
|
Endpoint |
엔드포인트 확인 컨텍스트에 대한 속성의 이름입니다. |
|
Endpoint |
|
|
Endpoint |
|
|
Error |
확장된 오류 정보입니다. |
|
Error |
오류 응답입니다. |
|
Error |
오류의 소스입니다. |
|
Name |
이름-값 쌍입니다. |
EndpointResolutionContextProperty
엔드포인트 확인에 사용되는 컨텍스트 속성을 정의합니다. Fabric에서 올바른 엔드포인트를 확인하려면 워크로드 매니페스트에 이 속성을 지정해야 합니다.
| Name | 형식 | Description |
|---|---|---|
| name |
컨텍스트 속성의 이름입니다. |
|
| value |
string |
컨텍스트 속성의 값입니다. |
EndpointResolutionContextPropertyName
엔드포인트 확인 컨텍스트에 대한 속성의 이름입니다.
| 값 | Description |
|---|---|
| EndpointName | |
| TenantRegion | |
| WorkspaceRegion | |
| TenantId |
EndpointResolutionRequest
| Name | 형식 | Description |
|---|---|---|
| context |
엔드포인트 확인을 위한 컨텍스트 속성의 배열입니다. |
EndpointResolutionResponse
| Name | 형식 | Description |
|---|---|---|
| ttlInMinutes |
integer (int32) |
확인된 URL에 대한 시간(분)입니다. |
| url |
string |
서비스의 확인된 URL입니다. |
ErrorExtendedInformation
확장된 오류 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalParameters |
오류와 관련된 추가 매개 변수 목록입니다. |
|
| errorCode |
string |
오류 코드입니다. |
| message |
string |
오류 메시지입니다. |
| messageParameters |
string[] |
지역화된 메시지의 서식을 지정하기 위한 매개 변수 목록입니다. |
ErrorResponse
오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 코드입니다. |
| isPermanent |
boolean |
오류가 영구적인지 아니면 작업을 다시 시도 할 수 있는지 여부를 나타냅니다. |
| message |
string |
오류 메시지입니다. |
| messageParameters |
string[] |
지역화된 메시지의 서식을 지정하기 위한 매개 변수 목록입니다. |
| moreDetails |
추가 오류 세부 정보 목록입니다. |
|
| source |
오류 원본입니다. |
ErrorSource
오류의 소스입니다.
| 값 | Description |
|---|---|
| System | |
| User | |
| External |
NameValuePair
이름-값 쌍입니다.
| Name | 형식 | Description |
|---|---|---|
| name |
string |
이름입니다. |
| value |
string |
값입니다. |