このページは Cloud Translation API によって翻訳されました。

トラブルシューティングの概要

OpenAPI | gRPC

このページでは一般的なトラブルシューティングについて説明します。また、詳細情報へのリンクも記載しています。

Cloud Endpoints 構成をデプロイする際のエラー

gcloud endpoints services deploy コマンドからエラーメッセージが表示された場合は、エラーのトラブルシューティングについて、Endpoints 構成のデプロイのトラブルシューティングをご覧ください。

API と Extensible Service Proxy（ESP）のGoogle Cloud バックエンドへのデプロイは、プラットフォームによって異なります。詳細については、以下のトラブルシューティングガイドをご覧ください。

API にリクエストを送信してエラーレスポンスを受け取った場合は、レスポンスエラーのトラブルシューティングでエラーのトラブルシューティング方法を確認してください。

Endpoints と ESP を使用するには、少なくとも次の Google サービスの有効化が必要です。

名前	タイトル
`servicemanagement.googleapis.com`	Service Management API
`servicecontrol.googleapis.com`	Service Control API

ほとんどの場合、gcloud endpoints services deploy コマンドによってこれらの必須サービスが有効化されます。ただし、以下の状況では、gcloud コマンドは正常に完了しますが、必須サービスが有効になりません。

必要なサービスが有効になっていることを確認するには、次のコマンドを実行します。

gcloud services list

必要なサービスが表示されない場合は、次のコマンドを使用してサービスを有効にします。

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com

Endpoints サービスも有効にします。

gcloud services enable ENDPOINTS_SERVICE_NAME

ENDPOINTS_SERVICE_NAME を確認するには、次のいずれかを行います。

Endpoints 構成をデプロイ後、Cloud コンソールの [Endpoints] ページに移動します。[サービス名] 列に、考えられる ENDPOINTS_SERVICE_NAME のリストが表示されます。
OpenAPI の場合、ENDPOINTS_SERVICE_NAME は OpenAPI 仕様の host フィールドで指定したものです。gRPC の場合、ENDPOINTS_SERVICE_NAME は gRPC Endpoints 構成の name フィールドで指定したものです。

gcloud コマンドの詳細については、gcloud サービスをご覧ください。

Extensible Service Proxy を実行するインスタンスには、Service ManagementとServiceControlを呼び出す権限が必要です。

詳細レベルをデバッグに指定して Google Cloud CLI を実行すると、デバッグに役立ちます。

gcloud --verbosity=debug COMMAND

このコマンドにより、Google Cloud CLI でエラーの詳細なログが出力されます。実行するコマンドによっては、サーバーからのリクエストとレスポンス情報が出力に含まれる場合があります。

gcloud を使用してサービスの状態を確認します。

gcloud services list

特定のサービスの構成を表示するには、次のコマンドを使用します。

gcloud endpoints services describe SERVICE_NAME

OpenAPI ドキュメントに、OAuth 定義が設定されている security セクションがあるかどうか確認してください。サンプルの仕様ファイルは、GitHub のスタートガイドのサンプルで入手できます。