Microsoft Entra-Gruppe (vormals Azure Active Directory-Gruppe) per API aus Learn365 löschen

In Learn365 können Sie nicht nur eine Microsoft Entra-Gruppe (vormals Azure Active Directory-Gruppe) aus einem Kurskatalog entfernen, sondern auch einen Endpunkt aus der Learn365-API nutzen, um eine Microsoft Entra-Gruppe aus einem Learn365-Mandanten zu löschen. Hierbei werden alle Informationen und Handlungsaufzeichnungen dieser Gruppe entfernt.

Dieser Artikel beschreibt, welche Schritte Sie ausführen müssen, um eine Microsoft Entra-Gruppe per API aus einem Learn365-Mandanten zu löschen.

Gehen Sie wie folgt vor, um eine Microsoft Entra-Gruppe (vormals Azure Active Directory-Gruppe) aus einem Learn365-Mandanten zu löschen:

1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Suchen und erweitern Sie den Abschnitt Users, suchen Sie die Methode POST /odata/v2/Users('{LoginName}')/Purge mit der Beschreibung Purges user's data und wählen Sie oben rechts Try it out aus.

3. Zwei zusätzliche Felder werden angezeigt. Hier müssen Sie den Pflichtparameter key: LoginName eintragen. Dazu geben Sie den Anmeldenamen der Microsoft Entra-Gruppe ein, die Sie aus dem Learn365-Mandanten entfernen möchten.

4. Wenn Sie bereit sind, wählen Sie Execute aus, um die Anfrage auszuführen.

5. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• Die Zahl 2xx (beispielsweise „202“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body sehen Sie die Ergebnisse der Anfrage: Die Microsoft Entra-Gruppe wird vollständig vom Mandanten gelöscht, d. h. aus allen Kurskatalogen, Kursen und Schulungsplänen. Ferner werden alle Aufzeichnungen, die sich auf diese Microsoft Entra-Gruppe beziehen, vollständig aus Learn365 entfernt, und es gibt keine Möglichkeit, sie wiederherzustellen.
  Benutzer aus dieser gelöschten Microsoft Entra-Gruppe verbleiben in solchen Katalogen des Mandanten sowie Kursen und Schulungsplänen, für die sie als Einzelbenutzer registriert waren. Allerdings behalten diese Benutzer nicht ihre Rollen und Registrierungen in Katalogen, Kursen und Schulungsplänen, denen sie über die gelöschte Microsoft Entra-Gruppe hinzugefügt gewesen waren. Gleichzeitig bleiben alle Qualifikationen und Zertifikate, die den Benutzern verliehen worden waren, als sie Teil der Microsoft Entra-Gruppe waren, in ihren Unterlagen erhalten.