groupes d'informations sur l'uip

Syntaxe et options pour `uip insights Groups`, qui lit les groupes Insights du locataire actif et leurs noms de rôle Insights.

uip insights groups lit les groupes de locataires visibles par l'appelant actuel, ainsi que leurs noms de rôle Insights. 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 groupes Insights nécessite l'autorisation Insights Management View 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 groups list [--include-email] [-l <n>] [-o <n>]
uip insights groups get <group-id> [--include-email]

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 groupes uip insights

Répertoriez les groupes de locataires visibles par l'appelant actuel, avec leurs noms de rôle Insights. Chaque ligne est résolue via le répertoire — un appel mis en cache par groupe, en séquence — de sorte que la première liste (mise en cache) d'un grand locataire peut être plus lente qu'une users list de taille similaire.

Options

Drapeau	Description
--include-email	Incluez les adresses e-mail et les ID de rôle imbriqués dans la sortie. Désactivé par défaut — la vue par défaut omet les deux.
-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 groups list

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

Format de données — Vue par défaut

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

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

Le filtrage par répertoire peut supprimer des lignes. Un groupe que la recherche dans l’annuaire du backend ne peut pas résoudre est entièrement omis de la liste - un groupe manquant n’est pas la preuve qu’il n’existe pas; groups get peut toujours le résoudre directement. Sur une liste vide, la note permanente ci-dessus est supprimée, car rien n'a été conservé sur les lignes zéro, mais la mise en garde de résolution de répertoire et la note de coût par groupe s'appliquent toujours.

groupes uip insights - Obtenir

Obtenez un groupe Insights par son GUID. Contrairement à list, cela peut conserver les champs de nom d'annuaire et d'e-mail actualisés pour le groupe comme effet latéral - il est en forme de lecture, mais pas une lecture pur.

Arguments

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

Options

Drapeau	Description
--include-email	Incluez les adresses e-mail et les ID de rôle imbriqués dans la sortie. Désactivé par défaut.

Exemple

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

Format des données (--sortie json)

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

Avec --include-email, la même forme gagne email et le roles[].id imbriqué, comme dans le mode Liste.

Group <id> was not found in the active Insights tenant, or is not visible there. sur un 404 — un groupe que le répertoire ne peut pas résoudre également 404 s ici, donc un 404 seul ne constitue pas la preuve que le groupe stocké n'existe pas. Si toutes les commandes RBAC Insights sont 404, le service Portail Insights n'est probablement pas enregistré dans le locataire.

Voir également

• Vue d’ensemble d’Insights
• utilisateurs, rôles — les autres interfaces de lecture RBAC; roles mappe les noms de rôle affichés ici à leurs GUID et inversement.