Recuperar el trabajo de aprovisionamiento
Encuentra un trabajo de aprovisionamiento sin terminar y vuelve a intentar generar las pautas que fallaron sin reemplazar los conjuntos generados correctamente.
Guarda id y engineId del trabajo de aprovisionamiento en cuanto se cree correctamente. Usa GET /v2/provisioning/jobs/:id si el cliente se desconectó o si, después de esperar, no sabes si el trabajo terminó. Los estados del trabajo y de cada tipo determinan qué necesita recuperarse.
Encontrar trabajos en ejecución #
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEYstatus=running es obligatorio. La respuesta contiene data, un arreglo de trabajos visibles en ejecución, sin paginación por cursor. Agrega startedBy=me para limitar los resultados a los trabajos iniciados por el usuario autenticado. Una clave de servicio no tiene una identidad de usuario asociada, por lo que ese filtro devuelve una lista vacía cuando se usa con ella.
Si se perdió la respuesta de creación de un motor nuevo, revisa también GET /v2/organizations/:orgId/engines y el panel para encontrar el motor creado. Es posible que el trabajo ya haya finalizado y desaparecido de la lista de trabajos en ejecución. Repetir la solicitud de creación puede crear otro motor.
Reintentar los tipos que fallaron #
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEYEsta solicitud no tiene cuerpo. Devuelve un trabajo nuevo en el mismo motor, con las fuentes originales. Solo se seleccionan los tipos que fallaron y siguen vacíos; los conjuntos completados se conservan. Guarda el ID del trabajo devuelto y sigue su progreso hasta que finalice.
NothingToProvision (409) significa que ya no queda ningún tipo fallido que pueda reintentarse, por ejemplo, porque otra acción adjuntó un conjunto desde entonces. ProvisioningJobRunning (409) identifica un trabajo que ya está en ejecución en ese motor. Consulta esos recursos antes de volver a intentarlo.
Si necesitas cambiar las fuentes originales, envía un trabajo nuevo al motor existente con las fuentes corregidas y selecciona explícitamente Empty o Requested. La ruta de reintento reutiliza los datos de entrada originales.
Resolver límites e inicios incompletos #
ProvisioningLimitReached (429) incluye retryAt. Espera hasta ese momento antes de volver a enviar la solicitud. Los errores relacionados con créditos, el plan y el acceso requieren los ajustes correspondientes en la cuenta o los permisos.
Si el inicio del flujo de trabajo falla, puede quedar un motor nuevo vacío, incluso si la solicitud devuelve un error del servidor. Revisa la lista de motores antes de repetir la creación de un motor nuevo. Reutiliza el motor existente si es el que querías configurar.
Una vez que el trabajo llegue a un estado final, haz una revisión de las pautas generadas en Studio antes de usarlas para traducir.