使用配额

Google Cloud 使用配额来限制您可以使用的特定共享 Google Cloud 资源的数量。每个配额代表一个特定的可数资源。例如：对特定服务的 API 调用次数、您的项目并发使用的负载均衡器数量或者您可以创建的项目数量。

本页面介绍如何在项目中使用配额。其中包括如何查找和修改现有配额上限、如何申请更高的配额以及如何监控配额用量。

许多服务还具有与配额系统无关的限制。限制（例如文件大小上限或数据库架构限制）是固定限制，无法增加或减少限制。您可以在服务的相关“配额和限制”页面上查看限制（例如 Cloud Storage 配额和限制）。

以下链接提供了有关资源使用情况的其他信息：

• 如需了解资源价格，请参阅相关服务的价格页面（例如 Cloud Storage 价格）。
• 如需了解其他 API 用量指标，请参阅 Monitoring API 用量。

自行试用

如果您是 Google Cloud 新手，请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

免费开始使用

配额简介

在了解如何监控和管理您的配额之前，有必要先了解 Google Cloud 配额系统工作原理的基础知识。本部分介绍一些关键配额概念：配额类型、配额限制和配额增加请求。

我们为何要强制执行配额？

实施配额的原因有很多，包括：

• 配额可保护 Google Cloud 用户群体，避免出现不可预见的用量激增和服务过载。
• 帮助您管理资源。例如，开发和测试应用时，您可以设置自己的服务用量限额，以避免使用昂贵的资源而产生意外的费用。

配额类型

Google Cloud 配额分为三类：

• 速率配额通常用于限制您可以对 API 或服务发出的请求数。速率配额会在特定于服务的时间间隔（例如每天的 API 请求数）之后重置。
• 分配配额用于限制没有使用率的资源的使用。例如，在给定时间项目使用的虚拟机数量。分配配额不会在一段时间后重置。相反，当您不再需要使用它们时，必须明确释放它们，例如删除 GKE 集群。
• 并发配额用于限制任意时间点处于运行状态的并发操作总数。这些操作通常是长时间运行的操作。例如，Compute Engine 运行的 insert_operations 操作预计会持续一小时。

在这些类别中，一些配额是全球性的，适用于您在 Google Cloud 中的任何位置使用资源的情况。其他配额为区域级或可用区级的，适用于在特定 Google Cloud 区域（两种配额类型）或可用区（仅限分配配额）中使用资源的情况。例如，您可以在每个 Google Cloud 区域中创建的 Compute Engine 虚拟机实例数量有单独的限制。

配额按项目强制执行，但您可以创建的项目数除外，每个用户帐号和结算帐号均会强制执行此配额。

查看配额信息

您可以通过多种方式查看和管理您的 Google Cloud 配额：

• 在 Google Cloud 控制台中
• 使用 Google Cloud CLI
• 使用 Service Usage API
• 作为 Cloud Monitoring 中的配额指标

您可以在本文档的其余部分中查看有关如何使用这些方法的详细信息。每个产品或服务也有自己的配额和限制页面，其中包含有关该服务配额的特定信息。例如，“GKE 配额和限制”页面。

了解配额限制

适用于您的应用的一组配额限制专用于您、您的项目或您的组织。例如，如果您使用的是免费试用帐号，则某些资源的配额可能比结算帐号低。为项目启用结算功能可增加大多数服务的配额。随着您的 Google Cloud 使用量逐步增加，您的配额可能会相应地增加。

如果您的项目需要的特定资源超出了配额所允许的数量，您可以针对特定服务申请更多配额。如需详细了解配额增加申请的工作原理，请参阅配额增加申请简介。 如果您想强制执行支出限额，则可以为特定配额添加您自己的限额。在开发或测试使用昂贵资源的应用时，可以使用此工具。

特定用户的某些配额不受限制。在这种情况下，您可以根据需要使用任意数量的该资源。

最后，少数配额无法在其默认值的基础上增加。例如，当使用率较高但适得其反或资源非常有限时。这些限制通常记录在该服务的相关配额和限制页面中，如 Cloud Functions 中的本示例所示。

配额用尽时

