licencias de plataforma UIP

Sintaxis y opciones para las "licencias de plataforma UIP", que informan de la asignación de consumibles a nivel de organización y el consumo por tenant.

uip platform licenses es el informador de consumibles en el nivel de organización. Responde a tres preguntas: cómo se asigna y consume cada consumible en los tenants hoy en día, cuánto de un consumible determinado quemaba un tenant cada día en una ventana y qué carpetas dentro de un tenant impulsaban ese consumo.

Para los cambios de asignación por tenant, utiliza uip platform tenants licenses. Para paquetes por usuario, utiliza uip platform users licenses.

Sinopsis

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

Verbos

Verbo	Propósito
consumables get	Obtenga un informe de consumibles. El valor predeterminado --mode summary devuelve la asignación por consumible más el consumo del grupo por tenant. --mode daily devuelve el desglose diario por servicio y --mode folders devuelve el desglose por carpeta, ambos con ámbito de una sola unidad de tenant × consumible.
summary	Obtén el resumen de licencias de organización consolidadas: robots, licencias de paquete de usuario y consumibles en una tabla plana.

licencias de plataforma uip consumibles obtener

Obtenga un informe de consumibles. El marcador --mode selecciona una de tres formas:

• summary predeterminado): una fila por consumible × tenant. Los totales a nivel de organización (totalUnitsInAccount, allocated, consumedFromOrgWithoutTenant) y las fechas del paquete se repiten en las filas. Las columnas por tenant dividen el consumo entre el propio grupo del tenant (consumedFromTenantPool) y el grupo compartido de la organización (consumedFromOrgPool). Los consumibles sin actividad de tenant obtienen una única fila de resumen con columnas de tenant vacías.
• daily : una fila por (date, service) para un solo tenant × unidad consumible durante un intervalo de fechas ISO 8601. Requiere --tenant, --unit, --start-date y --end-date.
• folders : una fila por carpeta dentro de un solo tenant × unidad consumible, con el propio consumo (no heredado) de esa carpeta y el recuento de procesos. Requiere --tenant, --unit, --start-date y --end-date.

Sin --start-date y --end-date, el informe summary utiliza la ventana de validez del paquete de cada consumible. Proporcionarlos anula esa ventana solo para el informe: las asignaciones subyacentes no se modifican.

Opciones

Largo	Valor	Predeterminado	Descripción
--mode	ENUM	summary	Forma de informe: summary, daily o folders.
--tenant	tenant-name	—	Ámbito del informe a un solo tenant (coincidencia por nombre de la lista de tenants de la organización actual). Obligatorio para --mode daily y --mode folders.
--unit	code	—	Filtrar a una sola unidad consumible por código de producto (por ejemplo, AIU, AGU, RU, PLTU). No distingue entre mayúsculas y minúsculas. Obligatorio para --mode daily y --mode folders.
--start-date	Fecha de ISO 8601	—	Inicio de la ventana de consumo. Debe utilizarse junto con --end-date. Obligatorio para --mode daily y --mode folders.
--end-date	Fecha de ISO 8601	—	Fin de la ventana de consumo. Debe utilizarse junto con --start-date. Obligatorio para --mode daily y --mode folders.

--start-date debe estar estrictamente antes de --end-date, y ambos marcadores deben proporcionarse juntos (se rechaza pasar solo uno).

Ejemplos

Informe de resumen predeterminado:

uip platform licenses consumables get

Intervalo de fechas personalizado para el resumen:

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

Ámbito del resumen a un solo tenant:

uip platform licenses consumables get --tenant default

Desglose diario por servicio para un tenant × unidad:

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

Desglose de carpetas para un tenant × unidad:

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

Forma de datos (--json de salida)

Modo resumen — 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
    }
  ]
}

Modo diario — 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
    }
  ]
}

Modo de carpetas — 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
    }
  ]
}

Resumen de licencias de la plataforma UIP

Obtener el resumen de licencias de la organización consolidada: robots (total y asignadas), licencias de paquete de usuario (total y utilizadas) y consumibles (totales, asignadas y utilizadas), todo en una tabla plana de filas etiquetadas por category, para que siga siendo filtrable (por ejemplo, --output-filter "[?Category=='Robot']").

A diferencia de consumables get, esta es una llamada única y no controlada: no se requieren --mode, --tenant ni intervalo de fechas.

Opciones

Largo	Valor	Predeterminado	Descripción
--organization	ID de cuenta	sesión predeterminada	GUID de la cuenta de la organización.

Ejemplos

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

Forma de datos (--json de salida)

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

Los campos que no se aplican a una categoría son null: los robots y las licencias de usuario no tienen fechas, los consumibles no tienen available significativo, las licencias de usuario no tienen allocated.

Códigos de salida

Consulta Códigos de salida. Sin anulaciones específicas de verbos.

Comandos relacionados

• uip platform tenants : cambia la asignación por tenant contra la que mide este informe.
• uip platform users : asignación de paquetes por usuario.

Ver también

• Opciones globales.
• Formatos de salida.