uip platform users

「uip platform users」の構文とオプション - ライセンス会計士を使用してユーザーごとのライセンス バンドルの割り当てを管理します。

uip platform users は、ライセンス会計士を通じてユーザーごとのライセンス バンドルの割り当てを管理するほか、ユーザーごとの消費可能なチャージとライセンス/消費可能な使用状況のレポートを管理します。ここには、 licenses (直接/グループ バンドル割り当て)、 top-ups (消費可能なチャージの付与と追跡)、および usage (ユーザーごとのライセンス消費) の 3 つの独立したコマンド グループが存在します。

概要

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

動詞

グループ	動詞	目的
licenses	set	ユーザー バンドル ライセンスをディレクトリ ユーザーに直接割り当てる
licenses	get	ディレクトリ ユーザーが現在保持しているユーザー バンドル リースを、各リースのソースと共に一覧表示します。
licenses	available	ユーザー バンドル ライセンスのアカウント レベルの概要を取得します (合計、割り当て済み、利用可能)。
top-ups	create	組織のアクティブな消費可能プールからユーザーに上座費を付与します。
top-ups	get	追加助成金ジョブのステータスを確認します。
top-ups	request	自分でチャージをリクエストしてください。組織の管理者に通知します。
usage	list	組織内でライセンスが消費されているユーザーのリストを表示します。
usage	get	ユーザーごとのライセンス消費量 (自分のライセンス、または管理者が別のユーザーのライセンスを表示している状態) を表示します。

ユーザーの解決方法

set と get は、 <user> 位置引数 (名前または電子メールのプレフィックス) を受け取ります。CLI は、「starts with」の一致を持つローカル ユーザーとディレクトリ ユーザーを検索し、 一致が 1 つだけ 必要です。

• No match → error with "No directory user found matching '<input>'."(一致なし) のエラーです。
• 複数の一致→エラーには最大 10 個の候補がリストされるため、入力を絞り込むことができます。

uip platform users licenses set

ディレクトリ ユーザーにユーザー バンドル ライセンスを割り当てます。--input のバンドルは、ユーザーが直接割り当てたバンドルを置き換えます。グループ ルールから継承されたバンドルは、このコマンドの影響を受けません。

引数

名前	Required	目的
<user>	○	ユーザー識別子 (名前またはメール プレフィックス。1 人のディレクトリ ユーザーと完全に一致している必要があります)。

オプション

長押し	値 (Value)	既定 (Default)	説明
--input	パス	必須	目的のユーザー ライセンス割り当てを含む JSON ファイルへのパス (例: [{"code":"RPADEVPRONU"},{"code":"ATTUNU"},{"code":"TSTNU"}]
--organization	account-id	セッションの既定値	組織アカウントの GUID。現在のログインから解決された組織を上書きします。

例

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

user-bundles.json:

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

データシェイプ(--output json)

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

uip platform users licenses get

ディレクトリ ユーザーによって現在リースされているユーザー バンドル ライセンスを取得します。各行は1つのリースバンドルです。sourceは、リースがグループ ルールから継承される場合、または非グループ割り当ての場合は"direct"場合に"group"されます。

引数

名前	Required	目的
<user>	○	ユーザー識別子 (名前またはメール プレフィックス。1 人のディレクトリ ユーザーと完全に一致している必要があります)。

オプション

長押し	値 (Value)	既定 (Default)	説明
--organization	account-id	セッションの既定値	組織アカウントの GUID。現在のログインから解決された組織を上書きします。

例

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

データシェイプ(--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

ユーザー バンドル ライセンスのアカウント レベルの概要を取得します。バンドルあたりのシート数 (total)、すでに割り当てられているシート数 (allocated)、および利用可能なままのシート数 ( ) (available) を取得します。割り当て前に使用して、容量を確認します。

オプション

長押し	値 (Value)	既定 (Default)	説明
--organization	account-id	セッションの既定値	組織アカウントの GUID。現在のログインから解決された組織を上書きします。

例

uip platform users licenses available

データシェイプ(--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 }
  ]
}