通常，如果配额用尽，您尝试执行的任务会失败，并且您会收到配额错误。抛出此错误的任务可能包括部署应用、创建新项目或调用 API。之后，该任务将持续失败，直到您释放资源（对于分配配额）、时间段重置（对于速率配额）或增加配额。

配额错误的显示方式取决于您与 Google Cloud 进行交互所用的工具或客户端。您可以在配额错误中查看配额错误的详细信息。

通过设置监控，以便在接近配额上限时收到提醒，您可以避免配额错误。如需详细了解如何监控配额，请参阅本文档后面的监控配额指标并发出提醒。

配额增加申请简介

大多数配额增加请求由自动化系统评估。它们的决定取决于严格的标准，包括资源可用性、您使用 Google Cloud 的时长以及其他因素。不符合特定条件的申请会被拒绝。为了确保对所有客户都公平，以及防止企图操纵流程，我们不会披露自动审核的评估标准。有时，配额增加申请会上报给人工审核者，审核者也会遵循严格的标准，但会考虑您的具体情况。

您可能需要提前支付一些增加配额的费用。例如，如果您请求使用更多项目来使用付费的云服务，则系统可能会要求您付款。付款可应用于您未来产生的任何费用，并将在帐号中显示为余额。

如需了解如何申请更多配额，请参阅申请更高配额限制。您无需拥有付费 Customer Care 服务即可申请增加配额。配额增加请求通常会在 2-3 个工作日内完成。我们会在收到申请后向您发送电子邮件，您可以回复该邮件。如果您有疑问或想要提供关于请求的其他信息（例如，如果您的增加请求为紧急请求），请使用此功能。然后，您会在申请处理后收到另一封电子邮件，通知您配额增加是否获得批准。该电子邮件会提供提升的有效日期（如果适用）。

权限

查看项目配额的权限

如需在 Google Cloud 控制台中查看项目配额或以编程方式访问项目配额，您必须拥有以下 Identity and Access Management (IAM) 权限：

• resourcemanager.projects.get
• resourcemanager.folders.get（如果您想查看整个文件夹的配额）
• resourcemanager.organizations.get（如果您想查看整个组织的配额）
• monitoring.timeSeries.list
• serviceusage.services.list
• serviceusage.quotas.get

如需了解默认情况下哪些角色具备这些权限，请参阅 IAM 权限参考文档。

更改项目配额的权限

如需在项目、文件夹或组织级层更改配额，您必须具有以下权限：

• serviceusage.quotas.update

默认情况下，以下角色包含此权限：Owner、Editor、Quota Administrator 和 Service Usage Admin。

查看增加配额请求的权限

如需在 Google Cloud 控制台中查看增加配额请求，您必须拥有以下 IAM 权限：

• resourcemanager.projects.get
• serviceusage.services.list
• serviceusage.quotas.get

创建有关配额的提醒政策的权限

如需创建有关配额的提醒政策，您必须拥有以下权限：

• monitoring.alertPolicies.create

在 Google Cloud 控制台中查看配额

您可以在 Google Cloud 控制台的两个不同区域查看当前配额限制：

• 配额页面，其中列出了项目的所有配额用量和限制
• Google Cloud 控制台 API 信息中心，其中列出了特定 API 的配额信息，包括随时间变化的资源用量

查看项目的配额

如需查看项目中所有资源的配额用量和限制，请按以下步骤操作：

1. 在 Google Cloud 控制台中，转到配额页面。

   转到配额
   其余步骤将自动显示在 Google Cloud 控制台中。

2. 如需重点查看您需要的信息，可以按如下方式过滤和排序列表：

   • 要过滤列表，请在 过滤条件字段中输入所需的属性和值。例如，如需查看 BigQuery API 配额，请选择服务，然后选择 BigQuery API。

   • 如需对列表进行排序，请点击要作为排序依据的列的标题。例如，要按配额名称的字母顺序进行排序，请点击配额列标题。

     默认情况下，列表会将您用量最高的配额显示在最前面，便于您发现哪些资源用量有超出限制的风险。

配额页面会显示一个包含可配置列的表。服务列和配额列提供有关所描述配额的常规信息。例如，服务可能是 Cloud Logging API，而配额可能是每分钟的日志提取请求数。配额字段还描述了配额的评估方式。速率配额按每分钟、每 100 秒或每天进行评估。不含上述任何陈述的配额是分配配额。

