トラブルシューティング

このページでは、Model Armor に関する問題を解決する方法について説明します。

このセクションでは、Model Armor の使用中に問題が発生した場合に役立つトラブルシューティングの手順について説明します。

Model Armor に対するすべての API 呼び出しが「404 Not Found」エラーを返す

Model Armor API と Private Service Connect を確立します。このエラーは通常、プライベート Google アクセスを使用している場合、または Private Service Connect を使用せずに Model Armor リージョン エンドポイント（REP）にアクセスしている場合に発生します。詳細については、Private Service Connect エンドポイントを介したリージョン エンドポイントへのアクセスについてをご覧ください。

Sensitive Data Protection フィルタでエラーが発生するか、スキップされる

以下を確認してください。

  • Sensitive Data Protection テンプレートが、呼び出される Model Armor エンドポイントと同じリージョンにある。
  • Sensitive Data Protection テンプレートを含むプロジェクトで、Model Armor リクエストを行うサービス エージェントに dlp.User ロールと dlp.Reader ロールが付与されている。

このエラーは、SanitizeUserPrompt リクエストまたは SanitizeModelResponse リクエストのクライアント エラー、または Sensitive Data Protection テンプレートの問題が原因で発生します。

Model Armor グローバル エンドポイント エラー

API リクエストがグローバル エンドポイントではなく、適切なリージョン エンドポイントに送信されていることを確認します。

Model Armor は、リージョン エンドポイントでのみ次のオペレーションをサポートしています。

  • テンプレートに対する作成、読み取り、更新、削除、一覧取得のオペレーション。
  • SanitizeUserPrompt と SanitizeModelResponse API リクエスト。

これらのオペレーションの API リクエストをグローバル エンドポイントに送信すると、次のエラーが発生します。

{
  "error": {
    "code": 403,
    "message": "Write access to project '<PROJECT_ID>' was denied",
    "status": "PERMISSION_DENIED"
  }
}

Model Armor リージョン エンドポイントにアクセスする際の証明書エラー

このエラーは通常、プライベート Google アクセスまたは VPC Service Controls を使用して VPC ネットワーク内から Model Armor リージョン エンドポイントにアクセスし、証明書の検証に失敗した場合に発生します。

たとえば、次のようなエラー メッセージが表示されることがあります。

curl: (60) SSL: no alternative certificate subject name matches target host name 'modelarmor.europe-west4.rep.googleapis.com'

この問題を解決するには、Private Service Connect エンドポイントを Model Armor API に作成します。詳細については、 Private Service Connect エンドポイントを介したリージョン エンドポイントへのアクセスについてをご覧ください。

リージョンがリクエストされた機能をサポートしていない

次のようなエラー メッセージが表示されることがあります。

Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'

このエラーは、機能制限のあるリージョンでテンプレートを作成または更新しようとしたときに、そのリージョンでサポートされていない機能をリクエストで有効にすると発生します。

テンプレート構成には、悪意のある URL や CSAM などの検出項目が含まれています。これらの検出項目は、サポートされていない機能がある一部のリージョンでは使用できません。

この問題を解決するには:

  1. エラー メッセージに記載されているサポートされていない機能を特定します。
  2. リージョン別の機能の可用性 を確認して、ターゲット リージョンで使用できない機能を確認します。
  3. 作成または更新するテンプレートから、サポートされていない機能を削除します。

または、データの所在地に関する要件で許可されている場合は、機能をサポートする別の Model Armor リージョンを使用します。