本页面包含了各版以下 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错误到客户端。此类错误通常意味着托管式服务中存在问题。
“服务未启用”错误是什么意思?
如需使用任何 Google API 服务,您需要有一个 Google Cloud 项目,为该项目启用服务,并为每个 API 请求传递与该项目关联的 API 密钥或 OAuth 访问令牌。如需了解详情,请参阅身份验证指南。如需解决此错误,您需要使用 Google Cloud 控制台、Google Cloud CLI 或 Service Usage API 为项目启用该服务。如需了解如何启用服务,请参阅启用和停用服务。
如何修复权限遭拒错误?
此类错误通常意味着调用者没有适当的 Identity and Access Management 权限。如需了解以下每个 Service Infrastructure API 所需的权限,请参阅相应的“访问权限控制”页面:
如何在 API 错误时执行重试?
建议以指数间隔随机执行重试。
如果是 429 配额错误,最小重试间隔应为 30 秒;500 和 503 服务器错误为 1 秒。 如果是其他错误,只有其他错误信息要求时才应执行重试。如需了解详情,请参阅 google.rpc.Code。
如何请求更高的 API 配额?
如要了解如何为以下每个 Service Infrastructure API 申请更高的配额,请访问配额和限制页面的相应部分: