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.

Resumo

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

Verbo

Texto	Finalidade
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

Name	Required	Finalidade
<user>	sim	User identifier (name or email prefix; must match exactly one directory user).

Opções

Long	Valor	Padrão	Description
--input	Path	necessário	Path to a JSON file with the desired user license allocation, for example [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	account-id	padrão da sessão	Organization account GUID. Override the org resolved from the current login.

Exemplo

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

user-bundles.json:

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

Formato dos dados (--output json)

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

Name	Required	Finalidade
<user>	sim	User identifier (name or email prefix; must match exactly one directory user).

Opções

Long	Valor	Padrão	Description
--organization	account-id	padrão da sessão	Organization account GUID. Override the org resolved from the current login.

Exemplo

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

Formato dos dados (--output 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"
    }
  ]
}

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.

Opções

Long	Valor	Padrão	Description
--organization	account-id	padrão da sessão	Organization account GUID. Override the org resolved from the current login.

Exemplo

uip platform users licenses available

Formato dos dados (--output json)

{
  "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 saída

Consulte Códigos de saída. Nenhuma substituição específica do verbo.

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.

Veja também

• Opções globais.