Benutzer und Microsoft Entra-Gruppen (vormals Azure Active Directory-Gruppen) per API aus einem Kurskatalog löschen

Mit der Learn365-API können Sie einen Benutzer oder eine Gruppe aus einem Kurskatalog entfernen.

Dieser Artikel beschreibt, wie Sie mithilfe eines API-Endpunkts einen Benutzer oder eine Microsoft Entra-Gruppe (vormals Azure Active Directory-Gruppe) per Learn365-API aus einem Kurskatalog löschen.

Gehen Sie wie folgt vor, um einen Benutzer oder eine Microsoft Entra-Gruppe per API aus einem Kurskatalog zu löschen:

Zum Verwenden der Learn365-API müssen Sie mit dem entsprechenden API-Schlüssel auf https://api.365.systems autorisiert sein. Ausführliche Informationen finden Sie in diesem Artikel.

1. Erweitern Sie auf https://api.365.systems den Abschnitt CourseCatalogs.

2. Wählen Sie den Endpunkt DELETE /odata/v2/CourseCatalogs({id})/Users('{userLogin}') aus, mit dem ein Benutzer aus einem Kurskatalog entfernt wird, und wählen Sie Try it out aus.

3. Tragen Sie im geöffneten Abschnitt Parameters die Pflichtparameter für die Abfrage ein:

• Geben Sie unter id die ID des Kurskatalogs ein, aus dem Sie einen Benutzer oder eine Gruppe entfernen möchten.
• Unter User login geben Sie den Anmeldenamen des Benutzers oder einer Gruppe ein, den bzw. die Sie aus einem Kurskatalog entfernen möchten.

4. Wählen Sie Execute aus, um die Anfrage auszuführen.

5. Im Block Response kontrollieren Sie die Ergebnisse:

• Die Zahl 2xx (beispielsweise „204“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body werden die Ergebnisse der Anfrage angezeigt. Der Benutzer bzw. die Gruppe wird aus dem Kurskatalog und aus der zugehörigen Liste Benutzer gelöscht und von allen Kursen und Schulungsplänen dieses Kurskatalogs abgemeldet.