UIP-Plattformlizenzen

Syntax und Optionen für „UIP-Plattformlizenzen“, die die Zuweisung von Verbrauchsmaterialien auf Organisationsebene und den Verbrauch pro Mandant melden.

uip platform licenses ist der Melder für Verbrauchsmaterialien auf Organisationsebene. Es beantwortet drei Fragen: Wie wird jedes Verbrauchsmaterial heute den Mandanten zugeordnet und verbraucht, wie viel von einem bestimmten Verbrauchsmaterial hat ein Mandant täglich in einem Fenster verbraucht und welche Ordner innerhalb eines Mandanten diesen Verbrauch verursachten.

Für Änderungen der Zuweisung pro Mandant verwenden Sie uip platform tenants licenses. Verwenden Sie für Pakete pro Benutzer uip platform users licenses.

Zusammenfassung

uip platform licenses consumables <verb> [options]
uip platform licenses summary [options]

Verben

Verb	Zweck
consumables get	Rufen Sie einen Verbrauchsbericht ab. Die Standardeinstellung --mode summary gibt die Zuweisung pro Verbrauch plus den Poolverbrauch pro Mandant zurück. --mode daily gibt die tägliche Aufschlüsselung nach Dienst zurück und --mode folders gibt die Aufschlüsselung pro Ordner zurück – beides ist auf einen einzelnen Mandanten × Verbrauchseinheit beschränkt.
summary	Get the consolidated organization license summary: robots, user-bundle licenses, and consumables in one flat table.

Abrufen von Verbrauchsmaterialien für UIP-Plattform-Lizenzen

Rufen Sie einen Verbrauchsbericht ab. Das Flag --mode wählt eine von drei Formen aus:

• summary (Standard) – eine Zeile pro Verbrauchsmaterial × Mandant. Gesamtwerte auf Organisationsebene (totalUnitsInAccount, allocated, consumedFromOrgWithoutTenant) und Paketdaten werden zeilenübergreifend wiederholt. Die Spalten pro Mandant teilen den Verbrauch zwischen dem eigenen Pool des Mandanten (consumedFromTenantPool) und dem freigegebenen Organisationspool (consumedFromOrgPool) auf. Verbrauchsmaterialien ohne Mandantenaktivität erhalten eine einzelne Zusammenfassungszeile mit leeren Mandantenspalten.
• daily – eine Zeile pro (date, service) für eine einzelne Mandant × Verbrauchseinheit über einen ISO 8601-Datumsbereich. Erfordert --tenant, --unit, --start-date und --end-date.
• folders – eine Zeile pro Ordner innerhalb einer × verbrauchten Einheit für einen einzelnen Mandanten, mit dem eigenen (nicht geerbten) Verbrauch und der Prozessanzahl dieses Ordners. Erfordert --tenant, --unit, --start-date und --end-date.

Ohne --start-date und --end-date verwendet der summary -Bericht das Gültigkeitsfenster jedes Verbrauchselements. Wenn Sie sie bereitstellen, wird dieses Fenster nur für den Bericht überschrieben – die zugrunde liegenden Zuweisungen sind unverändert.

Optionen

Long	Wert	Standard	Beschreibung
--mode	ENUM	summary	Berichtsform: summary, daily oder folders.
--tenant	tenant-name	–	Ordnen Sie den Bericht einem einzelnen Mandanten zu (abgeglichen mit dem Namen aus der Mandantenliste der aktuellen Organisation). Erforderlich für --mode daily und --mode folders.
--unit	code	–	Filtern Sie auf eine einzelne Verbrauchseinheit nach Produktcode (z. B. AIU, AGU, RU, PLTU). Groß-/Kleinschreibung wird nicht beachtet. Erforderlich für --mode daily und --mode folders.
--start-date	ISO 8601-Datum	–	Beginn des Verbrauchsfensters. Muss zusammen mit --end-date verwendet werden. Erforderlich für --mode daily und --mode folders.
--end-date	ISO 8601-Datum	–	Ende des Verbrauchsfensters. Muss zusammen mit --start-date verwendet werden. Erforderlich für --mode daily und --mode folders.

--start-date muss streng vor --end-date sein, und beide Flags müssen zusammen bereitgestellt werden (die Übergabe nur eines wird abgelehnt).

