참고
그룹과 프로젝트는 동의어입니다. {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-작업-ID | 문자열 | 필수 사항 | 스텍 다운 또는 스텍 업 엔드포인트에서 반환되는 재투표 작업을 식별하는 고유한 24-16진수 string. |
요청 쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
이름 | 유형 | 필요성 | 설명 | 기본값 |
|---|---|---|---|---|
pretty | 부울 | 옵션 | 응답 본문이 pretty-print 형식인지 여부를 나타내는 플래그입니다. |
|
envelope | 부울 | 옵션 | 응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.
|
|
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
응답은 단일 재투표 작업을 반환합니다.
이름 | 유형 | 설명 |
|---|---|---|
id | 문자열 | 재투표 작업을 식별하는 고유한 24-16진수 문자열입니다. |
groupId | 문자열 | 프로젝트를 식별하는 고유한 24자리 16진수 문자열. |
조치 | 문자열 | 이 작업이 수행하는 조치입니다. |
복제본 세트 이름 | 문자열 | 대상 복제본 세트의 이름입니다. |
호스트 이름 | 문자열 | 대상 프로세스의 호스트 이름입니다. |
포트 | integer | 대상 프로세스의 포트입니다. |
상태 | 문자열 | 작업 상태입니다. |
눕 | 부울 | 작업이 no-op으로 완료되었는지 여부를 나타내는 플래그입니다. |
메시지 | 문자열 | 작업에 대한 사람이 읽을 수 있는 세부 정보입니다. 에이전트가 결과를 보고한 후 MongoDB Ops Manager가 이 필드를 채웁니다. |
생성됨 | 문자열 | Ops Manager 작업 생성한 시점의 ISO 8601 UTC 형식의 타임스탬프입니다. |
마지막 업데이트 | 문자열 | MongoDB Ops Manager가 작업을 마지막으로 업데이트한 시간(ISO 8601 UTC 형식). |
expires | 문자열 | 자동화 에이전트가 이 작업을 더 이상 선택하지 않는 ISO 8601 UTC 형식의 타임스탬프입니다. |
작업 상태 값
상태 | 터미널 | 의미 |
|---|---|---|
QUEUED | No | MongoDB Ops Manager가 작업을 생성했습니다. 대상 호스트의 자동화 에이전트가 이를 가져가기를 기다리는 중입니다. |
실행 중 | No | 에이전트가 작업을 실행 중입니다. |
completed | 예 | 작업이 완료되었습니다. 작업이 변경사항을 일으켰는지 여부를 판단하려면 |
실패하였습니다. | 예 | 작업을 완료할 수 없습니다. 이유는 |
만료됨 | 예 |
|
요청 예시
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --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 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-aliveHTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}응답 본문
{ "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_UP", "replicaSetName": "rs0", "hostname": "node2.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:38:45Z", "expires": "2026-08-11T05:39:59Z"}응답 코드
HTTP Status | 오류 코드 | 설명 |
|---|---|---|
200 | -- | 재투표 작업 문서를 반환합니다. |
401 | USER_UNAUTHORIZED | API 키에 |
404 | REELECTION_JOB_NOT_FOUND |
|