Fehlermeldungen

Hier erfahren Sie, wie Sie einige durch Document AI verursachte Fehler beheben können. In diesem Thema werden Fehler beschrieben, deren Lösung mehr Schritte erfordert, als in einer Fehlermeldung beschrieben werden können.

Empfohlene Vorgehensweisen für die Fehlerbehandlung finden Sie in der Cloud API-Dokumentation.

Berechtigungen

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

Standardanmeldedaten für Anwendungen sind nicht verfügbar

Sie erhalten diese Meldung:

The Application Default Credentials are not available. They are
available if running in Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

Document AI verwendet für die Authentifizierung die Standardanmeldedaten für Anwendungen.

Sie müssen ein Dienstkonto für Ihr Projekt haben, den Schlüssel (die JSON-Datei) für das Dienstkonto in die Entwicklungsumgebung herunterladen und dann als Speicherort dieser JSON-Datei eine Umgebungsvariable mit dem Namen GOOGLE_APPLICATION_CREDENTIALS festlegen.

Darüber hinaus muss die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS in dem Kontext verfügbar sein, in dem Sie die Document AI API aufrufen. Wenn Sie beispielsweise die Variable in einer Terminalsitzung festlegen, Ihren Code jedoch im Debugger Ihrer IDE ausführen, hat der Ausführungskontext Ihres Codes möglicherweise keinen Zugriff auf die Variable. In diesem Fall kann Ihre Anfrage an Document AI fehlschlagen, weil keine ordnungsgemäße Authentifizierung erfolgt.

In der Kurzanleitung zu Document AI und in der Dokumentation zur Verwendung der Standardanmeldedaten für Anwendungen finden Sie weitere Informationen dazu, wie Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS festlegen.

Berechtigung verweigert

Sie erhalten diese Meldung:

ERROR: (gcloud.auth.application-default.print-access-token) File
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

Bestätigen Sie, dass Sie eine gültige Dienstkonto-JSON-Datei an dem in der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS gespeicherten Ort haben und dass die Variable auf den richtigen Ort verweist.

Zur Diagnose dieses Fehlers öffnen Sie die Dienstkontoschlüsseldatei in dem Ordner, aus dem Sie die Document AI API aufrufen möchten.

cat $GOOGLE_APPLICATION_CREDENTIALS

Unzulässig: 403 POST API wurde nicht verwendet oder wurde deaktiviert

Wenn Sie die Meldung erhalten:

Forbidden: 403 POST Document AI API has not been used in
project # before or it is disabled.
Enable it by visiting [url], then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.
  1. Rufen Sie den in der Fehlermeldung angegebenen Link auf und aktivieren Sie die Document AI API. Warten Sie einige Minuten und versuchen Sie es dann noch einmal.
  2. Prüfen Sie, ob Sie eine gültige JSON-Datei für den Dienstkontoschlüssel in der Umgebungsvariablen GOOGLE_APPLICATION_CREDENTIALS gespeichert haben. Zur Diagnose dieses Fehlers öffnen Sie die Dienstkontoschlüsseldatei in dem Ordner, aus dem Sie die Document AI API aufrufen möchten. 
    cat $GOOGLE_APPLICATION_CREDENTIALS

Fehler beim Schreiben der endgültigen Ausgabe

Wenn Sie beim Empfangen der Ergebnisse einer Batchverarbeitungsanfrage eine Nachricht wie die folgende erhalten:

{
  "name": "projects/project-name/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.document.v1beta1.OperationMetadata",
    "state": "SUCCEEDED",
    "createTime": "2019-09-19T02:02:15.885267760Z",
    "updateTime": "2019-09-19T02:02:31.896425001Z"
  },
  "done": true,
  "error": {
    "code": 5,
    "message": "Error writing final output to: gs://bucket-name/filename.json"
  }
}

Ihr Dienstkonto hat möglicherweise nicht die erforderlichen Berechtigungen zum Erstellen von Objekten in Ihrem Cloud Storage-Bucket. Achten Sie darauf, dass Sie Ihrem Dienstkonto die richtigen Berechtigungen zugewiesen haben, wie in der Kurzanleitung beschrieben.

Möglicherweise haben Sie den Namen Ihres Cloud Storage-Buckets auch falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.

