Fehlermeldungen

Hier erfahren Sie, wie Sie einige von Vertex AI 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.

In der Cloud API-Dokumentation finden Sie empfohlene Verfahren zur Fehlerbehandlung.

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

Ungültige Argumente

Nicht unterstützte API-Version

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 Anfragefelder aber einen oder mehrere Verstöße aufweisen. Jeder Verstoß wird in den google.rpc.BadRequest-Details als field_violations 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. Beispiel für eine Projektnummer: 1234 und Beispiel für eine 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 für das Asset bereits Videodaten gestreamt worden sein, damit der Beginn des Assets abgeleitet werden kann. 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 Vertex AI Vision an.

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