Zum Hauptinhalt springen

region_unavailable

HTTP 503 · code: "region_unavailable" · type: https://docs.formfeed.dev/errors/region-unavailable

Der Render-Dienst der Region konnte die Anfrage nicht annehmen. Formfeed rendert in der EU (eu, der Standard); siehe Datenresidenz. Die Antwort trägt immer Retry-After. Es wurde nichts gerendert oder berechnet.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/region-unavailable",
  "title": "Region unavailable",
  "status": 503,
  "detail": "The render region is busy, retry shortly",
  "code": "region_unavailable",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Der Render-Dienst der Region ist ausgelastet oder startet neu (detail: The render region is busy, retry shortly; Retry-After kommt vom Dienst, meist 2). Die PDF-Tools, Umwandlungen und Prüfungen wie validate_data versuchen es noch einmal und antworten dann mit diesem Code. Ein synchrones Rendering nicht: Es wartet bis zu 30 Sekunden auf einen freien Render-Platz und geht dann in die Warteschlange, mit der Antwort 202 und dem Header X-Render-Async-Fallback: true (der automatische Fallback).
  • Eine region, für die im Gateway kein Render-Dienst eingerichtet ist (detail: Region us is not available, Retry-After: 60). In Betrieb ist nur eu: Lassen Sie region weg, statt sich auf diese Antwort zu verlassen, denn eine Region, für die das Gateway eine Adresse hat, die aber nicht rendert, kann anders scheitern.

So beheben Sie es​

  • Bei einer ausgelasteten Region wiederholen Sie nach den Sekunden aus Retry-After, mit demselben Idempotency-Key. Die SDKs erledigen das für Sie.
  • Senden Sie große Mengen an Dokumenten als asynchrone Renderings oder Batch: Die Warteschlange wartet auf freie Plätze, statt mit diesem Code zu antworten.
  • Lassen Sie region weg, oder senden Sie "region": "eu".

Wiederholen?​

Ja, nach den Sekunden aus Retry-After, mit demselben Idempotency-Key; Antworten 503 werden nicht unter dem Schlüssel gespeichert. Eine Region ohne Render-Dienst antwortet jedes Mal gleich.