AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

단일 복제본 세트 투표 작업 가져오기

참고

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

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

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

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 형식인지 여부를 나타내는 플래그입니다.

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 중 하나의 값을 반환합니다.

눕

부울

작업이 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

예

작업이 완료되었습니다. 작업이 변경사항을 일으켰는지 여부를 판단하려면 noOp을(를) 확인하세요.

실패하였습니다.

예

작업을 완료할 수 없습니다. 이유는 message을(를) 참조하세요.

만료됨

예

expiresAfterSeconds이(가) 경과하기 전에 작업을 선택한 에이전트가 없습니다.

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-alive
HTTP/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 키에 Project Automation Admin 역할이 없습니다.

404

REELECTION_JOB_NOT_FOUND

REELECTION-JOB-ID 알 수 없거나 형식이 잘못되었거나, 작업이 RS-ID에 명명된 복제본 세트에 속하지 않습니다.