プロジェクトのすべてのアラート構成を取得する

項目一覧

Resource

リクエストパスパラメーター
リクエストクエリパラメータ
リクエストボディパラメータ
応答
応答ドキュメント
results embeddedDocument
リクエストの例
応答例
応答ヘッダー
レスポンス本体

Cloud Manager は、 2024年8月30日でMongoDB 3.6と4.0のオートメーション、バックアップおよびモニタリングのサポートを終了します。 MongoDB の配置をアップグレードするか、Atlas に移行してください。

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

GET /groups/{PROJECT-ID}/alertConfigs

リクエストパスパラメーター

すべてのリクエストパスパラメータは必須です。

Parameter	タイプ	説明
プロジェクトID	string	このプロジェクトの一意の識別子。

リクエストクエリパラメータ

次のクエリパラメータは任意です。

名前	タイプ	必要性	説明	default
pageNum	数値	任意	結果のサブセクションを返す 1 から始まる整数。	`1`
itemsPerPage	数値	任意	1 ページあたりに返す項目の数は最大 500 です。	`100`
pretty	ブール値	任意	レスポンス本体を pretty-print にするかどうかを示すフラグ形式。	`false`
envelope	ブール値	任意	応答をエンベロープでラップするかどうかを示すフラグ。一部の APIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリで`envelope : true`を設定します。結果のリストを返すエンドポイントの場合、 `content`オブジェクトはエンベロープです。 Cloud Manager は、レスポンス本体に`status`フィールドを追加します。	`false`
backupJobsEnabledOnly	ブール値	任意	データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。これを`false`に設定し、 `backupJobsEnabled`フラグが`false`に設定されているデーモン構成を含めます。	`true`

リクエストボディパラメータ

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

応答

応答ドキュメント

レスポンスJSONドキュメントには、 resultオブジェクトの配列、 linkオブジェクトの配列、および取得されたresultオブジェクトの合計数が含まれます。

名前	タイプ	説明
`results`	配列	配列には、`results` 埋め込みドキュメントセクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。
`links`	配列	配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様で説明されています。
`totalCount`	数値	結果セット内の項目の合計数の整数。結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。

`results` embeddedDocument

各結果は 1 つのアラート構成です。

注意

アラート構成はさまざまです。アラート構成には、これらの要素のサブセットのみを含めることができます。

