노드 전환 시작

클러스터 노드를 시작하거나 중지합니다.

클러스터 노드를 시작하거나 중지합니다. 클러스터 노드는 프로세스이지 OS 인스턴스 그 자체가 아닙니다. 노드를 시작하려면 NodeTransitionType 매개 변수에 대한 "Start"을 전달합니다. 노드를 중지하려면 NodeTransitionType 매개 변수에 대한 "Stop"을 전달합니다. API가 아직 전환을 마치지 못한 노드를 반환할 때 이 API가 작업을 시작합니다. 작업의 진행률을 가져오려면 동일한 OperationId로 GetNodeTransitionProgress를 호출합니다.

요청

매개 변수

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에 전달됩니다.

NodeTransitionType

형식: string(열거형)
필수: 예

수행할 전환의 유형을 나타냅니다. NodeTransitionType.Start는 중지된 노드를 시작합니다. NodeTransitionType.Stop은 작동하는 노드를 중지합니다. 가능한 값은 'Invalid', 'Start', 'Stop'입니다.

NodeInstanceId

형식: 문자열
필수: 예

대상 노드의 노드 인스턴스 ID입니다. 이것은 GetNodeInfo API를 통해 확인할 수 있습니다.

StopDurationInSeconds

형식: 정수(int32)
필수: 예
InclusiveMinimum: 0

노드가 중지된 채로 유지되는 기간(초). 최솟값은 600, 최댓값은 14400입니다. 이 시간이 만료되면 노드가 자동으로 다시 작동합니다.

timeout

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

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

응답