취소 작업

사용자로 인한 오류 작업을 취소합니다.

다음 API는 CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition을 사용하여 취소될 수 있는 오류 작업을 시작합니다.

force가 false인 경우 지정된 사용자로 인한 작업이 정상적으로 중지되며 정리됩니다. force가 true인 경우 명령이 중단되며, 일부 내부 상태가 남아 있을 수 있습니다. force를 true로 지정하는 것은 주의해서 사용해야 합니다. force가 true로 설정된 이 API를 호출하는 것은 이 API가 force가 false로 먼저 설정된 동일한 테스트 명령에서 호출될 때까지 또는 테스트 명령에 이미 OperationState.RollingBack의 OperationState가 있는 한 허용되지 않습니다. 설명: OperationState.RollingBack은 시스템이 명령 실행으로 인해 발생된 내부 시스템 상태를 정리함을 의미합니다. 테스트 명령이 데이터 손실을 발생시킨 경우 데이터를 복원하지 않습니다. 예를 들어 StartDataLoss를 호출한 다음, 이 API를 호출하는 경우 시스템은 명령 실행에서의 내부 상태만을 정리합니다. 명령이 데이터 손실을 충분히 진행시킨 경우 대상 파티션의 데이터를 복원하지 않습니다.

중요 설명: 이 API가 force==true로 호출되면 내부 상태는 남아 있을 수 있습니다.

요청

메서드	요청 URI
POST	/Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}

매개 변수

속성	형식	필수	위치
api-version	문자열	예	쿼리
OperationId	string(uuid)	예	쿼리
Force	boolean	예	쿼리
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 버전에 따라 다릅니다.

---

OperationId

형식: string(uuid)
필수: 예

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

---

Force

형식: 부울
필수: 예
기본: false

사용자로 인한 작업을 실행하여 수정된 내부 시스템 상태를 정상적으로 롤백 및 정리할지 여부를 나타냅니다.

---

timeout

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

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

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	작업이 성공하면 200개 상태 코드가 반환됩니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError