servicePrincipal: delta
Obtenga entidades de servicio recién creadas, actualizadas o eliminadas sin tener que realizar una lectura completa de toda la colección de recursos.
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 | Application.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | Application.ReadWrite.OwnedBy | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
Solicitud HTTP
Para comenzar a realizar el seguimiento de los cambios, realice una solicitud incluyendo la función delta en el recurso servicePrincipal.
GET /servicePrincipals/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 debe especificar una vez por adelantado los parámetros de consulta deseados.
En solicitudes posteriores, copie y aplique la dirección URL @odata.nextLink
o @odata.deltaLink
de la respuesta anterior, dado que la dirección URL ya incluye los parámetros codificados deseados.
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 la dirección URL @odata.deltaLink , incluido este token, en la primera solicitud de la siguiente ronda de seguimiento de cambios de la 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 utilizar un parámetro de consulta
$select
como en cualquier solicitud GET para especificar solo las propiedades que necesita para un mejor rendimiento. Siempre se devuelve la propiedad id.Hay compatibilidad limitada con
$filter
:- La única expresión admitida
$filter
es para realizar un seguimiento de los cambios de recursos específicos, por su identificador:$filter=id+eq+{value}
o$filter=id+eq+{value1}+or+id+eq+{value2}
. El número de identificadores que puede especificar está limitado por la longitud máxima de la dirección URL.
- La única expresión admitida
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 código de respuesta y un 200 OK
objeto de colección servicePrincipal en el cuerpo de la respuesta. La respuesta también incluye una dirección URL de nextLink o una dirección URL de deltaLink.
Si se devuelve una
@odata.nextLink
dirección URL, hay más páginas de datos que se recuperarán en la sesión. La aplicación 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 hay más datos sobre el estado existente del recurso que se va a devolver. Conserve y use la@odata.deltaLink
dirección URL para obtener información sobre los cambios en el recurso en el futuro.
Vea:
-
Uso de la consulta delta para obtener más detalles
-
Obtenga cambios incrementales para los usuarios para una solicitud de ejemplo.
Ejemplo
Solicitud
GET https://graph.microsoft.com/v1.0/servicePrincipals/delta
Respuesta
Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#servicePrincipals",
"@odata.nextLink":"https://graph.microsoft.com/v1.0/servicePrincipals/delta?$skiptoken=pqwSUjGYvb3jQpbwVAwEL7yuI3dU1LecfkkfLPtnIjsXoYQp_dpA3cNJWc",
"value": [
{
"accountEnabled": true,
"addIns": [
{
"id": "id-value",
"type": "type-value",
"properties": [
{
"key": "key-value",
"value": "value-value"
}
]
}
],
"appDisplayName": "appDisplayName-value",
"appId": "appId-value",
"appOwnerOrganizationId": "appOwnerOrganizationId-value",
"appRoleAssignmentRequired": true
}
]
}