P4SA hat keinen Zugriff auf Cloud Storage

Wenn das produktbezogene Document AI-Dienstkonto (P4SA) keine Berechtigung für den Zugriff auf einige Cloud Storage-Ressourcen hat.

message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"

Dienstkonto kann kein Objekt in Cloud Storage erstellen

Wenn das produktbezogene Document AI-Dienstkonto (P4SA) keine Berechtigung zum Erstellen von Objekten in Cloud Storage hat.

message: "Service account service-123@gcp-sa-prod-dai-core.iam.gserviceaccount.com
         does not have permission storage.objects.create to create
         Google Cloud Storage object in bucket gs://foo."

Das Document AI-Dienstkonto hat möglicherweise nicht die erforderlichen Berechtigungen zum Erstellen von Objekten in Ihrem Cloud Storage-Bucket. Achten Sie darauf, dass Sie dem Document AI-Dienstkonto die richtigen Berechtigungen zugewiesen haben, wie in der Einrichtung des projektübergreifenden Dateizugriffs beschrieben.

Möglicherweise haben Sie den Namen Ihres Cloud Storage-Buckets auch falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.

Aufrufer kann keine Objekte in Cloud Storage abrufen

Wenn der Aufrufer der Document AI API keine Berechtigung zum Abrufen von Objekten in Cloud Storage hat.

message: "The caller does not have permission storage.objects.get to get Google
         Cloud Storage objects in bucket gs://foo."

Der Aufrufer der API hat möglicherweise nicht die richtigen Berechtigungen, um Objekte in Ihrem Cloud Storage-Bucket abzurufen. Prüfen Sie, ob Sie dem Anrufer die richtigen Berechtigungen zugewiesen haben.

Möglicherweise haben Sie den Namen Ihres Cloud Storage-Buckets auch falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.

Ungültige Argumente

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

API-Version wird nicht unterstützt

Wenn eine Anfrage an eine API-Version gesendet wird, die den Vorgang nicht unterstützt.

message: "The requested operation is unsupported for the API version."

Prozessortyp wird nicht unterstützt

Wenn eine Anfrage an eine API-Methode gesendet wird, die den angegebenen Prozessortyp nicht unterstützt.

message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."

Bad Request (Fehlerhafte Anfrage)

Wenn eine API-Anfrage gestellt wird, die Felder der Anfrage jedoch einen oder mehrere Verstöße aufweisen. Jeder Verstoß wird in den google.rpc.BadRequest-Details als field_violations erfasst.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

Batchverarbeitung aller Dokumente fehlgeschlagen

Wenn die Verarbeitung aller Dokumente in einer Batchverarbeitungsanfrage fehlschlägt.

message: "Failed to process all documents."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

Keine Dokumente

Wenn Dokumente erforderlich oder erwartet werden, aber keine angegeben werden, z. B. beim Importieren von Dokumenten über einen Cloud Storage-URI.

message: "No valid documents found in ${training|test} directory. Ensure files are in a supported MIME type. For details, see https://cloud.google.com/document-ai/docs/file-types."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

Die Parameter gcsUriPrefix und gcsOutputConfig.gcsUri müssen mit gs:// beginnen und mit einem nachgestellten Backslash-Zeichen (/) enden. Prüfen Sie die Konfiguration für die Bucket-URIs.

Beispiel: gs://bucket/directory/

Training wird nicht unterstützt

Wenn eine Anfrage zum Trainieren einer Prozessorversion für einen Prozessortyp gestellt wird, der das Training nicht unterstützt.

message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."

Keine Dokumente ausgewählt

Wenn Dokumente erwartet werden, aber keine im Dataset ausgewählt sind, z. B. beim Erstellen von Aufgaben zur Labelerstellung für Daten.

message: No documents selected. Please select at least one document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS_SELECTED"
    domain: "documentai.googleapis.com"
  }
}

Dokumenttyp nicht gefunden

Wenn die Klasse eines Dokuments (z. B. Führerschein, Reisepass oder Rechnung) nicht der für den Prozessortyp erforderlichen Klassifizierung entspricht. Ein Beispiel ist, wenn im Klassifizierungsschritt des W2-Parsers keine Elemente aus einer Rechnung gefunden werden.

