/ /

/ /

Obtenga un evento de organización

Cloud Manager dejará de ofrecer compatibilidad con automatización, copias de seguridad y monitorización para MongoDB 3.6 y 4.0 a partir del 30de agosto de 2024. Por favor, Actualice su implementación de MongoDB o migre a Atlas.

Roles necesarios

Su clave API debe tener la Organization Member rol para llamar a este recurso exitosamente.

Solicitud

URL base: https://cloud.mongodb.com/api/public/v1.0

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

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
orgId	string	Identificador único de la organización asociada al evento deseado.
ID de evento	string	Identificador único del evento deseado.

Parámetros de consulta de solicitud

Los siguientes parámetros de consulta son opcionales:

Parámetro de consulta	Tipo	Descripción	predeterminado
bonita	booleano	Muestra la respuesta en una impresión bonita formato.	`false`
envolvente	booleano	Especifica si se debe envolver o no la respuesta en un sobre.	`false`
incluirRaw	booleano	Especifica si se debe incluir el documento `raw` en la salida. El documento `raw` contiene información adicional sobre el evento. IMPORTANTE: Los valores del `raw` documento varían según el recurso al que se aplica el evento. Utilice este campo con precaución, ya que su estructura puede variar según el tipo de recurso.	`false`

Parámetros del cuerpo de la solicitud

Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.

Respuesta

Nombre	Tipo	Descripción
alertId	string	Identificador único de la alerta asociada a este evento.
alertConfigId	string	Identificador único para la configuración de alerta asociada con `alertId`.
apiKeyId	string	Identificador único de la clave API que activó este evento. Si este campo está presente en la respuesta, Cloud Manager no devuelve el campo `userId`.
clusterId	string	ID del clúster al que se aplica este evento.
nombre del clúster	string	Nombre del clúster al que se aplica este evento.
Colección	string	Nombre de la colección donde ocurrió el evento. Este campo puede estar presente cuando `eventTypeName` es `DATA_EXPLORER` o `DATA_EXPLORER_CRUD`.
creado	string	Marca de tiempo en formato de fecha y hora ISO en 8601 UTC cuando se activó este evento.
valorActual	Objeto	Valor actual de la métrica que activó este evento.
currentValue .number	Número	Valor de la métrica.
currentValue .units	string	Unidades relevantes para el valor. Por ejemplo, una métrica que mide el consumo de memoria tendría una medida de byte, mientras que una métrica que mide el tiempo tendría una unidad de tiempo. Los valores aceptados son: `RAW` `BITS` `BYTES` `KILOBITS` `KILOBYTES` `MEGABITS` `MEGABYTES` `GIGABITS` `GIGABYTES` `TERABYTES` `PETABYTES` `MILLISECONDS` `SECONDS` `MINUTES` `HOURS` `DAYS`
database	string	Nombre de la base de datos donde ocurrió el evento. Este campo puede estar presente cuando `eventTypeName` es `DATA_EXPLORER` o `DATA_EXPLORER_CRUD`.
nombreDeTipoDeEvento	string	Nombre de la circunstancia que desencadenó este evento. Para revisar los tipos de eventos que generan alertas, consulte Tipos de alerta.
ID de grupo	string	ID del proyecto en el que ocurrió este evento.
ID de host	string	ID del host en el que ocurrió este evento.
Nombre del host	string	Nombre dehost, FQDN, direcciónIPv4 o dirección IPv del host en el que ocurrió este evento.6
ID.	string	Identificador único para este evento.
invoiceId	string	Identificador único de la factura asociada a este evento.
esGlobalAdmin	booleano	Bandera que indica si el usuario que activó este evento es un empleado de MongoDB.
enlaces	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
nombremétrico	string	Nombre de la medida cuyo valor salió del umbral. Para ver los valores posibles, consulte a continuación.
tipo de operación	string	Tipo de operación que generó el evento. Este campo está presente cuando `eventTypeName` es `DATA_EXPLORER` o `DATA_EXPLORER_CRUD`.
ID de pago	string	Identificador único del pago de factura asociado a este evento.
Puerto	entero	Puerto del host asociado con este evento.
publicKey	string	Clave pública asociada con la clave API que activó este evento. Si este campo está presente en la respuesta, Cloud Manager no devuelve el campo `username`.
crudo	Documento	Metainformación adicional sobre el evento. Este campo solo aparece cuando el parámetro de consulta `includeRaw` es `true`. IMPORTANTE: Los valores del `raw` documento varían según el recurso al que se aplica el evento. Utilice este campo con precaución, ya que su estructura puede variar según el tipo de recurso.
dirección remota	string	Dirección IP asociada con el usuario de Cloud Manager (userId) que activó el evento.
nombreConjuntoRéplica	string	Nombre del conjunto de réplicas.
nombrefragmento	string	El nombre del fragmento asociado con el evento.
targetPublicKey	string	Clave pública de la clave API a la que se dirige el evento.
Nombre de usuario objetivo	string	Nombre de usuario del usuario de Cloud Manager al que se dirige este evento.
ID de equipo	string	Identificador único del equipo de Cloud Manager asociado a este evento.
ID de usuario	string	Identificador único del usuario de Cloud Manager que activó este evento. Si este campo está presente en la respuesta, Cloud Manager no devuelve el campo `apiKeyId`.
Nombre de usuario	string	Nombre de usuario del usuario de Cloud Manager que activó este evento. Si este campo está presente en la respuesta, Cloud Manager no devuelve el campo `publicKey`.
Entrada de lista de acceso	string	Entrada de la lista de acceso de la clave API a la que se dirige el evento.

Ejemplo de solicitud

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" \

Ejemplo de respuesta

Encabezado de respuesta

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}

Cuerpo de respuesta

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 }

Volver

Obtener todo (Organización)

Get All (Proyecto)

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	}