노드 전환 시작

아티클
07/19/2023

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

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

요청

메서드	요청 URI
POST	`/Faults/Nodes/{nodeName}/$/StartTransition/?api-version=6.0&OperationId={OperationId}&NodeTransitionType={NodeTransitionType}&NodeInstanceId={NodeInstanceId}&StopDurationInSeconds={StopDurationInSeconds}&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`nodeName`	문자열	예	경로
`api-version`	문자열	예	쿼리
`OperationId`	string(uuid)	예	쿼리
`NodeTransitionType`	string(열거형)	예	쿼리
`NodeInstanceId`	문자열	예	쿼리
`StopDurationInSeconds`	정수(int32)	예	쿼리
`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에 전달됩니다.

`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초입니다.

응답

HTTP 상태 코드	설명	응답 스키마
202(수락됨)	202 상태 코드는 작업이 수락되었음을 나타냅니다. GetNodeTransitionProgress API를 호출하여 진행 상황을 가져옵니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

Share via