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

복제본 세트 프라이머리 단계 다운 요청

참고

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

이 엔드포인트를 사용하여 복제본 세트의 현재 프라이머리가 직책 사임하도록 요청하고, 이로 인해 새로운 투표를 트리거합니다. Ops Manager는 대상 호스트의 자동화 에이전트가 다음 체크인 시 실행할 배경 작업을 대기열에 추가합니다.

에이전트가 작업을 실행할 때 타겟 프로세스가 쓰기 가능한 프라이머리가 아닌 경우, 작업은 실패하지 않고 아무 작업도 실행하지 않은 상태로 완료됩니다. 프라이머리가 물러난 후, stepDownSecs에 의해 지정된 기간 동안 재선 자격이 없습니다.

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

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

이 요청을 수행하는 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

expiresAfterSeconds

integer

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

300

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

이름
유형
설명

id

문자열

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

groupId

문자열

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

조치

문자열

이 작업이 수행하는 조치입니다. STEP_DOWN을(를) 반환합니다.

복제본 세트 이름

문자열

대상 복제본 세트의 이름입니다.

호스트 이름

문자열

대상 프로세스의 호스트 이름입니다.

포트

integer

대상 프로세스의 포트입니다.

상태

문자열

작업 상태입니다. QUEUED, RUNNING, COMPLETED, FAILED 또는 EXPIRED 중 하나의 값을 반환합니다.

눕

부울

작업이 no-op으로 완료되었는지 여부를 나타내는 플래그입니다. 에이전트가 작업을 실행했을 때 대상 프로세스가 이미 세컨더리인 경우 true을(를) 반환합니다.

메시지

문자열

작업에 대한 사람이 읽을 수 있는 세부 정보입니다. 에이전트가 결과를 보고한 후 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}:stepDown?pretty=true" \ --data '{ "stepDownSecs": 60, "secondaryCatchUpPeriodSecs": 10 }'
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_DOWN", "replicaSetName": "rs0", "hostname": "node1.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:42:59Z"}
HTTP Status
오류 코드
설명

202

--

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

400

INVALID_PARAMETER

튜너블이 범위를 벗어났거나 요청 본문에 freezeSecs이(가) 포함되어 있습니다.

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

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