配额和限制

本文档列出了适用于您的 API 的配额和限制， 媒体 CDN。

Google Cloud 使用配额来帮助确保公平性并减少资源使用和可用性的激增。配额用于限制您的 Google Cloud 项目可使用的 Google Cloud 资源的数量。配额适用于一系列资源类型，包括硬件、软件和网络组件。例如，配额可以限制对某项服务的 API 调用次数、您的项目并发使用的负载均衡器数量或者您可以创建的项目数量。配额可以防止服务过载，从而保护 Google Cloud 用户社区。配额还可帮助您管理自己的 Google Cloud 资源。

Cloud 配额系统执行以下操作：

  • 监控 Google Cloud 产品和服务的消耗情况
  • 限制这些资源的消耗量
  • 提供请求更改配额值的方法。

在大多数情况下，当您尝试消耗的资源超出其配额允许的范围时，系统会阻止对资源的访问，并且您尝试执行的任务会失败。

配额通常在 Google Cloud 项目级层应用。您在一个项目中使用资源不会影响您在另一个项目中的可用配额。在 Google Cloud 项目中，配额在所有应用和 IP 地址间共享。

媒体 CDN 资源也存在限制。这些限制与配额系统无关。除非另有说明，否则无法更改限制。

限制

以下限制适用于媒体 CDN。

配置

项 限制 备注
EdgeCacheService 的数量上限 每个项目 20 个 如需提高配额，请与您的 Google Cloud 销售团队联系。 这一限制。
EdgeCacheOrigin 的数量上限 每个项目 30 个 如需提高配额，请与您的 Google Cloud 销售团队联系。 这一限制。
EdgeCacheKeyset 的数量上限 每个项目 10 个 如需提高配额，请与您的 Google Cloud 销售团队联系。 这一限制。
每次RouteRules的数量上限 EdgeCacheService 2000

每个 EdgeCacheService 最多可以定义 10 个 PathMatchers, 每个 PathMatcher 最多可以定义 200 个 RouteRules。

此限制无法提高。
每项服务的 SSL 证书数量上限 5 此限制无法提高。另请参阅每 项目配额。
每个 EdgeCacheKeyset 3 此限制无法提高。一个密钥集中的多个键 用于启用密钥轮替：您应该移除较旧的和未使用的 键。
每个 EdgeCacheKeyset 3 此限制无法提高。一个密钥集中的多个键 用于启用密钥轮替：您应该移除较旧的和未使用的 键。

HTTP 标头、请求和响应

项 限制 备注
请求标头大小上限 大约11 KiB 此限制无法提高。

请求网址和请求标头的总大小不能超过 15 KiB。

请求被拒绝并返回 HTTP/1.1 的 HTTP 431 响应 连接。

HTTP/2 连接在没有响应代码的情况下关闭 写入。

系统会记录这些请求，其 statusDetails 为 headers_too_long。 如果启用了日志记录，则会发生此错误。

请求正文大小上限 16 KiB 正文量超过此限制的请求会被拒绝并返回 HTTP 413 Content Too Large 状态代码。
响应标头大小上限 大约128 KiB 此限制无法提高。

如果源响应的标头超过此限制，则会导致 HTTP 502 发送到客户端。这些事件通过 statusDetails 进行记录， backend_response_headers_too_long（如果已启用日志记录）。

可缓存对象大小上限 100 GiB 此限制无法提高。

这是源中对象的最大大小， 媒体 CDN 可以缓存。较大的对象会 视为不可缓存

不可缓存响应大小上限 500 MiB 此限制无法提高。

这是响应正文中可存储的字节数上限 当某个对象不可缓存时，媒体 CDN 会进行代理。 无法缓存的响应在达到上限后会被截断。

标头的小写转换 始终，对于媒体 CDN 媒体 CDN 遵循 HTTP/2 规范 请求和响应标头的情况。

无论使用何种协议，所有标头都将转换为 。

例如，Host 会变为 host，并且 Keep-Alive 会变为 keep-alive。

标头值的情况不变。

API 请求速率限制

如果您需要提高 API 请求的速率限制，请参阅当前使用情况 并请求增加配额

项 限制
失效操作 每分钟 10 次/EdgeCacheService
所有不在 networkservices 命名空间 每个项目每分钟 1200 次调用
只读：GetEdgeCache*、 ListEdgeCache* 每个项目每分钟 100 次
读/写：networkservices 中的所有内容 命名空间未标记为只读 每个项目每分钟 100 次

客户端超时

超时 时长上限 响应代码 说明
Maximum request duration 5 分钟 HTTP 408 (Request Timeout) 单个请求-响应的最大时长。
Header timeout 10 秒 HTTP 408 (Request Timeout) 客户端必须发送全部请求标头的时间。

