注意
グループとプロジェクトは同義語です。あなたの {PROJECT-ID} は、グループ IDと同じです。既存のグループの場合、グループ/グループ ID は同じままです。このページでは、説明を参照するときに、より一般的なタームのグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。
このエンドポイントとなる接続されたデバイスを使用して、レプリカセットの特定のセカンダリをプライマリに昇格させるようリクエストします。MongoDB Ops Managerは、他のノードではなくターゲットプロセスが選挙に勝てるように、他の選出可能なセカンダリをフリーズします。ターゲットホストのオートメーションエージェントは、次回のチェックイン時にフリーズおよびステップダウン手順を実行します。
エージェントがジョブを実行する際に、ターゲットプロセスが選出可能なセカンダリではない場合(例:すでにプライマリである、またはアービタ、非表示、投票権のないノードであるなど)、ジョブは失敗し、説明メッセージが表示されます。
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp必須のロール
このリクエストを行うAPIキーには、Project Automation Adminロールが必要です。
リクエスト パス パラメーター
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
グループ ID | string | 必須 | プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。 |
RS-ID | string | 必須 | ターゲットプロセスを含むレプリカセットの名前。 |
ホストする-ポート | string | 必須 |
|
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
|---|---|---|---|---|
pretty | ブール値 | 任意 | レスポンス本体をpretty-print形式にするかどうかを示すフラグ。 |
|
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。
|
|
リクエスト ボディ パラメータ
リクエストボディでは、以下の任意の調整項目を指定できます。空のボディを送信する場合は、{}を使用してください。
名前 | タイプ | 説明 | default |
|---|---|---|---|
stepDownSecs | integer | 送信側のプライマリが再選挙の対象外となる秒数。 |
|
secondaryCatchUpPeriodSecs | integer | プライマリがステップダウンする前に、遅延しているセカンダリが追いつくのを待機する秒数。 | なし |
freezeSecs | integer | ターゲットが選挙に勝てるように、MongoDB Ops Managerが他の選出可能なセカンダリをフリーズさせる秒数。 |
|
expiresAfterSeconds | integer | ジョブが期限切れになる前に、オートメーションエージェントがリクエストをピックアップするためにキューに留まる秒数。 |
|
重要
フリーズウィンドウの間、他のすべての選挙可能なセカンダリはフリーズされ、選挙に立候補できません。freezeSecsは、環境が許す限り短くしてください。フリーズ中にターゲットホストに到達できなくなった場合、フリーズが終了するまでレプリカセットにプライマリが存在しない状態になる可能性があります。
応答
Ops Managerは、1つの再選挙ジョブを取得エンドポイントとなる接続されたデバイスを指す点であるLocationヘッダーを含む202 Acceptedを返し、レスポンス本文には再選挙ジョブドキュメントを返します。
名前 | タイプ | 説明 |
|---|---|---|
id | string | 再選挙ジョブを識別するユニークな 24 桁の 16 進数の string。 |
グループ ID | string | プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。 |
アクション | string | このジョブが実行するアクション。 |
ReplicaSetName | string | ターゲットレプリカセットの名前。 |
Hostname | string | ターゲットプロセスのホスト名。 |
ポート | integer | ターゲットプロセスのポート。 |
状態 | string | ジョブのステータス。 |
noop | ブール値 | 操作がno-opとして完了したかどうかを示すフラグ。 |
メッセージ | string | ジョブに関する人間が読める形式の詳細。エージェントが結果を報告した後、MongoDB Ops Managerがこのフィールドに値を入力します。 |
作成済み | string | Ops Manager がジョブを作成したときのタイムスタンプ(ISO 8601 UTC形式 ) 。 |
最終更新日時 | string | MongoDB Ops Managerが最後にジョブを更新した日時(ISO 8601 UTC形式)。 |
expires | string | オートメーションエージェントがこのジョブをこれ以上取得しなくなる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 | チューナブルが範囲外であるか、 |
400 | AUTOMATION_AGENT_VERSION_NOT_SUPPORTED | ターゲットホストのオートメーションエージェントが |
401 | USER_UNAUTHORIZED | APIキーには |
401 | ユーザーは組織にアクセスできません | 呼び出し元はプロジェクトの組織外にあります。 |
404 | 自動化構成が見つかりません | プロジェクトには公開されたオートメーション構成がありません。 |
404 | CLUSTER_NOT_FOUND |
|
404 | PROCESS_NOT_IN_CLUSTER |
|
409 | REELECTION_AGENT_NOT_RESPONDING | ターゲットホストのオートメーションエージェントが、最近MongoDB Ops Managerにpingを送信していません。 |
409 | REELECTION_ALREADY_IN_PROGRESS | このレプリカセットでは、再選挙ジョブがすでにキューに入れられているか、実行中です。 |