directoryObject: checkMemberObjects
Namespace: microsoft.graph
Wichtig
APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .
Suchen Sie nach einer Mitgliedschaft in einer Liste von Gruppen-IDs, administrativen Einheiten-IDs oder Verzeichnisrollen-IDs für die IDs des angegebenen Benutzers, der Gruppe, des Dienstprinzipals, des Organisationskontakts, des Geräts oder des Verzeichnisobjekts. Diese Methode ist transitiv.
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.
Mitgliedschaften für ein Verzeichnisobjekt
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Directory.Read.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | Directory.Read.All |
Mitgliedschaften für einen Benutzer
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
Mitgliedschaften für eine Gruppe
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
Mitgliedschaften für einen Dienstprinzipal
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
Mitgliedschaften für einen Organisationskontakt
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Directory.Read.All, Directory.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | Directory.Read.All, Directory.ReadWrite.All |
Mitgliedschaften für ein Gerät
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
HTTP-Anforderung
Mitgliedschaften für ein Verzeichnisobjekt.
POST /directoryObjects/{id}/checkMemberObjects
Mitgliedschaften für einen Benutzer.
POST /me/checkMemberObjects
POST /users/{id | userPrincipalName}/checkMemberObjects
Mitgliedschaften für eine Gruppe.
POST /groups/{id}/checkMemberObjects
Mitgliedschaften für einen Dienstprinzipal.
POST /servicePrincipals/{id}/checkMemberObjects
Mitgliedschaften für einen Organisationskontakt.
POST /contacts/{id}/checkMemberObjects
Mitgliedschaften für ein Gerät.
POST /devices/{id}/checkMemberObjects
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token} |
| Content-Type | application/json |
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
| Parameter | Typ | Beschreibung |
|---|---|---|
| ids | String-Sammlung | Eine Auflistung, die die Objekt-IDs der Gruppen, Verzeichnisrollen, administrativen Einheiten oder roleTemplate-IDs von Verzeichnisrollen enthält, in denen die Mitgliedschaft überprüft werden soll. Es können bis zu 20 Objekte angegeben werden. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein neues Objekt der String-Auflistung im Antworttext zurück.
Beispiele
Es folgt ein Beispiel für das Aufrufen dieser API.
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/me/checkMemberObjects
Content-type: application/json
{
"ids": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10",
"86a64f51-3a64-4cc6-a8c8-6b8f000c0f52",
"ac38546e-ddf3-437a-ac5c-27a94cd7a0f1"
]
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10"
]
}
Feedback
Feedback senden und anzeigen für