REST Resource: alerts

Recurso: Alert

Una alerta que afecta a un cliente.

Representación JSON 
{
  "customerId": string,
  "alertId": string,
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "type": string,
  "source": string,
  "data": {
    "@type": string,
    field1: ...,
    ...
  },
  "securityInvestigationToolLink": string,
  "deleted": boolean,
  "metadata": {
    object (AlertMetadata)
  },
  "updateTime": string,
  "etag": string
}
Campos
customerId

string

Solo salida. Es el identificador único de la cuenta de Google Workspace del cliente.
alertId

string

Solo salida. El identificador único de la alerta.
createTime

string (Timestamp format)

Solo salida. La hora en la que se creó esta alerta.
startTime

string (Timestamp format)

Obligatorio. La hora a la que se inició o detectó el evento que causó esta alerta.
endTime

string (Timestamp format)

Opcional. El momento en que el evento que causó esta alerta dejó de estar activo. Si se proporciona, la hora de finalización no debe ser anterior a la hora de inicio. Si no se proporciona, significa que hay una alerta en curso.
type

string

Obligatorio. Es el tipo de alerta. Este es solo un resultado después de crear la alerta. Para obtener una lista de los tipos de alertas disponibles, consulta Tipos de alertas de Google Workspace.
source

string

Obligatorio. Es un identificador único para el sistema que informó la alerta. Este es solo un resultado después de crear la alerta.

Las fuentes admitidas son cualquiera de las siguientes:

  • Operaciones de Google
  • Administración de dispositivos móviles
  • Suplantación de identidad (phishing) de Gmail
  • Prevención de pérdida de datos
  • Exportación de datos en todo el dominio
  • Ataque patrocinado por el Estado
  • Identidad de Google
  • Interrupción de las apps
data

object

Opcional. Los datos asociados con esta alerta, por ejemplo, google.apps.alertcenter.type.DeviceCompromised.
deleted

boolean

Solo salida. True si se marca esta alerta para su eliminación.
metadata

object (AlertMetadata)

Solo salida. Los metadatos asociados con esta alerta.
updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó esta alerta por última vez.
etag

string

Opcional. etag se usa para el control de simultaneidad optimista, como una forma de evitar que las actualizaciones simultáneas de una alerta se reemplacen entre sí. Se recomienda que los sistemas usen el etag en el ciclo de lectura-modificación-escritura para realizar actualizaciones de alerta a fin de evitar condiciones de carrera: se muestra un etag en la respuesta que contiene alertas, y se espera que los sistemas coloquen ese ETag en la solicitud de actualización de alertas para garantizar que su cambio se aplique a la misma versión de la alerta.

Si no se proporciona ninguna etag en la llamada para actualizar la alerta, la alerta existente se reemplazará sin consultar.

Metadatos de alerta

Los metadatos de una alerta.

Representación JSON 
{
  "customerId": string,
  "alertId": string,
  "status": string,
  "assignee": string,
  "updateTime": string,
  "severity": string,
  "etag": string
}
Campos
customerId

string

Solo salida. Es el identificador único de la cuenta de Google Workspace del cliente.
alertId

string

Solo salida. El identificador de alerta.
status

string

El estado actual de la alerta. Los valores admitidos son los siguientes:

  • NO COMENZADO
  • IN_PROGRESS
  • CERRADA
assignee

string

La dirección de correo electrónico del usuario asignado a la alerta.
updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizaron los metadatos por última vez.
severity

string

El valor de gravedad de la alerta. En el Centro de alertas, este campo se configurará al crear la alerta; la configuración predeterminada se establecerá como una string vacía cuando no se pueda determinar. Los valores admitidos para las acciones de actualización en este campo son los siguientes:

  • ALTA
  • MEDIO
  • BAJO
etag

string

Opcional. etag se usa para el control de simultaneidad optimista, como una forma de evitar que las actualizaciones simultáneas de los metadatos de alerta se reemplacen entre sí. Se recomienda que los sistemas usen el etag en el ciclo de lectura-modificación-escritura para realizar actualizaciones de metadatos a fin de evitar condiciones de carrera: se muestra un etag en la respuesta que contiene metadatos de alerta, y se espera que los sistemas coloquen ese ETag en la solicitud de actualizar metadatos de alerta para garantizar que su cambio se aplique a la misma versión de los metadatos de alerta.

Si no se proporciona ninguna etag en la llamada para actualizar los metadatos de la alerta, los metadatos de alerta existentes se reemplazan a ciegas.

Métodos

batchDelete

 Realiza la operación de eliminación por lotes en las alertas.

batchUndelete

 Realiza la operación de recuperación en lote de las alertas.

delete

 Marca la alerta especificada para su eliminación.

get

 Obtiene la alerta especificada.

getMetadata

 Muestra los metadatos de una alerta.

list

 Enumera las alertas.

undelete

 Restauraciones o "recuperaciones", una alerta que se marcó para eliminación en los últimos 30 días