アラート構成の有効化と無効化
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
注意
グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。
ベース URL: https://cloud.mongodb.com/api/public/v 1.0
Resource
PATCH /groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}
注意
このエンドポイントは、アラート構成の有効/無効状態のみを更新します。 この構成以外を更新するには、「アラート構成の更新 」を参照してください。
リクエスト パス パラメーター
すべてのリクエスト パス パラメータは必須 です。
Parameter | タイプ | 説明 |
|---|---|---|
プロジェクトID | string | このプロジェクトの一意の識別子。 |
ALERT-CONFIG-ID | string | このアラート構成の一意の識別子。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | ブール値 | 任意 | レスポンス本体を pretty-print にするかどうかを示すフラグ 形式。 |
| ||||||
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の APIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリでenvelope=trueを設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。
|
|
リクエスト ボディ パラメータ
リクエスト本文パラメータはすべて必須です。
Parameter | タイプ | 説明 |
|---|---|---|
enabled | ブール値 | 有効にするには |
応答
注意
アラート構成はさまざまです。 アラート構成には、これらの要素のサブセットのみを含めることができます。
名前 | タイプ | 説明 |
|---|---|---|
作成済み | string | ISO8601 のタイムスタンプ このアラート構成が作成されたときの UTC の日付と時刻形式。 |
enabled | ブール値 | このアラート構成が有効になっていることを示すフラグ。 |
eventTypeName | string | アラートをトリガーするイベントのタイプ。 |
グループ ID | string | このアラート構成を所有するプロジェクトの一意の識別子。 |
id | string | アラート構成の一意の識別子です。 |
Links | オブジェクトの配列 | サブリソースや関連リソースへの 1 つ以上のリンク。 URL 間の関係タイプについては、 Web リンク仕様 で説明されています。 。 |
マッチャー | オブジェクトの配列 | このアラート構成に対してオブジェクトを照合するときに適用するルール。 |
matchers .[n].fieldName | string | この構成で一致させたターゲット オブジェクト内のフィールドの名前。 |
matchers .[n].operator | string | 現在のメトリクス値を |
matchers .[n].value | string |
|
metricThreshold | オブジェクト | アラートをトリガーする比較の値と平均。 |
metricThreshold .metricName | string | 確認するメトリクスの名前。 |
metricThreshold .mode | string | このメトリクスの平均値。 |
metricThreshold .operator | string | 現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。 |
metricThreshold .threshold | 数値 | 超えた場合にアラートをトリガーする |
metricThreshold .units | string |
|
notifications | オブジェクトの配列 | アラート条件が検出されたときに Cloud Manager が通知を送信する 1 つ以上のターゲット。 |
notifications.[n] .apiToken | string | Slack API トークン トークン。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .channelName | string | Slack チャンネル名。 |
notifications.[n] .datadogApiKey | string | DataDog API キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .delayMin | 数値 | アラート条件が検出された後最初の通知を送信するまでに待機する時間（分）。 |
notifications.[n] .emailAddress | string | 通知を送信するメールアドレス。 |
notifications.[n] .emailEnabled | ブール値 | メール通知を送信する必要があることを示すフラグ。 |
notifications.[n] .intervalMin | 数値 | 解決されていない未確認アラートの連続した通知間で待機する時間（分）。 |
notifications.[n] .microsoftTeamsWebhookUrl | string | Microsoft Teams チャネルの受信 Webhook URL 。 Webhook 通知のアラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化された状態で表示されます。 |
notifications.[n] .mobileNumber | string | アラート通知が送信されるモバイル番号。 |
notifications.[n] .notificationToken | string | HipChat API トークン。 後でトークンが無効になった場合、MongoDB Atlas は API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .opsGenieApiKey | string | Opsgenie Alert API キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .opsGenieRegion | string | 使用するAPI URLを示すリージョン。 |
notifications.[n] .roles | 文字列の配列 | 現在のプロジェクトまたは組織の Cloud Manager ロール。 |
notifications.[n] .roomName | string | HipChat ルーム名。 Cloud Manager は、 |
notifications.[n] .serviceKey | string | PagerDuty サービス キー。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .smsEnabled | ブール値 | テキスト通知を送信する必要があることを示すフラグ。 |
notifications.[n] .teamId | string | この通知を受け取るチームの固有の識別子。 |
notifications.[n] .teamName | string | この通知を受け取ったチームのラベル。 |
notifications.[n] .typeName | string | Cloud Manager がアラートの通知を送信する方法を意味します。 |
notifications.[n] .username | string | 通知を送信する Cloud Manager ユーザーの名前。 |
notifications.[n] .victorOpsApiKey | string | VictorOps APIキー。 後でキーが無効になった場合、MongoDB Atlas は
API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .victorOpsRoutingKey | string | VictorOps ルーティングキー。 後でキーが無効になった場合、MongoDB Atlas は
API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。
|
notifications.[n] .webhookSecret | string | |
notifications.[n] .webhookUrl | string | |
しきい値 | オブジェクト | アラートをトリガーするしきい値。 Cloud Manager は、 |
threshold .operator | string | 現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。 |
threshold .threshold | 数値 | 超えた場合に Cloud Manager がアラートをトリガーする値。 |
threshold .units | string |
|
typeName | string | このフィールドは非推奨であり、無視されます。 |
Updated | string | ISO8601 のタイムスタンプ このアラート構成が最後に更新されたときの UTC の日付と時刻形式。 |
リクエストの例
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Content-Type: application/json' \ --include \ --request PATCH "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}" \ --data ' { "enabled" : false }'
応答例
応答ヘッダー
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
レスポンス本体
{ "created" : "2014-04-23T14:52:29Z", "enabled" : false, "groupId" : "{PROJECT-ID}", "id" : "{ALERT-CONFIG-ID}", "links" : [], "matchers" : [ { "fieldName" : "REPLICA_SET_NAME", "operator" : "EQUALS", "value" : "rs1" } ], "notifications" : [ { "delayMin" : 5, "emailAddress" : "sos@example.com", "intervalMin" : 60, "typeName" : "EMAIL" }, { "delayMin" : 60, "emailEnabled" : false, "intervalMin" : 120, "smsEnabled" : true, "typeName" : "GROUP" } ], "updated" : "2014-04-23T14:52:29Z" }