使用配额

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

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

如需了解如何查看其他 API 使用量指标，请参阅监控 API 使用量。

亲自尝试

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

免费开始使用

配额简介

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

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

实施配额的目的有多种，其中包括：

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

配额类型

配额分为两类：

  • 速率配额通常用于限制您可以对 API 或服务发出的请求数。速率配额会在特定于服务的时间间隔（例如每天的 API 请求数）之后重置。
  • 分配配额用于限制对没有使用速率的资源（例如，您的项目在给定时间使用的虚拟机数量）的使用。分配配额不会随着时间的推移而重置，而是必须由您在不想再使用（例如，删除 GKE 集群）时明确释放资源。

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

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

查看配额信息

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

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

了解配额限制

虽然许多服务对某些资源设有默认配额，但适用于您的应用的一组配额限制专用于您、您的项目或您的组织。例如，如果您使用免费试用帐号探索平台，则某些资源的配额可能非常低，甚至低于结算帐号的最低配额。为项目启用结算功能可增加大多数服务的配额。随着您的 Google Cloud 使用量逐步增加，您的配额可能会相应地增加。

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

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

最后，少数配额无法在其默认值的基础上增加，例如，在使用量较高构成反模式或资源非常有限的情况。这些情况通常记录在相关服务的“配额和限制”页面中，如 Cloud Functions 中的本示例所示。

配额即将用尽

在大多数情况下，如果尝试执行的任务（例如部署应用、创建新项目或调用 API）的配额即将用尽，则会出现失败并返回配额错误。在您释放资源（对于分配配额）、时间段重置（对于速率配额）或申请并被授予增加配额之前，任务将持续失败。

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

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

配额增加申请简介

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

部分配额增加可能需要提前付费。例如，如果您申请更多使用付费云服务的项目，则可能需要支付费用。该付款可应用于您未来产生的任何费用，并将在帐号中显示为赠金。

配额增加申请由处理申请的 Cloud Customer Care（而非结算功能）处理，通常会在 2-3 个工作日内得到处理。我们会在收到申请后向您发送电子邮件，您可以在遇到问题或想要提供关于申请的其他信息（例如，如果您的增加申请为紧急申请）时使用该邮件进行回复。然后，您会在申请处理后收到另一封电子邮件，通知您配额增加是否获得批准。该电子邮件会提供提升的有效日期（如果适用）。

如需详细了解如何申请更多配额，请参阅申请更高配额限制。

权限

查看项目配额的权限

如需在 Google Cloud Console 中查看项目配额或以编程方式访问项目配额，您必须拥有以下 IAM 权限：

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

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

更改项目配额的权限

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

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

在 Cloud Console 中查看配额

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

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

查看项目的所有配额

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

  1. 在 Google Cloud Console 中，转到配额页面。

    转到“配额”

    列表会按行列出每项服务中提供的每种配额类型的资源项。

  2. 对结果进行排序和过滤，以便重点查看所需信息：

    • 如需查看特定属性，请点击 过滤表。
    • 如需按字母顺序对列表进行排序，请将鼠标指针悬停在服务、限制名称、配额状态或详情标题上。
    • 默认情况下，列表会将您用量最高的配额（根据过去七天的峰值用量）显示在最前面，便于您发现哪些资源用量有超出限制的风险。若要将用量最少的配额排在最前，请切换配额状态箭头。
    • 如需详细了解特定配额的当前用量，请在详细信息列中点击所有配额。

配额页面上列出的配额用量指标的计算方式如下：

  • 速率配额：
    • 对于每日速率配额，列出的数字表示当前 24 小时时间段到目前为止的总用量。
    • 对于每分钟或每 100 秒配额，列出的数字表示过去 24 小时内的平均使用量。
  • 分配配额：列出的数字表示项目当前正在使用的资源数量（例如负载平衡器数量）。

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

查看 API 特定配额

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

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

  • Cloud Console 配额页面，如查看所有项目配额部分所述。

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

    某些配额不会显示在 API 特定的配额页面中。例如，对 Compute Engine API 的请求有 API 特定的配额页面，但该页面中不包含 Compute Engine 计算资源用量（分配配额）。此外，如果您在多个位置使用某个服务，则 API 特定的配额页面不会显示区域或可用区配额限制及其用量。如需查看可以按位置过滤的项目配额用量的完整列表，请参阅项目配额页面。

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

