AdministrativeUnits auflisten
Namespace: microsoft.graph
Ruft eine Liste von administrativeUnit-Objekten ab.
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) | AdministrativeUnit.Read.All | AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | AdministrativeUnit.Read.All | AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
HTTP-Anforderung
GET /directory/administrativeUnits
Optionale Abfrageparameter
Diese Methode unterstützt die $count
OData-Abfrageparameter , $select
, $search
, $filter
(eq
) und $expand
zum Anpassen der Antwort. Erweiterungseigenschaften unterstützen auch Abfrageparameter wie folgt:
Erweiterungstyp | Kommentare |
---|---|
Schemaerweiterungen | Wird nur mit $select zurückgegeben. Unterstützt $filter (eq ). |
Verzeichniserweiterungen | Wird standardmäßig zurückgegeben. Unterstützt $filter (eq ). |
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode und eine 200 OK
Sammlung von administrativeUnit-Objekten im Antworttext zurück.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/directory/administrativeUnits
Antwort
Das folgende Beispiel zeigt die 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#directory/administrativeUnits",
"value": [
{
"id": "4d7ea995-bc0f-45c0-8c3e-132e93bf95f8",
"deletedDateTime": null,
"displayName": "Seattle District Technical Schools",
"description": "Seattle district technical schools administration",
"membershipRule": null,
"membershipType": null,
"membershipRuleProcessingState": null,
"visibility": "HiddenMembership"
}
]
}