本页面包含了各版以下 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 申请更高的配额,请访问配额和限制页面的相应部分:
如何修复“域名所有权无法验证”错误?
此错误表示调用者对用于托管式服务名称(在服务配置中指定)的域名不具备所有权。 请按照相应指南使用有效网域。