인프라 쿼리 호출

  • 아티클

지정된 인프라 서비스 인스턴스에 대한 읽기 전용 쿼리를 호출합니다.

하나 이상의 인프라 서비스 인스턴스를 구성한 클러스터의 경우 이 API는 인프라 서비스의 특정 인스턴스에 인프라 관련 쿼리를 전송하는 방법을 제공합니다.

사용 가능한 명령 및 해당 응답 형식은 클러스터가 실행되는 인프라에 따라 달라집니다.

이 API는 Service Fabric 플랫폼을 지원하며 코드에서 직접 사용할 수 없습니다.

요청

메서드 요청 URI
GET /$/InvokeInfrastructureQuery?api-version=6.0&Command={Command}&ServiceId={ServiceId}&timeout={timeout}

매개 변수

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

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

Command

형식: 문자열
필수: 예

호출할 명령의 텍스트입니다. 명령의 콘텐츠는 인프라에 따라 다릅니다.

ServiceId

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

인프라 서비스의 ID입니다. ‘fabric:’ URI 스키마가 없는 인프라 서비스의 전체 이름입니다. 이 매개 변수는 실행 중인 하나 이상의 인프라 서비스 인스턴스가 있는 클러스터에만 필요합니다.

timeout

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

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

응답

HTTP 상태 코드 설명 응답 스키마
200(확인) 인프라 서비스의 응답입니다. 응답 형식은 JSON 스트림입니다.
응답의 내용은 실행된 명령에 따라 달라집니다.
 문자열
다른 모든 상태 코드 자세한 오류 응답입니다.
 FabricError