Benutzer auflisten

Dient zum Abrufen einer Liste von Benutzerobjekten.

Hinweis: Durch das Auflisten von Benutzern wird nur ein standardmäßiger Satz von Eigenschaften zurückgegeben (businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, userPrincipalName). Verwenden Sie $select, um die anderen Eigenschaften und Beziehungen für das user-Objekt abzurufen. Es können jedoch nur die folgenden Eigenschaften für einzelne Benutzer, z. B. „/v1.0/me?$select=aboutMe“, und nicht für Sammlungen von Benutzern wie z. B. „/v1.0/users?$select=aboutMe“ ausgewählt werden. * aboutMe * birthday * hireDate * interests * mySite * pastProjects * preferredName * responsibilities * schools * skills * mailboxSettings

Voraussetzungen

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

HTTP-Anforderung

GET /users

Optionale Abfrageparameter

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

Anforderungsheader

Kopfzeile Wert
Authorization Bearer . Required.
Content-Type application/json

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 user-Objekten im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/v1.0/users
Antwort

Nachfolgend sehen Sie ein Beispiel der 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
Content-length: 608

{
  "value": [
    {
      "businessPhones": [
        "businessPhones-value"
      ],
      "displayName": "displayName-value",
      "givenName": "givenName-value",
      "jobTitle": "jobTitle-value",
      "mail": "mail-value",
      "mobilePhone": "mobilePhone-value",
      "officeLocation": "officeLocation-value",
      "preferredLanguage": "preferredLanguage-value",
      "surname": "surname-value",
      "userPrincipalName": "userPrincipalName-value",
      "id": "id-value"
    }
  ]
}