service_unavailable

The message text is shown in the example below.

HTTP status503
typeservice_unavailable_error
Retry?Yes, with back-off after Retry-After
StatusIn the public catalog (error-envelope.ts)
Extra fieldsretry_after

When it happens

Any other short outage.

Example

{
  "error": {
    "type": "service_unavailable_error",
    "code": "service_unavailable",
    "message": "The service is temporarily unavailable. Retry shortly.",
    "param": null,
    "request_id": "req_6f1c2a9e0b7d4c3a8e5f1b2d",
    "retry_after": 10
  }
}

How to fix it

  • Retry after Retry-After.

Detect it in code

err = resp.json().get("error", {})
if resp.status_code == 503 and err.get("code") == "service_unavailable":
    delay = err.get("retry_after") or 2
    time.sleep(delay)  # then retry
Was this page helpful?