名前	タイプ	説明
作成済み	string	ISO8601 のタイムスタンプこのアラート構成が作成されたときの UTC の日付と時刻形式。
enabled	ブール値	このアラート構成が有効になっていることを示すフラグ。
eventTypeName	string	アラートをトリガーするイベントのタイプ。
グループ ID	string	このアラート構成を所有するプロジェクトの一意の識別子。
id	string	アラート構成の一意の識別子です。
Links	オブジェクトの配列	サブリソースや関連リソースへの 1 つ以上のリンク。 URL 間の関係タイプについては、 Web リンク仕様で説明されています。。
マッチャー	オブジェクトの配列	このアラート構成に対してオブジェクトを照合するときに適用するルール。
matchers .[n].fieldName	string	この構成で一致させたターゲットオブジェクト内のフィールドの名前。
matchers .[n].operator	string	現在のメトリクス値を`matcher.[n].value`と照合するときに適用する比較演算子。
matchers .[n].value	string	`matchers.[n].operator`を使用して一致するかそれを超える値。
metricThreshold	オブジェクト	アラートをトリガーする比較の値と平均。
metricThreshold .metricName	string	確認するメトリクスの名前。 `alerts`リソースの`metricName`フィールドと同じ値をサポートします。
metricThreshold .mode	string	このメトリクスの平均値。
metricThreshold .operator	string	現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。
metricThreshold .threshold	数値	超えた場合にアラートをトリガーする`metricThreshold.metricName`の値。
metricThreshold .units	string	`metricThreshold.threshold`の範囲を定義する容量または時間の単位。
notifications	オブジェクトの配列	アラート条件が検出されたときに Cloud Manager が通知を送信する 1 つ以上のターゲット。
notifications.[n] .apiToken	string	Slack API トークントークン。 `notifications.[n].typeName`を`SLACK`に設定すると、Cloud Manager がこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .channelName	string	Slack チャンネル名。 `notifications.[n].typeName`を`SLACK`に設定すると、Cloud Manager がこの値を返します。
notifications.[n] .datadogApiKey	string	DataDog API キー。 `notifications.[n].typeName`を`DATADOG`に設定すると、Cloud Manager がこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .delayMin	数値	アラート条件が検出された後最初の通知を送信するまでに待機する時間（分）。
notifications.[n] .emailAddress	string	通知を送信するメールアドレス。 `notifications.[n].typeName`を`EMAIL`に設定すると、Cloud Manager がこの値を返します。
notifications.[n] .emailEnabled	ブール値	メール通知を送信する必要があることを示すフラグ。 `notifications.[n].typeName`を`ORG` 、 `GROUP` 、または`USER`に設定すると、Cloud Manager はこの値を返します。
notifications.[n] .intervalMin	数値	解決されていない未確認アラートの連続した通知間で待機する時間（分）。
notifications.[n] .microsoftTeamsWebhookUrl	string	Microsoft Teams チャネルの受信 Webhook URL 。 `notifications.[n].typeName`を`MICROSOFT_TEAMS`に設定すると、Cloud Manager がこの値を返します。 Webhook 通知のアラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化された状態で表示されます。
notifications.[n] .mobileNumber	string	アラート通知が送信されるモバイル番号。 `notifications.[n].typeName`を`SMS`に設定すると、Cloud Manager がこの値を返します。
notifications.[n] .notificationToken	string	HipChat API トークン。 `notifications.[n].typeName`を`HIP_CHAT`に設定すると、Cloud Manager がこの値を返します。後でトークンが無効になった場合、MongoDB Atlas は`Project Owner`にメールを送信し、最終的にトークンを削除します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .opsGenieApiKey	string	Opsgenie Alert API キー。`notifications.[n].typeName`を`OPS_GENIE`に設定すると、Cloud Manager はこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .opsGenieRegion	string	使用するAPI URLを示すリージョン。 `notifications.[n].typeName`を`OPS_GENIE`に設定すると、Cloud Manager はこの値を返します。
notifications.[n] .roles	文字列の配列	現在のプロジェクトまたは組織の Cloud Manager ロール。 `notifications.[n].typeName`を`ORG`または`GROUP`に設定すると、Cloud Manager はこの値を返します。
notifications.[n] .roomName	string	HipChat ルーム名。 Cloud Manager は、 `"notifications.typeName" : "HIP_CHAT`の場合にこの値を返します。
notifications.[n] .serviceKey	string	PagerDuty サービスキー。 `notifications.[n].typeName`を`PAGER_DUTY`に設定すると、Cloud Manager がこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .smsEnabled	ブール値	テキスト通知を送信する必要があることを示すフラグ。 `notifications.[n].typeName`を`ORG` 、 `GROUP` 、または`USER`に設定すると、Cloud Manager はこの値を返します。
notifications.[n] .teamId	string	この通知を受け取るチームの固有の識別子。
notifications.[n] .teamName	string	この通知を受け取ったチームのラベル。
notifications.[n] .typeName	string	Cloud Manager がアラートの通知を送信する方法を意味します。
notifications.[n] .username	string	通知を送信する Cloud Manager ユーザーの名前。 `notifications.[n].typeName`を`USER`に設定すると、Cloud Manager がこの値を返します。
notifications.[n] .victorOpsApiKey	string	VictorOps APIキー。後でキーが無効になった場合、MongoDB Atlas は`Project Owner`にメールを送信し、最終的にキーを削除します。 `notifications.[n].typeName`を`VICTOR_OPS`に設定すると、Cloud Manager がこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .victorOpsRoutingKey	string	VictorOps ルーティングキー。後でキーが無効になった場合、MongoDB Atlas は`Project Owner`にメールを送信し、最終的にキーを削除します。 `notifications.[n].typeName`を`VICTOR_OPS`に設定すると、Cloud Manager がこの値を返します。 API または統合キーが必要なサードパーティ統合を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。 UI を通じてアラートを表示または編集します。 APIを介してサードパーティ統合設定をクエリします。
notifications.[n] .webhookSecret	string	通知を受け入れ、転送する Webhook で認証するために使用される値。 `notifications.[n].typeName`を`WEBHOOK`に設定し、次のいずれかの場合に、Cloud Manager にこの値が返されます。 `notification.[n].webhookSecret` に空でないstringを設定した場合統合ページで、または統合 APIを使用してデフォルトの`webhookSecret`を設定します Webhook 通知の作成後、アラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化されます。
notifications.[n] .webhookUrl	string	この通知をトリガーする Webhook のURL 。 `notifications.[n].typeName`を`WEBHOOK`に設定し、次のいずれかの場合に、Cloud Manager にこの値が返されます。 `notification.[n].webhookURL` に空でないstringを設定した場合統合ページで、または統合 APIを使用してデフォルトの`webhookUrl`を設定します Webhook 通知の作成後、アラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化されます。
しきい値	オブジェクト	アラートをトリガーするしきい値。 Cloud Manager は、 `eventTypeName`が`OUTSIDE_METRIC_THRESHOLD`以外の値である場合、この値を返します。
threshold .operator	string	現在のメトリクス値をしきい値と照合するときに Cloud Manager が適用した比較演算子。
threshold .threshold	数値	超えた場合に Cloud Manager がアラートをトリガーする値。
threshold .units	string	`threshold.threshold`の範囲を定義する容量または時間の単位。
typeName	string	このフィールドは非推奨であり、無視されます。
Updated	string	ISO8601 のタイムスタンプこのアラート構成が最後に更新されたときの UTC の日付と時刻形式。

