Recuperar tarefas de provisionamento

Encontre uma tarefa de provisionamento inacabada e tente gerar novamente as orientações que falharam, sem substituir os conjuntos gerados com sucesso.

Salve id e engineId da tarefa de provisionamento assim que a criação for concluída com sucesso. Use GET /v2/provisioning/jobs/:id se o cliente se desconectar ou se houver incerteza sobre o resultado da espera. Os estados da tarefa e de cada tipo determinam o que precisa ser recuperado.

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 de tarefas visíveis em execução, sem paginação por cursor. Adicione startedBy=me para restringir a lista às tarefas iniciadas pelo usuário autenticado. Uma chave de serviço não tem identidade de usuário, por isso esse filtro retorna uma lista vazia para ela.

Se a resposta à solicitação de criação de um novo engine tiver sido perdida, consulte também GET /v2/organizations/:orgId/engines e o painel para localizar o engine criado. A tarefa pode já ter sido concluída e saído da lista de tarefas em execução. Repetir a solicitação de criação pode criar outro engine.

Tentar novamente os tipos que falharam #

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

Esta solicitação não tem corpo. Ela retorna uma nova tarefa no mesmo engine, usando as fontes originais. Apenas os tipos que falharam e ainda estão vazios são selecionados; os conjuntos concluídos são mantidos. Salve o ID da tarefa retornada e acompanhe sua execução até a conclusão.

NothingToProvision (409) significa que nenhum dos tipos que falharam continua elegível, por exemplo, porque outra ação já associou um conjunto a ele. ProvisioningJobRunning (409) indica que já há uma tarefa em execução nesse engine. Consulte esses recursos antes de tentar novamente.

Se for necessário alterar as fontes originais, envie uma nova tarefa no engine existente com as fontes corrigidas e uma seleção explícita de Empty ou Requested. A rota de nova tentativa reutiliza os dados de entrada originais.

Resolver limites e inicializações incompletas #

ProvisioningLimitReached (429) inclui retryAt. Aguarde até o horário indicado antes de enviar novamente. Falhas relacionadas a créditos, plano e acesso exigem os ajustes correspondentes na conta ou nas permissões.

Uma falha ao iniciar um workflow pode deixar um novo engine vazio, mesmo quando a solicitação retorna um erro do servidor. Consulte a lista de engines antes de repetir a criação de um novo engine. Reutilize o engine existente se ele for o que você pretendia configurar.

Quando a tarefa chegar a um estado final, revise as orientações geradas no Studio antes de usá-las para traduzir.