Respuestas de error de Microsoft Graph API para seguridad

Espacio de nombres: microsoft.graph

Los errores de la API para seguridad de Microsoft Graph se devuelven mediante el código de estado de contenido parcial HTTP 206 estándar y se entregan a través de un encabezado de advertencia.

Errores

Microsoft Graph API para seguridad es un servicio federado que recibe varias respuestas de todos los proveedores de datos. Cuando microsoft Graph API para seguridad recibe un error HTTP, devuelve un encabezado de advertencia con el siguiente formato:

{Vendor}/{Provider}/{StatusCode}/{LatencyInMs}

Este encabezado de advertencia solo se devuelve a los clientes cuando uno de los proveedores de datos devuelve un código de error distinto de 2xx o 404. Por ejemplo:

• HttpStatusCode.Forbidden (403) podría devolverse si no se concede el acceso al recurso.
• Si un proveedor agota el tiempo de espera, HttpStatusCode.GatewayTimeout (504) se devuelve en el encabezado de advertencia.
• Si se produce un error interno del proveedor, HttpStatusCode.InternalServerError (500) se usa en el encabezado de advertencia.

Si un proveedor de datos devuelve 2xx o 404, no se muestra en el encabezado de advertencia porque se espera que estos códigos se realicen correctamente o cuando no se encuentren datos, respectivamente. En un sistema federado, se espera un 404 no encontrado, ya que muchas veces los datos solo son conocidos por uno o varios proveedores, pero no todos.

Ejemplo:

Un usuario solicita security/alerts/{alert_id}.

Provider 1: 404 (provider does not have a record of this alert ID)
Provider 2: 504 (provider timed out)
Provider 3: 200 (success)
Provider 4: 403 (customer has not licensed this provider)

Dado que 404 y 200 son condiciones esperadas, el encabezado de advertencia contiene lo siguiente:

Warning : 199 - "{Vendor2}/{Provider 2}/504/10000",    (usual timeout limit is set at 10 seconds)
          199 - "{Vendor4}/{Provider 4}/403/10"       (Provider 4 rejected the request in 10 ms)

Nota: Cada encabezado HTTP es una colección de subelementos, por lo que los usuarios pueden enumerar el encabezado Warning y comprobar todos los elementos.

Restricciones

El $top parámetro de consulta OData tiene un límite de 1000 alertas. Se recomienda incluir solo $top y no $skip en la primera consulta GET. Puede usar @odata.nextLink para la paginación. Si necesita usar $skip, tiene un límite de 500 alertas. Por ejemplo, /security/alerts?$top=10&$skip=500 devuelve un 200 OK código de respuesta, pero /security/alerts?$top=10&$skip=501 devolverá un código de 400 Bad Request respuesta. Para obtener más información, vea respuestas de error de la API Microsoft Graph Security.

Una solución alternativa para este límite es usar el $filter parámetro de consulta OData con el eventDateTime de la entidad de alerta de la API para seguridad de Microsoft Graph, mediante ?$filter=eventDateTime gt {YYYY-MM-DDT00:00:00.000Z} y reemplazando el valor dateTime por la última alerta (1500th). También puede establecer un intervalo para ; eventDateTimepor ejemplo, alerts?$filter=eventDateTime gt 2018-11-11 T00:00:00.000Z&eventDateTime lt 2018-11-12 T00:00:00.000Z

Contenido relacionado

Si tiene problemas con la autorización, consulte Autorización y la API para seguridad de Microsoft Graph.