In der Google Cloud Console wird dies möglicherweise auch als Couldn't preview the document: Unable to find a document of type: 'foo' angezeigt. Diese Fehlermeldung gilt für Legacy-Prozessoren.

message: "Unable to find a document of type: 'foo'"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_OF_TYPE_NOT_FOUND"
    domain: "documentai.googleapis.com"
  }
}

Größenbeschränkung für Dokument überschritten

Wenn beim Importieren eines Datasets oder beim Ausführen einer Vorhersage die Obergrenze für die Dateigröße eines Dokuments überschritten wurde.

message: "Document size (2) exceeds limit: 1 (bytes)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SIZE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "limit" value: "1" }
    metadata { key: "size" value: "2" }
  }
}

Dokumentlimit überschritten

Wenn die Obergrenze für die Anzahl der Dokumente überschritten wurde.

message: "Document count exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "document_limit" value: "5" }
    metadata { key: "documents" value: "6" }
  }
}

Nicht unterstützter MIME-Typ

Wenn ein nicht unterstützter MIME-Typ angegeben wurde. Das System prüft das Dateiformat (MIME-Typ), wenn Sie ein Dataset importieren oder einen Vorhersageaufruf ausführen. Unter Unterstützte Dateien (und für Layout Parser) finden Sie die verfügbaren Dateitypen. Wenn das Dateiformat nicht unterstützt wird, wird die folgende Fehlermeldung angezeigt:

message: "INVALID_ARGUMENT: Unsupported MIME type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "UNSUPPORTED_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

Keine Seiten

Wenn ein Dokument ohne Seiten bereitgestellt wurde, aber eine oder mehrere Seiten erforderlich sind.

message: "No pages were found in the document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_PAGES"
    domain: "documentai.googleapis.com"
  }
}

Negative Seitenzahl

Wenn in einem Dokument ein negativer Wert für eine seiner Seitenzahlen angegeben ist.

message: "Page number cannot be negative."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NEGATIVE_PAGE_NUMBER"
    domain: "documentai.googleapis.com"
  }
}

Doppelte Seitenzahlen

Wenn in einem Dokument dieselbe Seitenzahl ein- oder mehrmals aufgeführt ist.

message: "Duplicate page number detected (page numbers to indices): [{1, [1, 2]}, {4, [4, 5]}]."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DUPLICATE_PAGE_NUMBERS"
    domain: "documentai.googleapis.com"
    metadata {
      key: "page_number_to_indices"
      value: "[{1, [1, 2]}, {4, [4, 5]}]"
    }
  }
}

Seitenlimit überschritten

Wenn die Obergrenze für die Gesamtzahl der Seiten eines Dokuments überschritten wird. Dieser Fehler tritt beim Importieren von Datasets oder bei der Vorhersage auf, wenn ein Dokument im Dataset zu viele Seiten hat und die Grenzwerte des Prozessors überschreitet.

message: "Document pages exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "page_limit" value: "5" }
    metadata { key: "pages" value: "6" }
  }
}

Seitenlimit im bildlosen Modus überschritten

Dieser Fehler tritt beim Importieren von Datasets oder bei der Vorhersage auf, wenn ein Dokument im Dataset zu viele Seiten hat und die Grenzwerte des Prozessors überschreitet. Sie können beantragen, dass Ihr Projekt auf eine Zulassungsliste gesetzt wird, um den bildlosen Modus zu aktivieren. Dadurch wird das Seitenlimit auf 30 erhöht.

message: "Document pages in non-imageless mode exceed the limit: 15 got 16. Try using imageless mode to increase the limit to 30."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_LIMIT_EXCEEDED_IN_IMAGELESS_MODE"
    domain: "documentai.googleapis.com"
    metadata { key: "page_limit" value: "15" }
    metadata { key: "pages" value: "16" }
    metadata { key: "imageless_page_limit" value: "30" }
  }
}

Statusänderung der Version eines vortrainierten Prozessors

Wenn eine Anfrage zum Ändern des Status einer vortrainierten Prozessorversion gestellt wurde. Dieser Fehler tritt auf, wenn Sie versuchen, eine vortrainierte Prozessorversion zu löschen.

