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

복제본 세트 세컨더리 승격 요청

참고

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

이 엔드포인트를 사용하여 복제본 세트의 특정 세컨더리가 프라이머리가 되도록 요청합니다. MongoDB Ops Manager는 다른 노드가 아닌 대상 프로세스가 투표에서 승리하도록 다른 선출 가능한 세컨더리를 동결합니다. 대상 호스팅하다의 자동화 에이전트는 다음 체크인 시 동결 및 단계적 축소 절차를 실행합니다.

에이전트가 작업을 실행할 때 대상 프로세스가 선출 가능한 세컨더리가 아닌 경우(예시: 이미 프라이머리이거나 중재자, 숨겨진 노드 또는 투표권이 없는 노드인 경우), 작업은 설명 메시지와 함께 실패합니다.

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

POST /groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp

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

이름
유형
필요성
설명

그룹 ID

문자열

필수 사항

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

RS-ID

문자열

필수 사항

대상 프로세스가 포함된 복제본 세트의 이름입니다.

호스팅하다-포트

문자열

필수 사항

hostname:port으로 대상 프로세스. 이 프로세스는 현재 활성 상태이며 선출 가능한 세컨더리여야 합니다.

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

이름
유형
필요성
설명
기본값

pretty

부울

옵션

응답 본문이 pretty-print 형식인지 여부를 나타내는 플래그입니다.

false

envelope

부울

옵션

응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다.

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

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

  • status: HTTP 응답 코드

  • content예상되는 응답 본문

false

요청 본문은 다음 선택 사항인 조정 가능한 매개변수를 허용합니다. 빈 본문을 보내는 경우 {}을(를) 사용하세요.

이름
유형
설명
기본값

stepDownSecs

integer

기존 프라이머리가 투표 대상에서 제외되는 시간(초)입니다. 0보다 커야 합니다.

60

secondaryCatchUpPeriodSecs

integer

프라이머리가 단계적으로 중단되기 전에 지연된 세컨더리가 따라잡을 때까지 기다리는 시간(초)입니다. 0보다 크거나 같아야 합니다. 이 필드를 생략하면 mongod이(가) 자체 기본값을 적용합니다.

none

freezeSecs

integer

대상 노드가 투표에서 승리할 수 있도록 MongoDB Ops Manager가 다른 선출 가능한 세컨더리를 고정하는 시간(초)입니다. 0보다 커야 하며 stepDownSecs보다 크거나 같아야 합니다.

120와 stepDownSecs 중 더 큰 값

expiresAfterSeconds

integer

작업이 만료되기 전에 자동화 에이전트가 요청을 선택할 때까지 요청이 대기열에 유지되는 시간(초)입니다. 0보다 커야 합니다.

300와 freezeSecs 중 더 큰 값

중요

동결 창 동안에는 투표 가능한 다른 모든 세컨더리가 동결되어 투표에 참여할 수 없습니다. 환경이 허용하는 한 freezeSecs을(를) 짧게 유지하세요. 동결 중에 대상 호스팅하다에 연결할 수 없게 되면 동결이 만료될 때까지 복제본 세트에 프라이머리가 없을 수 있습니다.

Ops Manager는 재투표 작업 가져오기 엔드포인트를 점 가리키는 Location 헤더와 함께 202 Accepted을(를) 반환하며, 응답 본문에는 재투표 작업 문서가 포함됩니다.

이름
유형
설명

id

문자열

재투표 작업을 식별하는 고유한 24-16진수 문자열입니다.

groupId

문자열

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

조치

문자열

이 작업이 수행하는 조치입니다. 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" \ --header "Content-Type: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp?pretty=true" \ --data '{ "stepDownSecs": 60, "freezeSecs": 120 }'
HTTP/1.1 202 AcceptedVary: Accept-EncodingContent-Type: application/jsonLocation: https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}Strict-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": "QUEUED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:37:59Z", "expires": "2026-08-11T05:39:59Z"}
HTTP Status
오류 코드
설명

202

--

요청이 수락되었습니다. 재투표 작업 문서를 반환합니다.

400

INVALID_PARAMETER

튜너블이 범위를 벗어났거나 freezeSecs이(가) stepDownSecs보다 작습니다.

400

AUTOMATION_AGENT_VERSION_NOT_SUPPORTED

대상 호스트의 자동화 에이전트가 109.0.0.9226-1보다 이전 버전입니다.

401

USER_UNAUTHORIZED

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

401

USER_CANNOT_ACCESS_ORG

호출자가 프로젝트 조직 외부에 있습니다.

404

AUTOMATION_CONFIG_NOT_FOUND

이 프로젝트에는 게시된 자동화 구성이 없습니다.

404

CLUSTER_NOT_FOUND

RS-ID 프로젝트의 배포서버에 있는 복제본 세트와 일치하지 않습니다.

404

PROCESS_NOT_IN_CLUSTER

HOST-PORT 은(는) 지정된 복제본 세트의 노드가 아닙니다.

409

REELECTION_AGENT_NOT_RESPONDING

대상 호스트의 자동화 에이전트가 최근 MongoDB Ops Manager에 핑을 보내지 않았습니다.

409

REELECTION_ALREADY_IN_PROGRESS

이 복제본 세트에 대해 이미 재투표 작업이 대기 중이거나 실행 중입니다.