すべての組織イベントを取得

項目一覧

必須のロール

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

必須のロール

このリソースを正常に呼び出すには、API キーに Organization Memberロールが必要です。

リクエスト

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /orgs/{orgId}/events

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

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

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

一意のクエリパラメーター

このエンドポイントは、返されたイベントをフィルタリングするために次のクエリパラメータを受け入れます。

名前	タイプ	説明	default
eventType	string	指定された型のイベントのみを返します。アラートを生成するイベントの種類を確認するには、「アラートのタイプ」を参照してください。 MongoDB Ops Managerの監査ログに含まれるイベントの完全なリストについては、「監査イベント」を参照してください。
includeRaw	ブール値	出力に`raw`ドキュメントを含めるかどうかを指定します。 `raw`ドキュメントには、イベントに関する追加のメタ情報が含まれています。重要: `raw`ドキュメントの値は変更される可能性があります。形式モニタリングの場合、 `raw`の値に依存しないでください。	`false`
minDate	string	作成された日付が指定されたタイムスタンプ以上のイベントのみを返す ISO8601 UTC の日付と時刻形式。
最大日付	string	ISO8601 の作成日が指定されたタイムスタンプ以下のイベントのみを返す UTC の日付と時刻形式。

一般的なクエリパラメーター

このエンドポイントは、値のリストを返すすべてのエンドポイントに共通のクエリパラメーターも受け入れます。

名前

タイプ

説明

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 リクエスト本体パラメータを使用しません。

応答

応答ドキュメント

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

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

`results` embeddedDocument

各結果は 1 つのイベントです。

名前	タイプ	説明
alertId	string	このイベントに関連付けられたアラートの一意の識別子。
alertConfigId	string	`alertId`に関連付けられたアラート構成の一意の識別子。
apiKeyId	string	このイベントをトリガーしたAPI キーの一意の識別子。このフィールドが応答に存在する場合、MongoDB Ops Manager は`userId`フィールドを返しません。
clusterId	string	このイベントが適用されるクラスターの一意の識別子。
clusterName	string	このイベントが適用されるクラスターの名前。
コレクション	string	イベントが発生したコレクションの名前。このフィールドは、 `eventTypeName`が`DATA_EXPLORER`または`DATA_EXPLORER_CRUD`のいずれかの場合に表示される可能性があります。
作成済み	string	ISO8601 のタイムスタンプこのイベントがトリガーされたときの日付と時刻形式（ UTC）。
currentValue	オブジェクト	このイベントをトリガーしたメトリクスの現在の値。
currentValue .number	数値	メトリクスの値。
currentValue .units	string	値に関連する単位。たとえば、メモリ消費を測定するメトリクスにはバイト単位が含まれ、時間を測定するメトリクスには時間単位が含まれます。指定できる値は次のとおりです。 `RAW` `BITS` `BYTES` `KILOBITS` `KILOBYTES` `MEGABITS` `MEGABYTES` `GIGABITS` `GIGABYTES` `TERABYTES` `PETABYTES` `MILLISECONDS` `SECONDS` `MINUTES` `HOURS` `DAYS`
database	string	イベントが発生したデータベースの名前。このフィールドは、 `eventTypeName`が`DATA_EXPLORER`または`DATA_EXPLORER_CRUD`のいずれかの場合に表示される可能性があります。
distinct	オブジェクトの配列	このイベント中に配置に変更が加えられました。 MongoDB Ops Managerは、変更された内容に応じて異なる要素を返します。特権やロール、復元ジョブ、オートメーションモジュールなど。この配列とそのオブジェクトのリストはすべて網羅されていません。
diffs .id	string	このイベントで実行された差分の一意の識別子。
diffs .params	オブジェクトの配列	指定されたリソースに対して行われた変更のコレクション。
diffs .params .display	string	変更が行われたときにアクティビティフィードのコンソールに表示されるラベル。
diffs .params .new	string	変更されたパラメーターの新しい状態。
diffs .params .old	string	変更されたパラメーターの初期状態。
diffs .params .param	string	変更されたパラメーターの名前。
diffs .status	string	このリソースに加えられた変更の内容。 `NEW` `MODIFIED` `REMOVED` `SHUTDOWN` `STARTUP` `RESTORE` `RESTART`
diffs .type	string	変更が行われたリソース。 `AUTH` `AUTOMATION_AGENT` `BACKUP_AGENT` `BI_CONNECTOR` `MONITORING_AGENT` `PROCESS` `REPLICA_SET` `ROLES` `USERS`
eventTypeName	string	このイベントをトリガーした状況の名前。アラートを生成するイベントの種類を確認するには、「アラートのタイプ」を参照してください。 MongoDB Ops Managerの監査ログに含まれるイベントの完全なリストについては、「監査イベント」を参照してください。
グループ ID	string	このイベントが発生したプロジェクトの一意の識別子。
hostId	string	このイベントが発生したホストの一意の識別子。
Hostname	string	このイベントが発生したホストのホスト名、 FQDN 、 IPv4アドレス、またはIPv6アドレス。
id	string	このイベントの一意の識別子。
is GlobalAdmin	ブール値	このイベントをトリガーしたユーザーが`Global Monitoring Administrator`ロールを持っているかどうかを示すフラグ。
Links	オブジェクト配列	サブリソースや関連リソースへの 1 つ以上のリンク。応答内のすべての`links`配列には、 `self`と呼ばれるリンクが少なくとも 1 つ含まれています。 URL の関係は、 Web リンク仕様で説明されています。
metricName	string	値がしきい値を超えた測定値の名前。
opType	string	イベントを生成した操作のタイプ。このフィールドは、 `eventTypeName`が`DATA_EXPLORER`または`DATA_EXPLORER_CRUD`のいずれかである場合に表示されます。
ポート	integer	このイベントに関連付けられているホストのポート。
publicKey	string	このイベントをトリガーしたAPIキーに関連付けられた公開キー。このフィールドが応答に存在する場合、MongoDB Ops Manager は`username`フィールドを返しません。
生	ドキュメント	イベントに関する追加のメタ情報。このフィールドは、 `includeRaw`クエリパラメータが`true`の場合にのみ表示されます。重要: `raw`ドキュメントの値は変更される可能性があります。形式モニタリングの場合、 `raw`の値に依存しないでください。
remoteAddress	string	イベントをトリガーした MongoDB Ops Manager ユーザー（userId）に関連付けられた IP アドレス。
ReplicaSetName	string	レプリカセットの名前。
shardName	string	イベントに関連付けられたシャードの名前。
targetPublicKey	string	イベントの対象となるAPI キーの公開キー。
targetUsername	string	このイベントの対象となる MongoDB Ops Manager ユーザーのユーザー名。
teamId	string	このイベントに関連付けられた MongoDB Ops Manager チームの一意の識別子。
userId	string	このイベントをトリガーした MongoDB Ops Manager ユーザーの一意の識別子。このフィールドが応答に存在する場合、MongoDB Ops Manager は`apiKeyId`フィールドを返しません。
username	string	このイベントをトリガーした MongoDB Ops Manager ユーザーのユーザー名。このフィールドが応答に存在する場合、MongoDB Ops Manager は`publicKey`フィールドを返しません。
accessListEntry	string	イベントの対象となる API キーのアクセスリストエントリ。

