UIP-Plattformmandanten

Syntax und Optionen für „uip platform tenants“, die Lizenzzuweisungen pro Mandant lesen und aktualisieren.

uip platform tenants reads and updates per-tenant license allocations, and manages per-folder outcome billing configuration. licenses get returns the active product allocation for a tenant (allocated, available, consumed, validity window); licenses set overlays a JSON delta of {code, quantity} entries, routing each product code to the service license that already owns it within the tenant. folder-outcome-billing get/set reads and toggles whether a specific folder in a tenant has outcome billing enabled.

Zusammenfassung

uip platform tenants licenses <verb> [options] <tenant-key>
uip platform tenants folder-outcome-billing <verb> [options] <tenant-id> <folder-key>

Verben

„Gruppieren“ (Group)	Verb	Zweck
licenses	get	Rufen Sie die aktive Lizenzzusammenfassung für einen Mandanten ab (eine Zeile pro Produkt, Daten als ISO).
licenses	set	Wenden Sie ein Delta von {code, quantity} Einträgen auf die Runtime-Lizenzen und Verbrauchsmaterialien eines Mandanten an, die automatisch über Diensttypen hinweg weitergeleitet werden.
folder-outcome-billing	get	Get the outcome billing configuration for a folder in a tenant.
folder-outcome-billing	set	Enable or disable outcome billing for a folder in a tenant.

Abrufen von Lizenzen für UIP-Plattform-Mandanten

Rufen Sie die Lizenzzusammenfassung für einen Mandanten ab: zugewiesene, verfügbare, verbrauchte Mengen pro Produktcode mit Anzeigenamen. Gibt eine Zeile pro aktivem Produkt zurück (Verbrauchsmaterialien und Runtime-Lizenzen).

Argumente

Name	Erforderlich	Zweck
<tenant-key>	ja	Mandantenschlüssel (GUID).

Optionen

Long	Wert	Standard	Beschreibung
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

Beispiel

uip platform tenants licenses get 296b7134-6691-43db-b48a-2d95ed3ab031

Datenform (--output json)

{
  "Code": "TenantLicenses",
  "Data": [
    {
      "code": "PLTU",
      "name": "Platform Units",
      "allocated": 300,
      "availableForAllocation": 4700,
      "allocatedAcrossOtherTenants": 0,
      "totalUnitsInAccount": 5000,
      "consumed": 50,
      "startDate": "2023-11-14T22:13:20.000Z",
      "endDate": "2027-09-15T18:40:00.000Z"
    }
  ]
}

UIP-Plattform-Mandantenlizenzen festgelegt

Legen Sie Runtime-Lizenzen und Verbrauchsmaterialien für einen Mandanten fest. Die CLI ruft die vorhandenen Dienstlizenzen des Mandanten ab, indiziert seine Produkte nach code und leitet jeden Eingabeeintrag an die Dienstlizenz weiter, die diesen Code bereits besitzt. Mengen in --input überlagern die aktuelle Zuweisung nach Code; Produkte, die Sie nicht auflisten, behalten ihre vorhandenen Mengen bei.

Der Befehl schlägt vor dem Schreiben eines Eingabecodes fehl:

• in keinen der vorhandenen Dienstlizenzen des Mandanten vorhanden ist (nicht weitergeleitet) oder
• wird unter mehr als einer der Dienstlizenzen des Mandanten angezeigt (mehrdeutiges Routing).

Bei einem Teilfehler (ein Diensttyp kann nicht aktualisiert werden, nachdem ein anderer bereits erfolgreich war) listet die Fehlermeldung die Diensttypen auf, die bereits angewendet wurden, sodass Sie mit derselben Eingabe idempotent erneut ausführen können.

Argumente

Name	Erforderlich	Zweck
<tenant-key>	ja	Mandantenschlüssel (GUID).

Optionen

Long	Wert	Standard	Beschreibung
--input	Pfad	erforderlich	Pfad zu einer JSON-Datei mit dem Produkt-Delta, z. B. [{"code":"UNATT","quantity":5}]. Mengen überlagern die aktuelle Zuweisung nach Produktcode.
--organization	Konto-ID	Sitzungsstandard	GUID des Organisationskontos. Überschreiben Sie die von der aktuellen Anmeldung aufgelöste Organisation.

Beispiel

uip platform tenants licenses set 296b7134-6691-43db-b48a-2d95ed3ab031 \
    --input ./delta.json

delta.json:

[
  { "code": "PLTU", "quantity": 500 },
  { "code": "RU",   "quantity": 100 }
]

Datenform (--output json)

{
  "Code": "TenantLicensesSet",
  "Data": [
    {
      "serviceType": "orchestrator",
      "code": "PLTU",
      "name": "Platform Units",
      "quantity": 500
    },
    {
      "serviceType": "orchestrator",
      "code": "RU",
      "name": "Robot Units",
      "quantity": 100
    }
  ]
}

uip platform tenants folder-outcome-billing

View and manage the outcome billing configuration of a tenant's folders.

uip platform tenants folder-outcome-billing get

Get the outcome billing configuration for a folder: whether outcome billing is enabled.

Argumente

Name	Erforderlich	Zweck
<tenant-id>	ja	Tenant id (GUID).
<folder-key>	ja	Ordnerschlüssel (GUID).

Optionen

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

Beispiel

uip platform tenants folder-outcome-billing get 296b7134-6691-43db-b48a-2d95ed3ab031 11111111-1111-1111-1111-111111111111

Datenform (--output json)

{
  "Code": "TenantFolderOutcomeBilling",
  "Data": {
    "FolderKey": "11111111-1111-1111-1111-111111111111",
    "IsOutcomeBillingEnabled": true
  }
}

uip platform tenants folder-outcome-billing set

Enable or disable outcome billing for a folder. Returns the configuration now in effect.

Argumente

Name	Erforderlich	Zweck
<tenant-id>	ja	Tenant id (GUID).
<folder-key>	ja	Ordnerschlüssel (GUID).

Optionen

Long	Wert	Standard	Beschreibung
--enabled	true	false	erforderlich
--organization	Konto-ID	Sitzungsstandard	Organization account GUID.

Beispiele

uip platform tenants folder-outcome-billing set 296b7134-6691-43db-b48a-2d95ed3ab031 11111111-1111-1111-1111-111111111111 --enabled true
uip platform tenants folder-outcome-billing set 296b7134-6691-43db-b48a-2d95ed3ab031 11111111-1111-1111-1111-111111111111 --enabled false

Datenform (--output json)

{
  "Code": "TenantFolderOutcomeBillingSet",
  "Data": {
    "FolderKey": "11111111-1111-1111-1111-111111111111",
    "IsOutcomeBillingEnabled": true
  }
}

Exitcodes

Siehe Exitcodes. Keine Verb-spezifischen Überschreibungen.

Zugehörige Befehle

• uip platform licenses consumables – Bericht zu Verbrauchsmaterialien auf Organisationsebene (Poolnutzung pro Mandant, Tages- und Ordneraufschlüsselungen).
• uip platform users – Lizenzpakete pro Benutzer.
• uip or licenses – Zuweisung von Maschinen auf Orchestrator-Ebene und Named User-Lizenzen.

Siehe auch

• Globale Optionen.
• Ausgabeformate – Wechseln Sie die Tabellenansicht mit --output table.