您可以使用指标、限制名称和受监控的资源列找到有关配额的其他信息。这些列提供了绘制配额图表所需的详细信息。

如需了解配额用量，请查看当前用量和 7 天峰值用量列。这些字段中显示的值的计算方法如下：

• 对于每分钟费率配额：

  • 当前用量是过去 10 分钟内的总用量。
  • 7 天峰值用量是过去 7 天以 1 小时为间隔计算的平均峰值用量。

• 对于每 100 秒速率配额：

  • 当前用量是过去 10 分钟内的总用量。
  • 7 天峰值用量是过去 7 天以 1 小时为间隔计算的总用量峰值。

• 对于每日速率配额：

  • 当前用量是当前 24 小时时段内到目前为止的总用量（按每日速率配额计算）。
  • 7 天峰值用量是过去 7 天以 1 天为间隔计算的总用量峰值。

• 对于分配配额：

  • 当前用量是最新值。例如，此数字可能会显示项目中当前使用的负载均衡器数量。
  • 7 天峰值用量是最大用量的估算值。通过将前 7 天的数据拆分为 1 小时间隔，从每个间隔中选择具有最新时间戳的数据点，然后选择该集合中的最大值来计算估计值。由于峰值用量的估算方式，该字段的值可能会低估实际峰值用量。

• 对于并发配额：

  • 当前用量是最新值。例如，此数字可能会显示给定服务中处于运行状态的 insert_operations 操作的数量。
  • 7 天峰值用量是最大用量的估算值。通过将前 7 天的数据拆分为 1 小时间隔，从每个间隔中选择具有最新时间戳的数据点，然后选择该集合中的最大值来计算估计值。由于峰值用量的估算方式，该字段的值可能会低估实际峰值用量。

如需详细了解特定服务的配额，请参阅该服务的相应文档。例如，资源配额中介绍了 Compute Engine 配额。

查看 API 特定配额

如需查看特定 API 的详细配额信息（包括一段时间内的用量），请访问 Google Cloud 控制台中的 API 配额页面。根据 API 的不同，这些限制可能包括“每天请求数”“每分钟请求数”和“每个用户每分钟请求数”。在为项目启用结算功能之前，某些 API 设置的限制非常低。

您可以在 Google Cloud 控制台的两个不同区域中查看特定 API 的当前限制：

• Google Cloud 控制台配额页面，如查看所有项目配额部分所述。

• Google Cloud 控制台 API 和服务信息中心页面。在此页面上，选择您的项目，点击 API 名称，然后点击配额。配额页面会显示 API 的配额名称。您可以点击每个配额的 显示用量图表，以查看随时间变化的详细用量。默认情况下，显示的限制是由 Google 施加的。您可以按照限制用量部分中的说明为使用量设置上限。如果 Google 没有对给定配额施加限制，则限制会显示为无限制。

查看您可以创建的项目数量

每个用户帐号（包括服务帐号）和结算帐号都有创建限额。如果您配额中剩余的项目数量不到 30 个，新建项目页面会显示一条通知，其中说明您配额中剩余的项目数量。如需详细了解如何管理此配额，请参阅管理项目配额和项目配额申请。

使用 Google Cloud 控制台管理配额

如果项目增加或减少，您可能需要调整配额限制，具体取决于您的资源使用情况。本部分介绍如何更改提供的配额限制。如需查看配额限制，请在详细信息列中点击所有配额。

过滤配额

如需按特定属性过滤配额列表，请执行以下操作：

1. 转到 Google Cloud 控制台中的配额页面。

   转到“配额”

2. 点击 过滤条件，按特定属性查询配额。

申请更高的配额限制

如需使用 Google Cloud 控制台申请提高配额上限，请执行以下操作：

1. 转到配额页面：

   转到配额
   其余步骤将自动显示在 Google Cloud 控制台中。

2. 在配额页面上的配额列中，找到要增加的配额。

   您可以使用过滤条件搜索框来搜索所需配额。

3. 选中配额左侧的复选框。

4. 点击 修改配额。此时将显示配额更改表单。

5. 在配额更改表单中，在新限制字段中输入项目所需增加的配额。

6. 填写表单中的任何其他字段，然后点击完成。

7. 点击提交请求。