UIP プラットフォーム ユーザーへのトップアップ

ユーザーごとの消費可能なチャージを付与し、追跡します。ソース プールは、組織のアクティブな消費可能なユニット数 (PLTU が優先され、それ以外の場合は AGU) から自動的に解決されます。プールを明示的に渡すことはありません。

UIP プラットフォーム ユーザーのトップアップにより、作成

ユーザーにトップアップを付与する

引数

名前	Required	目的
<user>	○	ユーザー識別子 (名前またはメール プレフィックス。1 人のディレクトリ ユーザーと完全に一致している必要があります)。

オプション

長押し	値 (Value)	既定 (Default)	説明
--wait	フラグ	無効	補充ジョブが完了するまで待ってから、許可されたかどうかを報告します。
--count	整数 (1-100)	1	付与するトップアップ ユニットの数。
--organization	account-id	セッションの既定値	組織アカウント: GUID。

例

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

データシェイプ(--output json)

--waitなし:

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

--wait:

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

UIP プラットフォーム ユーザーのトップアップ

追加助成金ジョブのステータスを確認します。

引数

名前	Required	目的
<job-id>	○	top-ups createが返すトップアップ ジョブ ID です。

オプション

長押し	値 (Value)	既定 (Default)	説明
--organization	account-id	セッションの既定値	組織アカウント: GUID。

例

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

データシェイプ(--output json)

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

UIP プラットフォーム ユーザーへのトップアップ要求

自分 (ログインしているユーザー) のチャージをリクエストします。これは組織の管理者に通知されます。直接何も付与されることはありません。

オプション

長押し	値 (Value)	既定 (Default)	説明
--organization	account-id	セッションの既定値	組織アカウント: GUID。

例

uip platform users top-ups request

データシェイプ(--output json)

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

NotificationSent以外の結果 (NotEligible や NoActiveDistributionなど) は、サーバーのメッセージとともに失敗として返されます。

UIP プラットフォーム ユーザーの使用状況

ユーザーごとのライセンス消費量を表示します: 月間プールの消費率とチャージ ウォレットの消費率。

UIP プラットフォーム ユーザーの使用状況リスト

組織内でライセンスが消費されているユーザーのリストを表示します。

オプション

長押し	値 (Value)	既定 (Default)	説明
--limit	integer	既定のページ サイズ	返されるユーザーの最大数。
--offset	integer	0	スキップするユーザーの数。
--sort-by	フィールド	—	ユーザーの使用状況行のフィールド (例: email、 displayName) で並べ替えます。
--sort-order	asc	desc	—
--license-codes	スペース区切りコード	—	フィルターを適用し、特定のライセンス バンドル ( RPADEVPRONU ATTUNUなど) を保有しているユーザーに絞り込む。
--organization	account-id	セッションの既定値	組織アカウント: GUID。

例

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

データシェイプ(--output 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 は、ユーザーに月間許可がない場合は null されます ( 0ではありません)。status MonthlyLimit、 TopUp、 PaidUnitsのいずれかです。

UIP プラットフォーム ユーザーの使用状況 Get

ユーザーごとのライセンス消費量の表示: 各消費ライセンスの月間消費率、リセット日、サービスごとの内訳、およびトップアップ ウォレット (存在する場合)。

引数

名前	Required	目的
[user]	×	ユーザー識別子 (名前またはメール アドレスのプレフィックス)。省略すると、ログインしているユーザー自身の使用状況が表示されます。一方 (管理者パス) を渡すと、別のユーザーのパスが表示されます。

オプション

長押し	値 (Value)	既定 (Default)	説明
--organization	account-id	セッションの既定値	組織アカウント: GUID。

例

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

データシェイプ(--output 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 }
          ]
        }
      }
    ]
  }
}

終了コード

「終了コード」を参照してください。動詞固有の上書きはありません。

関連コマンド

• uip platform groups — バンドルを一度に多くのユーザーにリースするグループルール(これらはusers licenses getsource: "group"とともに表示されます)。
• uip platform tenants — テナント レベルのランタイムと消費可能の割り当て。

参照

• グローバル オプション。