Questa pagina è stata tradotta dall'API Cloud Translation.

Messaggi di errore

Scopri come risolvere alcuni errori rilevati da Document AI. Questo argomento illustra gli errori la cui risoluzione richiede più passaggi di quelli che possono essere descritti in un messaggio di errore.

Consulta la documentazione dell'API Cloud per le best practice di gestione degli errori.

Autorizzazioni

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Le credenziali predefinite dell'applicazione non sono disponibili

Se ricevi questo messaggio:

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 utilizza le credenziali predefinite dell'applicazione per l'autenticazione.

Devi avere un account di servizio per il tuo progetto, scaricare la chiave (file JSON) per l'account di servizio nel tuo ambiente di sviluppo e impostare la posizione del file JSON su una variabile di ambiente denominata GOOGLE_APPLICATION_CREDENTIALS.

Inoltre, la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS debe essere disponibile nel contesto in cui chiami l'API Document AI. Ad esempio, se imposti la variabile da una sessione del terminale, ma esegui il codice nel debugger dell'IDE, il contesto di esecuzione del codice potrebbe non avere accesso alla variabile. In questo caso, la tua richiesta di accesso a Document AI potrebbe non andare a buon fine per mancanza di autenticazione adeguata.

Per ulteriori informazioni su come impostare la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS, consulta la guida introduttiva di Document AI o la documentazione sull'utilizzo delle credenziali predefinite dell'applicazione.

Autorizzazione negata

Se ricevi questo messaggio:

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"
  }
}

Verifica di avere un file JSON della chiave dell'account di servizio valido nella posizione memorizzata nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS e che la variabile indichi la posizione corretta.

Per diagnosticare questo errore, prova ad aprire il file della chiave dell'account di servizio dalla la cartella da cui stai tentando di chiamare l'API Document AI.

cat $GOOGLE_APPLICATION_CREDENTIALS

Non consentito: 403 L'API POST non è stata utilizzata o è disabilitata

Se ricevi il messaggio:

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.

Visita il link specificato nel messaggio di errore e abilita l'API Document AI. Attendi alcuni minuti e riprova.
Verifica di avere un file JSON della chiave dell'account di servizio valido archiviato nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS. Per diagnosticare questo errore, prova ad aprire il file della chiave dell'account di servizio dalla la cartella da cui stai tentando di chiamare l'API Document AI.
```
cat $GOOGLE_APPLICATION_CREDENTIALS
```

Errore durante la scrittura dell'output finale

Se ricevi un messaggio simile al seguente quando ricevi i risultati di una richiesta di elaborazione collettiva:

{
  "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"
  }
}

Il tuo account di servizio potrebbe non disporre delle autorizzazioni corrette per creare oggetti nel bucket Cloud Storage. Assicurati di aver assegnato le autorizzazioni corrette al tuo account di servizio, come descritto nella guida introduttiva.

Potresti anche aver scritto male il nome del tuo bucket Cloud Storage. Verifica che il bucket a cui stai tentando di accedere esista.

P4SA senza accesso a Cloud Storage

Quando l'account di servizio per prodotto (P4SA) di Document AI non dispone dell'autorizzazione per accedere ad alcune risorse Cloud Storage.

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

L'account di servizio non può creare oggetti in Cloud Storage

Quando l'account di servizio per prodotto (P4SA) Document AI non dispone dell'autorizzazione per creare oggetti in Cloud Storage.

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.

L'account di servizio Document AI potrebbe non disporre delle autorizzazioni corrette per creare oggetti nel bucket Cloud Storage. Assicurati di aver assegnato le autorizzazioni corrette all'account di servizio Document AI, come descritto nella configurazione dell'accesso ai file tra progetti.

Potresti anche aver scritto male il nome del tuo bucket Cloud Storage. Verifica che il bucket a cui stai tentando di accedere esista.

L'utente che chiama non riesce a recuperare gli oggetti in Cloud Storage

Quando l'autore della chiamata dell'API Document AI non dispone dell'autorizzazione per recuperare gli oggetti in Cloud Storage.

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

L'autore della chiamata dell'API potrebbe non disporre delle autorizzazioni corrette per recuperare gli oggetti nel bucket Cloud Storage. Assicurati di avere assigned le autorizzazioni corrette all'utente chiamante.

Potresti anche aver scritto male il nome del tuo bucket Cloud Storage. Verifica che il bucket a cui stai tentando di accedere esista.

Argomenti non validi

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Versione dell'API non supportata

Esempio: quando viene effettuata una richiesta a una versione dell'API che non supporta l'operazione.

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

Richiesta non valida