Beispiele

Standardzusammenfassungsbericht:

uip platform licenses consumables get

Benutzerdefinierter Datumsbereich für die Zusammenfassung:

uip platform licenses consumables get \
    --start-date 2025-01-01 --end-date 2025-01-31

Fassen Sie die Zusammenfassung auf einen einzelnen Mandanten ein:

uip platform licenses consumables get --tenant default

Tägliche Aufschlüsselung nach Dienst für einen Mandanten × Einheit:

uip platform licenses consumables get \
    --mode daily --tenant default --unit AIU \
    --start-date 2025-01-01 --end-date 2025-01-31

Ordneraufschlüsselung für einen Mandanten × Einheit:

uip platform licenses consumables get \
    --mode folders --tenant default --unit AIU \
    --start-date 2025-01-01 --end-date 2025-01-31

Datenform (--output json)

Zusammenfassungsmodus – Code: "LicensesConsumablesSummary":

{
  "Code": "LicensesConsumablesSummary",
  "Data": [
    {
      "code": "AIU",
      "name": "AI Units",
      "totalUnitsInAccount": 5000,
      "allocated": 1200,
      "consumedFromOrgWithoutTenant": 30,
      "startDate": "2023-11-14T22:13:20.000Z",
      "endDate": "2027-09-15T18:40:00.000Z",
      "tenantId": "296b7134-6691-43db-b48a-2d95ed3ab031",
      "tenantName": "default",
      "consumedFromTenantPool": 800,
      "consumedFromOrgPool": 150
    }
  ]
}

Täglicher Modus – Code: "LicensesConsumablesDaily":

{
  "Code": "LicensesConsumablesDaily",
  "Data": [
    {
      "code": "AIU",
      "name": "AI Units",
      "tenantId": "296b7134-6691-43db-b48a-2d95ed3ab031",
      "tenantName": "default",
      "date": "2025-01-15",
      "service": "orchestrator",
      "consumedAmount": 24
    }
  ]
}

Ordnermodus – Code: "LicensesConsumablesFolders":

{
  "Code": "LicensesConsumablesFolders",
  "Data": [
    {
      "code": "AIU",
      "name": "AI Units",
      "tenantId": "296b7134-6691-43db-b48a-2d95ed3ab031",
      "tenantName": "default",
      "folderKey": "11111111-1111-1111-1111-111111111111",
      "folderName": "Shared",
      "parentFolderKey": null,
      "consumedBySelf": 42,
      "processCountSelf": 3
    }
  ]
}

uip platform licenses summary

Get the consolidated organization license summary: robots (total & allocated), user-bundle licenses (total & used), and consumables (total, allocated & used) — all as one flat table of rows tagged by category, so it stays filterable (for example --output-filter "[?Category=='Robot']").

Unlike consumables get, this is a single, ungated call — no --mode, --tenant, or date range required.

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiele

uip platform licenses summary
uip platform licenses summary --output-filter "[?Category=='Consumable']" --output table

Datenform (--output json)

{
  "Code": "LicensesSummary",
  "Data": [
    {
      "category": "Robot",
      "code": "RU",
      "name": "Robot Units",
      "total": 25,
      "allocated": 10,
      "used": null,
      "available": 15,
      "startDate": null,
      "endDate": null
    },
    {
      "category": "User license",
      "code": "RPADEVPRONU",
      "name": "Automation Developer",
      "total": 60,
      "allocated": null,
      "used": 2,
      "available": 58,
      "startDate": null,
      "endDate": null
    },
    {
      "category": "Consumable",
      "code": "AIU",
      "name": "AI Units",
      "total": 5000,
      "allocated": 1200,
      "used": 980,
      "available": null,
      "startDate": "2023-11-14T22:13:20.000Z",
      "endDate": "2027-09-15T18:40:00.000Z"
    }
  ]
}

Fields that don't apply to a category are null: robots and user licenses have no dates, consumables have no meaningful available, user licenses have no allocated.

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip platform tenants – Ändern Sie die Zuweisung pro Mandant, an der dieser Bericht misst.
• uip platform users – Paketzuweisung pro Benutzer.

Siehe auch

• Globale Optionen.
• Ausgabeformate.