servicePrincipal: delta
Rufen Sie neu erstellte, aktualisierte oder gelöschte Dienstprinzipale ab, ohne die gesamte Ressourcensammlung vollständig lesen zu müssen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Directory.Read.All | Application.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Application.ReadWrite.OwnedBy | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
HTTP-Anforderung
Um mit der Nachverfolgung von Änderungen zu beginnen, stellen Sie eine Anforderung, indem Sie die Delta-Funktion in die servicePrincipal-Ressource einschließen.
GET /servicePrincipals/delta
Abfrageparameter
Das Nachverfolgen von Änderungen verursacht eine Runde von einem oder mehreren Deltafunktionsaufrufen. Wenn Sie Abfrageparameter (außer $deltatoken
und $skiptoken
) verwenden, müssen Sie sie in der ursprünglichen Delta-Anforderung angeben. Microsoft Graph codiert automatisch alle angegebenen Parameter in den Tokenteil der in der Antwort enthaltenen @odata.nextLink
- oder @odata.deltaLink
-URL.
Sie müssen alle gewünschten Abfrageparameter nur einmal im Vorfeld angeben.
In nachfolgenden Anforderungen können Sie die @odata.nextLink
- oder @odata.deltaLink
-URL aus der vorherigen Antwort kopieren und anwenden, da diese URL bereits die codierten gewünschten Parameter enthält.
Abfrageparameter | Typ | Beschreibung |
---|---|---|
$deltatoken | string | Ein Zustandstoken, das in der @odata.deltaLink URL des vorherigen Delta-Funktionsaufrufs für dieselbe Ressourcensammlung zurückgegeben wird und den Abschluss dieser Änderungsnachverfolgungsrunde angibt. Speichern Sie die gesamte @odata.deltaLink -URL einschließlich dieses Tokens, und wenden Sie sie in der ersten Anforderung der nächsten Änderungsnachverfolgungsrunde für diese Sammlung an. |
$skiptoken | string | Ein Zustandstoken, das in der @odata.nextLink URL des vorherigen Delta-Funktionsaufrufs zurückgegeben wurde und angibt, dass weitere Änderungen in derselben Ressourcensammlung nachverfolgt werden müssen. |
Optionale Abfrageparameter
Diese Methode unterstützt OData-Abfrageparameter zur Anpassung der Antwort.
Sie können wie bei jeder GET-Anforderung den Abfrageparameter
$select
verwenden, um zwecks Leistungsoptimierung nur die benötigten Eigenschaften anzugeben. Die Eigenschaft id wird immer zurückgegeben.Es gibt eingeschränkte Unterstützung für
$filter
:- Der einzige unterstützte
$filter
Ausdruck ist für die Nachverfolgung von Änderungen für bestimmte Ressourcen anhand ihrer ID:$filter=id+eq+{value}
oder$filter=id+eq+{value1}+or+id+eq+{value2}
. Die Anzahl der IDs, die Sie angeben können, ist durch die maximale URL-Länge begrenzt.
- Der einzige unterstützte
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen Antwortcode und ein 200 OK
servicePrincipal-Auflistungsobjekt im Antworttext zurück. Die Antwort enthält auch eine nextLink-URL oder eine deltaLink-URL.
Wenn eine
@odata.nextLink
URL zurückgegeben wird, gibt es weitere Seiten mit Daten, die in der Sitzung abgerufen werden müssen. Die Anwendung stellt weiterhin Anforderungen mithilfe der@odata.nextLink
URL, bis eine@odata.deltaLink
URL in der Antwort enthalten ist.Wenn eine
@odata.deltaLink
URL zurückgegeben wird, gibt es keine Weiteren Daten zum vorhandenen Zustand der Ressource, die zurückgegeben werden soll. Speichern Sie die@odata.deltaLink
URL, und verwenden Sie sie, um sich über zukünftige Änderungen an der Ressource zu informieren.
Siehe:
-
Verwenden von Delta Query für weitere Details
-
Rufen Sie inkrementelle Änderungen für Benutzer für eine Beispielanforderung ab.
Beispiel
Anforderung
GET https://graph.microsoft.com/v1.0/servicePrincipals/delta
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
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
}
]
}