UIP Insights-Rollen

Syntax und Optionen für „UIP Insights Roles“, die die Insights-Rollen des aktiven Mandanten lesen.

uip insights roles liest die im aktiven Mandanten definierten Insights-Rollen. Dies ist eine schreibgeschützte Oberfläche – es gibt kein Verb zum Erstellen, Aktualisieren oder Löschen.

Wichtig:

Das Lesen von Insights-Rollen erfordert die Berechtigung Insights Management View 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 roles list [--include-resource] [-l <n>] [-o <n>]
uip insights roles get <role-id> [--include-resource]

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-Rollen

Listen Sie Insights-Rollen auf, die für den aktuellen Aufrufer sichtbar sind. Die Liste kann nach Berechtigungen gefiltert werden – ein Mandant ohne Berechtigung für den Vollmodus sieht nur den schreibgeschützten Rollensatz – und die Auflistung kann einen zwischengespeicherten Aufruf an die Lizenzierung auslösen, um diese Berechtigung zu überprüfen.

Optionen

Markieren	Beschreibung
--include-resource	Fügen Sie die Rollenressourcenzeichenfolge, die die GUIDs der Organisation und des Mandanten enthalten kann, in die Ausgabe ein. Standardmäßig deaktiviert.
-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 roles list

uip insights roles list --include-resource --limit 100

Datenform – Standardansicht

{
  "Code": "InsightsRolesList",
  "Data": [
    { "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer", "actions": ["Read"] }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Role names can be entitlement-filtered: a role missing from this list can still exist and 'roles get' can still resolve it. Listing roles can trigger a cached entitlement call to Licensing. 'uip insights users list' and 'uip insights groups list' show these roles by name on each principal's row."
}

Datenform – mit --include-resource

{
  "Code": "InsightsRolesList",
  "Data": [
    {
      "id": "c1d2e3f4-0000-0000-0000-000000000001",
      "name": "Viewer",
      "actions": ["Read"],
      "resource": "orn:orch:tenant:t1:role:Viewer"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

Eine leere Liste ist ein erfolgreiches Ergebnis, kein Fehler – die Antwort lässt die stehenden/zurückgehaltenen Hinweise oben weg, wenn keine Zeilen vorhanden sind, da von einem leeren Ergebnis nichts zurückgehalten wurde.

Abrufen von UIP Insights-Rollen

Rufen Sie eine Insights-Rolle anhand ihrer GUID ab. Der Berechtigungsfilter der Liste gilt hier nicht – get kann eine Rolle auflösen, die list herausgefiltert hat.

Argumente

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

Optionen

Markieren	Beschreibung
--include-resource	Fügen Sie die Rollenressourcenzeichenfolge in die Ausgabe ein. Standardmäßig deaktiviert.

Beispiel

uip insights roles get c1d2e3f4-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Code": "InsightsRoleGet",
  "Data": { "id": "c1d2e3f4-0000-0000-0000-000000000001", "name": "Viewer", "actions": ["Read"] }
}

Mit --include-resource erhält dieselbe Form ein resource -Feld wie die Listenansicht.

Role <id> was not found in the active Insights tenant, or is not visible there. auf einem 404 – wenn jeder Insights RBAC-Befehl 404 ist, hat der Mandant den Insights Portal-Dienst wahrscheinlich nicht bereitgestellt.

Siehe auch

• Insights-Übersicht
• Benutzer, Gruppen – die anderen RBAC-Leseoberflächen; Beide zeigen Rollennamen an, die durch die Daten dieses Befehls aufgelöst wurden.