Share via

노드 전환 진행률 가져오기

  • 아티클

StartNodeTransition을 사용하여 시작된 작업의 진행률을 가져옵니다.

제공 된 OperationId를 사용하여 StartNodeTransition으로 시작되는 작업의 진행률을 가져옵니다.

요청

메서드 요청 URI
GET /Faults/Nodes/{nodeName}/$/GetTransitionProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

매개 변수

속성 형식 필수 위치
nodeName 문자열 예 경로
api-version 문자열 예 쿼리
OperationId string(uuid) 예 쿼리
timeout 정수(int64) 아니요 쿼리

nodeName

형식: 문자열
필수: 예

노드의 이름입니다.

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

OperationId

형식: string(uuid)
필수: 예

이 API의 호출을 식별하는 GUID입니다. 해당 GetProgress API에 전달됩니다.

timeout

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

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

응답

HTTP 상태 코드 설명 응답 스키마
200(확인) 노드 전환 작업의 진행률에 대한 정보입니다.
 NodeTransitionProgress
다른 모든 상태 코드 자세한 오류 응답입니다.
 FabricError

예제

완료된 NodeTransition 작업에 대한 정보를 가져옵니다.

GetTransitionProgress가 완료됨 상태에 도달했을 때 가능한 출력의 예를 보여 줍니다. State에 실행 중 값이 있는 경우 상태 필드에만 값이 있습니다.

요청

GET http://localhost:19080/Faults/Nodes/N0060/$/GetTransitionProgress?api-version=6.0&OperationId=a9c24269-88e9-4812-b4ad-a0bf2b724ad4

200 응답

본문
{
  "State": "Completed",
  "NodeTransitionResult": {
    "ErrorCode": "0",
    "NodeResult": {
      "NodeName": "N0060",
      "NodeInstanceId": "131366982707950527"
    }
  }
}

실행 중인 NodeTransition 작업에 대한 정보를 가져옵니다.

GetTransitionProgress에 실행 중 상태가 있는 경우의 출력 예제를 보여 줍니다.

요청

GET http://localhost:19080/Faults/Nodes/N0060/$/GetTransitionProgress?api-version=6.0&OperationId=ed903556-acf1-489c-9f33-b484c31f9087

200 응답

본문
{
  "State": "Running"
}