配额和限制

本文档列出了适用于 Media CDN 的配额和系统限制。 配额用于指定您可以使用的可计数共享资源数量,由 Google Cloud 服务(例如 Media 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 此限制无法提高。

这是在对象无法缓存时,Media CDN 代理响应正文中的字节数上限。 无法缓存的响应在达到上限后会被截断。

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

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

例如,Host 会变为 hostKeep-Alive 会变为 keep-alive

标头值的情况不变。

API 请求速率限制

如果您需要更高的 API 请求速率限制,则可以查看当前的使用情况并申请提高限制。

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

客户端超时

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

来源超时

  • connectTimeoutmaxAttemptsTimeout 用于限制 Media CDN 查找可用响应所需的时间。

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

    当 Media CDN 遇到非重定向响应(例如来自重定向或故障切换源站的响应)时,系统会应用 readTimeoutresponseTimeout 值。重定向的来源使用为遇到重定向的 EdgeCacheOrigin 配置的 connectTimeoutreadTimeoutresponseTimeout 值。

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

无论每个 EdgeCacheOrigin 设置了什么 maxAttempts,Media CDN 对所有来源最多只会尝试四次。媒体 CDN 使用主 CDN 的 maxAttemptsTimeoutEdgeCacheOrigin。每次尝试的超时值 (connectTimeoutreadTimeoutresponseTimeout)已针对 EdgeCacheOrigin 配置 。

下表介绍了超时字段:

字段 默认值 说明
connectTimeout 5 秒

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

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

maxAttemptsTimeout 15 秒

尝试连接到来源(包括故障切换来源)的最大总次数,达到此上限后,系统会向客户端返回错误。HTTP 504 是 如果达到超时限制,则会在返回响应之前返回。

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

此设置定义了所有源的时长 (包括故障切换源),以限制 客户端必须等待内容开始流式传输的总时长。系统只会使用第一个 maxAttemptsTimeout 值,其中“第一个”由为给定路线配置的起点定义。

readTimeout 15 秒

单个 HTTP 响应的读取之间等待的最大时长。 readTimeoutresponseTimeout 限制。 所有 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。