Ops Manager API を使用すると、配置のホストに直接接続せずにレプリカセットの再選挙を実行できます。このリソースを使用して、現在のプライマリをステップダウンさせ、特定のセカンダリをプライマリになるようにステップアップして、結果のジョブを追跡します。
各リクエストは、ターゲット ホストのオートメーションエージェントが次回のチェックインで実行するジョブをキューに入れます。次のエンドポイントを使用して、再選挙ジョブを作成および取得します。
前提条件
再選挙ジョブリソースを使用する前に、次の要件を確認してください。
注意
グループとプロジェクトは同義語です。あなたの {PROJECT-ID} は、グループ IDと同じです。既存のグループの場合、グループ/グループ ID は同じままです。このページでは、説明を参照するときに、より一般的なタームのグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
再選挙ジョブ リソースを使用するには、Project Automation Admin ロールを持つ MongoDB Ops Manager ユーザー である必要があります。
重要
この機能には、非管理（セルフホスト型）配置で有料の Ops Managerサブスクライブが必要です。
配置では Ops Manager 8.0.27 または 9.0.0 以降を実行する必要があり、ターゲット ホストのオートメーションエージェントはバージョン 109.0.0.9226-1 以降を実行し、最近 Ops Manager を ping している必要があります。
レプリカセットごとに一度に未処理になる再選挙ジョブは、ステップダウンまたはステップアップリクエストのいずれか 1 つだけです。ジョブがすでにキューに入れられているか、を実行中場合、Ops Manager は 409 REELECTION_ALREADY_IN_PROGRESS エラーを発生させて、同じレプリカセットに対する新しいリクエストを拒否します。
重要
レプリカセットの再選挙は、 Kubernetes Operator（MVK）配置ではサポートされていません。
エンドポイント
次の表は、 再選挙ジョブリソースで使用できるエンドポイントを一覧表示したものです。
方式 | エンドポイント | 説明 |
|---|---|---|
| レプリカセットの現在のプライマリが降格することを要求します。 | |
| 特定のセカンダリがプライマリになるようにステップアップすることを要求します。 | |
|
| |
| 指定されたレプリカセットのすべての再選挙ジョブを検索します。 |