虽然上述过程适用于大多数配额提升请求，但可能会遇到以下异常之一：

• 如果存在用量上限，则必须先移除用量上限，然后才能增加配额。系统会向您显示披露信息和协议。该披露信息指出用量上限将被删除，并且限额将立即更新为默认限额。然后，Google Cloud 将正常处理您的配额增加申请。
• 有时，Google Cloud 控制台会将您重定向至单独表单，以申请增加限额。提交申请表后，Google Cloud 会通过电子邮件确认您的申请。
• 有些配额无法使用 Google Cloud 控制台进行更新。如果您发现无法在控制台中更改配额，请通过 Cloud Customer Care 申请增加配额。结算团队不会处理配额上限增加的情况。

如果您的配额提升请求需要批准，则您可能需要收到来自 Google Cloud 的电子邮件，以确认收到您的请求。如果需要进一步的帮助，您可以回复该电子邮件。Cloud Customer Care 通常会在 2-3 个工作日内处理您的申请。然后，Cloud Customer Care 会向您发送电子邮件，告知您配额提升是否获得批准。该电子邮件会提供提升的有效日期（如果适用）。

如需详细了解配额增加流程的工作原理，请参阅配额增加申请简介。

查看配额增加请求

您可以在 Google Cloud 控制台中查看当前待处理和过去的配额增加请求。

如需查看待处理的配额增加请求，请执行以下操作：

1. 确保您拥有查看增加配额请求的权限。

2. 转到配额页面：

   转到“配额”

3. 在配额页面上， 待处理显示在当前正在等待有关先前提交的增加请求的决策的配额限制旁边。您可以点击 待处理来查看待处理请求的详细信息。

新的配额增加请求即将提交时，待处理的请求也会显示在配额更改表单中。

如需查看所有配额增加请求（当前待处理和过去的请求），请执行以下操作：

1. 转到配额页面：

   转到“配额”

2. 点击增加请求标签页

3. 点击 过滤，按特定属性查询配额增加请求。

选择组织或文件夹后，该页面会显示组织或文件夹内所有项目的全部配额增加请求。

上限用量

您可能希望通过设置自己的配额限制来限制特定资源的用量。例如，为了防止超出免费用量限额而产生费用，您可以请求每日上限。

如需为配额设置上限，请按照与申请提高配额上限相同的步骤进行操作。

使用配额限制用量并不适用于所有服务。如需了解详情，请查看服务的特定配额页面。

注意：用量上限有时称为使用方替换值。

使用 Google Cloud CLI 管理配额（Alpha 版）

您可以使用 Google Cloud CLI 获取当前配额并限制某些 Google Cloud API 和服务的用量，包括项目级、文件夹级和组织级配额（如有）。

如需使用此方法，请先确保您已安装并初始化最新版本的 Google Cloud CLI，包括 Alpha 版命令组件。如果您使用 Cloud Shell 与 Google Cloud 进行交互，则系统会为您安装 Google Cloud CLI。

如需查看特定服务的配额，请运行以下命令，并替换为您的项目 ID 和服务名称：

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=projects/PROJECT_ID

如需查看组织的同一服务的配额详细信息，请执行以下操作：

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=organizations/ORG_ID

如需查看 gcloud quota 命令和标志的完整列表，请参阅 Google Cloud CLI 参考文档。

除了 gcloud quota 之外，某些服务还可以通过自己的命令行访问配额和资源用量信息。例如，Compute Engine 允许您使用 gcloud compute 命令访问配额信息。

使用 Service Usage API 管理配额

您可以使用 Service Usage API 来获取当前配额并限制某些 Google Cloud API 和服务的配额用量。如需详细了解 Service Usage，请参阅以下内容：

• 如需查看概览，请参阅什么是 Service Usage？
• 如需查看 API 参考文档，请参阅 API 与参考文档。
• 如需查看用量指南，请参阅方法指南。

您无法使用 Service Usage API 来申请更高的配额，而必须使用 Google Cloud 控制台进行申请。

监控配额指标并发出提醒

在“配额”页面中设置配额用量提醒

您可以在配额页面中设置配额提醒，以便在配额用量达到定义的阈值时收到通知。此功能目前仅支持项目级配额。

如需设置有关特定配额的提醒，请执行以下操作：

1. 确保您拥有创建提醒的权限

