プロセスの監視を停止する
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
このチュートリアルでは、 プロセスの監視を停止する 方法について説明します。 プロセスのモニタリングを停止すると、Cloud Manager はそのステータスの表示とメトリクスの追跡を停止します。
目的を理解する
Cloud Manager Administration API を使用して次の方法を実行する方法を学習します。
プロセスのホスト ID を見つけます。
ホスト ID に一致するプロセスの監視を停止します。
Cloud Manager が プロセスの監視を終了しました。
前提条件を完了する
チュートリアルを完了する前に、これらの前提条件を完了してください。
モニタリング設定を変更するために必要な権限を取得します。 次のいずれかのロールが必要です。
プロセスの監視を停止する前に、 プロセスのバックアップを終了してください。
実行手順
API を使用してプロセスの監視を停止するには、次のすべての手順を完了します。
プロセスのホスト ID を見つけます。
ホスト名とポートで 1 つのホストを取得 リソースを使用して プロセスを見つけ、 id
値を取得します。
このステップの内容
ホスト名とポートで 1 つのホストを取得リソースは、指定されたホスト名とポートを使用してプロセスを検索します。 次に、このプロセスに関する情報を返します。 応答 の次のステップに必要なid
が見つかります。
このコマンドを発行します
次の curl コマンドをコピーします。 これを希望のターミナルまたはコンソールに貼り付けます。 表示されたプレースホルダーを次の値に置き換えます。
プレースホルダー | 説明 |
---|---|
{PUBLIC-KEY} | APIキーの公開部分。 |
{PRIVATE-KEY} | APIキーのプライベート部分。 |
{PROJECT-ID} | ホストを所有するプロジェクトの一意の識別子。 |
{HOSTNAME} | Cloud Manager がインスタンスに接続するために使用するプライマリ ホスト名。 これは、ホスト名、 FQDN 、 IPv4アドレス、またはIPv6アドレスにすることができます。 |
{PORT} | プロセスが listen するポート。 |
コマンド内のプレースホルダーを置き換えて実行します。
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/byName/{HOSTNAME}:{PORT}"
ホストの ID のコピー
レスポンス本文で、 id
フィールドに返された値をコピーします。 次のステップには 値が必要です。
例
1 { 2 "alertsEnabled" : true, 3 "aliases": [ "server1.example.com:27017", "203.0.113.3:27017" ], 4 "authMechanismName" : "SCRAM-SHA-1", 5 "clusterId" : "<cluster-ID-1>", 6 "created" : "2021-04-22T19:56:50Z", 7 "groupId" : "<project-ID-1>", 8 "hasStartupWarnings" : false, 9 "hidden" : false, 10 "hostEnabled" : true, 11 "hostname" : "server1.example.com", 12 "id" : "{HOST-ID}", 13 "ipAddress": "203.0.113.3", 14 }
ホスト ID に一致するプロセスの監視を停止します。
ホストの監視を停止するには、 「1 つのホストの監視を停止」 リソースを使用します。
このステップの内容
[ 1 つのホストの監視を停止]リソースは、実際にはホストを削除しません。 リソースは、Cloud Manager が監視するホストのリストからホストを削除します。 これにより、プロセスは監視から削除されます。
このコマンドを発行します
次の curl コマンドをコピーします。 これを希望のターミナルまたはコンソールに貼り付けます。 表示されたプレースホルダーを次の値に置き換えます。
プレースホルダー | 説明 |
---|---|
{PUBLIC-KEY} | APIキーの公開部分。 |
{PRIVATE-KEY} | APIキーのプライベート部分。 |
{PROJECT-ID} | ホストを所有するプロジェクトの一意の識別子。 |
{HOST-ID} | プロセスのホストの一意の識別子です。 ステップ 1 の id を使用します。 |
コマンド内のプレースホルダーを置き換えて実行します。
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request DELETE "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}"
Cloud Manager が プロセスの監視を終了しました。
ホスト名とポートで 1 つのホストを取得リソースを再度使用して、ホスト名とポートを使用する プロセスを見つけます。 次に、 details
がNo host with hostname
and port {HOSTNAME}:{PORT} exists in group {PROJECT-ID}
を返すことを確認します。
このステップの内容
ホスト名とポートで 1 つのホストを取得リソースは、指定されたホスト名とポートを使用してプロセスを検索します。 次に、このプロセスに関する情報を返します。 レスポンスのdetails
値がNo host with hostname
and port {HOSTNAME}:{PORT} exists in group {PROJECT-ID}
であれば、Cloud Manager がプロセスを監視していないことがわかります。 つまり、Cloud Manager は監視するプロセスのリストでホストを見つけられません。
このコマンドを発行します
次の curl コマンドをコピーします。 これを希望のターミナルまたはコンソールに貼り付けます。 表示されたプレースホルダーを次の値に置き換えます。
プレースホルダー | 説明 |
---|---|
{PUBLIC-KEY} | APIキーの公開部分。 |
{PRIVATE-KEY} | APIキーのプライベート部分。 |
{PROJECT-ID} | ホストを所有するプロジェクトの一意の識別子。 |
{HOSTNAME} | Cloud Manager がこのインスタンスに接続するために使用するプライマリ ホスト名。 これは、ホスト名、FQDN、IPv4 アドレス、または IPv6 アドレスにすることができます。 |
{PORT} | プロセスが listen するポート。 |
コマンド内のプレースホルダーを置き換えて実行します。
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/byName/{HOSTNAME}:{PORT}"
応答の詳細を確認する
レスポンス本体で、 details
フィールドに返された値を確認します。 details
がNo host with hostname
and port {HOSTNAME}:{PORT} exists in group {PROJECT-ID}
を返す場合は成功します。 Cloud Manager は プロセスの監視を終了しました。