Quando viene effettuata una richiesta API, ma i campi della richiesta presentano una o più violazioni. Ogni violazione viene acquisita come field_violations nei dettagli google.rpc.BadRequest.

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

L'elaborazione collettiva di tutti i documenti non è riuscita

Quando non è possibile elaborare tutti i documenti di una richiesta di elaborazione collettiva.

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

Nessun documento

Quando i documenti sono obbligatori o previsti, ma non vengono forniti, ad esempio quando si importano documenti tramite URI di Cloud Storage.

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"
  }
}

I parametri gcsUriPrefix e gcsOutputConfig.gcsUri devono iniziare con gs:// e terminare con un carattere barra rovesciata finale (/). Controlla la configurazione degli URI del bucket.

Esempio: gs://bucket/directory/

L'addestramento non è supportato

Quando viene effettuata una richiesta di versione del processore di addestramento su un tipo di processore che non supporta l'addestramento.

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

Nessun documento selezionato

Quando sono previsti documenti, ma non ne viene selezionato nessuno nel set di dati, ad esempio quando si creano job di etichettatura dei dati.

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"
  }
}

Tipo di documento non trovato

Quando la classe di un documento (ad esempio patente, passaporto o fattura) non corrisponde alla classificazione necessaria per il tipo di elaboratore. Un esempio è quando il passaggio del classificatore nel parser W2 non trova elementi di una fattura.

Potrebbe anche essere visualizzato come Couldn't preview the document: Unable to find a document of type: 'foo' nella console Google Cloud. Questo messaggio di errore è applicabile ai vecchi processori.

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"
  }
}

Limite di dimensioni del documento superato

Quando il limite superiore per le dimensioni del file di un documento è stato superato durante l'importazione del set di dati o l'esecuzione della previsione.

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" }
  }
}

Limite di documenti superato

Quando viene superato il limite superiore per il conteggio dei documenti.

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" }
  }
}

Tipo MIME non supportato

Quando è stato fornito un tipo MIME non supportato. Il sistema verifica il formato del file (tipo MIME) quando importi un set di dati e quando effettui una chiamata di previsione. Se il formato file non è supportato, viene visualizzato il seguente messaggio di errore:

message: "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" }
  }
}

Tipo MIME del documento errato

Quando i contenuti del documento non corrispondono al tipo MIME specificato. Il sistema verifica il formato del file (tipo MIME) quando importi un set di dati e quando effettui una chiamata di previsione. Se il formato del file specificato non corrisponde a quello previsto, viene visualizzato il seguente messaggio di errore:

message: "Incorrect document content for mime_type: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INCORRECT_DOCUMENT_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

Nessuna pagina

Quando è stato fornito un documento senza pagine, ma sono richieste una o più pagine.

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

Numero di pagina negativo

Quando un documento elenca un valore negativo per uno dei numeri di pagina.

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

Numeri di pagina duplicati

Quando un documento elenca lo stesso numero di pagina una o più volte.

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]}]"
    }
  }
}

Limite di pagine superato

Quando viene superato il limite massimo del numero totale di pagine di un documento. Questo errore si verifica durante l'importazione o la previsione del set di dati quando un documento al suo interno ha troppe pagine, superando i limiti del processore.

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" }
  }
}

Modifica dello stato della versione del processore preaddestrato

Quando è stata emessa una richiesta di modifica dello stato di una versione del processore preaddestrato. Questo errore si verifica quando si tenta di eliminare una versione del processore preaddestrato.

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" }
  }
}

Convalida del set di dati

Quando un set di dati non soddisfa i criteri di convalida, ad esempio a causa di ancore di pagina mancanti, dati errati o dettagli incompleti in alcuni attributi dell'oggetto proto del documento.

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

Documento non in linea di human-in-the-loop per la revisione

Quando è stata avviata una revisione da parte di persone fisiche per un documento non definito in linea.

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"
  }
}

Tipo di documento non valido

Quando viene fatto riferimento a un documento con un formato file non supportato o non valido, ad esempio .mp4.

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" }
  }
}

Aggiornamento fuori intervallo

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" }
  }
}

Intervallo di documento non valido

Quando viene fornito un intervallo di documento non valido, ad esempio se l'inizio è successivo alla fine.

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" }
  }
}

Documento UTF-8 non valido

Quando viene fornito un documento che include UTF-8 non valido.

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)" }
  }
}

Lo schema del set di dati non è valido

Quando un elaboratore non dispone di uno schema unione valido o lo schema del set di dati fornito non è valido.

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 non supportato

Quando viene emessa una richiesta di elaborazione per un elaboratore che non supporta OcrConfig.

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

Configurazione di importazione non valida

Quando la configurazione di importazione non è valida.

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

