Bereitstellungsjobs wiederaufnehmen

Finde einen noch nicht abgeschlossenen Bereitstellungsjob und wiederhole die fehlgeschlagene Erstellung von Vorgaben, ohne erfolgreich erstellte Vorgabensätze zu ersetzen.

Speichere id und engineId des Bereitstellungsjobs, sobald die Erstellung erfolgreich war. Verwende GET /v2/provisioning/jobs/:id, wenn die Client-Verbindung abgebrochen ist oder nach einer Wartezeit unklar bleibt, ob der Vorgang erfolgreich war. Die Zustände des Jobs und der einzelnen Typen zeigen, wo eine Wiederaufnahme nötig ist.

Laufende Jobs finden #

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

status=running ist erforderlich. Die Antwort enthält data, ein Array der sichtbaren laufenden Jobs ohne Cursor-Paginierung. Füge startedBy=me hinzu, um die Liste auf Jobs zu beschränken, die von der authentifizierten Person gestartet wurden. Ein Dienstschlüssel hat keine Nutzeridentität. Für ihn liefert dieser Filter daher eine leere Liste.

Wenn die Antwort auf die Erstellung einer neuen Engine verloren gegangen ist, sieh auch unter GET /v2/organizations/:orgId/engines und im Dashboard nach der erstellten Engine. Ein Job kann bereits abgeschlossen und aus der Liste der laufenden Jobs verschwunden sein. Eine erneute Erstellungsanfrage kann eine weitere Engine anlegen.

Fehlgeschlagene Typen erneut verarbeiten #

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

Diese Anfrage hat keinen Body. Sie gibt einen neuen Job für dieselbe Engine zurück, der die ursprünglichen Quellen verwendet. Ausgewählt werden nur fehlgeschlagene Typen, die weiterhin leer sind; fertiggestellte Vorgabensätze bleiben erhalten. Speichere die zurückgegebene Job-ID und verfolge den Job bis zum Abschluss.

NothingToProvision (409) bedeutet, dass kein fehlgeschlagener Typ mehr für einen erneuten Versuch infrage kommt, etwa weil inzwischen durch eine andere Aktion ein Vorgabensatz hinzugefügt wurde. ProvisioningJobRunning (409) weist auf einen bereits laufenden Job auf dieser Engine hin. Lies diese Ressourcen, bevor du einen neuen Versuch startest.

Wenn du die ursprünglichen Quellen ändern musst, starte auf der bestehenden Engine einen neuen Job mit korrigierten Quellen und einer bewusst gewählten Auswahl von Empty oder Requested. Die Route für erneute Versuche verwendet die ursprüngliche Eingabe erneut.

Limitprobleme und unvollständige Starts beheben #

ProvisioningLimitReached (429) enthält retryAt. Warte bis zu diesem Zeitpunkt, bevor du die Anfrage erneut sendest. Fehler im Zusammenhang mit Guthaben, Tarif oder Zugriff erfordern entsprechende Anpassungen am Konto oder an den Berechtigungen.

Ein fehlgeschlagener Workflow-Start kann eine neue, leere Engine hinterlassen, selbst wenn die Anfrage einen Serverfehler zurückgibt. Sieh dir die Engine-Liste an, bevor du erneut eine neue Engine erstellst. Verwende die bestehende Engine weiter, wenn es diejenige ist, die du konfigurieren wolltest.

Führe eine Prüfung der generierten Vorgaben in Studio durch, sobald der Job beendet ist und bevor du die Vorgaben zum Übersetzen verwendest.