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

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

이름
유형
필요성
설명

그룹 ID

문자열

필수 사항

프로젝트를 식별하는 고유한 24자리 16진수 문자열입니다.

RS-ID

문자열

필수 사항

재투표 작업을 나열하려는 복제본 세트의 이름입니다.

이름
유형
설명
기본값

pageNum

integer

페이지 번호(1-인덱스 기준)입니다.

1

itemsPerPage

integer

페이지당 반환할 항목 수. 최대 500개까지 가능합니다.

100

pretty

부울

응답 본문이 프리티 프린트 형식이어야 하는지 여부를 나타냅니다.

false

envelope

부울

응답을 엔벨로프에 래핑할지 여부를 나타냅니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 "envelope" : true을(를) 설정합니다.

하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.

  • status: HTTP 응답 코드

  • content예상되는 응답 본문

결과 목록을 반환하는 엔드포인트의 경우 results 객체는 엔벨로프입니다. Ops Manager가 응답 본문에 status 필드를 추가합니다.

none

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

응답에는 재투표 작업 객체 배열과 조회된 작업 객체의 총 개수가 포함됩니다.

이름
유형
설명

결과

배열

가장 최근에 생성된 순서대로 정렬된 재투표 작업의 배열입니다. results 내장된 문서를 참조하세요.

총 개수

숫자

결과 세트의 총 항목 수입니다. 응답이 페이지화된 경우 results의 항목 수를 초과할 수 있습니다.

results의 각 요소는 하나의 재투표 작업을 나타냅니다.

이름
유형
설명

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 형식의 타임스탬프입니다.

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?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}
{ "results": [ { "id": "665a1234567890abcdef5678", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_UP", "replicaSetName": "rs0", "hostname": "node2.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:40:00Z", "lastUpdated": "2026-08-11T05:41:15Z", "expires": "2026-08-11T05:45:00Z" }, { "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_DOWN", "replicaSetName": "rs0", "hostname": "node1.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:38:30Z", "expires": "2026-08-11T05:42:59Z" } ], "totalCount": 2}
HTTP Status
오류 코드
설명

200

--

재투표 작업의 배열을 반환합니다.

401

USER_UNAUTHORIZED

API 키에 Project Automation Admin 역할이 없습니다.