Einen Besitzer zu einer benutzerdefinierten Benutzergruppe über die Learn365-API hinzufügen

Mit der Learn365-API können Sie Katalogadministratoren als Besitzer benutzerdefinierter Benutzergruppen hinzufügen. Während LMS-Administratoren jede benutzerdefinierte Benutzergruppe in ihrer Organisation verwalten können, können Katalogadministratoren nur diejenigen benutzerdefinierten Benutzergruppen verwalten, deren Besitzer sie sind. Die Liste der Aktionen, die Katalogadministratoren zur Verfügung stehen, finden Sie am Ende dieses Artikels.

In diesem Artikel beschreiben wir, wie Sie einer neuen oder bestehenden benutzerdefinierten Benutzergruppe einen Besitzer hinzufügen.

Benutzer-IDs von Katalogadministratoren finden

Um Benutzer-IDs von Katalogadministratoren zu finden, folgen Sie den Schritten aus diesem Artikel.

Einer neuen benutzerdefinierten Benutzergruppe einen Besitzer hinzufügen

Erforderliche Rolle: LMS-Administrator, Katalogadministrator.

Um beim Erstellen einer neuen benutzerdefinierten Benutzergruppe einen Besitzer hinzuzufügen, folgen Sie den Schritten im Abschnitt Benutzerdefinierte Benutzergruppen erstellen in diesem Artikel.

Einer bestehenden benutzerdefinierten Benutzergruppe einen Besitzer hinzufügen

Erforderliche Rolle: LMS-Administrator. Katalogadministrator, wenn er der Besitzer der Gruppe ist.

Um einer bestehenden benutzerdefinierten Benutzergruppe einen Besitzer hinzuzufügen, benötigen Sie die Gruppen-ID. Außerdem lohnt es sich zu prüfen, ob die Gruppe bereits Besitzer hat. So erhalten Sie diese Informationen:

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

2. Wählen Sie im Abschnitt Groups den Endpunkt GET /services/users/v2/Groups aus und klicken Sie oben rechts auf Try it out .

3. Falls erforderlich, verwenden Sie Abfrageoptionsparameter, um die Daten in der Antwort zu steuern.

4. Klicken Sie auf Execute, um die Anfrage auszuführen.

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

• Ein 200-Code mit einer Liste von Benutzergruppen bedeutet, dass die Antwort erfolgreich war. 100 Gruppen sind das Limit für eine Antwort. Um die Daten in der Antwort zu steuern, verwenden Sie Abfrageoptionsparameter.
• Jede Benutzergruppe hat diese Parameter:
  • id: die Benutzergruppen-ID. Sie benötigen diese ID, um einen Eigentümer zur Gruppe hinzuzufügen.
  • ownerIds: eine Liste der Besitzer-IDs der Benutzergruppenbesitzer. Wenn die Benutzergruppe keine Besitzer hat, ist die Liste leer. 

So fügen Sie einer vorhandenen benutzerdefinierten Benutzergruppe einen Besitzer hinzu:

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

2. Wählen Sie im Abschnitt Groups den Endpunkt PUT /services/users/v2/Groups/{groupId} aus und wählen Sie oben rechts Try it out aus.

3. Geben Sie im Feld groupId die ID der benutzerdefinierten Benutzergruppe ein.

4. Geben Sie im Anfragetext Folgendes ein:

• String-Parameter Titel. Wenn der Titel der Benutzergruppe unverändert bleiben soll, geben Sie den aktuellen Titel ein. Wenn Sie ihn ändern möchten, geben Sie einen neuen Titel ein. Der Titel muss eindeutig sein, d. h., er darf keiner bestehenden benutzerdefinierten Benutzergruppe oder Microsoft Entra-Gruppe zugewiesen sein. Um eine Liste der vorhandenen benutzerdefinierten Benutzergruppen und Microsoft Entra-Gruppen anzuzeigen, senden Sie die API-Anfrage GET /services/users/v2/Groups.
• ownerIds-Array: eine Liste der Benutzer-IDs der Katalogadministratoren, die die Besitzer der Benutzergruppe werden sollen. Beachten Sie, dass die Liste der neuen Gruppenbesitzer die vorhandenen Besitzer der Benutzergruppe ersetzt, falls es welche gibt.

Der Anfragetext könnte wie folgt aussehen:

{
 "Titel": "Sound Engineers",
 "ownerIds": [
 "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "fa35cdf2-75bd-40b0-ac0d-b5ca7bfde448" 
 ]
}

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

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

• Ein 200-Code mit der id und dem Titel der Gruppe im Antworttext weist auf eine erfolgreiche Antwort hin.
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.

Für Besitzer von Benutzergruppen verfügbare Aktionen

Die folgenden Aktionen stehen Katalogadministratoren zur Verfügung, unabhängig davon, ob sie Administratoren benutzerdefinierter Benutzergruppen sind oder nicht:

• Eine Liste der Benutzergruppen anzeigen und deren IDs abrufen.
• Eine benutzerdefinierte Benutzergruppe erstellen.
• Informationen zu einer bestimmten Benutzergruppe über die API-Anfrage GET /services/users/v2/Groups/{groupId} abrufen.

Die folgenden Aktionen stehen Katalogadministratoren zur Verfügung, die Besitzer benutzerdefinierter Benutzergruppen sind:

• Eine benutzerdefinierte Benutzergruppe, die sie besitzen, löschen.
• Eine benutzerdefinierte Benutzergruppe, die sie besitzen, aktualisieren.
• Benutzer zu einer benutzerdefinierten Benutzergruppe, die der Katalogadministrator besitzt, hinzufügen oder aus dieser entfernen.