Recuperar trabajos de aprovisionamiento

Localiza un trabajo de aprovisionamiento sin terminar y reintenta la generación de las directrices que hayan fallado sin sustituir los conjuntos generados correctamente.

Guarda id y engineId del trabajo de aprovisionamiento en cuanto se haya creado correctamente. Usa GET /v2/provisioning/jobs/:id si el cliente se ha desconectado o si, tras la espera, no sabes en qué estado ha quedado el trabajo. Los estados del trabajo y de cada tipo determinan qué hay que recuperar.

Buscar trabajos en curso #

http
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEY

status=running es obligatorio. La respuesta contiene data, una lista de los trabajos en curso visibles, sin paginación por cursor. Añade startedBy=me para limitarla a los trabajos iniciados por el usuario autenticado. Una clave de servicio no tiene una identidad de usuario asociada, por lo que este filtro devuelve una lista vacía cuando se usa con ella.

Si se ha perdido la respuesta de creación de un motor nuevo, consulta también GET /v2/organizations/:orgId/engines y el panel para localizar el motor creado. Es posible que el trabajo ya haya finalizado y no aparezca en la lista de trabajos en curso. Repetir la solicitud de creación puede crear otro motor.

Reintentar los tipos fallidos #

http
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEY

Esta solicitud no tiene cuerpo. Devuelve un trabajo nuevo en el mismo motor y utiliza las fuentes originales. Solo se seleccionan los tipos fallidos que siguen vacíos; los conjuntos completados se conservan. Guarda el ID del trabajo devuelto y sigue su progreso hasta que finalice.

NothingToProvision (409) indica que ya no queda ningún tipo fallido que se pueda reintentar, por ejemplo, porque otra acción ha asociado un conjunto desde entonces. ProvisioningJobRunning (409) identifica un trabajo que ya está en curso 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 una selección explícita de 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. Para resolver los fallos relacionados con el crédito, el plan o el acceso, hay que realizar los ajustes correspondientes en la cuenta o en los permisos.

Un fallo al iniciar un flujo de trabajo puede dejar un motor nuevo vacío, incluso si la solicitud devuelve un error del servidor. Consulta la lista de motores antes de volver a crear un motor nuevo. Reutiliza el motor existente si es el que querías configurar.

Una vez que el trabajo haya terminado, revisa las directrices generadas en Studio antes de usarlas para traducir.