rôles UiPath Insights

Syntaxe et options pour `uip insights Roles`, qui lit les rôles Insights du locataire actif.

uip insights roles lit les rôles Insights définis dans le locataire actif. Il s'agit d'une interface en lecture seule; il n'y a pas de verbe de création, de mise à jour ou de suppression.

Important :

La lecture des rôles Insights nécessite l'autorisation Insights Management View (Afficher la gestion Insights) dans le locataire actif. Une session sans identité d’utilisateur (par exemple, une session connectée avec les informations d’identification du client) ne peut pas du tout lire ces données et obtient une erreur 403.

Synthèse

uip insights roles list [--include-resource] [-l <n>] [-o <n>]
uip insights roles get <role-id> [--include-resource]

Les deux verbes respectent les options globales et les codes de sortie standard. Aucun accepte -t, --tenant — il utilise le locataire sélectionné lors de uip login.

liste des rôles UiPath Insights

Répertoriez les rôles Insights visibles par l’appelant actuel. La liste peut être filtrée par le droit - un locataire sans le droit en mode complet ne voit que le rôle en lecture seule défini - et la liste peut déclencher un appel mis en cache vers les licences pour vérifier ce droit.

Options

Drapeau	Description
--include-resource	Incluez la chaîne de ressource de rôle, qui peut porter les GUID de l'organisation et du locataire, dans la sortie. Désactivé par défaut.
-l, --limit <number>	Nombre maximal de lignes à renvoyer. La valeur par défaut est 50.
-o, --offset <number>	Lignes à ignorer avant de renvoyer des résultats.

La pagination est côté client: le backend renvoie la liste non paginée complète et la CLI la coupe après la récupération.

Exemples

uip insights roles list

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

Format de données — Vue par défaut

{
  "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."
}

Format de données — avec --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 }
}

Une liste vide est un résultat réussi, et non une erreur - la réponse omet les notes permanentes/reprises ci-dessus lorsqu'il n'y a pas de lignes, car rien n'a été conservé d'un résultat vide.

rôles uip insights - Obtenir

Obtenez un rôle Insights par son GUID. Le filtre de droit de la liste ne s’applique pas ici. get peut résoudre un rôle que list a filtré.

Arguments

Nom	Requis	Objectif
<role-id>	oui	GUID du rôle. Doit être un vrai GUID — une valeur mal formée échoue côté client avec Run 'uip insights roles list' to find a role ID. avant tout appel réseau.

Options

Drapeau	Description
--include-resource	Incluez la chaîne de ressource de rôle dans la sortie. Désactivé par défaut.

Exemple

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

Format des données (--sortie json)

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

Avec --include-resource, la même forme obtient un champ resource, exactement comme dans le mode Liste.

Role <id> was not found in the active Insights tenant, or is not visible there. sur un 404 — si toutes les commandes RBAC Insights 404 s, le service Insights Portal n'est probablement pas enregistré dans le locataire.

Voir également

• Vue d’ensemble d’Insights
• utilisateurs, groupes — les autres interfaces de lecture RBAC; les deux affichent les noms de rôle résolus par les données de cette commande.