Accounts
Una cuenta C21 Live Cloud es el registro de credenciales que conecta una instancia de C21 Live Control con un tenant de la plataforma C21 Live Cloud. Registrar una cuenta habilita las variantes cloud de Channel y Destination y permite que las referencien.
El CRUD completo vive bajo /c21apiv2/settings/integrations/c21livecloud y está restringido al rol System Administrator.
Columnas del listado
En la pestaña, la lista muestra dos columnas:
| Columna | Notas |
|---|---|
| Account name | Nombre visible de la cuenta. |
| Account id | Identificador numérico de la plataforma upstream. |
El estado Enabled y la API key viven en el formulario de detalle (que se abre con doble-clic en una fila), no en la lista.
Campos de la cuenta
| Etiqueta UI | Campo | Notas |
|---|---|---|
| Name | client | Nombre visible (≤ 100 caracteres). Reutilizado por UI, API y logs. |
| Account ID | client_id | Identificador numérico proporcionado por la plataforma upstream. Obligatorio al crear. |
| API key | password | API key de la cuenta. Solo escritura — nunca se devuelve en GET. Obligatorio al crear. |
| Enabled | enabled | Si la cuenta está disponible para selección por Channels y Destinations. Por defecto true. |
El esquema también expone un booleano owner; para las cuentas listadas en esta sección siempre es false (la plataforma filtra por owner = 0).
Operaciones
| Acción | Método + ruta | operationId |
|---|---|---|
| Listar cuentas | GET /c21apiv2/settings/integrations/c21livecloud | getAllC21LiveCloudAccounts |
| Crear cuenta | POST /c21apiv2/settings/integrations/c21livecloud | addC21LiveCloudAccount |
| Leer cuenta | GET /c21apiv2/settings/integrations/c21livecloud/{accountId} | getC21LiveCloudAccountById |
| Actualizar cuenta | PUT /c21apiv2/settings/integrations/c21livecloud/{accountId} | updateC21LiveCloudAccount |
| Borrar cuenta | DELETE /c21apiv2/settings/integrations/c21livecloud/{accountId} | deleteC21LiveCloudAccount |
| Validar credenciales | POST /c21apiv2/settings/integrations/c21livecloud/{accountId}/validate | validateC21LiveCloudAccount |
Cada operación requiere el rol System Administrator.
Registrar una cuenta
Abre el formulario
En la UI de System Administrator, abre Integrations → C21 Live Cloud y elige Add account.
Rellena los campos
| Campo | Valor |
|---|---|
| Name | Un nombre visible para esta cuenta. |
| Account ID | El identificador numérico de cuenta de la plataforma upstream. |
| API key | La API key de la cuenta (solo escritura). |
| Enabled | Déjalo activo para operación normal. |
Guarda
Al enviar se llama a addC21LiveCloudAccount. En éxito la nueva cuenta aparece en la lista; la API key se cifra en el servidor y no se devuelve más. La cuenta queda disponible inmediatamente en los selectores de tipo de Channel cloud y en los formularios de Destination que aceptan destinos cloud — la sincronización interna entre la cuenta y los selectores corre a cargo del servidor.
Validar una cuenta
validateC21LiveCloudAccount revalida la credencial almacenada contra la plataforma upstream. Úsalo tras una rotación de credenciales o cuando estés depurando un fallo de publicación.
El endpoint acepta un cuerpo opcional {client_id, password} si quieres probar credenciales nuevas antes de guardarlas. Una respuesta correcta confirma que las credenciales se aceptan upstream; un fallo devuelve el error upstream en el envelope estándar.
Editar una cuenta
updateC21LiveCloudAccount es una actualización parcial:
- Cambiar Name propaga el nuevo nombre a los selectores que muestren la cuenta.
- Dejar API key vacío preserva el valor almacenado.
- Apagar Enabled oculta la cuenta de los selectores de Channel y Destination sin borrarla.
Borrar una cuenta
deleteC21LiveCloudAccount elimina la cuenta junto con cualquier referencia interna que el servidor mantenga. Los Channels que referenciaban la cuenta borrada por client_id pierden la referencia y fallarán al arrancar hasta que se apunten a otra cuenta.
Cross-links
- C21 Live Cloud overview — Qué es una cuenta y qué habilita registrarla.
- Sources — El tipo de Channel Stream – C21 Live Cloud y sus tres protocolos (RTMP, SRT, UDP-R).
FAQ
/c21apiv2/settings/integrations/c21livecloud requiere rol System Administrator; los Operators reciben 403 Forbidden.Overview
Registra una cuenta C21 Live Cloud en C21 Live Control para habilitar la integración; los Live streams podrán ejecutarse en instancias C21 Live Encoder aprovisionadas automáticamente por C21 Live Cloud, aportando capacidad elástica al despliegue.
Overview
Protección multi-DRM en C21 Live Control con Widevine, PlayReady y FairPlay y empaquetado CENC y CBCS.