Messaggi di errore

Scopri come risolvere alcuni errori generati da Agent Platform Vision. Questo argomento tratta 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 pratiche consigliate per la 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 account di servizio valido nella posizione archiviata nella variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS e che la variabile punti alla 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 Gemini Enterprise Agent Platform Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

Vietato: 403 POST API non è stata utilizzata o è disabilitata

Se ricevi il messaggio:

Forbidden: 403 POST Gemini Enterprise Agent Platform 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 Agent Platform Vision. Attendi alcuni minuti e riprova.
2. Verifica di avere un file JSON della chiave 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 Gemini Enterprise Agent Platform Vision.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Argomenti non validi

Versione 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 registrata come field_violations nei google.rpc.BadRequest dettagli.

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 risorsa non valido

Quando il formato di una risorsa non è valido. Numero di progetto di esempio: 1234 e ID località 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"
    }
}

Errore condizione necessaria

Dati video mancanti

Per alcune API (ad esempio CreateAnnotation per un'annotazione a livello di partizione), è necessario che l'asset abbia già eseguito lo streaming dei dati video per dedurre l'ora di inizio dell'asset. 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 tua quota al minuto o giornaliera. Esamina le quote e i limiti per l'utilizzo di Agent Platform Vision.

Puoi richiedere l'incremento delle tue quote dalla Google Cloud console.