복제본 제거

노드에서 실행되는 서비스 복제본을 제거합니다.

이 API는 Service Fabric 클러스터에서 복제본을 제거하여 Service Fabric 복제 오류를 시뮬레이션합니다. 제거는 복제본을 닫고, 복제본을 None 역할로 전환한 다음, 클러스터에서 복제본의 상태 정보 모두를 제거합니다. 이 API는 복제 상태 제거 경로를 테스트하고, 클라이언트 API를 통해 보고서 오류 영구 경로를 시뮬레이션합니다. 경고 ‑ 이 API가 사용될 때 수행되는 안전 검사가 없습니다. 이 API를 잘못 사용하면 상태 저장 서비스에 대한 데이터가 손실될 수 있습니다. 또한 forceRemove 플래그는 동일한 프로세스에서 호스팅되는 다른 모든 복제본에 영향을 줍니다.

요청

메서드	요청 URI
POST	/Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout}

매개 변수

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

---

nodeName

형식: 문자열
필수: 예

노드의 이름입니다.

---

partitionId

형식: string(uuid)
필수: 예

파티션의 id입니다.

---

replicaId

형식: 문자열
필수: 예

복제본의 식별자입니다.

---

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

---

ForceRemove

형식: 부울
필수: 아니요

정상적인 종료 시퀀스를 거치지 않고 강제로 Service Fabric 애플리케이션이나 서비스를 제거합니다. 이 매개 변수는 복제본을 정상적으로 종료하지 못하게 하는 서비스 코드의 문제로 인해 삭제 시간이 초과되는 애플리케이션이나 서비스를 강제로 삭제하는 데 사용할 수 있습니다.

---

timeout

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

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

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	작업이 성공하면 200개 상태 코드가 반환됩니다. 작업이 성공하면 노드의 복제본(replica) 다시 시작 명령을 수신했으며 다시 시작하는 중입니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError