Share via

정책 및 고급 필터를 사용하여 클러스터 상태 청크 가져오기

  • 아티클

상태 청크를 사용하여 Service Fabric 클러스터의 상태를 가져옵니다.

상태 청크를 사용하여 Service Fabric 클러스터의 상태를 가져옵니다. 상태 평가는 입력 클러스터 상태 청크 쿼리 설명을 기반으로 수행됩니다. 쿼리 설명을 사용하면 사용자가 클러스터 및 해당 자식을 평가하기 위한 상태 정책을 지정할 수 있습니다. 사용자는 매우 유연한 필터를 지정하여 반환할 클러스터 엔터티를 선택할 수 있습니다. 엔터티 상태 및 계층 구조에 따라 선택할 수 있습니다. 쿼리는 지정된 필터에 따라 엔터티의 다중 수준 자식을 반환할 수 있습니다. 예를 들어 지정된 이름을 가진 하나의 애플리케이션을 반환할 수 있으며, 이 애플리케이션의 경우 오류 또는 경고에 있는 서비스 및 이러한 서비스 중 하나에 대한 모든 파티션 및 복제본만 반환합니다.

요청

메서드 요청 URI
POST /$/GetClusterHealthChunk?api-version=6.0&timeout={timeout}

매개 변수

속성 형식 필수 위치
api-version 문자열 예 쿼리
timeout 정수(int64) 아니요 쿼리
ClusterHealthChunkQueryDescription ClusterHealthChunkQueryDescription 예 본문

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 버전에 따라 다릅니다.

timeout

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

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

ClusterHealthChunkQueryDescription

형식: ClusterHealthChunkQueryDescription
필수: 아니요

클러스터 상태를 평가하는 데 사용되는 클러스터 및 애플리케이션 상태 정책과 반환할 클러스터 엔터티를 선택하는 필터에 대해 설명합니다. 클러스터 상태 정책이 있는 경우 클러스터 이벤트 및 클러스터 노드를 평가하는 데 사용됩니다. 상태 평가가 없는 경우 클러스터 매니페스트 또는 기본 클러스터 상태 정책에 정의된 클러스터 상태 정책을 사용합니다. 매니페스트에 정의된 정책이 없는 경우 기본적으로 각 애플리케이션은 애플리케이션 매니페스트에 정의된 특정 애플리케이션 상태 정책 또는 기본 상태 정책을 사용하여 평가됩니다. 애플리케이션 상태 정책 맵이 지정되고 애플리케이션에 대한 항목이 있는 경우 지정된 애플리케이션 상태 정책이 애플리케이션 상태를 평가하는 데 사용됩니다. 사용자는 매우 유연한 필터를 지정하여 응답에 포함할 클러스터 엔터티를 선택할 수 있습니다. 엔터티 상태 및 계층 구조에 따라 선택할 수 있습니다. 쿼리는 지정된 필터에 따라 엔터티의 다중 수준 자식을 반환할 수 있습니다. 예를 들어 지정된 이름을 가진 하나의 애플리케이션을 반환할 수 있으며, 이 애플리케이션의 경우 오류 또는 경고에 있는 서비스 및 이러한 서비스 중 하나에 대한 모든 파티션 및 복제본만 반환합니다.

응답

HTTP 상태 코드 설명 응답 스키마
200(확인) 작업이 성공하면 200개의 상태 코드와 요청된 클러스터 상태 청크 정보가 반환됩니다.
 ClusterHealthChunk
다른 모든 상태 코드 자세한 오류 응답입니다.
 FabricError