Vertex AI Vision で発生するいくつかのエラーを解決する方法を学習します。このトピックでは、エラー メッセージによって解決方法が簡単にわかるエラーではなく、解決に際して、より多くの手順が必要となるエラーを取り上げます。
エラー処理の推奨事項については、Cloud API のドキュメントをご覧ください。
権限
アプリケーションのデフォルト認証情報は使用できません
このメッセージが表示された場合の対処方法を示します。
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" } }
GOOGLE_APPLICATION_CREDENTIALS
環境変数に設定されている場所に有効なサービス アカウント キーの JSON ファイルがあること、変数が正しい場所を指していることを確認します。
このエラーを診断するには、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.
- エラー メッセージで指定されたリンクにアクセスし、Vertex AI Vision API を有効にします。数分待ってから、再試行します。
- 有効なサービス アカウント キー JSON ファイルが
GOOGLE_APPLICATION_CREDENTIALS
環境変数に格納されていることを確認します。このエラーを診断するには、Vertex AI Vision API を呼び出そうとしているフォルダからサービス アカウント キー ファイルを開いてみてください。cat $GOOGLE_APPLICATION_CREDENTIALS
無効な引数
サポートされていない API バージョン
例: オペレーションをサポートしていない API バージョンに対してリクエストが行われた場合。
message: "The requested operation is unsupported for the API version."
Bad Request
API リクエストが行われたものの、リクエスト フィールドに 1 つ以上の違反がある場合。各違反は、google.rpc.BadRequest
の詳細で field_violations
としてキャプチャされます。
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、ロケーション 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"
}
}
事前の条件付けに失敗
動画データがない
一部の 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.
1 分あたりまたは 1 日あたりの割り当ての制限に達しました。Vertex AI Vision の使用に関する割り当てと上限を確認してください。
割り当ての増加は、Google Cloud コンソールからリクエストできます。