配额错误问题排查

您可能会由于多种原因而收到配额错误,例如超出配额值或未正确设置配额项目。如果您希望在将来出现错误时收到提醒,则可以针对特定配额错误创建自定义提醒,如设置配额提醒中所述。

超出速率配额

速率配额会在特定于每个服务的预定义时间间隔后重置。如需了解详情,请参阅特定服务的配额文档。

超出配额值

如果您的项目在使用服务时超过了其最大配额值,Google Cloud 会根据您访问该服务的方式返回错误:

  • 如果在发出 API 请求时超出了配额值,Google Cloud 会返回 HTTP 413 REQUEST ENTITY TOO LARGE 状态代码。请注意,在生产环境中使用 BigQuery 旧版流式插入 API 时,如果 HTTP 请求大于 10 MB,则您可能会收到 413 REQUEST ENTITY TOO LARGE 状态代码。如果每秒超过 300 MB,也可能收到此错误。如需了解详情,请参阅流式插入
  • 如果在发出 HTTP/REST 请求时超出了配额值,Google Cloud 会返回 HTTP 429 TOO MANY REQUESTS 状态代码。
  • 如果超过了 Compute Engine 的配额,Google Cloud 通常会返回 HTTP 403 QUOTA_EXCEEDED 状态代码,无论它是来自 API、HTTP/REST 还是来自 gRPC。如果配额是速率配额,则返回 403 RATE_LIMIT_EXCEEDED
  • 如果在使用 gRPC 时超出配额值,Google Cloud 会返回 ResourceExhausted 错误。此错误的显示方式取决于该服务。
  • 如果在使用 Google Cloud CLI 命令时超出配额值,gcloud CLI 会输出“已超出配额”错误消息并返回退出代码 1
  • 如果您在服务发布期间收到 QUOTA_EXCEEDED 消息,请参阅以下部分。

在服务发布期间超出配额值

Google Cloud 有时会更改资源和 API 的默认配额值。这些更改逐步进行,这意味着在发布新的默认配额期间,Google Cloud 控制台中显示的配额值可能无法反映您可以使用的新配额值。

如果配额发布正在进行,您可能会收到一条错误消息,其内容为 The future limit is the new default quota that will be available after a service rollout completes.。如果您看到此错误消息,则表示引用的配额值和未来值正确无误,即使出现在 Google Cloud 控制台中的内容有所不同。

  • 如需了解详情,请查看审核日志并查找 QUOTA_EXCEEDED 消息。

        "status": {
          ...
          "message": "QUOTA_EXCEEDED",
          "details": [
            {
              ...
              "value": {
                "quotaExceeded": {
                  ...
                  "futureLimit": FUTUREVALUE
                }
              }
            }
          ]
        },
    
  • 如需查看显示当前用量和峰值用量的图表,请在 Google Cloud 控制台中点击监控监控图标。您可能需要一直向右滚动,直到看到此图标。

  • 如果您需要的配额超出您有权使用的配额,并且无法等到服务发布完成,请申请配额调整

API 错误消息

如果配额项目(也称为结算项目)未正确设置,API 请求可能会返回以下错误消息:

  • user credentials not supported by this API
  • API not enabled in the project
    • no quota project set

这些错误和其他错误通常可以通过设置配额项目来解决。如需了解详情,请参阅配额项目概览