La versione del processore di origine non è valida

Quando si tenta di importare una versione del processore, la versione del processore di origine non è valida per l'importazione.

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"
  }
}

Precondizione non riuscita

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Chiave KMS non valida

Quando è stata fornita una chiave non valida (ad es. disattivata).

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" }
  }
}

Modifica dello stato del processore

Quando viene emessa una richiesta non valida per modificare lo stato di un elaboratore.

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" }
  }
}

Modifica dello stato della versione del processore

Quando viene emessa una richiesta non valida per modificare lo stato di una versione del processore.

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" }
  }
}

Processore non abilitato

Quando viene emessa una richiesta che dipende da un elaboratore specifico, ma quest'ultimo non è abilitato.

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" }
  }
}

Versione del processore non di cui è stato eseguito il deployment

Quando viene eseguita una richiesta che dipende dal deployment di una versione specifica del processore, ma il processore non è stato dipartito.

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" }
  }
}

Versione predefinita del processore

Quando viene inviata una richiesta che dipende dalla configurazione di una versione predefinita, ma non è configurata alcuna versione.

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" }
  }
}

Rimuovere la versione predefinita del processore

Quando viene emessa una richiesta di annullamento del deployment o di eliminazione di una versione del processore, ma questa è configurata come versione predefinita.

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" }
  }
}

Set di dati non inizializzato

Quando viene emessa una richiesta che richiede l'inizializzazione di un set di dati, ma il set di dati non è stato inizializzato.

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

Set di dati inizializzato o in fase di inizializzazione

Quando viene inviata una richiesta che richiede un set di dati non inizializzato, ma il set di dati è già stato inizializzato o è in fase di inizializzazione.

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

Errore: posizione del set di dati non vuota

Quando una richiesta richiede che la posizione di archiviazione di un set di dati sia vuota, ma la cartella contiene oggetti.

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"
  }
}

Contiene un errore di operazione di blocco

Quando sono in esecuzione altre operazioni che bloccano l'operazione richiesta.

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"
  }
}

Errore relativo all'intervallo di pagine non supportato

Quando il campo page_range non è supportato in alcune operazioni, ad esempio in un processo batch.

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

La cartella Cloud Storage contiene un errore del set di dati

Quando una cartella Cloud Storage contiene già un set di dati.

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"
   }
}

Errore: miniatura mancante

Quando non è possibile recuperare la miniatura di un documento del set di dati.

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"
   }
}

Limite di pagine del set di dati superato

Quando viene superato il limite di pagine totali di un set di dati.

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"
  }
}

Non trovato

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Valutazione non trovata

Quando non è possibile trovare una valutazione per una versione del processore.

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" }
  }
}

Documento non trovato

Quando non è possibile trovare un documento necessario per un'operazione.

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" }
  }
}

Processore non trovato

Quando non è possibile trovare un elaboratore necessario per un'operazione.

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" }
  }
}

Versione del processore non trovata

Quando non è possibile trovare una versione del processore necessaria per un'operazione.

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 di etichettatura dati non trovato

Quando non è possibile trovare un job di etichettatura dati.

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

Già esistente

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

L'etichettatore human-in-the-loop esiste già

Quando viene creato un pool di labeler che esiste già.

message: "The labeler pool already exists."

Quote e limiti

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Quota superata

Se ricevi questo messaggio:

RESOURCE_EXHAUSTED: Quota exceeded.

Hai raggiunto il limite della quota giornaliera o per minuto. Esamina le quote e i limiti per l'utilizzo di Document AI.

Puoi richiedere l'incremento delle tue quote da Google Cloud Console.

Intreruzioni e latenza

La risoluzione richiede l'esecuzione di alcuni passaggi, come indicato nel messaggio di errore.

Timeout

Per l'elaborazione online, è previsto un timeout lato server di 2 minuti per le richieste.
Per l'elaborazione batch, è previsto un timeout lato server di 2 minuti per la generazione dell'operazione a lungo termine, ma non è previsto un timeout per il completamento del job batch.
- Per ulteriori informazioni, consulta la documentazione relativa alle operazioni a lungo termine.

L'operazione non è stata completata entro il timeout specificato.

Se ricevi i seguenti messaggi di errore (o simili) durante l'esecuzione di un'operazione a lunga esecuzione (LRO):

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.

Ciò significa che il valore del timeout impostato dall'utente per il completamento dell'operazione è troppo basso per il documento in fase di elaborazione. Questo errore non indica che l'operazione di elaborazione batch non è riuscita, l'operazione continuerà indipendentemente dal valore di timeout impostato dall'utente.

Indietro

Richiedere assistenza

Avanti

Deprecazioni