Troubleshooting

​

Triage-Ablauf

​

Erreichbarkeit

​

Authentifizierung und Scope

​

401 INVALID_API_KEY

• Prüfen Sie, ob der Wert aus der vorgesehenen Secret-Version geladen wird.
• Prüfen Sie auf führende oder nachgestellte Leerzeichen und versehentliche Anführungszeichen.
• Prüfen Sie in der API-Key-Verwaltung, ob der Key aktiv ist.
• Prüfen Sie, ob bei der Rotation eine veraltete Runtime übersehen wurde.

​

403 TENANT_NOT_IN_SCOPE

• Prüfen Sie, ob X-Tenant-ID eine Tenant-ID und kein Unternehmensname oder keine Divisions-ID enthält.
• Prüfen Sie, ob der ausgewählte Tenant im Key-Scope enthalten ist.
• Prüfen Sie, ob die referenzierte Ressource zum selben autorisierten Kontext gehört.

​

Mehrdeutige Zuordnung

​

Request-Validierung

​

Statuskonflikte

• ORDER_ALREADY_DECIDED: aktuellen finalen Entscheidungsstatus abgleichen.
• INVALID_STATE_TRANSITION: der aktuelle Lifecycle erlaubt die Anfrage nicht.
• DIVISION_CYCLE: ausgewählter Parent ist ein Nachfahre der Division.
• DIVISION_NAME_NOT_UNIQUE_ON_SAME_LEVEL: eindeutigen Geschwisternamen wählen.
• DUPLICATE_RESOURCE: vorhandene Ressource finden und zuordnen.

​

Timeout nach einem Schreibvorgang

​

Downloadfehler

• Metadaten erneut lesen und prüfen, dass fileName nicht null ist.
• Prüfen, ob die ID zum erwarteten Tenant gehört.
• Status und Content-Type prüfen, bevor die Response auf Datenträger geschrieben wird.
• Unvollständige Dateien nach 502, 503, 504 oder Netzwerkunterbrechung verwerfen.
• Transiente Downloadfehler mit begrenztem Backoff wiederholen.

​

Datensatz für die Eskalation

UTC-Zeitstempel
Methode und Pfad
HTTP-Status
error.code und error.message
X-Request-ID / error.requestId
Tenant-Kontext
Anzahl der Versuche
ob dryRun verwendet wurde
bereinigte Reproduktionsschritte