참고
그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID가 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.
이 엔드포인트를 사용하여 특정 복제본 세트 에 대한 모든 재선 작업 조회 .
기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs
필수 역할
이 요청 수행하는 API 키에는 Project Automation Admin 역할 있어야 합니다.
요청 경로 매개변수
이름 | 유형 | 필요성 | 설명 |
|---|---|---|---|
그룹 ID | 문자열 | 필수 사항 | 프로젝트를 식별하는 고유한 24자리 16진수 문자열입니다. |
RS- ID | 문자열 | 필수 사항 | 재투표 작업을 나열하려는 복제본 세트 의 이름입니다. |
요청 쿼리 매개변수
이름 | 유형 | 설명 | 기본값 |
|---|---|---|---|
pageNum | integer | 페이지 번호(1-인덱스 기준)입니다. |
|
itemsPerPage | integer | 페이지당 반환할 항목 수. 최대 500개까지 가능합니다. |
|
pretty | 부울 | 응답 본문이 프리티 프린트 형식이어야 하는지 여부를 나타냅니다. |
|
envelope | 부울 | 응답을 엔벨로프에 래핑할지 여부를 나타냅니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드 액세스 할 수 없습니다. 이 문제를 해결하려면 쿼리 에서 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.
결과 목록을 반환하는 엔드포인트의 경우 | none |
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
응답에는 재투표 작업 객체 배열 과 조회된 총 작업 객체 수가 포함됩니다.
이름 | 유형 | 설명 |
|---|---|---|
결과 | 배열 | 가장 최근에 생성된 것부터 가장 최근에 생성된 것 순으로 정렬된 재투표 작업의 배열입니다. |
총 개수 | 숫자 | 결과 설정하다 의 총 항목 수입니다. 이는 응답이 페이지 매김될 때 |
results embeddedDocument
results의 각 요소는 하나의 재투표 작업 나타냅니다.
이름 | 유형 | 설명 |
|---|---|---|
id | 문자열 | 재투표 작업 식별하는 고유한 24-16진수 문자열입니다. |
groupId | 문자열 | 프로젝트를 식별하는 고유한 24자리 16진수 문자열. |
조치 | 문자열 | 이 작업 수행하는 작업입니다. |
복제본 세트 이름 | 문자열 | 대상 복제본 세트 의 이름입니다. |
호스트 이름 | 문자열 | 대상 프로세스 의 호스트 이름입니다. |
포트 | integer | 대상 프로세스 의 포트입니다. |
상태 | 문자열 | 작업 의 상태입니다. 다음 값 중 하나를 반환합니다: |
noOp | 부울 | 작업이 no-op으로 완료되었는지 여부를 나타내는 플래그입니다. |
메시지 | 문자열 | 사람이 읽을 수 있는 작업 에 대한 세부 정보입니다. 에이전트 결과를 보고하면 Ops Manager 이 필드 채웁니다. |
생성됨 | 문자열 | Ops Manager 작업 생성한 시점의 ISO 8601 UTC 형식의 타임스탬프입니다. |
lastUpdated | 문자열 | Ops Manager 작업 마지막으로 업데이트한 ISO 8601 UTC 형식의 타임스탬프입니다. |
expires | 문자열 | 자동화 에이전트 더 이상 이 작업 선택하지 않는 ISO 8601 UTC 형식의 타임스탬프입니다. |
요청 예시
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?pretty=true"
응답 예시
응답 헤더
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
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 "results": [ 3 { 4 "id": "665a1234567890abcdef5678", 5 "groupId": "5c8100bcf2a30b12ff88258f", 6 "action": "STEP_UP", 7 "replicaSetName": "rs0", 8 "hostname": "node2.example.com", 9 "port": 27017, 10 "status": "COMPLETED", 11 "noOp": false, 12 "message": null, 13 "created": "2026-08-11T05:40:00Z", 14 "lastUpdated": "2026-08-11T05:41:15Z", 15 "expires": "2026-08-11T05:45:00Z" 16 }, 17 { 18 "id": "665a1234567890abcdef1234", 19 "groupId": "5c8100bcf2a30b12ff88258f", 20 "action": "STEP_DOWN", 21 "replicaSetName": "rs0", 22 "hostname": "node1.example.com", 23 "port": 27017, 24 "status": "COMPLETED", 25 "noOp": false, 26 "message": null, 27 "created": "2026-08-11T05:37:59Z", 28 "lastUpdated": "2026-08-11T05:38:30Z", 29 "expires": "2026-08-11T05:42:59Z" 30 } 31 ], 32 "totalCount": 2 33 }
응답 코드
HTTP Status | 오류 코드 | 설명 |
|---|---|---|
200 | -- | 재투표 작업의 배열 반환합니다. |
401 | USER_UNAUTHORIZED | API 키에 |