Fehlermeldungen

Hier erfahren Sie, wie Sie einige durch Agent Platform Vision 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

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

Berechtigung verweigert

Sie erhalten diese Meldung:

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

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 Vision API der Gemini Enterprise Agent Platform aufrufen möchten.

cat $GOOGLE_APPLICATION_CREDENTIALS

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

Sie erhalten die Meldung: 

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. Rufen Sie den in der Fehlermeldung angegebenen Link auf und aktivieren Sie die Agent Platform Vision 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 Vision API der Gemini Enterprise Agent Platform aufrufen möchten. 
    cat $GOOGLE_APPLICATION_CREDENTIALS

Ungültige Argumente

API-Version nicht unterstützt

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

Bad Request (Fehlerhafte Anfrage)

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

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

Ungültige Projektnummer

Wenn eine ungültige Projektnummer angegeben wird. Beispiel für eine Projektnummer: 848757893952147483648.

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

Ungültiges Ressourcenformat

Wenn ein Ressourcenformat ungültig ist. Beispielprojektnummer: 1234 und Beispiel-Standort-ID: 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"
    }
}

Vorbedingung nicht erfüllt

Fehlende Videodaten

Bei einigen APIs (z. B. CreateAnnotation für eine Anmerkung auf Partitionsebene) müssen bereits Videodaten für das Asset gestreamt worden sein, um die Startzeit des Assets abzuleiten. Andernfalls wird der folgende Fehler ausgelöst.

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

Kontingente und Limits

Kontingent überschritten

Sie erhalten diese Meldung:

RESOURCE_EXHAUSTED: Quota exceeded.

Sie haben das Limit Ihres Minuten- oder Tageskontingents erreicht. Sehen Sie sich die Kontingente und Limits für die Verwendung von Agent Platform Vision an.

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