uip platform users

uip platform users manages per-user license-bundle allocation through the License Accountant. Allocate bundles directly to a directory user, list a user's current leases (and whether each one came from a direct allocation or a group rule), and view the account-level user-bundle availability.

Sinopsis

uip platform users licenses <verb> [options] [<user>]

Verbos

Verbo	Propósito
set	Allocate user bundle licenses directly to a directory user.
get	List the user-bundle leases currently held by a directory user, with the source of each lease.
available	Get the account-level summary of user-bundle licenses (total, allocated, available).

User resolution

set and get take a <user> positional argument — a name or email prefix. The CLI searches local and directory users with a "starts with" match and requires exactly one match:

• No match → error with "No directory user found matching '<input>'.".
• Multiple matches → error listing up to 10 candidates so you can refine the input.

uip platform users licenses set

Allocate user bundle licenses to a directory user. Bundles in --input replace the user's directly-allocated bundles; bundles inherited from group rules are unaffected by this command.

Argumentos

Nombre	Obligatorio	Propósito
<user>	Sí	User identifier (name or email prefix; must match exactly one directory user).

Opciones

Largo	Valor	Predeterminado	Descripción
--input	Ruta	obligatorio	Path to a JSON file with the desired user license allocation, for example [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	account-id	sesión predeterminada	Organization account GUID. Override the org resolved from the current login.

Ejemplo

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

user-bundles.json:

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

Forma de datos (--json de salida)

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

uip platform users licenses get

Get the user bundle licenses currently leased by a directory user. Each row is one leased bundle; source is "group" when the lease is inherited from a group rule, or "direct" for non-group allocations.

Argumentos

Nombre	Obligatorio	Propósito
<user>	Sí	User identifier (name or email prefix; must match exactly one directory user).

Opciones

Largo	Valor	Predeterminado	Descripción
--organization	account-id	sesión predeterminada	Organization account GUID. Override the org resolved from the current login.

Ejemplo

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

Forma de datos (--json de salida)

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

uip platform users licenses available

Get the account-level summary of user-bundle licenses: how many seats per bundle exist (total), how many are already allocated (allocated), and how many remain available (available). Use this before allocating to confirm capacity.

Opciones

Largo	Valor	Predeterminado	Descripción
--organization	account-id	sesión predeterminada	Organization account GUID. Override the org resolved from the current login.

Ejemplo

uip platform users licenses available

Forma de datos (--json de salida)

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

Códigos de salida

Consulta Códigos de salida. Sin anulaciones específicas de verbos.

Comandos relacionados

• uip platform groups — group rules that lease bundles to many users at once (these appear with source: "group" in users licenses get).
• uip platform tenants — tenant-level runtime and consumable allocation.

Ver también

• Opciones globales.