Freigeben über


directoryObject: getAvailableExtensionProperties

Namespace: microsoft.graph

Gibt alle Verzeichniserweiterungsdefinitionen zurück, die in einem Verzeichnis registriert sind, auch über mehrinstanzenfähige Apps. Die folgenden Entitäten unterstützen Erweiterungseigenschaften:

Wichtig

Diese API hat ein bekanntes Problem und verarbeitet nur Ergebnisse für Mandanten mit bis zu 1.000 Dienstprinzipalen. Andernfalls wird eine leere Antwort zurückgegeben. Verwenden Sie stattdessen List extensionProperties (Verzeichniserweiterungen).

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) Directory.Read.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Directory.Read.All Nicht verfügbar.

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

  • Verzeichnisautoren
  • Cloudanwendungsadministrator
  • Anwendungsadministrator

HTTP-Anforderung

POST /directoryObjects/getAvailableExtensionProperties

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie als Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Parameter Typ Beschreibung
isSyncedFromOnPremises Boolean true , um anzugeben, dass nur Erweiterungseigenschaften zurückgegeben werden sollen, die aus dem lokalen Verzeichnis synchronisiert werden; false , um anzugeben, dass nur Erweiterungseigenschaften zurückgegeben werden sollen, die nicht aus dem lokalen Verzeichnis synchronisiert werden. Wenn der Parameter nicht angegeben wird, werden alle Erweiterungseigenschaften (synchronisiert und nicht synchronisiert) zurückgegeben. Optional.

Antwort

Wenn die Aktion erfolgreich verläuft, werden der 200 OK Antwortcode und eine extensionProperty-Auflistung im Antworttext zurückgegeben.

Beispiele

Anforderung

POST https://graph.microsoft.com/v1.0/directoryObjects/getAvailableExtensionProperties

{

}

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#Collection(extensionProperty)",
  "value": [
    {
      "@odata.type": "#microsoft.graph.extensionProperty",
      "id": "d6a8bfec-893d-46e4-88fd-7db5fcc0fa62",
      "deletedDateTime": null,
      "appDisplayName": "SampleApp",
      "name": "extension_4d405aa8baa04fb494d3e0571fd9fd71_skypeId",
      "dataType": "String",
      "isSyncedFromOnPremises": false,
      "targetObjects": [
        "User"
      ]
    }
  ]
}