UIP Insights-Gruppen

Syntax und Optionen für „UIP Insights Groups“, wodurch die Insights-Gruppen des aktiven Mandanten und ihre Insights-Rollennamen gelesen werden.

uip insights groups liest die für den aktuellen Aufrufer sichtbaren Mandantengruppen zusammen mit ihren Insights-Rollennamen. Dies ist eine schreibgeschützte Oberfläche – es gibt kein Verb zum Erstellen, Aktualisieren oder Löschen.

Wichtig:

Das Lesen von Insights-Gruppen erfordert die Berechtigung zur Insights-Verwaltungsansicht im aktiven Mandanten. Eine Sitzung ohne Benutzeridentität (z. B. eine, die mit Client-Anmeldeinformationen angemeldet ist) kann diese Daten überhaupt nicht lesen und erhält einen 403-Fehler.

Zusammenfassung

uip insights groups list [--include-email] [-l <n>] [-o <n>]
uip insights groups get <group-id> [--include-email]

Beide Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Keiner von beiden akzeptiert -t, --tenant – sie verwenden den während uip login ausgewählten Mandanten.

Liste der UIP Insights-Gruppen

Listen Sie Mandantengruppen auf, die für den aktuellen Aufrufer sichtbar sind, mit ihren Insights-Rollennamen. Jede Zeile wird über das Verzeichnis aufgelöst – ein zwischengespeicherter Aufruf pro Gruppe, sequenziell –, sodass die erste (Kalkul-Cache-)Liste eines großen Mandanten langsamer sein kann als eine users list ähnlicher Größe.

Optionen

Markieren	Beschreibung
--include-email	Fügen Sie E-Mail-Adressen und die geschachtelten Rollen-IDs in die Ausgabe ein. Standardmäßig deaktiviert – die Standardansicht lässt beides weg.
-l, --limit <number>	Maximale Anzahl zurückzugebender Zeilen. Die Standardeinstellung ist 50.
-o, --offset <number>	Zeilen, die übersprungen werden sollen, bevor Ergebnisse zurückgegeben werden.

Die Paginierung ist clientseitig: Das Back-End gibt die vollständige unpaginierte Liste zurück und die CLI schneidet sie nach dem Abrufen ab.

Beispiele

uip insights groups list

uip insights groups list --include-email --limit 100

Datenform – Standardansicht

{
  "Code": "InsightsGroupsList",
  "Data": [
    { "id": "d1e2f3a4-0000-0000-0000-000000000001", "name": "Automation Users", "roles": [{ "name": "Viewer" }] }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Roles shown are the group's Insights roles in the active tenant, by name; 'uip insights roles list' maps a role name to its role GUID and back. Directory filtering can omit unresolved groups, so a missing row is not proof the stored group does not exist. Listing groups resolves each row through the directory, one cached call per group in sequence. 'uip insights groups get' returns the same fields as a row here and can persist refreshed directory name and email fields for the group, so read the row here when it is enough."
}

Datenform – mit --include-email

{
  "Code": "InsightsGroupsList",
  "Data": [
    {
      "id": "d1e2f3a4-0000-0000-0000-000000000001",
      "name": "Automation Users",
      "email": "[e-mail]",
      "roles": [{ "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

Die Verzeichnisfilterung kann Zeilen verwerfen. Eine Gruppe, die die Verzeichnissuche des Back-Ends nicht auflösen kann, wird vollständig aus der Liste weggelassen – eine fehlende Gruppe ist kein Nachweis dafür, dass sie nicht existiert; groups get kann es trotzdem direkt lösen. Auf einer leeren Liste wird der obige ständige Hinweis verworfen, da von null Zeilen nichts zurückgehalten wurde, aber der Vorbehalt für die Verzeichnisauflösung und der Kostenhinweis pro Gruppe gelten weiterhin.

UIP Insights-Gruppen abrufen

Rufen Sie eine Insights-Gruppe anhand ihrer GUID ab. Im Gegensatz zu list kann dies als Nebeneffekte den aktualisierten Verzeichnisnamen und die E-Mail-Felder für die Gruppe beibehalten – es ist lesbar, aber kein reiner Lesevorgang.

Argumente

Name	Erforderlich	Zweck
<group-id>	ja	Gruppen-GUID. Muss eine echte GUID sein – ein falsch formatierter Wert schlägt auf der Clientseite mit Run 'uip insights groups list' to find a group ID. vor einem Netzwerkaufruf fehl.

Optionen

Markieren	Beschreibung
--include-email	Fügen Sie E-Mail-Adressen und die geschachtelten Rollen-IDs in die Ausgabe ein. Standardmäßig deaktiviert.

Beispiel

uip insights groups get d1e2f3a4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Code": "InsightsGroupGet",
  "Data": { "id": "d1e2f3a4-0000-0000-0000-000000000001", "name": "Automation Users", "roles": [{ "name": "Viewer" }] }
}

Mit --include-email erhält dieselbe Form email und die geschachtelte roles[].id, genau wie bei der Listenansicht.

Group <id> was not found in the active Insights tenant, or is not visible there. bei einem 404 – eine Gruppe, die das Verzeichnis nicht auch 404er auflösen kann, sodass ein 404 allein kein Nachweis ist, dass die gespeicherte Gruppe nicht vorhanden ist. Wenn jeder Insights RBAC-Befehl 404s enthält, wurde der Insights Portal-Dienst wahrscheinlich nicht für den Mandanten bereitgestellt.

Siehe auch

• Insights-Übersicht
• Benutzer, Rollen – die anderen RBAC-Leseoberflächen; roles ordnet die hier angezeigten Rollennamen ihren GUIDs und zurück zu.