הודעות שגיאה

איך לפתור שגיאות שנוצרות על ידי Vertex AI Vision בנושא הזה נסביר על שגיאות שפתרונן דורש יותר שלבים מכפי שאפשר לתאר בקלות בהודעת שגיאה.

בתיעוד ה-API של Cloud מפורטות שיטות מומלצות לטיפול בשגיאות.

הרשאות

פרטי הכניסה שמוגדרים כברירת מחדל לאפליקציה לא זמינים

אם קיבלתם את ההודעה הזו:

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.

ההרשאה נדחתה

אם קיבלתם את ההודעה הזו:

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

מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות במיקום שמאוחסן במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS, ושהמשתנה מצביע על המיקום הנכון.

כדי לאבחן את השגיאה הזו, נסו לפתוח את קובץ המפתח של חשבון השירות מהתיקייה שממנה אתם מנסים לקרוא ל-Vertex AI Vision API.

cat $GOOGLE_APPLICATION_CREDENTIALS

Forbidden: 403 POST API has not been used or is disabled

אם קיבלתם את ההודעה:

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. עוברים לקישור שצוין בהודעת השגיאה ומפעילים את Vertex AI Vision API. מחכים כמה דקות ומנסים שוב.
2. מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות שמאוחסן במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS. כדי לאבחן את השגיאה הזו, נסו לפתוח את קובץ המפתח של חשבון השירות מהתיקייה שממנה אתם מנסים לקרוא ל-Vertex AI Vision API.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

ארגומנטים לא תקינים

גרסת ה-API לא נתמכת

לדוגמה: כשמבצעים בקשה לגרסת API שלא תומכת בפעולה.

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

בקשה פגומה

כשמתבצעת בקשת API אבל יש הפרה אחת או יותר בשדות הבקשה. כל הפרה מתועדת כfield_violations בפרטי google.rpc.BadRequest.

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

מספר הפרויקט לא חוקי

אם מספקים מספר פרויקט לא תקין. דוגמה למספר פרויקט: 848757893952147483648.

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

פורמט משאב לא תקין

כשפורמט המשאב לא תקין. דוגמה למספר פרויקט: 1234 ודוגמה למזהה מיקום: 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"
    }
}

תנאי מוקדם נכשל

נתוני סרטון חסרים

בממשקי API מסוימים (כמו CreateAnnotation להערה ברמת המחיצה), הנכס צריך כבר לכלול נתוני וידאו שמוזרמים כדי להסיק את שעת ההתחלה של הנכס. אחרת, תופעל השגיאה הבאה.

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

מכסות ומגבלות

חריגה מהמכסה

אם קיבלתם את ההודעה הזו:

RESOURCE_EXHAUSTED: Quota exceeded.

הגעתם למכסה היומית או למכסה לדקה. כדאי לעיין במכסות ובמגבלות של Vertex AI Vision.

אפשר לבקש להגדיל את המכסות דרך Google Cloud המסוף.