서비스 해결

아티클
08/05/2023

Service Fabric 파티션을 해결합니다.

Service Fabric 서비스 파티션을 확인하여 서비스 복제본의 엔드포인트를 가져옵니다.

요청

메서드	요청 URI
GET	`/Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`serviceId`	문자열	예	경로
`api-version`	문자열	예	쿼리
`PartitionKeyType`	integer	아니요	쿼리
`PartitionKeyValue`	문자열	예	쿼리
`PreviousRspVersion`	문자열	예	쿼리
`timeout`	정수(int64)	아니요	쿼리

`serviceId`

형식: 문자열
필수: 예

서비스 id입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0에서 시작하며, 계층적 이름이 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.

`api-version`

형식: 문자열
필수: 예
기본: 6.0

API 버전입니다. 이 매개 변수는 필수이며 해당 값은 '6.0'이어야 합니다.

Service Fabric REST API 버전은 API가 도입되었거나 변경된 런타임 버전을 기반으로 합니다. Service Fabric 런타임은 둘 이상의 API 버전을 지원합니다. 지원되는 최신 버전의 API입니다. 더 낮은 API 버전이 전달되면 반환된 응답이 이 사양에 설명된 응답과 다를 수 있습니다.

또한 런타임은 현재 버전의 런타임까지 지원되는 최신 버전보다 높은 모든 버전을 허용합니다. 따라서 최신 API 버전이 6.0이지만 런타임이 6.1인 경우 클라이언트를 더 쉽게 작성하기 위해 런타임은 해당 API에 대해 버전 6.1을 수락합니다. 그러나 API의 동작은 문서화된 6.0 버전에 따라 다릅니다.

`PartitionKeyType`

형식: 정수
필수: 아니요

파티션의 키 유형입니다. 서비스의 파티션 구성표가 Int64Range 또는 Named인 경우 이 매개 변수가 필요합니다. 가능한 값은 다음과 같습니다.

None (1) - PartitionKeyValue 매개 변수가 지정되지 않음을 나타냅니다. 파티션 구성표가 싱글톤인 파티션에 유효합니다. 이것은 기본값입니다. 값은 1입니다.
Int64Range (2) - PartitionKeyValue 매개 변수가 int64 파티션 키임을 나타냅니다. 파티션 구성표가 Int64Range인 파티션에 유효합니다. 값은 2입니다.
명명됨(3) - PartitionKeyValue 매개 변수가 파티션의 이름임을 나타냅니다. 파티션 구성표가 Named인 파티션에 유효합니다. 값이 3입니다.

`PartitionKeyValue`

형식: 문자열
필수: 아니요

파티션 키입니다. 서비스의 파티션 구성표가 Int64Range 또는 Named인 경우 필요합니다. 파티션 ID가 아니라 정수 키 값 또는 파티션 ID의 이름입니다. 예를 들어 서비스가 0~10 범위의 파티션을 사용하는 경우 PartitionKeyValue는 해당 범위의 정수입니다. 범위 또는 이름을 보려면 서비스 설명을 쿼리합니다.

`PreviousRspVersion`

형식: 문자열
필수: 아니요

이전에 수신한 응답의 버전 필드 값입니다. 이전에 얻은 결과가 오래되었다는 것을 사용자가 아는 경우에 필요합니다.

`timeout`

형식: 정수(int64)
필수: 아니요
기본: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 요청된 작업이 완료될 때까지 클라이언트가 기다릴 시간을 지정합니다. 이 매개 변수의 기본값은 60초입니다.

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	작업이 성공하면 200개 상태 코드가 반환됩니다.	ResolvedServicePartition
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

Share via