エラー メッセージ

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.

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

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 コンソールからリクエストできます。