directoryRole: delta
Namespace: microsoft.graph
Rufen Sie neu erstellte, aktualisierte oder gelöschte Verzeichnisrollen ab, ohne die gesamte Ressourcensammlung vollständig lesen zu müssen. Weitere Informationen finden Sie unter Verwenden von Delta Query .
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) | RoleManagement.Read.Directory | Directory.Read.All, Directory.ReadWrite.All, RoleManagement.ReadWrite.Directory |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | RoleManagement.Read.Directory | Directory.Read.All, Directory.ReadWrite.All, RoleManagement.ReadWrite.Directory |
HTTP-Anforderung
Um mit der Nachverfolgung von Änderungen zu beginnen, stellen Sie eine Anforderung einschließlich der Delta-Funktion für die directoryRole-Ressource .
GET /directoryRoles/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. |
OData-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 besteht 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. |
Content-Type | application/json |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und das directoryRole-Auflistungsobjekt im Antworttext zurückgegeben. Die Antwort enthält auch eine @odata.nextLink
-URL oder eine @odata.deltaLink
-URL.
Wenn eine
@odata.nextLink
-URL zurückgegeben wird, gibt es zusätzliche Seiten mit Daten, die in der Sitzung abgerufen werden müssen. Die Anwendung nimmt weiterhin Anforderungen über die@odata.nextLink
-URL vor, bis eine@odata.deltaLink
-URL in der Antwort zurückgegeben wird.Wenn eine
@odata.deltaLink
-URL zurückgegeben wird, gibt es keine weiteren Daten über den derzeitigen Status der zurückzugebenden Ressource. Speichern Sie@odata.deltaLink
die URL, und wenden Sie sie im nächsten Delta-Aufruf an, um sich über zukünftige Änderungen an der Ressource zu informieren.
Beispiel
Anforderung
GET https://graph.microsoft.com/v1.0/directoryRoles/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#directoryRoles",
"@odata.nextLink": "https://graph.microsoft.com/v1.0/directoryRoles/delta?$skiptoken=pkXMyA5aFCIMmH1Kk1XEAnf2X-fodqXKXF03gYPQknSHRxogVsxvSq_26nhos-O2-shortened",
"value": [
{
"description": "Device Administrators",
"displayName": "Azure AD Joined Device Local Administrator",
"roleTemplateId": "9f06204d-73c1-4d4c-880a-6edb90606fd8",
"id": "f8e85ed8-f66f-4058-b170-3efae8b9c6e5",
"members@delta": [
{
"@odata.type": "#microsoft.graph.user",
"id": "bb165b45-151c-4cf6-9911-cd7188912848",
"@removed": {
"reason": "deleted"
}
}
]
}
]
}
Verwandte Inhalte
- Verwenden von Deltaabfragen zum Nachverfolgen von Änderungen in Microsoft Graph-Daten für weitere Details
- Beispielanforderungen finden Sie unter Inkrementelle Änderungen für Benutzer abrufen.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für