配额错误问题排查

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

超出速率配额

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

超出配额值

如果您的项目在使用服务时超过了其最大配额值,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
                }
              }
            }
          ]
        },
    
  • 如需查看显示当前用量和峰值用量的图表,请前往配额和系统限制页面,然后点击 Monitoring。您可能需要转到表末尾。

  • 如果您需要更多配额,可以申请配额调整

API 错误消息

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

  • User credentials not supported by this API
  • API not enabled in the project
  • No quota project set

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

gcloud CLI 错误

如果您尚未设置配额项目,Google Cloud CLI (gcloud CLI) 命令可能会返回如下错误:

PERMISSION_DENIED: Your application is authenticating by using local Application Default Credentials.
The cloudquotas.googleapis.com API requires a quota project, which is not set by default.

如需解决此问题,请在 gcloud CLI 命令中添加 --billing-project 标志以明确设置配额项目,或重新运行 gcloud config set billing/quota_project CURRENT_PROJECT 以将配额项目设置为当前项目。

详情请参阅以下内容: