Mit der Learn365 API ist es möglich, den Anmeldenamen eines Benutzers sowie den einer Gruppe abzurufen. Dieser Artikel beschreibt die Schritte zum Abrufen des entsprechenden Anmeldenamens.
HINWEIS
In der API wird der Parameter LoginName manchmal als userLoginName bezeichnet. Der Anmeldename, den Sie erhalten, wenn Sie den Anweisungen in diesem Artikel folgen, kann in jedes Feld eingetragen werden, in dem einer der beiden Parameter erforderlich ist.
Führen Sie die folgenden Schritte aus, um den Anmeldenamen eines Benutzers oder einer Gruppe abzurufen:
1. Gehen Sie zu https://api.365.systems/ und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.
2. Suchen Sie den Abschnitt Users , erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/Users mit der Beschreibung Returns the list of Users und klicken Sie dann oben rechts auf Try it out .
3. Wählen Sie Execute aus, um die Anfrage auszuführen.
TIPP
Sie können Abfrageoptionsparameter verwenden, um die Daten in der Antwort durch das Festlegen von Filtern zu steuern. Wenn Abfrageoptionsparameter festgelegt sind, enthält die Antwort zusätzliche Daten und Details, die Sie für die Suche verwenden können.
Beachten Sie, dass sich die Leistung der Anfrage verringern kann, wenn der Wert UserFieldValues im Parameter $expand verwendet wird, je nachdem, wie viele Daten verarbeitet werden müssen. Um das Risiko von Leistungsproblemen bei der Verwendung dieses Endpunkts zu verringern, können Sie die folgenden Parameter verwenden:
- &select – um nur die angegebenen Spalten abzurufen.
- &skip – um die ersten n Datensätze zu überspringen (auszuschließen).
- &top – um nur die angegebene Anzahl von Elementen abzurufen.
4. Gehen Sie zum Block Responses, um die Ergebnisse zu prüfen:
- Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
- Im Feld Response body sehen Sie alle Benutzer des Tenants und deren Daten, einschließlich der in der Zeile LoginName angegebenen Anmeldenamen.
- Suchen Sie mit Strg+F nach einem bestimmten Benutzer oder einer Gruppe. Mit der Option Download können Sie die Ergebnisse der API-Anfrage im JSON-Format auf Ihrem Computer speichern.
Hier sind einige Beispiele dafür, wie die Anmeldenamen eines Benutzers oder einer Gruppe in der Antwort angezeigt werden:
- Anmeldename eines Benutzers
- Anmeldename einer Microsoft 365-Gruppe
- Anmeldename einer Sicherheitsgruppe
WICHTIG
In einigen Fällen empfehlen wir, DirectoryObjectId statt LoginName zu verwenden.
DirectoryObjectId ist ein eindeutiger Bezeichner in Microsoft Entra. Er bleibt unverändert, selbst wenn der Anmeldename des Objekts geändert wird, damit das System den Benutzer identifizieren kann.
DirectoryObjectId ist in derselben Antwort wie der Anmeldename des Benutzers enthalten.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.