utilisateurs d’éclairages uip

Syntaxe et options pour `uip insights users`, qui lisent les utilisateurs Insights du locataire actif et leurs noms de rôle Insights.

uip insights users lit les utilisateurs du locataire 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 utilisateurs d'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 users list [--include-email] [-l <n>] [-o <n>]

Ce verbe respecte les options globales et les codes de sortie standard. Elle n'accepte pas -t, --tenant — elle utilise le locataire sélectionné lors de uip login.

liste des utilisateurs uip insights

Répertoriez les utilisateurs du locataire visibles par l'appelant actuel, avec leurs noms de rôle Insights.

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 users list

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

Format de données — Vue par défaut

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "roles": [{ "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false },
  "Instructions": "Roles shown are the user's Insights roles in the active tenant, by name. A user's row is kept even when directory enrichment fails."
}

Format de données — avec --include-email

{
  "Code": "InsightsUsersList",
  "Data": [
    {
      "id": "b2c3d4e5-0000-0000-0000-000000000001",
      "name": "Jane Doe",
      "email": "[e-mail]",
      "roles": [{ "id": 3, "name": "Viewer" }]
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "Total": 1, "HasMore": false }
}

La ligne d'un utilisateur est conservée dans la liste même lorsque l'enrichissement du répertoire (résolution des données d'affichage) échoue pour cet utilisateur — une ligne incomplète n'est pas supprimée.

Voir également

• Vue d’ensemble d’Insights
• alertes, alert-history — autres interfaces de lecture à l'échelle du locataire.