message: "ProcessorVersion with id 'xyz' is pretrained by Google and cannot change states."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PRETRAINED_PROCESSOR_VERSION_STATE_CHANGE"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DELETING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Dataset-Validierung

Wenn ein Datensatz die Validierungskriterien nicht erfüllt, z. B. aufgrund fehlender Seitenanker, falscher Daten oder unvollständiger Details in einigen Attributen des Dokument-Proto-Objekts.

message: "Invalid dataset. See operation metadata for specific errors."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DATASET"
    domain: "documentai.googleapis.com"
  }
}

Human in the Loop – nicht inline eingefügtes Dokument zur Überprüfung

Wenn eine manuelle Überprüfung für ein Dokument gestartet wurde, das nicht inline definiert wurde.

message: "The document for review must be provided inline."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HUMAN_REVIEW_NON_INLINED_DOCUMENT"
    domain: "documentai.googleapis.com"
  }
}

Ungültiger Dokumenttyp

Wenn der Dokumenttyp ungültig ist oder vom Prozessor nicht unterstützt wird. Ein Dokumenttyp bezieht sich auf die Kategorie des Dokuments (z.B. W2) und nicht das Dateiformat oder der MIME-Typ wie PDF oder JPEG.

message: "Invalid document type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DOCUMENT_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "type" value: "foo" }
  }
}

Dokumentbereich außerhalb des zulässigen Bereichs

message: "Text span [1, 5) is out of bounds: [1, 3)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_OUT_OF_BOUNDS"
    domain: "documentai.googleapis.com"
    metadata { key: "bounds" value: "[1, 3)" }
    metadata { key: "span" value: "[1, 5)" }
    metadata { key: "type" value: "Text" }
  }
}

Ungültiger Dokumentbereich

Wenn ein ungültiger Dokumentbereich angegeben wird, z. B. wenn der Start nach dem Ende liegt.

message: "Character span is invalid. Ensure the max is greater than the min."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "span" value: "Character" }
  }
}

Ungültiges UTF-8-Dokument

Wenn ein Dokument mit ungültigem UTF-8-Code bereitgestellt wird.

message: "Document contains invalid UTF-8 text."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_INVALID_UTF_8"
    domain: "documentai.googleapis.com"
    metadata { key: "bytes" value: "[2, 3)" }
  }
}

Dataset-Schema ist ungültig

Wenn ein Prozessor kein gültiges Unionsschema hat oder das angegebene Dataset-Schema ungültig ist.

message: "The processor has an empty or invalid schema: "
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SCHEMA_ERROR"
    domain: "documentai.googleapis.com"
  }
}

OcrConfig wird nicht unterstützt

Wenn eine Verarbeitungsanfrage für einen Prozessor gestellt wird, der OcrConfig nicht unterstützt.

message: "OcrConfig is not supported for processor type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "OCR_CONFIG_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

Ungültige Importkonfiguration

Wenn die Importkonfiguration ungültig ist.

message: "The import config is invalid: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_IMPORT_CONFIG"
    domain: "documentai.googleapis.com"
  }
}

Die Quellprozessorversion ist ungültig.

Beim Importieren einer Prozessorversion ist die Quellprozessorversion ungültig.

message: "The source processor version is invalid in import processor version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SOURCE_PROCESSOR_VERSION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

Ungültige Chunk-Größe

Wenn die Konfiguration der Chunk-Größe ungültig ist.

message: "Invalid chunk size. Requested chunk size (${CHUNK_SIZE}) must be in the range of [${MIN_CHUNK_SIZE}, ${MAX_CHUNK_SIZE}]."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_ARGUMENT"
    domain: "documentai.googleapis.com"
  }
}

Nicht erfüllte Voraussetzung

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

KMS-Schlüssel ungültig

Wenn ein ungültiger Schlüssel angegeben wurde (z.B. wenn er deaktiviert ist).

message: "KMS key 'projects/1/keys/abc' is invalid (KEY_DISABLED)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "KMS_KEY_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "details" value: "KEY_DISABLED" }
    metadata { key: "kms_key_name" value: "projects/1/keys/abc" }
  }
}

Änderung des Prozessorstatus

Wenn eine ungültige Anfrage zum Ändern des Status eines Prozessors ausgegeben wird.

message: "Processor state cannot be changed to 'DISABLED' since it is 'DISABLED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DISABLED" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "target_state" value: "DISABLED" }
  }
}

