Reprendre le provisionnement
Retrouvez une tâche de provisionnement inachevée et relancez la génération des consignes en échec sans remplacer les ensembles déjà créés.
Enregistrez les valeurs id et engineId de la tâche de provisionnement dès que sa création a réussi. Utilisez GET /v2/provisioning/jobs/:id après une déconnexion du client ou une attente dont l'issue est incertaine. Les états de la tâche et de chaque type déterminent ce qui doit être repris.
Trouver les tâches en cours #
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEYstatus=running est requis. La réponse contient data, un tableau des tâches en cours visibles, sans pagination par curseur. Ajoutez startedBy=me pour limiter les résultats aux tâches lancées par l'utilisateur authentifié. Une clé de service n'est associée à aucune identité utilisateur ; ce filtre renvoie donc une liste vide avec cette clé.
Si la réponse à la requête de création d'un nouveau moteur a été perdue, consultez aussi GET /v2/organizations/:orgId/engines et le tableau de bord pour retrouver le moteur créé. Une tâche peut déjà être terminée et avoir disparu de la liste des tâches en cours. Répéter la requête de création peut créer un autre moteur.
Relancer les types en échec #
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEYCette requête n'a pas de corps. Elle renvoie une nouvelle tâche sur le même moteur, à partir des sources d'origine. Seuls les types en échec encore vides sont sélectionnés ; les ensembles terminés sont conservés. Enregistrez l'identifiant de la tâche renvoyée et suivez son exécution jusqu'à son terme.
NothingToProvision (409) signifie qu'aucun type en échec ne remplit encore les conditions de relance, par exemple parce qu'une autre action a entre-temps associé un ensemble. ProvisioningJobRunning (409) indique qu'une tâche est déjà en cours sur ce moteur. Consultez ces ressources avant de réessayer.
Si les sources d'origine doivent être modifiées, soumettez une nouvelle tâche sur le moteur existant avec les sources corrigées, en choisissant explicitement Empty ou Requested. La route de relance réutilise les données d'entrée d'origine.
Gérer les limites et les démarrages incomplets #
ProvisioningLimitReached (429) inclut retryAt. Attendez l'heure indiquée avant de soumettre à nouveau la requête. Les échecs liés aux crédits, au forfait ou à l'accès nécessitent de corriger le compte ou les autorisations concernés.
L'échec du lancement d'un workflow peut laisser un nouveau moteur vide, même si la requête renvoie une erreur serveur. Consultez la liste des moteurs avant de renouveler la requête de création d'un nouveau moteur. Réutilisez le moteur existant s'il s'agit de celui que vous souhaitiez configurer.
Une fois la tâche terminée, procédez à la relecture des consignes générées dans Studio avant de les utiliser pour traduire.