Messaggi di errore

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

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

Autorizzazioni

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 Google 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.

Autorizzazione negata

Se ricevi questo messaggio:

ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(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 cartella da cui stai tentando di chiamare l'API Vertex AI Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

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

Se ricevi il messaggio:

Forbidden: 403 POST Vertex AI Vision API has not been used in
project # before or it is disabled.
Enable it by visitng [url] then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.

1. Visita il link specificato nel messaggio di errore e abilita l'API Vertex AI Vision. Attendi alcuni minuti e riprova.
2. 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 cartella da cui stai tentando di chiamare l'API Vertex AI Vision.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argomenti non validi

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

Bad Request (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" }
  }
}

Numero di progetto non valido

Quando viene fornito un numero di progetto non valido. Numero di progetto di esempio: 848757893952147483648.

message: "Invalid project number used: 848757893952147483648."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_PROJECT_NUMBER"
      domain: "visionai.googleapis.com"
    }
}

Formato della risorsa non valido

Quando il formato di una risorsa non è valido. Numero di progetto di esempio: 1234 e ID posizione di esempio: us-central1.

message: "Invalid Resource Used: project/1234/location/us-central1. Valid format should be "
"projects/{project_number}/locations/{location_id}."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_RESOURCE_FORMAT"
      domain: "visionai.googleapis.com"
    }
}

Precondizione non riuscita

Dati video mancanti

Per alcune API (ad esempio CreateAnnotation per un'annotazione a livello di partizione), è necessario che la risorsa abbia già i dati video in streaming per dedurre l'ora di inizio della risorsa. In caso contrario, verrà attivato il seguente errore.

message: "Asset doesn't have start time inferred yet. Should ingest asset and retry."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "FAILED_PRECONDITION"
      domain: "visionai.googleapis.com"
    }
}

Quote e limiti

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 Vertex AI Vision.

Puoi richiedere l'incremento delle tue quote dalla consoleGoogle Cloud .