---
title: "Estado del Trabajo"
description: "Sigue un trabajo de transcodificación por queued, analyzing, encoding y finalizing, lee progreso y segmentos, recoge las salidas y diagnostica los fallos."
category: "Despliegue"
language: es
source: https://cubepath.com/es/docs/products/despliegue/transcoding-job-status-es
updated: 2026-08-08
---

# Estado del Trabajo

La página **Video Transcoding** de [my.cubepath.com](https://my.cubepath.com) lista todos los trabajos con su origen, sus salidas, su destino, su estado y la fecha de creación. Mientras haya algo en marcha, la lista se refresca sola cada pocos segundos, así que puedes dejarla abierta y ver cómo se vacía la cola.

## El ciclo de vida

| Estado | Qué está pasando |
|--------|------------------|
| **Queued** | Aceptado, esperando worker. Es normal cuando hay carga |
| **Analyzing** | Estamos leyendo el origen para averiguar su duración, sus pistas y cómo segmentarlo |
| **Encoding** | Se están produciendo las versiones, en paralelo entre segmentos. Aquí es donde se va el tiempo |
| **Finalizing** | Los segmentos se unen, se empaquetan y se suben a tu bucket |
| **Completed** | Todas las salidas están escritas en el destino |
| **Failed** | Algo lo paró. El error queda en el trabajo |
| **Canceled** | Lo cancelaste antes de que terminara |

Los cuatro primeros son transitorios; los tres últimos son finales. Un trabajo en estado final ya no vuelve a cambiar.

## Progreso y segmentos

Un trabajo en marcha lleva un **progreso de 0 a 100** y, en cuanto pasa el análisis, un contador de **segmentos completados / totales**. En ficheros largos el contador de segmentos es el más honesto de los dos: te dice qué parte del origen se ha codificado de verdad, y avanza a saltos visibles.

Usa el **filtro de estado** sobre la lista para quedarte con lo que te importa — normalmente `failed` cuando algo va mal, o `encoding` cuando quieres saber qué está ocupando la capacidad ahora mismo.

## Recoger las salidas

Cuando un trabajo termina, **View outputs** lista todos los ficheros que ha escrito, con su bucket y su clave. Es la forma más rápida de confirmar que las rutas son las que esperabas antes de apuntar una aplicación a ellas; los ficheros en sí están en tu propio bucket, así que los descargas de ahí.

Si un trabajo completado no lista nada, es que las salidas no produjeron artefactos — lo habitual es una salida HLS sin peldaños. Míralo en [Salidas](/docs/products/despliegue/transcoding-outputs-es).

## Webhooks

Define una **URL de webhook** al [crear el trabajo](/docs/products/despliegue/transcoding-jobs-es) y te hacemos un POST cuando llega a un estado final. Esa es la forma correcta de mover una tubería: sin bucle de sondeo y sin esperas.

> Nota: La entrega del webhook es de mejor esfuerzo y **no se reintenta**. Trátalo como un aviso, no como una garantía — cuando la notificación es lo que dispara la publicación, ten un barrido que reconcilie contra el estado del trabajo todo lo que siga marcado como en curso, y así no perderás ningún vídeo por una petición caída.

## Cancelar y borrar

**Cancelar** detiene el trabajo que aún no se ha hecho y elimina sus tareas pendientes. Uno ya completado o fallido no se puede cancelar: no queda nada que parar. Cancelar no borra lo que ya se haya escrito en tu bucket; si el trabajo llegó a subir ficheros, ahí siguen y la limpieza es tuya.

**Borrar** quita el trabajo de la lista. Tampoco toca tu bucket.

## Diagnóstico

| Síntoma | Causa probable |
|---------|----------------|
| Atascado en **queued** | Normal bajo carga; la codificación arranca según se libera capacidad. Si no se mueve nunca, comprueba si estás en el tope de trabajos activos de [Lotes y límites](/docs/products/despliegue/transcoding-batches-es) |
| **Failed** enseguida | El origen no se pudo leer: una URL que da 404, una clave de objeto que no existe, o credenciales sin permiso de lectura |
| **Failed** al final | El destino rechazó la escritura: endpoint incorrecto, región incorrecta o una clave sin permiso de escritura en el prefijo |
| Completado sin salidas | Una salida HLS sin peldaños, o una lista de salidas que no produjo artefactos |
| El progreso avanza y se estanca | Un fichero enorme o una escalera cara — 4K y h265/av1 codifican despacio. Mira el contador de segmentos: si sigue subiendo, está trabajando |
| No llegó el webhook | La entrega no se reintenta. Confirma que el endpoint es alcanzable y responde rápido, y reconcilia contra el estado del trabajo |

> Consejo: **View error** en un trabajo fallido muestra el mensaje que produjo el codificador. Léelo antes de cambiar nada — nombra la fase que falló, y casi siempre eso basta para distinguir un problema de origen de uno de destino.