2. 进入配额页面：进入“配额”

3. 在配额页面的表的最后一列上，点击 按钮以打开操作菜单，然后点击创建配额提醒。

4. 选择配额用量模板，然后选择所需的通知渠道。

5. 点击创建政策

6. 可选：如果您要自定义默认提醒政策，请展开下拉列表，然后按照说明操作。

使用 Cloud Monitoring

Cloud Monitoring API 和控制台可让您更深入地监控配额用量、限制和错误。您可以使用这些指标创建自定义信息中心和提醒。您可以监控一段时间内的配额用量并接收提醒。例如，当您接近配额限制时。

Cloud Monitoring 支持多种不同的指标，您可以将这些指标与过滤器和聚合功能结合使用，从全新的角度深入了解配额使用情况。例如，您可以将分配配额用量指标与 Cloud TPU 名称上的 quota_metric 过滤器结合使用。

如需使用 Metrics Explorer 查看受监控资源的指标，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，转到 Monitoring 中的 Metrics Explorer 页面。

进入 Metrics Explorer

2. 选择 Configuration（配置）标签页。
3. 展开选择一个指标菜单，在过滤栏中输入 quota usage，然后使用子菜单选择特定的资源类型和指标：
   1. 在活跃资源 (Active resources) 菜单中，选择使用者配额 (Consumer Quota)。
   2. 在活跃指标类别 (Active metric categories) 菜单中，选择配额 (Quota)。
   3. 在活跃指标 (Active metrics) 菜单中，选择分配配额用量 (Allocation quota usage) 或速率配额用量 (Rate quota usage)。
   4. 点击应用。
4. 可选：如需配置数据的查看方式，请添加过滤条件并使用分组依据、聚合器和图表类型菜单。例如，您可以按资源或指标标签进行分组。如需了解详情，请参阅使用 Metrics Explorer 时选择指标。
5. 可选：更改图表设置：
   • 对于配额和每天报告一个样本的其他指标，请将时间范围设置为至少一周，并将绘制类型设置为堆积条形图。
   • 对于分布值指标，请将绘制类型设置为热图。

同样，如需查看配额上限或超出配额错误，请先选择 Consumer Quota 作为资源类型，然后选择 Quota limit 或 Quota exceeded error。

找到需要的配额用量信息后，您可以使用 Cloud Monitoring 创建自定义信息中心和提醒，以帮助您监控和维护稳健的应用。如需了解详情，请参阅以下文档：

• 构建图表
• 提醒简介
• 管理提醒政策

如需查看特定于常见配额的提醒政策示例，请参阅使用配额指标。

Cloud Monitoring 参考指南包含配额指标的详细参考文档。

注意：配额限制每天更新一次。对限制的更改最长可能需要 24 小时才能在 Google Cloud 控制台中更新。

检查配额指标支持

并非所有服务都支持 Cloud Monitoring 中的配额指标。如需查看受支持的服务的适用配额指标，请在构建图表或创建提醒政策时选择使用方配额 (Consumer Quota) 作为资源类型。不会显示不支持配额指标的服务。

• 支持配额指标的常用服务包括 Compute Engine、Dataflow、Cloud Spanner、Pub/Sub、Cloud Vision、Speech-to-Text、Cloud Monitoring 和 Cloud Logging。

• 不支持配额指标的常用服务包括 App Engine、Cloud Storage 和 Cloud SQL。

配额错误

如果您的项目在使用服务时超过了配额，Google Cloud 会根据您访问该服务的方式返回错误：

• 如果在发出 HTTP/REST 请求时超出了配额，Google Cloud 会返回 HTTP 429 TOO MANY REQUESTS 状态代码。
• 如果在发出 API 请求时超出了配额，Google Cloud 会返回 HTTP 413 REQUEST ENTITY TOO LARGE 状态代码。
• 如果在使用 gRPC 时超出配额，Google Cloud 会返回 ResourceExhausted 错误。此错误的显示方式取决于该服务。
• 如果在使用 Google Cloud CLI 命令时超出配额，gcloud CLI 会输出“已超出配额”错误消息并返回退出代码 1。

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

如果您希望在将来出现错误时收到提醒，则可以针对特定配额错误创建自定义提醒，如监控配额指标中所述。