获取一个组织事件

在此页面上

所需角色

请求
请求路径参数
请求查询参数
请求正文参数
响应
请求示例
响应示例
响应标头
响应体

2024 年 8 月 30 日以后，Cloud Manager 将不再支持 MongoDB 3.6 和 4.0 的自动化、备份和监控。请升级您的 MongoDB 部署或迁移到 Atlas。

用于以编程访问权限Cloud Manager的 OAuth 2.0身份验证作为预览功能。: 在预览期间，功能和相应的文档可能随时更改。要使用 OAuth2.0 身份验证，请创建一个服务帐户，以便在向Cloud Manager Public API发出的请求中使用。

所需角色

您的 API 密钥必须具有 Organization Member角色才能成功调用此资源。

请求

基本 URL： https://cloud.mongodb.com/api/public/v 1.0

GET /orgs/{orgId}/events/{eventId}

请求路径参数

名称	类型	说明
orgId	字符串	与所需事件关联的组织的唯一标识符。
eventId	字符串	所需事件的唯一标识符。

请求查询参数

以下查询参数为可选参数：

查询参数	类型	说明	默认
pretty	布尔	以美观打印形式显示响应 { 格式。	`false`
envelope	布尔	指定是否将响应包装在信封中。	`false`
includeRaw	布尔	指定是否在输出中包含`raw`文档。 `raw`文档包含有关事件的其他元信息。重要提示： `raw`文档中的值可能会发生变化。请勿依赖`raw`值进行正式监控。	`false`

请求正文参数

此端点不使用 HTTP 请求正文参数。

响应

名称	类型	说明
alertId	字符串	与此事件关联的警报的唯一标识符。
alertConfigId	字符串	与`alertId`关联的警报配置的唯一标识符。
apiKeyId	字符串	触发此事件的API 密钥的唯一标识符。如果响应中存在此字段，则 Cloud Manager 不会返回`userId`字段。
clusterId	字符串	此事件适用的集群的 ID。
集群名称	字符串	应用此事件的集群的名称。
集合	字符串	发生事件的collection的名称。当`eventTypeName`为`DATA_EXPLORER`或`DATA_EXPLORER_CRUD`时，可以存在此字段。
已创建	字符串	ISO8601 格式的时间戳触发此事件时的日期和时间（格式为 UTC ）。
currentValue	对象	触发此事件的指标的当前值。
currentValue .number	数字	指标的值。
currentValue .units	字符串	值的相关单位。示例，测量内存消耗的指标将具有字节测量值，而测量时间的指标将具有时间单位。接受的值为： `RAW` `BITS` `BYTES` `KILOBITS` `KILOBYTES` `MEGABITS` `MEGABYTES` `GIGABITS` `GIGABYTES` `TERABYTES` `PETABYTES` `MILLISECONDS` `SECONDS` `MINUTES` `HOURS` `DAYS`
database	字符串	发生事件的数据库名称。当`eventTypeName`为`DATA_EXPLORER`或`DATA_EXPLORER_CRUD`时，可以存在此字段。
eventTypeName	字符串	触发此事件的情况名称。要查看生成警报的事件类型，请参阅警报类型。
groupId	字符串	发生此事件的项目的 ID。
hostId	字符串	发生此事件的主机的 ID。
主机名	字符串	发生此事件的主机的主机名、 FQDN 、 IPv4地址或IPv6地址。
id	字符串	此事件的唯一标识符。
invoiceId	字符串	与此事件关联的发票的唯一标识符。
isGlobalAdmin	布尔	指示触发此事件的用户是否为 MongoDB 员工的标志。
链接	对象数组	指向子资源和/或相关资源的一个或多个链接。响应中的所有`links`数组至少包含一个名为`self`的链接。 URL 之间的关系在 Web 链接规范中进行了解释。
metricName	字符串	Go阈值的测量名称。有关可能的值，请参阅下文。
opType	字符串	生成事件的操作类型。当`eventTypeName`为`DATA_EXPLORER`或`DATA_EXPLORER_CRUD`时，此字段存在。
PaymentId	字符串	与此事件相关的发票付款的唯一标识符。
端口	整型	与此事件关联的主机的端口。
公钥	字符串	与触发此事件的API密钥关联的公钥。如果响应中存在此字段，则 Cloud Manager 不会返回`username`字段。
原始	文档	有关事件的其他元信息。仅当`includeRaw`查询参数为`true`时，才会显示此字段。重要提示： `raw`文档中的值可能会发生变化。请勿依赖`raw`值进行正式监控。
远程地址	字符串	与触发事件的 Cloud Manager 用户 (userId) 关联的 IP 地址。
ReplicaSetName	字符串	副本集名称。
shardName	字符串	与事件关联的分片的名称。
targetPublicKey	字符串	事件针对的 API 密钥的公钥。
targetUsername	字符串	此事件所针对的 Cloud Manager 用户的用户名。
teamId	字符串	与此事件关联的 Cloud Manager 团队的唯一标识符。
用户 ID	字符串	触发此事件的 Cloud Manager 用户的唯一标识符。如果响应中存在此字段，则 Cloud Manager 不会返回`apiKeyId`字段。
用户名	字符串	触发此事件的 Cloud Manager 用户的用户名。如果响应中存在此字段，Cloud Manager 不会返回`publicKey`字段。
accessListEntry	字符串	事件针对的 API 密钥的访问列表条目。

请求示例

curl --user "{publicKey}:{privateKey}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{orgId}/events/{eventId}?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   "invoiceId": "{invoiceId}",
17   "isGlobalAdmin": false,
18   "maintenanceWindowId": "{maintenanceWindowId}",
19   "metricName": "OPCOUNTER_CMD",
20   "orgId": "{orgId}",
21   "paymentId": "{paymentId}",
22   "port": 27017,
23   "remoteAddress": "192.168.1.1",
24   "replicaSetName": "rs1",
25   "shardName": "sh1",
26   "userId": "{userId}",
27   "username": "john.doe@example.com",
28   "targetUsername": "jane.doe@example.com",
29   "teamId": "{teamId}"
30 }

后退

获取全部（组织）

来年

获取全部（项目）

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	"invoiceId": "{invoiceId}",
17	"isGlobalAdmin": false,
18	"maintenanceWindowId": "{maintenanceWindowId}",
19	"metricName": "OPCOUNTER_CMD",
20	"orgId": "{orgId}",
21	"paymentId": "{paymentId}",
22	"port": 27017,
23	"remoteAddress": "192.168.1.1",
24	"replicaSetName": "rs1",
25	"shardName": "sh1",
26	"userId": "{userId}",
27	"username": "john.doe@example.com",
28	"targetUsername": "jane.doe@example.com",
29	"teamId": "{teamId}"
30	}