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.

大纲

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

动词

动词	用途
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.

参数

名称	必填	用途
<user>	是	User identifier (name or email prefix; must match exactly one directory user).

选项

长	值	默认	描述
--input	路径	必填	Path to a JSON file with the desired user license allocation, for example [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}].
--organization	account-id	会话默认值	Organization account GUID. Override the org resolved from the current login.

示例

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

user-bundles.json:

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

数据形状（--输出 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.

参数

名称	必填	用途
<user>	是	User identifier (name or email prefix; must match exactly one directory user).

选项

长	值	默认	描述
--organization	account-id	会话默认值	Organization account GUID. Override the org resolved from the current login.

示例

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

数据形状（--输出 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.

选项

长	值	默认	描述
--organization	account-id	会话默认值	Organization account GUID. Override the org resolved from the current login.

示例

uip platform users licenses available

数据形状（--输出 json）

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

退出代码

请参阅退出代码。没有动词特定的覆盖。

相关命令

• 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.

另请参阅

• 全局选项。