Document AI 503 DNS failure: set api_endpoint for your processor location

Not specified by the original author.

TL;DR

When creating a DocumentProcessorServiceClient, always pass clientoptions with apiendpoint set to f"{location}-documentai.googleapis.com" matching where your processor lives (us or eu).

Steps

1. When creating a DocumentProcessorServiceClient, always pass clientoptions with apiendpoint set to f"{location}-documentai.googleapis.com" matching where your processor lives (us or eu). Do not assume the default endpoint works for every location. A 503 with DNS resolution failed means the endpoint is wrong, not that the service is down.

When to use

You are seeing this: Do not assume the default endpoint works for every location. Use this skill when you run into "Document AI 503 DNS failure: set api_endpoint for your processor location".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

• https://us-documentai.googleapis.com/v1/'

Source: GitHub issue (googleapis/python-documentai #188): running the Document AI sample returned 503 'DNS resolution failed for service: https://us-documentai.googleapis.com/v1/' even though the web console worked fine. The root cause: the client must point at the endpoint matching the processor location, f"[location]-documentai.googleapis.com" (us or eu), via ClientOptions. Code that hardcodes the default endpoint or builds the processor name wrong silently hits a non-existent host and dies with a 503 instead of a useful error.

Verified resolution: When creating a DocumentProcessorServiceClient, always pass clientoptions with apiendpoint set to f"{location}-documentai.googleapis.com" matching where your processor lives (us or eu). Do not assume the default endpoint works for every location. A 503 with DNS resolution failed means the endpoint is wrong, not that the service is down.

Source URL: https://github.com/googleapis/python-documentai/issues/188