每个用户帐号（包括服务帐号）和结算帐号可以创建的项目数量都有所限制。如果配额中的剩余项目少于 30 个，新建项目页面上将出现一条通知，显示配额中剩余的项目数量。如需详细了解如何管理此配额，请参阅管理项目配额和项目配额申请。

使用 Cloud Console 管理配额

根据您的资源用量，您可能需要上下调整项目的配额限制。本部分介绍如何更改提供的配额限制。如需查看配额限制，请在详细信息列中点击所有配额。

过滤配额

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

  1. 转到 Google Cloud Console 中的配额页面：

    转到“配额”

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

申请更高配额限制

对于大部分配额而言，您都可以直接在 Google Cloud Console 中申请增加配额。您可能会遇到以下某种异常情况：

  • 在某些情况下，Google Cloud Console 会将您重定向至单独表单，以申请增加限制。提交申请表后，Google Cloud 会通过电子邮件确认您的申请。
  • 有些配额无法使用 Google Cloud Console 进行更新。如果您发现无法在控制台中更改配额，请通过 Cloud Customer Care 申请增加配额。结算团队不会处理配额上限增加的情况。

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

如需通过 Google Cloud Console 申请提高配额上限，请执行以下操作：

  1. 转到配额页面：

    转到“配额”

  2. 选择要更改的配额，如下所示：

    1. 在要更改的配额对应的行中，点击所有配额。在配额面板中，点击全局复选框。
    2. 您也可以点击 警告（如果它显示在配额状态列中）。在配额面板中，点击要更改的配额旁边的复选框。

  3. 在主配额页面上，点击 修改配额。

  4. 填写右侧显示的申请表，如下所示：

    1. 在新上限字段中，输入您申请的提升配额。
    2. 在申请说明字段中，输入申请的原因。建议您说明未来的发展计划、区域或地区扩展以及其他要求或依赖事项。
    3. 点击下一步。
    4. 在详细联系信息面板的电话字段中输入您的电话号码。
    5. 点击完成。

  5. 点击提交申请。

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

限制用量

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

  1. 在 Google Cloud Console 中，转到配额页面。

    转到“配额”

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

  3. 点击全部配额，找到您要设置上限的用量。

  4. 点击对应的复选框以选中要修改的属性。

  5. 点击修改配额。

  6. 填写申请表。

  7. 输入修改后的配额限制，并视情况输入说明。

  8. 点击完成。

  9. 点击提交申请。

如果您要为未显示在此页面上的配额设置上限，或者要设置为高于提供的上限，请按照申请更高配额中所述修改限制。

使用 gcloud 命令行工具管理配额（Alpha 版）

您可以使用 gcloud 命令行工具获取某些 Google Cloud API 和服务的当前配额和配额限制项目级层、文件夹级层和组织级层配额。

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

如需查看特定服务的项目配额，请运行以下命令，并替换为您的项目 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 命令和标志的完整列表，请参阅 Cloud SDK 参考文档。

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

使用 Service Usage API 管理配额

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

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

与配额指标有关的监控和提醒功能

Cloud Monitoring API 和界面可让您更深入地监控配额用量、限制和错误。您可以使用这些指标创建自定义信息中心和提醒，以便监控一段时间内的配额用量，并在接近配额限制等情况下收到提醒。

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

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

  1. 在 Google Cloud Console 中，转到 Monitoring 页面。

    转至 Resources

  2. 在 Monitoring 导航窗格中，点击 Metrics Explorer。
  3. 确保所选标签页为指标。
  4. 在查找资源类型和指标字段中，从菜单中选择或者输入资源和指标的名称。在各字段中填写以下信息：
    1. 对于资源，选择或输入使用者配额。
    2. 对于指标，选择或输入分配配额用量或速率配额用量，具体取决于需要监控的配额类型。
  5. 如需修改数据的显示方式，请使用过滤条件、分组依据和聚合器菜单。例如，您可以按资源或指标标签进行分组。如需了解详情，请参阅选择指标。

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

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

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

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

检查配额指标支持

并非所有服务都支持 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 错误。此错误的显示方式取决于该服务。
  • 如果在使用 gcloud 命令行工具命令时超出配额，gcloud 命令行工具会输出超出配额错误消息并返回退出代码 1。

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

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