Compartir a través de

oauth2permissiongrant: delta

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga objetos oauth2permissiongrant recién creados, actualizados o eliminados sin realizar una lectura completa de toda la colección de recursos. Para obtener más información, consulte Uso de la consulta delta para realizar un seguimiento de los cambios en los datos de Microsoft Graph para obtener más información.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Directory.Read.All Directory.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Directory.Read.All DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All

Importante

En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación:

  • Lector global
  • Lectores de directorio
  • Administrador de la aplicación
  • Desarrollador de la aplicación
  • Administrador de aplicaciones en la nube
  • Escritores de directorios
  • Administrador de usuarios
  • Administrador de roles con privilegios

Solicitud HTTP

GET /oauth2PermissionGrants/delta

Parámetros de consulta

El seguimiento de los cambios genera una ronda de una o varias llamadas de función delta . Si usa cualquier parámetro de consulta (distinto de $deltatoken y $skiptoken), debe especificarlo en la solicitud delta inicial. Microsoft Graph codifica automáticamente cualquier parámetro especificado en la parte del token de la URL @odata.nextLink o @odata.deltaLink proporcionada en la respuesta. Solo tiene que especificar parámetros de consulta una vez. En solicitudes posteriores, copie y aplique la @odata.nextLink dirección URL o @odata.deltaLink de la respuesta anterior. La dirección URL incluye los parámetros codificados.

Parámetro de consulta Tipo Descripción
$deltatoken string Un token de estado devuelto en la @odata.deltaLink dirección URL de la llamada de función delta anterior para la misma colección de recursos, que indica la finalización de esa ronda de seguimiento de cambios. Guarde y aplique toda @odata.deltaLink la dirección URL, incluido este token, en la primera solicitud de la siguiente ronda de seguimiento de cambios para esa colección.
$skiptoken string Token de estado devuelto en la @odata.nextLink dirección URL de la llamada a la función delta anterior, lo que indica que hay más cambios de los que realizar un seguimiento en la misma colección de recursos.

Parámetros de consulta opcionales

Este método admite parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.

  • Puede usar un parámetro de $select consulta para especificar solo las propiedades que necesita para obtener el mejor rendimiento. Siempre se devuelve la propiedad id.
  • El $filter parámetro de consulta solo se puede usar para realizar un seguimiento de los cambios en recursos específicos mediante el identificador de recurso. Por ejemplo, $filter=id+eq+{value} o $filter=id+eq+{value1}+or+id+eq+{value2}.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto de colección oauth2permissiongrant en el cuerpo de la respuesta. La respuesta también incluye una dirección URL @odata.nextLink o @odata.deltaLink.

  • Si se devuelve una @odata.nextLink dirección URL, se pueden recuperar páginas adicionales de datos en la sesión. Oauth2permissiongrant continúa realizando solicitudes mediante la @odata.nextLink dirección URL hasta que se incluye una @odata.deltaLink dirección URL en la respuesta.
  • Si se devuelve una @odata.deltaLink dirección URL, no se devuelven más datos sobre el recurso. Conserve y use la @odata.deltaLink dirección URL para obtener información sobre los cambios en el recurso en el futuro.

Para obtener más información, consulte Uso de la consulta delta. Para obtener solicitudes de ejemplo, consulte Obtención de cambios incrementales para los usuarios.

Ejemplo

Solicitud

GET https://graph.microsoft.com/v1.0/oauth2PermissionGrants/delta

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#oauth2permissiongrants",
  "@odata.nextLink":"https://graph.microsoft.com/v1.0/oauth2permissiongrants/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc",
  "value": [
    {
      "clientId": "22a3c970-8ad4-4120-8127-300837f87f2c",
      "consentType": "Principal",
      "principalId": "c2e8df37-c6a7-4d88-89b1-feb4f1fda7c5",
      "resourceId": "98dc9d95-49b6-405a-b3c0-834e969a708b",
      "scope": "User.Read Directory.AccessAsUser.All",
      "id": "cMmjItSKIEGBJzAIN_h_LJWd3Ji2SVpAs8CDTpaacIs33-jCp8aITYmx_rTx_afF"
    }
  ]
}