utilisateurs de la plate-forme uip

Syntaxe et options pour `uip platform users`, qui gère l'attribution de bundle de licences par utilisateur via le compte de licence.

uip platform users gère l’attribution de packs de licences par utilisateur via le Comptabilité de licence, ainsi que les recharges consommables par utilisateur et les rapports d’utilisation des licences/consommables. Trois groupes de commandes indépendants se trouvent ici: licenses (attribution directe/groupe de bundles), top-ups (octroi et suivi des recharges consommables) et usage (consommation de licence par utilisateur).

Synthèse

uip platform users licenses <verb> [options] [<user>]
uip platform users top-ups <verb> [options]
uip platform users usage <verb> [options] [<user>]

Verbes

Groupe	Verbe	Objectif
licenses	set	Affectez des licences de bundle d'utilisateur directement à un utilisateur de répertoire.
licenses	get	Répertoriez les baux de location de bundles d'utilisateurs actuellement détenus par un utilisateur de l'annuaire, avec la source de chaque location.
licenses	available	Obtenez le récapitulatif des licences au niveau du compte (total, alloué, disponible).
top-ups	create	Accordez un rechargement à un utilisateur à partir du pool consommable actif de l'organisation.
top-ups	get	Vérifier le statut d'une tâche d'octroi de recharge.
top-ups	request	Demandez un rechargement pour vous-même; notifie les administrateurs de l'organisation.
usage	list	Lister les utilisateurs ayant des licences dans l’organisation.
usage	get	Affichez l’utilisation de licences par utilisateur (la vôtre ou celle d’un administrateur affichant celle d’un autre utilisateur).

Résolution de l'utilisateur

set et get prennent un argument positionnel <user> — un préfixe de nom ou d'e-mail. La CLI recherche les utilisateurs locaux et du répertoire avec une correspondance « commence par» et requiert exactement une correspondance:

• Aucune correspondance → erreur avec "No directory user found matching '<input>'.".
• Correspondances multiples → erreur répertoriant jusqu’à 10 candidats afin que vous puissiez affiner l’entrée.

jeu de licences utilisateurs uip platform

Attribuez des licences de bundle d'utilisateur à un utilisateur d'annuaire. Les bundles dans --input remplacent les bundles directement attribués à l'utilisateur; les bundles hérités des règles de groupe ne sont pas affectés par cette commande.

Arguments

Nom	Requis	Objectif
<user>	oui	Identifiant de l'utilisateur (nom ou préfixe de l'adresse e-mail; doit correspondre exactement à un utilisateur du répertoire).

Options

Long	Valeur (Value)	Default	Description
--input	Chemin d'accès	requis	Chemin d'accès à un fichier JSON avec l'attribution de licences utilisateur souhaitée, par exemple [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform users licenses set "[e-mail]" \
    --input ./user-bundles.json

user-bundles.json :

[
  { "code": "RPADEVPRONU" },
  { "code": "ATTUNU" },
  { "code": "TSTNU" }
]

Format des données (--sortie json)

{
  "Code": "UserLicensesSet",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU" },
    { "code": "ATTUNU",      "name": "ATTUNU" },
    { "code": "TSTNU",       "name": "TSTNU" }
  ]
}

Obtenir des licences utilisateur de la plate-forme uip

Obtenez les licences de bundle d'utilisateur actuellement locataires par un utilisateur d'annuaire. Chaque ligne correspond à un bundle locataire; source est "group" lorsque la location est héritée d'une règle de groupe, ou "direct" pour les attributions hors groupe.

Arguments

Nom	Requis	Objectif
<user>	oui	Identifiant de l'utilisateur (nom ou préfixe de l'adresse e-mail; doit correspondre exactement à un utilisateur du répertoire).

Options

Long	Valeur (Value)	Default	Description
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform users licenses get "[e-mail]"

Format des données (--sortie json)

{
  "Code": "UserLicenses",
  "Data": [
    {
      "source": "direct",
      "code": "RPADEVPRONU",
      "name": "RPADEVPRONU",
      "leasedAt": "2026-04-15T10:30:00.000Z"
    },
    {
      "source": "group",
      "code": "ATTUNU",
      "name": "ATTUNU",
      "leasedAt": "2026-04-20T08:15:00.000Z"
    }
  ]
}

les licences utilisateurs de la plate-forme uip sont disponibles

Obtenez le résumé au niveau du compte des licences de bundles d’utilisateurs: combien il existe de sièges par bundle (total), combien sont déjà attribués (allocated) et combien restent disponibles (available). Utilisez cette option avant l’attribution pour confirmer la capacité.

Options

Long	Valeur (Value)	Default	Description
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation. Remplacer l’organisation résolue à partir de la connexion actuelle.

Exemple

uip platform users licenses available

Format des données (--sortie json)

{
  "Code": "UserLicensesAvailable",
  "Data": [
    { "code": "RPADEVPRONU", "name": "RPADEVPRONU", "total": 100, "allocated": 42, "available": 58 },
    { "code": "ATTUNU",      "name": "ATTUNU",      "total": 50,  "allocated": 50, "available": 0 }
  ]
}

recharges des utilisateurs de la plate-forme uip

Accordez et suivez les recharges consommables par utilisateur. Le pool source est résolu automatiquement à partir des consommables actifs de l'organisation (PLTU de préférence, sinon AGU) — vous ne transmettez jamais le pool explicitement.

création de recharges d'utilisateurs uip platform

Accordez un rechargement à un utilisateur.

Arguments

Nom	Requis	Objectif
<user>	oui	Identifiant de l'utilisateur (nom ou préfixe de l'adresse e-mail; doit correspondre exactement à un utilisateur du répertoire).

Options

