问题排查

本页面包含了各版以下 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 秒;500503 服务器错误为 1 秒。 如果是其他错误,只有其他错误信息要求时才应执行重试。如需了解详情,请参阅 google.rpc.Code

如何请求更高的 API 配额?

如要了解如何为以下每个 Service Infrastructure API 申请更高的配额,请访问配额和限制页面的相应部分:

如何修复“域名所有权无法验证”错误?

此错误表示调用者对用于托管式服务名称(在服务配置中指定)的域名不具备所有权。 请按照相应指南使用有效网域。