Compartir a través de

Obtención de la API de información de incidentes

  • Artículo

Se aplica a:

¿Quiere experimentar Microsoft Defender para punto de conexión? Regístrese para obtener una prueba gratuita.

Nota:

Si es un cliente del Gobierno de EE. UU., use los URI que aparecen en Microsoft Defender para punto de conexión para clientes del Gobierno de EE. UU.

Sugerencia

Para mejorar el rendimiento, puede usar el servidor más cercano a la ubicación geográfica:

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

Nota:

Pruebe nuestras nuevas API mediante la API de seguridad de MS Graph. Obtenga más información en: Uso de la API de seguridad de Microsoft Graph: Microsoft Graph | Microsoft Learn.

Descripción de la API

Recupera un incidente específico por su identificador

Limitaciones

  1. Las limitaciones de velocidad de esta API son 100 llamadas por minuto y 1500 llamadas por hora.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API.

Tipo de permiso Permiso Nombre para mostrar del permiso
Aplicación Incident.Read.All Read all Incidents
Aplicación Incident.ReadWrite.All Read and write all Incidents
Delegado (cuenta profesional o educativa) Incident.Read Read Incidents
Delegado (cuenta profesional o educativa) Incident.ReadWrite Read and write Incidents

Nota:

Al obtener un token con credenciales de usuario:

  • El usuario debe tener al menos el siguiente permiso de rol: View Data
  • La respuesta solo incluirá los incidentes a los que está expuesto el usuario.

Solicitud HTTP

GET .../api/incidents/{id}

Encabezados de solicitud

Nombre Tipo Descripción
Authorization Cadena {token} de portador. Necesario.

Cuerpo de la solicitud

En blanco

Respuesta

Si se ejecuta correctamente, este método devuelve 200 OKy la entidad de incidente en el cuerpo de la respuesta. Si no se encontró el incidente con el identificador especificado: 404 No encontrado.

Ejemplo

Solicitud

Este es un ejemplo de la solicitud.

GET https://api.security.microsoft.com/api/incidents/{id}

Uso de la API de seguridad de Microsoft Graph: Microsoft Graph | Microsoft Learn

Sugerencia

¿Desea obtener más información? Participe con la comunidad de Seguridad de Microsoft en nuestra Tech Community: Tech Community de Microsoft Defender XDR.