Cloudflare for SaaS 计划包含一定数量的自定义主机名。额外主机名按你的计划计费。有关包含的主机名数量、最大主机名数量以及当前用量定价,请参阅计划。
自定义主机名配额可应用于 zone 或账户级别。zone 级配额包含单个 zone 中的主机名。账户级配额包含该账户下所有 zone 中的主机名。
分配的配额是软限制。当用量达到此限制时,你仍可继续创建自定义主机名。此时 Create Custom Hostname 响应会包含计费警告。
非 Enterprise 计划还有 API 强制阈值。用量达到该阈值后,API 会拒绝创建自定义主机名的请求。Enterprise 计划在达到该阈值后仍可继续创建自定义主机名。
配额 API 会返回当前用量、软配额,以及适用范围内的强制阈值。
向自定义主机名配额端点发送 GET 请求:
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames/quota" \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"响应包含以下配额字段:
| 字段 | 说明 |
|---|---|
allocated |
zone 或账户的运营软配额。 |
used |
计入该配额的自定义主机名数量。 |
exceeded |
用量是否已达到或超过配额。 |
hard_cap |
非 Enterprise 计划的 API 强制阈值。Enterprise 计划可以超出此值。 |
使用 used 和 allocated 监控运营容量。当 used 大于或等于 allocated 时,exceeded 字段会变为 true。
每个自定义主机名在删除前都会计入用量。这包括仍处于待验证或待激活状态的主机名。删除未使用的自定义主机名会将其从用量计数中移除。