Revisar y exportar el uso
Lee las operaciones facturables que el servidor de licencias registró para tu tenant, saca un intervalo como archivo CSV y emite un estado de uso mensual firmado.
Quién puede hacerlo
Un administrador del tenant. Todos los roles integrados del tenant pueden leer las cifras de uso, pero solo el administrador del tenant tiene los permisos para exportarlas y para emitir estados. La consola ofrece Exportar CSV solo a quien tiene el permiso de exportación. El tenant siempre es el tuyo: se toma de tu credencial, y ninguna pantalla ni solicitud nombra otro.
Antes de empezar
- Hay una licencia de despliegue vigente. Sin ella, se rechaza cada solicitud de uso.
- Ten claro qué intervalo necesitas. Por día, un intervalo abarca como máximo 366 días; por mes, como máximo 24 meses.
Pasos
- Abre Uso desde la navegación de tu tenant. Se abre en los últimos 30 días, por día.
- Elige el intervalo:
- Selecciona Últimos 7 días, Últimos 30 días, Este mes, Mes pasado o Últimos 12 meses; cada uno lee su intervalo de inmediato.
- O establece Desde y Hasta (días UTC incluidos) y selecciona Aplicar.
- Elige la granularidad: Día o Mes.
- Cuando el intervalo tiene más periodos de los que caben en una página, muévete entre ellos con Periodos anteriores y Periodos posteriores.
- Lee el estado de cada periodo antes de confiar en sus cifras: un periodo abierto todavía puede crecer, uno provisional terminó pero todavía puede crecer, y uno definitivo no cambiará.
- Para sacar el intervalo, selecciona Exportar CSV. La exportación cubre todo el intervalo y la granularidad aplicados, no solo la página en pantalla, y la consola espera el archivo hasta dos minutos.
Listar las exportaciones anteriores y los estados de uso mensuales firmados no se ofrece en la consola; usa la API de abajo.
Qué ves cuando funcionó
La tabla muestra una fila por periodo con su estado y su total, las operaciones de streaming y las que no lo son, y la línea bajo los controles nombra el intervalo al que pertenecen las cifras. Después de Exportar CSV, el navegador descarga el archivo, y la exportación queda registrada en la auditoría con su intervalo y su granularidad.
Un estado emitido se devuelve con su identidad y su firma; nunca se reescribe, y una corrección es un segundo estado que nombra al que reemplaza.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| Este intervalo no se puede aplicar | No están establecidos los dos extremos, el inicio es posterior al final, o el intervalo es más amplio de lo que permite la granularidad | Corrige las fechas, o lee el intervalo por mes |
| No se pudieron leer las cifras de uso | El servidor de licencias no devolvió las cifras. No es un informe de uso cero | Vuelve a intentarlo; si persiste, tu operador de la plataforma revisa el servidor de licencias |
| Ya hay demasiadas exportaciones de uso en curso para ti o para tu tenant, así que esta no se inició. | Se alcanzó el límite de exportaciones en curso por persona o por tenant | Espera a que termine una y vuelve a exportar |
| El archivo seguía en preparación después de dos minutos, así que la consola dejó de esperar. | La exportación sigue en curso en el servidor | Vuelve a exportar cuando haya terminado |
| El servidor no pudo generar el archivo. | La exportación falló en el servidor | Vuelve a exportar; si falla de nuevo, contacta a tu operador de la plataforma |
| Se rechaza un estado con un conflicto | El mes todavía no se puede declarar, ya está declarado y la solicitud no declara ninguna corrección, o el estado nombrado en supersedes ya está reemplazado | Espera a que termine el mes, o corrige el estado que el error nombra como actual |
| Acceso restringido | No tienes el permiso para leer el uso de tu tenant | Pídeselo a un administrador del tenant |
Sin la consola
| Superficie | Cómo |
|---|---|
| API: lectura | GET /api/v3/admin/usage/telemetry?from=<day>&to=<day>&grain=<grain>, con la granularidad day o month (operación getUsageTelemetry) |
| API: exportación | POST /api/v3/admin/usage/exports con from, to y grain (operación createUsageExport), luego GET /api/v3/admin/usage/exports/{jobId} (getUsageExport) y GET /api/v3/admin/usage/exports/{jobId}/artifact (getUsageExportArtifact), cada una con el encabezado X-Usage-Export-Handle que devolvió el inicio; GET /api/v3/admin/usage/exports lista las exportaciones de tu tenant (listUsageExports) |
| API: estados | POST /api/v3/admin/usage/statements con period (por ejemplo 2026-08) y, para una corrección, supersedes (operación issueUsageStatement); GET /api/v3/admin/usage/statements (listUsageStatements); GET /api/v3/admin/usage/statements/{statementId} (getUsageStatement); GET /api/v3/admin/usage/statements/verification-keys (getUsageStatementVerificationKeys) para verificar la firma de un estado |
Relacionado
- Uso: qué muestra la pantalla y cada decisión que tomas en ella.