Retomar trabalhos de aprovisionamento

Encontre uma tarefa de aprovisionamento por concluir e volte a tentar gerar as orientações que falharam, sem substituir os conjuntos gerados com êxito.

Guarde o id e o engineId da tarefa de aprovisionamento assim que a criação for bem-sucedida. Utilize GET /v2/provisioning/jobs/:id se o cliente perder a ligação ou se o resultado da espera for incerto. Os estados da tarefa e de cada tipo determinam o que é necessário recuperar.

Encontrar tarefas em execução #

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

status=running é obrigatório. A resposta contém data, uma lista das tarefas em execução visíveis, sem paginação por cursor. Adicione startedBy=me para limitar a lista às tarefas iniciadas pelo utilizador autenticado. Uma chave de serviço não tem uma identidade de utilizador associada, pelo que este filtro devolve uma lista vazia quando se utiliza uma chave de serviço.

Se a resposta ao pedido de criação de um novo motor se tiver perdido, procure também o motor criado em GET /v2/organizations/:orgId/engines e no painel. A tarefa pode já ter sido concluída e deixado de aparecer na lista de tarefas em execução. Repetir o pedido de criação pode criar outro motor.

Voltar a tentar os tipos que falharam #

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

Este pedido não tem corpo. Devolve uma nova tarefa no mesmo motor, com as fontes originais. Só são selecionados os tipos que falharam e continuam vazios; os conjuntos concluídos são mantidos. Guarde o ID da tarefa devolvida e acompanhe-a até à conclusão.

NothingToProvision (409) significa que já não há tipos que tenham falhado e continuem elegíveis, por exemplo, porque entretanto outra ação associou um conjunto. ProvisioningJobRunning (409) identifica trabalho já em execução nesse motor. Consulte esses recursos antes de voltar a tentar.

Se precisar de alterar as fontes originais, submeta uma nova tarefa no motor existente com as fontes corrigidas, escolhendo deliberadamente Empty ou Requested. A rota de nova tentativa reutiliza os dados de entrada originais.

Resolver limites e arranques incompletos #

ProvisioningLimitReached (429) inclui retryAt. Aguarde até ao momento indicado antes de voltar a submeter o pedido. As falhas relacionadas com créditos, plano ou acesso exigem a respetiva correção na conta ou nas permissões.

Uma falha no arranque de um workflow pode deixar um novo motor vazio, mesmo que o pedido devolva um erro do servidor. Consulte a lista de motores antes de repetir a criação de um novo motor. Reutilize o motor existente se for esse que pretendia configurar.

Quando a tarefa terminar, faça a revisão das orientações geradas no Studio antes de as utilizar para traduzir.