Änderung des Status der Prozessorversion

Wenn eine ungültige Anfrage zum Ändern des Status einer Prozessorversion gestellt wird.

message: "ProcessorVersion state cannot be changed to 'DEPLOYING' since it is 'DEPLOYED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DEPLOYED" }
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DEPLOYING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Prozessor nicht aktiviert

Wenn eine Anfrage gestellt wird, die von einem bestimmten Prozessor abhängt, dieser aber nicht aktiviert ist.

message: "Processor 'xyz' is not enabled."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_ENABLED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "DISABLED" }
  }
}

Prozessorversion nicht bereitgestellt

Wenn eine Anfrage gestellt wird, für die eine bestimmte Prozessorversion bereitgestellt sein muss, der Prozessor aber nicht bereitgestellt ist.

message: "ProcessorVersion 'abc' is not deployed."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_DEPLOYED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "TRAINING" }
    metadata { key: "version_id" value: "abc" }
  }
}

Standardversion des Prozessors

Wenn eine Anfrage gestellt wird, für die eine Standardversion konfiguriert sein muss, aber keine konfiguriert ist.

message: "Processor 'xyz' does not have a default version configured."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_DEFAULT_VERSION_UNSET"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

Standardversion des Prozessors entfernen

Wenn eine Anfrage zum Aufheben der Bereitstellung oder zum Löschen einer Prozessorversion gestellt wird, diese aber als Standardversion konfiguriert ist.

message: "ProcessorVersion 'xyz' cannot be undeployed or deleted as it is the default version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_REMOVE_DEFAULT_VERSION"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Dataset nicht initialisiert

Wenn eine Anfrage gestellt wird, für die ein Dataset initialisiert werden muss, das Dataset aber nicht initialisiert ist.

message: "Dataset is not initialized."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_NOT_INITIALIZED"
    domain: "documentai.googleapis.com"
  }
}

Dataset wurde initialisiert oder wird initialisiert

Wenn eine Anfrage gestellt wird, für die ein Dataset nicht initialisiert sein muss, das Dataset aber bereits initialisiert ist oder gerade initialisiert wird.

message: "Dataset is already initialized or is initializing."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_INITIALIZED_OR_INITIALIZING"
    domain: "documentai.googleapis.com"
  }
}

Fehler: Dataset-Speicherort ist nicht leer

Wenn für eine Anfrage ein leerer Speicherort für das Dataset erforderlich ist, der Ordner aber Objekte enthält.

message: "Given dataset location is not empty. Please select an empty folder."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_LOCATION_NOT_EMPTY"
    domain: "documentai.googleapis.com"
  }
}

Fehler beim Blockieren

Wenn andere Vorgänge ausgeführt werden, die den erforderlichen Vorgang blockieren.

message: "The operation cannot be performed due to an ongoing 'EXAMPLE_OPERATION_TYPE' blocking operation. Try again after the operation finishes."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HAS_BLOCKING_OPERATION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

Fehler: Seitenbereich wird nicht unterstützt

Wenn das Feld page_range in einem Vorgang, z. B. in einem Batchprozess, nicht unterstützt wird.

message: "Page range is not supported."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_RANGE_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

Cloud Storage-Ordner enthält Dataset-Fehler

Wenn ein Cloud Storage-Ordner bereits ein Dataset enthält.

message:  "The folder 'folder_uri' already has dataset 'dataset-id' under it."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "GCS_FOLDER_CONTAINS_DATASET_ERROR"
     domain: "documentai.googleapis.com"
   }
}

Fehler: Miniaturansicht fehlt

Wenn eine Miniaturansicht eines Dataset-Dokuments nicht abgerufen werden konnte.

message:  "Failed to get dataset document thumbnail, consider running re-sync on the dataset."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "THUMBNAIL_MISSING"
     domain: "documentai.googleapis.com"
   }
}

Dataset-Seitenlimit überschritten

Wenn das Gesamtseitenlimit eines Datasets überschritten wurde.

message: "Dataset page count exceeds the limit of 5. Got 6."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
  }
}

Nicht unterstützter Prozessor für die synchrone Verarbeitung

