配额和限制

本页介绍了 API Gateway 的配额限制。

对 API、API 配置和网关的限制

API Gateway 对 API、API 配置和网关实施以下限制：

  • API 数 - 总共 50 个
  • API 配置数 - 每个 API 100 个
  • 网关数 - 每个区域 50 个

如果您尝试在同一 API 的第一个 API 配置创建完成之前创建第二个 API 配置，则其中一个或两个配置可能稍后无法在 Gateway 中使用。

请求速率限制

默认情况下，速率限制设为每个服务提供方项目每 100 秒 1000 万个配额单元。 以下每一项都计为 1 个配额单元：调用一次 services.check、services.report 报告一个操作。

载荷大小限制

以下限制仅适用于通过已部署网关的流量的载荷大小上限：

限额 数量
请求大小 32 MB
响应大小 32 MB
gRPC 转码响应大小 1 兆字节
gRPC 转码请求大小 1 兆字节

不支持流式传输。

标头大小限制

以下限制仅适用于通过已部署网关的流量的标头大小上限：

限制 金额
请求标头大小 60 千字节

API Gateway 调用的后端服务可能具有更低的限制。

如何增加配额

Cloud 配额调整请求需要经过审核。如果您的配额调整申请需要审核，您会收到一封电子邮件，确认已收到您的申请。如果您需要进一步的帮助，请回复该电子邮件。我们会在审核您的申请后向您发送电子邮件通知，告知您申请是否获得了批准。 您可以使用 Google Cloud 控制台、Cloud Quotas API 或 Google Cloud CLI 请求调整配额。以下说明介绍了如何使用 Google Cloud 控制台或通过向 Cloud Quotas API 发出 REST 请求来申请新的配额值。

控制台

如需申请调整配额，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，依次前往 IAM 和管理 > 配额和系统限制页面：

    进入“配额和系统限制”

    如果系统提示您选择项目，请选择要调整的项目。

  2. 找到要调整的配额，然后打开配额更改对话框：

    • 表格中未列出的配额：

      • 在过滤条件搜索框中搜索您的配额。请勿指定区域或时区（如适用），因为没有使用量或调整值的配额不会显示在表格中。
      • 在表格中找到您的配额对应的任何条目。可以是默认条目，也可以是任何具有历史记录的条目，无论区域或可用区如何。
      • 在相应条目的行中，依次点击 更多操作 > 配置其他区域/可用区。
      • 选择要调整的区域或可用区。点击修改。

    • 所有其他配额：

      • 在过滤条件搜索框中搜索您的配额。
      • 在相应条目的行中，选中您的配额对应的复选框。
      • 点击修改。

    此时将显示配额更改对话框。

  3. 如果您在新值字段上方看到申请更高配额的链接，并且想将配额值提高到超过屏幕上显示的数字，请点击该链接。填写表单，提交表单，然后跳过此处的其余步骤。否则，请继续按照本指南操作。

  4. 在新值字段中，输入所需的增加配额值。如果显示申请说明字段，请输入说明。 点击完成。

    • 如果您看到一个包含“我了解这项申请将移除所有替换设置”文本的复选框，则表示您的配额值低于默认值。如果将配额值调整到默认值或超出默认值，则会移除替换设置。 如需继续，请选中该复选框。详细了解配额覆盖。

    如果显示下一步按钮，请点击下一步，然后在随后显示的屏幕中填写您的联系人详细信息。

  5. 点击提交请求。

如果您发现无法在控制台中申请调整配额，请通过 Cloud Customer Care 申请增加配额。

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

批量申请配额调整

您可以通过选中要添加的每个配额对应的复选框来批量申请配额调整。不过，批量提交请求可能会增加 Google Cloud 审核您的请求所需的时间。

为缩短审核时间，请按产品和区域对配额调整请求进行分组。例如，如果您想申请调整网络配额和 Compute Engine 虚拟机配额，请针对网络配额创建一个申请，针对 Compute Engine 虚拟机配额再创建一个申请。

REST

如需通过 Cloud Quotas API 请求调整配额，请使用以下代码示例。使用您的值填充可修改的占位符。如需了解占位符字段，请参阅代码示例后面的说明。

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

替换以下内容：

  • PROJECT_NUMBER：您的 Google Cloud 项目编号。您可以在 Google Cloud 控制台的欢迎页面上，或通过运行以下 gcloud CLI 命令来查找项目编号：

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID：您要更新的配额偏好设置的 ID。

  • QUOTA_ID：您要更新的配额的 ID。

  • SERVICE_ID：您要调整的配额所属的 Google Cloud 的 ID。该名称通常采用 SERVICE_NAME.googleapis.com 格式。例如，Compute Engine 服务名称为 compute.googleapis.com。

  • DIMENSION_1：要调整的维度类型，例如 region 或 zone。您可以添加多个维度。在每个维度的值（例如 VALUE_1）后面添加英文逗号，以分隔各个维度。如需调整配额的所有维度，请省略此行。

  • VALUE_1：前一个维度的值。例如，如果前一个维度是 region，请输入一个区域，例如 us-central1。

  • JUSTIFICATION：此请求的原因。

  • EMAIL：可用作联系人的电子邮件地址（如果 Google Cloud 需要更多信息才能做出决定，然后才能授予额外的配额）。

示例请求

以下示例展示了针对 Compute Engine 配额 PUS-PER-GPU-FAMILY-per-project-region 提出的配额值增加请求。它请求将区域 us-central1 中 GPU 系列 NVIDIA_H100 的机器的配额值设置为 100。

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}