リクエストの例

curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
     --header 'Accept: application/json' \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs"

応答例

応答ヘッダー

HTTP/1.1 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

HTTP/1.1 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}

レスポンス本体

{
  "links" : [],
  "results": [ {
    "created" : "2013-10-30T15:28:30Z",
    "enabled" : true,
    "eventTypeName" : "RESYNC_REQUIRED",
    "groupId" : "{PROJECT-ID}",
    "id" : "5271259ee4b00ece6b4754ef",
    "links" : [],
    "matchers" : [ ],
    "notifications" : [ {
      "delayMin" : 0,
      "emailAddress" : "somebody@example.com",
      "intervalMin" : 60,
      "typeName" : "EMAIL"
    } ],
    "updated" : "2014-02-12T16:11:05Z"
  }, {
    "created" : "2014-03-19T16:42:07Z",
    "enabled" : true,
    "eventTypeName" : "MONITORING_AGENT_DOWN",
    "groupId" : "{PROJECT-ID}",
    "id" : "5329c8dfe4b0b07a83d67e7e",
    "links" : [],
    "matchers" : [ ],
    "notifications" : [ {
      "delayMin" : 0,
      "emailEnabled" : true,
      "intervalMin" : 5,
      "smsEnabled" : false,
      "typeName" : "GROUP"
    } ],
    "updated" : "2014-03-19T16:42:07Z"
  }, {
    "created" : "2014-04-03T20:26:50Z",
    "enabled" : true,
    "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD",
    "groupId" : "{PROJECT-ID}",
    "id" : "533dc40ae4b00835ff81eaee",
    "links" : [],
    "matchers" : [ {
      "field" : "hostnameAndPort",
      "operator" : "EQUALS",
      "value" : "mongo.example.com:27017"
    } ],
    "notifications" : [ {
      "delayMin" : 0,
      "intervalMin" : 5,
      "mobileNumber" : "2343454567",
      "typeName" : "SMS"
    } ],
    "metricThreshold" : {
      "metricName" : "ASSERT_REGULAR",
      "mode" : "AVERAGE",
      "operator" : "LESS_THAN",
      "threshold" : 99.0,
      "units" : "RAW"
    },
    "updated" : "2014-04-03T20:26:50Z",
  } ],
  "totalCount": 3
}

戻る

マッチャーフィールド名を取得する

作成

注意

Resource

リクエスト パス パラメーター

リクエスト クエリ パラメータ

リクエスト ボディ パラメータ

応答