Messages d'erreur

Découvrez comment résoudre certaines erreurs générées par Agent Platform Vision. Cette rubrique traite des erreurs dont la résolution nécessite un nombre d'étapes ne pouvant pas être indiqué facilement dans un message d'erreur.

Consultez la documentation de l'API Cloud pour connaître les bonnes pratiques de gestion des exceptions.

Autorisations

Les identifiants par défaut de l'application ne sont pas disponibles

Si vous recevez ce message :

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.

Autorisation refusée

Si vous recevez ce message :

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

Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide à l'emplacement stocké dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS et que cette dernière pointe vers l'emplacement approprié.

Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Gemini Enterprise Agent Platform Vision.

cat $GOOGLE_APPLICATION_CREDENTIALS

"Interdit : 403 La méthode POST de l'API n'est pas utilisée ou est désactivée"

Si vous recevez ce message : 

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. Accédez au lien indiqué dans le message d'erreur et activez l'API Agent Platform Vision. Patientez quelques minutes, puis réessayez.
  2. Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide stocké dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Gemini Enterprise Agent Platform Vision. 
    cat $GOOGLE_APPLICATION_CREDENTIALS

Arguments non valides

Version d'API non compatible

Exemple : lorsqu'une requête est envoyée à une version d'API qui ne prend pas en charge l'opération.

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

Requête incorrecte

Lorsqu'une requête API est envoyée, mais que les champs de la requête comportent une ou plusieurs violations. Chaque violation est capturée en tant que field_violations dans les détails google.rpc.BadRequest.

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

Numéro de projet non valide

Lorsqu'un numéro de projet non valide est fourni. Exemple de numéro de projet : 848757893952147483648.

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

Format de ressource non valide

Lorsqu'un format de ressource n'est pas valide. Exemple de numéro de projet : 1234 et exemple d'ID d'emplacement : 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"
    }
}

ÉCHEC DE LA CONDITION PRÉALABLE

Données vidéo manquantes

Pour certaines API (telles que CreateAnnotation pour une annotation au niveau d'une partition), l'élément doit déjà avoir des données vidéo diffusées pour déduire l'heure de début de l'élément. Sinon, l'erreur suivante est déclenchée.

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

Quotas et limites

Quota dépassé

Si vous recevez ce message :

RESOURCE_EXHAUSTED: Quota exceeded.

Vous avez atteint votre limite de quota par minute ou par jour. Consultez les quotas et les limites d'utilisation d'Agent Platform Vision.

Vous pouvez demander une augmentation de vos quotas depuis la Google Cloud console.