AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの 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

string

必須

プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。

RS-ID

string

必須

再選挙ジョブを一覧表示するレプリカセットの名前。

名前
タイプ
説明
default

pageNum

integer

ページ番号(1 インデックス ベース)。

1

itemsPerPage

integer

1 ページあたりに返す項目の数は最大 500 です。

100

pretty

ブール値

レスポンス本体を pretty-print 形式にするかどうかを示します。

false

envelope

ブール値

応答をエンベロープでラップするかどうかを示します。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで "envelope" : true を設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

  • status: HTTPレスポンス コード

  • content: 期待される応答本体

結果のリストを返すエンドポイントの場合、 resultsオブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体にstatusフィールドを追加します。

なし

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答には、再選挙ジョブオブジェクトの配列と、検索されたジョブオブジェクトの合計数が含まれます。

名前
タイプ
説明

結果

配列

再選挙ジョブの配列。作成日時が新しい順に並べ替えられています。results 埋め込みドキュメントを参照してください。

totalCount

数値

結果セット内のアイテムの総数。レスポンスがページ分割されている場合、これは results 内のアイテム数を超える可能性があります。

results の各要素は、1 つの再選挙ジョブを表します。

名前
タイプ
説明

id

string

再選挙ジョブを識別するユニークな 24 桁の 16 進数の string。

グループ ID

string

プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。

アクション

string

このジョブが実行するアクション。STEP_DOWN または STEP_UP のいずれかの値を返します。

ReplicaSetName

string

ターゲットレプリカセットの名前。

Hostname

string

ターゲットプロセスのホスト名。

ポート

integer

ターゲットプロセスのポート。

状態

string

ジョブのステータス。QUEUED、RUNNING、COMPLETED、FAILED、または EXPIRED のいずれかの値を返します。

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" \ --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ロールがありません。