リクエストの例

curl --user "{publicKey}:{privateKey}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/orgs/{orgId}/events?pretty=true"

応答例

応答ヘッダー

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}

レスポンス本体

1 {
2   "alertConfigId": "{alertConfigId}",
3   "alertId": "{alertId}",
4   "clusterId": "{clusterId}",
5   "clusterName": "Test Cluster",
6   "created": "2018-06-11T12:34:56Z",
7   "currentValue": {
8     "number": 50,
9     "units": "RAW"
10   },
11   "eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12   "groupId": "{groupId}",
13   "hostId": "{hostId}",
14   "hostname": "db.example.com",
15   "id": "{globalAlertId}",
16   "isGlobalAdmin": false,
17   "maintenanceWindowId": "{maintenanceWindowId}",
18   "metricName": "OPCOUNTER_CMD",
19   "orgId": "{orgId}",
20   "port": 27017,
21   "remoteAddress": "192.168.1.1",
22   "replicaSetName": "rs1",
23   "shardName": "sh1",
24   "userId": "{userId}",
25   "username": "john.doe@example.com",
26   "targetUsername": "jane.doe@example.com",
27   "teamId": "{teamId}"
28 }

戻る

イベント

1 つの組織イベントを取得

1	{
2	"alertConfigId": "{alertConfigId}",
3	"alertId": "{alertId}",
4	"clusterId": "{clusterId}",
5	"clusterName": "Test Cluster",
6	"created": "2018-06-11T12:34:56Z",
7	"currentValue": {
8	"number": 50,
9	"units": "RAW"
10	},
11	"eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12	"groupId": "{groupId}",
13	"hostId": "{hostId}",
14	"hostname": "db.example.com",
15	"id": "{globalAlertId}",
16	"isGlobalAdmin": false,
17	"maintenanceWindowId": "{maintenanceWindowId}",
18	"metricName": "OPCOUNTER_CMD",
19	"orgId": "{orgId}",
20	"port": 27017,
21	"remoteAddress": "192.168.1.1",
22	"replicaSetName": "rs1",
23	"shardName": "sh1",
24	"userId": "{userId}",
25	"username": "john.doe@example.com",
26	"targetUsername": "jane.doe@example.com",
27	"teamId": "{teamId}"
28	}

必須のロール

リクエスト

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

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

一意のクエリ パラメーター

一般的なクエリ パラメーター

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

応答