Mitgliedergruppen prüfen

Dient zum Überprüfen der Mitgliedschaft in einer angegebenen Liste von Gruppen und gibt aus dieser Liste die Gruppen zurück, in denen das angegebene Benutzer-, Gruppen- oder Verzeichnisobjekt Mitglied ist. Diese Funktion ist transitiv.

Voraussetzungen

Die folgenden Bereiche sind erforderlich, um diese API auszuführen: - User.Read.All UND Group.Read.All - Directory.Read.All

Hinweis: Berechtigungsbereiche werden in der Reihenfolge der geringsten erforderlichen Rechte aufgelistet.

HTTP-Anforderung

POST /me/checkMemberGroups
POST /users/{id | userPrincipalName}/checkMemberGroups
POST /groups/{id}/checkMemberGroups
POST /directoryObjects/{id}/checkMemberGroups

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer . Required.
Content-Type application/json  

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
groupIds String Eine Sammlung mit den Objekt-IDs der Gruppen, in denen die Mitgliedschaft überprüft werden soll. Bis zu 20 Gruppen können angegeben werden.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200, OK und das String-Sammlungsobjekt im Antworttext zurückgegeben.

Beispiel

Anforderung
POST https://graph.microsoft.com/v1.0/me/checkMemberGroups
Content-type: application/json

{
  "groupIds": [
        "fee2c45b-915a-4a64-b130-f4eb9e75525e",
        "4fe90ae7-065a-478b-9400-e0a0e1cbd540"
  ]
}
Antwort

Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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

{
  "value": [
        "fee2c45b-915a-4a64-b130-f4eb9e75525e"
  ]
}