このページには、以下の Service Infrastructure API の各バージョンに関するトラブルシューティング情報が記載されています。
Service Management API
Service Control API
Service Consumer Management API
Service Control API のエラーを処理するにはどうすればよいですか?
Service Control API により、ロギング、モニタリングなどのコントロール プレーン機能をマネージド サービスで使用できるようになります。したがって、Service Control API の呼び出しはサーバー アプリケーションで行うのが通例です。REST/RPC API レベルでエラーを処理する方法に関する一般的な推奨事項は次のとおりです。
サーバーは Service Control API により返されたすべてのエラーを記録する必要があります。そのデータはマネージド サービスのトラブルシューティングに利用できます。
サーバーに対して Service Control API から 429 エラーが返された場合、その 429 エラーをサーバーからクライアントに返す必要があります。
サーバーから Service Control API にアクセスできない場合、フェイルオープン(エラーを無視する)またはフェイルクローズ(503 をクライアントに返す)のいずれかを選択できます。
サーバーに対して Service Control API から 500 エラーが返された場合、その 500 エラーをサーバーからクライアントに返す必要があります。このようなエラーは、一般に Service Control API にバグがあることを意味します。
サーバーに対して Service Control API からその他のエラーが返された場合、500 エラーをサーバーからクライアントに返す必要があります。このようなエラーは、一般にマネージド サービスにバグがあることを意味します。
「service not enabled」というエラーは何を意味しますか?
Google API サービスを使用するには、Google デベロッパー プロジェクトが存在し、そのプロジェクトに対してサービスを有効にし、そのプロジェクトに関連付けられている API キーまたは OAuth アクセス トークンを渡す必要があります。詳細については、Auth ガイドをご覧ください。このエラーを修正するには、Google Cloud Platform Console、Google Cloud CLI、Service Usage API のいずれかを使用して、プロジェクトに対してサービスを有効にする必要があります。サービスを有効にする方法については、サービスの有効化と無効化を参照してください。
権限拒否エラーを修正するにはどうすればよいですか?
このようなエラーは、一般に呼び出し元が特定のリソースに対する適切な Identity and Access Management 権限を持っていないことを意味します。次の各 Service Infrastructure API に必要な権限と役割の詳細については、該当するアクセス制御のページを参照してください。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-04-21 UTC。"],[],[],null,["# Troubleshooting\n\nThis page contains troubleshooting information for each version of the following\nService Infrastructure APIs:\n\n- The Service Management API\n- The Service Control API\n- The Service Consumer Management API\n\n| **Note:** For Service Infrastructure troubleshooting information for the Service Usage API, see [Troubleshooting](/service-usage/docs/troubleshooting).\n\n### How do I handle Service Control API errors in general?\n\nThe Service Control API provides control plane functionality, such as\nlogging, monitoring, to managed services. Therefore, the callers of the\nService Control API typically are server applications. Here are general\nrecommendations on how to handle errors at the REST/RPC API level:\n\n- Your server should log all errors returned by the Service Control API and you can use the data to toubleshoot your [managed service](/service-infrastructure/docs/glossary#managed).\n- If your server receives `429` errors from the Service Control API, it should return `429` errors to its clients.\n- If your server cannot access the Service Control API, it can choose to either fail-open (ignore the error) or fail-close (return `503` to its client).\n- If your server receives `500` errors from the Service Control API, it should return `500` error to its clients. Such errors typically mean bugs within the Service Control API.\n- If your server receives other errors from the Service Control API, it should return `500` error to its clients. Such errors typically mean bugs within your managed service.\n\n### What does the \"service not enabled\" error mean?\n\nTo use any Google API service, you need to have a Google Cloud project,\nenable the service for that project, and pass an API key or an OAuth access\ntoken associated with the project for each API request. See\n[Auth Guide](/docs/authentication) for details. To fix this error, you need\nto enable the service for your project using the Google Cloud console,\nGoogle Cloud CLI, or Service Usage API. To learn how to enable a service, see\n[Enabling and Disabling Services](/service-usage/docs/enable-disable).\n\n### How do I fix permission denied errors?\n\nSuch errors typically mean the caller doesn't have the right\n[Identity and Access Management](/iam) permission on certain resources. For information on the\nrequired permissions for each of the following Service Infrastructure APIs, see the\nrespective Access Control page:\n\n- [Service Control API Access Control](/service-infrastructure/docs/service-control/access-control)\n- [Service Management API Access Control](/service-infrastructure/docs/service-management/access-control)\n\n### How do I perform a retry on API errors?\n\nIt is recommended to perform a retry with exponential intervals plus randomness.\nThe minimum retry interval should be 30s for `429` quota errors; 1s for `500`\nand `503` server errors. For other errors, retry should only be performed based\non additional error information. See\n[`google.rpc.Code`](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto)\nfor more details.\n\n### How do I request higher API quota?\n\nTo learn how to apply for higher quota for each of the following\nService Infrastructure APIs, visit the respective section of the\n[Quotas and Limits](/service-infrastructure/docs/quotas) page:\n\n- [Service Control API Quota](/service-infrastructure/docs/quotas#control)\n- [Service Consumer Management API Quota](/service-infrastructure/docs/quotas#consumer)\n- [Service Management API Quota](/service-infrastructure/docs/quotas#management)\n\n### How do I fix \"Ownership for domain name cannot be verified\" errors?\n\nThis error indicates the caller does not have the ownership of the domain\nname used for the [managed service](/service-infrastructure/docs/glossary#managed) name\nspecified in a\n[service configuration](/service-infrastructure/docs/service-management/reference/rpc/google.api#google.api.Service).\nFollow the [guide](/endpoints/docs/custom-domain) to use a valid domain."]]