Mitglieder auflisten

Dient zum Abrufen einer Liste der Benutzer, die der Verzeichnisrolle zugeordnet sind. Nur Benutzer können einer Verzeichnisrolle zugewiesen werden.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen: Directory.Read.All oder Directory.ReadWrite.All oder Directory.AccessAsUser.All

HTTP-Anforderung

GET /directoryRoles/{id}/members

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer . Required.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von directoryObject-Objekten im Antworttext zurückgegeben.

Beispiel

Anforderung
GET https://graph.microsoft.com/v1.0/directoryRoles/{id}/members
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": [
    {
      "businessPhones":["000-000-0000"],
      "displayName":"First Last",
      "givenName":"First",
      "jobTitle":null,
      "mail":"first@example.com",
      "officeLocation":null,
      "preferredLanguage":"en-US",
      "surname":"Last",
      "userPrincipalName":"first@example.com"
    }
  ]
}