源超时

  • connectTimeout 和 maxAttemptsTimeout 限制了媒体 CDN 的时长 找到可用响应所需的全部步骤

    两个超时时间均包括源站返回标头和 确定是使用故障切换还是重定向。connectTimeout适用 每次尝试都发送单独的请求，而 maxAttemptsTimeout 包含 跨所有源尝试进行连接所需的时间，包括 包括故障切换和重定向跟踪重定向会计为额外 尝试连接到源站，并计入 maxAttempts 集内 。

    当媒体 CDN 遇到非重定向响应（例如 来自重定向或故障切换源站的 readTimeout 和 responseTimeout 值适用。重定向的来源使用 connectTimeout、readTimeout、 和responseTimeout的值EdgeCacheOrigin 遇到重定向。

  • responseTimeout 和 readTimeout 用于控制流式传输响应的时长 。在媒体 CDN 确定将使用 上游响应，既不是 connectTimeout，也不是 maxAttemptsTimeout 至关重要。此时，readTimeout 和 responseTimeout 生效。

媒体 CDN 最多会在所有源站尝试四次源站， 而不会考虑每个 EdgeCacheOrigin 设置的 maxAttempts。 媒体 CDN 使用主 CDN 的 maxAttemptsTimeout 值 EdgeCacheOrigin。每次尝试的超时值 (connectTimeout、 readTimeout 和 responseTimeout）已针对 EdgeCacheOrigin 配置 。

下表介绍了超时字段：

字段 默认 说明
connectTimeout 5 秒

媒体 CDN 可以花费的最长时间 开始向源站发送请求，直到媒体 CDN 确定 响应是否可用。实际上是 connectTimeout 涵盖从创建请求到执行 DNS 操作 然后执行 TLS 握手、建立 TCP/QUIC 连接 通过获取响应标头 包含 HTTP 状态代码的标识符

超时值必须介于 1 秒到 15 秒。
maxAttemptsTimeout 15 秒

尝试连接到源站的最长时间，包括 故障切换来源，然后再向客户端返回错误。HTTP 504 是 如果达到超时限制，则会在返回响应之前返回。

超时值必须介于 1 秒到 30 秒。

此设置定义了所有源的总时长 （包括故障切换源），以限制 客户端必须等待内容开始流式传输的总时长。仅 使用 maxAttemptsTimeout 值，其中 由为指定路线配置的来源定义。
readTimeout 15 秒

单个 HTTP 响应的读取之间等待的最大时长。 readTimeout 受 responseTimeout 限制。 所有 HTTP 响应读取都必须在 responseTimeout。超时值必须介于 1 秒到 30 秒。如果在响应完成之前达到此超时时间， 响应会被截断并记录下来。
responseTimeout 30 秒

完成回答所允许的最大时长。

超时值必须介于 1 秒到 120 秒。

该时长从第一个正文字节 。如果在响应完成之前达到此超时时间， 响应会被截断并记录下来。

管理配额

出于各种原因，Media CDN 会对资源用量实施配额限制。例如，配额可避免出现意料之外的用量突增，从而为 Google Cloud 用户社区提供保护。配额还可帮助正在通过免费层级探索 Google Cloud 的用户避免中断试用。

所有项目在开始时都具有相同的配额，您可以通过申请更多配额来进行更改。根据您使用产品的情况，一些配额可能会自动增加。

权限

如需查看配额或申请增加配额，Identity and Access Management (IAM) 主账号需要具备以下某个角色：

任务 所需角色
检查项目的配额 以下之一：
修改配额，申请更多配额 以下之一：
  • Project Owner (roles/owner)
  • Project Editor (roles/editor)
  • Quota Administrator (roles/servicemanagement.quotaAdmin)
  • 具有 serviceusage.quotas.update 权限的自定义角色

查看您的配额

控制台

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

    转到“配额”

  2. 如需搜索要更新的配额，请使用过滤表。 如果您不知道配额的名称，请使用此页面上的链接。

gcloud

使用 Google Cloud CLI 运行以下命令来查看您的配额。请将 PROJECT_ID 替换为您自己的项目 ID。

      gcloud compute project-info describe --project PROJECT_ID

如需查看您在某一区域中已使用的配额，请运行以下命令：

    gcloud compute regions describe example-region

超出配额时引发的错误

如果在发出 gcloud 命令时超过了配额，gcloud 会显示一条 quota exceeded 错误消息，并返回退出代码 1。

如果在发出 API 请求时超出了配额，Google Cloud 会返回以下 HTTP 状态代码：413 Request Entity Too Large。

申请更多配额

如需增加或减少大多数配额，请使用 Google Cloud 控制台。如需了解详情，请参阅申请更高的配额。

控制台

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

    转到“配额”

  2. 在配额页面上，选择您要更改的配额。
  3. 点击位于页面顶部的修改配额。
  4. 在名称部分，输入您的名称。
  5. 可选：在手机部分，输入手机号码。
  6. 提交您的申请。 配额申请需要 24 到 48 小时才能完成处理。

资源可用性

每个配额代表您可以创建的特定类型资源的数量上限（如果该资源可用）。请务必注意，配额不保证资源可用性。即使您具有可用配额，如果新资源不可用，您也无法创建新资源。

例如，您的配额可能足以在 us-central1 区域中创建新的区域性外部 IP 地址。但是，如果该区域中没有可用的外部 IP 地址，则无法执行此操作。区域级资源可用性也会影响您能否创建新资源。

导致资源在整个区域不可用的情况非常罕见。但是，地区内的资源有时可能会耗尽，通常不会影响资源类型的服务等级协议 (SLA)。如需了解详情，请参阅资源的相关 SLA。