Long	Valeur (Value)	Default	Description
--wait	Drapeau	désactivé	Attendez que la tâche de recharge soit terminée et signalez si elle a été accordée.
--count	entier (1-100)	1	Nombre d'unités supplémentaires à accorder.
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation.

Exemples

uip platform users top-ups create "[e-mail]"
uip platform users top-ups create "[e-mail]" --wait
uip platform users top-ups create "[e-mail]" --count 5

Format des données (--sortie json)

Sans --wait:

{
  "Code": "TopUpStarted",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "started",
    "pool": "AGU",
    "poolPercentConsumed": 42
  }
}

Avec --wait:

{
  "Code": "TopUpCompleted",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "completed",
    "pool": "AGU",
    "poolPercentConsumed": 42,
    "granted": true,
    "rejectionReason": null
  }
}

les recharges des utilisateurs de la plate-forme uip obtiennent

Vérifier le statut d'une tâche d'octroi de recharge.

Arguments

Nom	Requis	Objectif
<job-id>	oui	ID de tâche de recharge renvoyé par top-ups create.

Options

Long	Valeur (Value)	Default	Description
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation.

Exemple

uip platform users top-ups get b3f1c2d4-0000-0000-0000-000000000009

Format des données (--sortie json)

{
  "Code": "TopUpStatus",
  "Data": {
    "jobId": "b3f1c2d4-0000-0000-0000-000000000009",
    "status": "completed",
    "granted": true,
    "rejectionReason": null
  }
}

demande de recharges des utilisateurs de la plate-forme uip

Demandez un rechargement pour vous-même (l'utilisateur connecté). Cela en informe les administrateurs de votre organisation — cela n’accorde rien directement.

Options

Long	Valeur (Value)	Default	Description
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation.

Exemple

uip platform users top-ups request

Format des données (--sortie json)

{
  "Code": "TopUpRequested",
  "Data": {
    "userId": "11111111-1111-1111-1111-111111111111",
    "outcome": "NotificationSent",
    "message": "Your administrators have been notified."
  }
}

Un résultat autre queNotificationSent (par exemple NotEligible ou NoActiveDistribution) est renvoyé comme un échec avec le message du serveur.

Utilisation des utilisateurs de la plate-forme uip

Afficher la consommation de licences par utilisateur: pourcentage utilisé pour le pool mensuel et pourcentage utilisé pour le portefeuille complémentaire.

liste d'utilisation des utilisateurs de la plate-forme uip

Lister les utilisateurs ayant des licences dans l’organisation.

Options

Long	Valeur (Value)	Default	Description
--limit	Integer	taille de page par défaut	Nombre maximal d'utilisateurs à renvoyer.
--offset	Integer	0	Nombre d'utilisateurs à ignorer.
--sort-by	Champ	—	Trier par un champ de la ligne d'utilisation de l'utilisateur (par exemple email, displayName).
--sort-order	asc	desc	—
--license-codes	codes séparés par des espaces	—	Filtrez sur les utilisateurs possédant des bundles de licences spécifiques (par exemple RPADEVPRONU ATTUNU).
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation.

Exemples

uip platform users usage list
uip platform users usage list --limit 50 --offset 50 --sort-by email --sort-order asc --license-codes RPADEVPRONU ATTUNU

Format des données (--sortie json)

{
  "Code": "UserUsageList",
  "Data": [
    {
      "userId": "11111111-1111-1111-1111-111111111111",
      "email": "[e-mail]",
      "displayName": "Jane Doe",
      "licenses": ["RPADEVPRONU"],
      "strongestLicense": "RPADEVPRONU",
      "monthlyPercentConsumed": 64,
      "topUpWalletPercentConsumed": 20,
      "topups": 2,
      "status": "TopUp"
    }
  ]
}

monthlyPercentConsumed est null (non 0) lorsque l'utilisateur ne dispose pas d'allocation mensuelle. status est l'un des MonthlyLimit, TopUp et PaidUnits.

utilisation des utilisateurs de la plate-forme uip obtenir

Afficher la consommation de licences utilisateur: le pourcentage mensuel consommé de chaque consommable, la date de réinitialisation, la répartition par service et le portefeuille de recharge, le cas échéant.

Arguments

Nom	Requis	Objectif
[user]	non	Identifiant de l’utilisateur (nom ou préfixe d’e-mail). Omettez pour afficher la propre utilisation de l'utilisateur connecté; transmettez un (chemin d'administration) pour voir celui d'un autre utilisateur.

Options

Long	Valeur (Value)	Default	Description
--organization	ID-Compte	session par défaut	GUID du compte de l'organisation.

Exemples

uip platform users usage get
uip platform users usage get "[e-mail]"

Format des données (--sortie json)

{
  "Code": "UserUsage",
  "Data": {
    "userId": "11111111-1111-1111-1111-111111111111",
    "consumables": [
      {
        "entitlement": "AgenticPool",
        "monthlyPercentConsumed": 64,
        "resetsOn": "2026-08-01T00:00:00.000Z",
        "services": [
          { "service": "AgentDevelopment", "serviceName": "Agent Development", "percentOfPool": 40 }
        ],
        "topUpWallet": {
          "monthlyPercentConsumed": 20,
          "topups": 2,
          "firstGrantedOn": "2026-07-10T09:00:00.000Z",
          "services": [],
          "topupCountPerMonth": [
            { "month": "2026-07-01T00:00:00.000Z", "topupCount": 2 }
          ]
        }
      }
    ]
  }
}

Codes de sortie

Voir Codes de sortie. Aucun remplacement spécifique au verbe.

Commandes associées

• uip platform groups — règles de groupe qui louent des bundles à plusieurs utilisateurs à la fois (celles-ci apparaissent avec source: "group" dans users licenses get).
• uip platform tenants — Runtime au niveau du locataire et affectation des consommables.

Voir également

• Options globales.