跳转到内容
搜索文档
↵选择
↑↓导航
ESC关闭

自定义主机名

最后更新 查看 MarkdownAgent 设置

成功状态码

端点 方法 代码
/v4/zones/:zone_id/custom_hostnames POST 201 Created
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id GET 200 OK
/v4/zones/:zone_id/custom_hostnames GET 200 OK
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id DELETE 200 OK
/v4/zones/:zone_id/custom_hostnames/:custom_hostname_id PATCH 202 Accepted

错误代码

HTTP 状态码 API 错误代码 错误消息
400 1400 无法解码 JSON 请求体。请检查输入后重试。
400 1401 无法将自定义元数据编码为 JSON。请检查输入后重试。
400 1402 需要 Zone ID。请检查输入后重试。
400 1403 请求没有 Authorization 请求头。请检查输入后重试。
400 1407 自定义主机名无效。自定义主机名长度必须小于 256 个字符，不能是 IP 地址，不能包含任何特殊字符，例如 ``~`!@#$%^&*()=+[]\
400 1408 不支持包含非 ASCII 字符的自定义主机名。请检查输入后重试。
400 1409 不支持保留的顶级域自定义主机名，例如 'test'、'example'、'invalid' 或 'localhost'。请检查输入后重试。
400 1410 无法解析自定义主机名 - :reason。请检查输入后重试。
原因：
publicsuffix: cannot derive eTLD+1 for domain :domain
publicsuffix: invalid public suffix :suffix for domain :domain
400 1411 禁止以 example.com、example.net 或 example.org 结尾的自定义主机名。请检查输入后重试。
400 1412 不支持通配符自定义主机名的自定义元数据。请检查输入后重试。
注意：
此消息仅向已选择退出通配符自定义元数据支持的客户显示。
400 1415 自定义源站主机名无效。自定义源站主机名长度必须小于 256 个字符，不能是 IP 地址，不能包含任何特殊字符，例如 ```!@#$%^&*()=+[]\
400 1416 不支持包含非 ASCII 字符的自定义源站主机名。请检查输入后重试。
400 1417 不支持保留的顶级域自定义源站主机名，例如 'test'、'example'、'invalid' 或 'localhost'。请检查输入后重试。
400 1418 无法解析自定义源站主机名 - :reason。请检查输入后重试。
原因：
publicsuffix: cannot derive eTLD+1 for domain :domain
publicsuffix: invalid public suffix:suffixfor domain:domain
400 1419 禁止以 example.com、example.net 或 example.org 结尾的自定义源站主机名。请检查输入后重试。
400 1420 不支持通配符自定义源站主机名。请检查输入后重试。
400 1421 你指定的自定义源站主机名在 Cloudflare 中不存在于你的 zone 的 DNS 记录（A、AAAA 或 CNAME）：:zone\_tag。请检查输入后重试。
400 1422 http2 设置无效。仅接受 'on' 或 'off'。请检查输入后重试。
400 1423 tls\_1\_2\_only 设置无效。仅接受 'on' 或 'off'。请检查输入后重试。
400 1424 tls\_1\_3 设置无效。仅接受 'on' 或 'off'。请检查输入后重试。
400 1425 min\_tls\_version 设置无效。仅接受 '1.0'、'1.1'、'1.2' 或 '1.3'。请检查输入后重试。
400 1426 你上传的证书无法解析。请检查输入后重试。
400 1427 你上传的证书为空。请检查输入后重试。
400 1428 你上传的私钥无法解析。请检查输入后重试。
400 1429 你上传的私钥与证书不匹配。请检查输入后重试。
400 1430 自定义 CSR ID 无效。请检查输入后重试。
404 1431 未找到自定义 CSR。
400 1432 不支持该验证方法。仅接受 http、email 或 txt。请检查输入后重试。
400 1433 不支持该验证类型。仅接受 'dv'。请检查输入后重试。
400 1434 SSL 属性无效。请参阅 API 文档，检查输入后重试。
400 1435 自定义主机名 ID 无效。请检查输入后重试。
404 1436 未找到自定义主机名。
400 1437 hostname.contain 查询参数无效。hostname.contain 查询参数长度必须小于 256 个字符，不能是 IP 地址，不能包含任何特殊字符，例如 ``~`!@#$%^&*()=+[]\
400 1438 除 id 外不能指定其他过滤参数。只能指定一个。请检查输入后重试。
409 1439 不支持修改自定义主机名。请检查输入后重试。
400 1440 验证类型与验证方法均为必填。请检查输入后重试。
400 1441 你上传的证书在捆绑到公共信任存储时遇到问题。请检查输入后重试。
400 1442 ciphers 设置无效。请参阅文档中接受的密码套件列表。请检查输入后重试。
400 1443 当最低 TLS 版本为 1.3 时，不支持密码套件选择。请检查输入后重试。
400 1444 你上传的证书链包含多个叶证书。请检查输入后重试。
400 1445 你上传的证书链没有叶证书。请检查输入后重试。
400 1446 你上传的证书不包含自定义主机名 - :custom_hostname。请检查输入后重试。
400 1447 你上传的证书未使用受支持的签名算法。仅支持 SHA-256/ECDSA、SHA-256/RSA 与 SHA-1/RSA 签名算法。请检查输入后重试。
400 1448 由 Cloudflare 管理的证书不支持带通配符的自定义主机名。请检查输入后重试。
400 1449 请求输入 bundle_method 必须是以下之一：ubiquitous、optimal、force。
401 1000 无法提取 bearer token
401 1001 无法解析 JWT token
401 1002 错误的 JWT 请求头
401 1003 验证 JWT token 失败
401 1004 无法从 JWT token 获取 claims
401 1005 JWT token 没有必需的 claims
403 1404 尚未为此 zone 分配配额。如果你已是付费 Cloudflare for SaaS 客户，请联系你的客户成功经理以获取额外预配。如果尚未注册，请 填写此联系表单 ↗，我们的销售团队会与你联系。
403 1405 超出配额。如果你已是付费 Cloudflare for SaaS 客户，请联系你的客户成功经理以获取额外预配。如果尚未注册，请 填写此联系表单 ↗，我们的销售团队会与你联系。
403 1413 尚未为此 zone 分配 自定义元数据 访问权限。如果你已是付费客户，请联系你的客户成功经理以获取额外预配。如果尚未注册，请 填写此联系表单 ↗，我们的销售团队会与你联系。
403 1414 尚未授予此 zone 设置自定义源站服务器的访问权限。如果你已是付费 Cloudflare for SaaS 客户，请联系你的客户成功经理以获取额外预配。如果尚未注册，请 填写此联系表单 ↗，我们的销售团队会与你联系。
409 1406 发现重复的自定义主机名。
500 1500 内部服务器错误

这篇文档对您有帮助吗？