Benutzer und Microsoft Entra-Gruppen per Learn365-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 per Learn365-API aus einem Kurskatalog löschen.

Um einen Benutzer oder eine Microsoft Entra group mithilfe der API aus einem Kurskatalog zu löschen, führen Sie die folgenden Schritte aus:

Um die Learn365 API verwenden zu können, sollten Sie mit dem entsprechenden API-Schlüssel auf https:/api.365.systems autorisiert sein. Details finden Sie in diesem Artikel.

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

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 Course catalog id, die ID des Kurskatalogs ein, aus dem Sie einen Benutzer oder eine Gruppe entfernen möchten.
• Geben Sie unter User login den Anmeldenamen des Benutzers oder einer Gruppe ein, den bzw. die Sie aus einem Kurskatalog entfernen möchten.

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

5. Überprüfen Sie im Block Responses 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 Users  gelöscht und wird von allen Kursen und Schulungsplänen dieses Kurskatalogs abgemeldet.