1개의 복제본 세트 재투표 작업 가져오기

참고

그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID가 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.

이 엔드포인트를 사용하여 고유 식별자로 단일 재투표 작업 조회 . 작업 이 터미널 상태에 도달할 때까지 이 엔드포인트를 폴링합니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}

필수 역할

이 요청 수행하는 API 키에는 Project Automation Admin 역할 있어야 합니다.

요청 경로 매개변수

이름	유형	필요성	설명
그룹 ID	문자열	필수 사항	프로젝트를 식별하는 고유한 24자리 16진수 문자열입니다.
RS- ID	문자열	필수 사항	재투표 작업 포함된 복제본 세트 의 이름입니다.
REELECTION-JOB- ID	문자열	필수 사항	재투표 작업 식별하는 고유한 24-16진수 문자열로, 강등 또는 승격 엔드포인트에서 반환됩니다.

요청 쿼리 매개변수

다음 쿼리 매개변수는 선택 사항입니다.

이름	유형	필요성	설명	기본값
pretty	부울	옵션	응답 본문이 프리티프린트 형식인지 여부를 나타내는 플래그입니다.	`false`
envelope	부울	옵션	응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다. `status`: HTTP 응답 코드 `content`예상되는 응답 본문	`false`

요청 본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

응답은 단일 재투표 작업 반환합니다.

이름	유형	설명
id	문자열	재투표 작업 식별하는 고유한 24-16진수 문자열입니다.
groupId	문자열	프로젝트를 식별하는 고유한 24자리 16진수 문자열.
조치	문자열	이 작업 수행하는 작업입니다. `STEP_DOWN` 또는 `STEP_UP` 값 중 하나를 반환합니다.
복제본 세트 이름	문자열	대상 복제본 세트 의 이름입니다.
호스트 이름	문자열	대상 프로세스 의 호스트 이름입니다.
포트	integer	대상 프로세스 의 포트입니다.
상태	문자열	작업 의 상태입니다. 다음 값 중 하나를 반환합니다: `QUEUED`, `RUNNING`, `COMPLETED`, `FAILED` 또는 `EXPIRED`.
noOp	부울	작업이 no-op으로 완료되었는지 여부를 나타내는 플래그입니다.
메시지	문자열	사람이 읽을 수 있는 작업 에 대한 세부 정보입니다. 에이전트 결과를 보고하면 Ops Manager 이 필드 채웁니다.
생성됨	문자열	Ops Manager 작업 생성한 시점의 ISO 8601 UTC 형식의 타임스탬프입니다.
lastUpdated	문자열	Ops Manager 작업 마지막으로 업데이트한 ISO 8601 UTC 형식의 타임스탬프입니다.
expires	문자열	자동화 에이전트 더 이상 이 작업 선택하지 않는 ISO 8601 UTC 형식의 타임스탬프입니다.

작업 상태 값

상태	터미널	의미
QUEUED	No	Ops Manager 작업 생성했습니다. 대상 호스트의 자동화 에이전트 이를 선택하기를 기다리고 있습니다.
달리는	No	에이전트 작업 실행 입니다.
완료	예	작업이 완료되었습니다. `noOp`를 확인하여 작업이 변경되었는지 확인합니다.
실패하였습니다.	예	작업을 완료할 수 없습니다. 그 이유는 `message`를 참조하세요.
만료됨	예	`expiresAfterSeconds`이(가) 경과하기 전에 작업 선택한 에이전트 없습니다.

요청 예시

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --include \
4      --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}?pretty=true"

응답 예시

응답 헤더

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

응답 본문

1 {
2   "id": "665a1234567890abcdef1234",
3   "groupId": "5c8100bcf2a30b12ff88258f",
4   "action": "STEP_UP",
5   "replicaSetName": "rs0",
6   "hostname": "node2.example.com",
7   "port": 27017,
8   "status": "COMPLETED",
9   "noOp": false,
10   "message": null,
11   "created": "2026-08-11T05:37:59Z",
12   "lastUpdated": "2026-08-11T05:38:45Z",
13   "expires": "2026-08-11T05:39:59Z"
14 }

응답 코드

HTTP Status	오류 코드	설명
200	--	재투표 작업 문서 반환합니다.
401	USER_UNAUTHORIZED	API 키에 `Project Automation Admin` 역할 없습니다.
404	REELECTION_JOB_NOT_FOUND	`REELECTION-JOB-ID` 알 수 없거나 형식이 잘못되었거나 작업 `RS-ID`로 명명된 복제본 세트 에 속하지 않습니다.

돌아가기

세컨더리 업그레이드

모두 가져오기

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--include \
4	--request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}?pretty=true"

1	{
2	"id": "665a1234567890abcdef1234",
3	"groupId": "5c8100bcf2a30b12ff88258f",
4	"action": "STEP_UP",
5	"replicaSetName": "rs0",
6	"hostname": "node2.example.com",
7	"port": 27017,
8	"status": "COMPLETED",
9	"noOp": false,
10	"message": null,
11	"created": "2026-08-11T05:37:59Z",
12	"lastUpdated": "2026-08-11T05:38:45Z",
13	"expires": "2026-08-11T05:39:59Z"
14	}