Wenn eine Anfrage für eine Prozessorversion gestellt wird, die für die synchrone Verarbeitung nicht mehr unterstützt wird.

message: "Processor ${PROCESSOR_ID} version ${VERSION_ID} of type ${TYPE_NAME} is no longer supported for sync processing. Please upgrade to a newer version: https://cloud.google.com/document-ai/docs/manage-processor-versions."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "UNSUPPORTED_PROCESSOR"
    domain: "documentai.googleapis.com"
  }
}

Nicht gefunden

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

Bewertung nicht gefunden

Wenn keine Bewertung für eine Prozessorversion gefunden werden kann.

message: "Evaluation with ID 'qrs' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "EVALUATION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "evaluation_id" value: "qrs" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

Dokument nicht gefunden

Wenn ein für einen Vorgang erforderliches Dokument nicht gefunden werden kann.

message: "Document not found: 'gs://foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "document" value: "gs://foo" }
  }
}

Prozessor nicht gefunden

Wenn ein für einen Vorgang erforderlicher Prozessor nicht gefunden werden kann.

message: "Processor with id 'xyz' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

Prozessorversion nicht gefunden

Wenn eine für einen Vorgang erforderliche Prozessorversion nicht gefunden werden kann.

message: "ProcessorVersion with id 'abc' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

Job zum Hinzufügen von Labels zu Daten nicht gefunden

Wenn ein Daten-Labeling-Job nicht gefunden werden kann.

message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."

Schemaversion nicht gefunden

Wenn eine Schemaversion nicht gefunden werden kann.

message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."

Schema nicht gefunden

Wenn ein Schema nicht gefunden werden kann.

message: "Schema with id 'EXAMPLE_SCHEMA' not found."

Bereits vorhanden

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

Human-in-the-Loop-Labeler ist bereits vorhanden

Wenn Sie einen Labelerstellerpool erstellen, der bereits vorhanden ist.

message: "The labeler pool already exists."

Anzeigename der Schemaversion ist bereits vorhanden

Wenn Sie eine Schemaversion mit einem Anzeigenamen erstellen, der bereits vorhanden ist.

message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."

Der Anzeigename des Schemas ist bereits vorhanden

Beim Erstellen eines Schemas mit einem Anzeigenamen, der bereits vorhanden ist.

message: "A schema with the name 'EXAMPLE_SCHEMA' already exists."

Kontingente und Limits

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

Kontingent überschritten

Sie erhalten diese Meldung:

RESOURCE_EXHAUSTED: Quota exceeded.

Sie haben das Limit Ihres Minuten- oder Tageskontingents erreicht. Überprüfen Sie die Kontingente und Limits für die Verwendung von Document AI.

Sie können über die Google Cloud -Konsole eine Erhöhung Ihrer Kontingente beantragen.

Ausfälle und Latenz

Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.

Zeitlimits

Der Vorgang wurde nicht innerhalb des festgelegten Zeitlimits abgeschlossen.

Wenn Sie beim Abrufen eines Vorgangs mit langer Ausführungszeit (Long-Running Operation, LRO) die folgenden oder ähnliche Fehlermeldungen erhalten:

google.api_core.future.polling._OperationNotComplete
...
google.api_core.exceptions.RetryError: Deadline of 0.0s exceeded while calling target function, last exception:
...
concurrent.futures._base.TimeoutError: Operation did not complete within the designated timeout.

Der vom Nutzer festgelegte Zeitlimitwert für den Abschluss des Vorgangs ist für das zu verarbeitende Dokument zu niedrig. Dieser Fehler bedeutet nicht, dass der Batchprozessvorgang fehlgeschlagen ist. Der Vorgang wird unabhängig vom vom Nutzer festgelegten Zeitüberschreitungswert fortgesetzt.

Fehler bei Sicherheitsfilter

Es ist ein interner serverseitiger Fehler aufgetreten, weil die Anfrage oder Antwort von den Sicherheitsfiltern des Large Language Model (LLM) blockiert wurde. Dieser Fehler kann nicht wiederholt werden.

message: "Safety filter error."

Interner Fehler

Ein interner serverseitiger Fehler ist aufgetreten. Erstellen Sie die Verbindung neu.

message: "Internal error encountered."
Zurück
Support
Weiter
Einstellung von Produkten und Funktionen