API 文档

配置自定义域名

最近更新时间:2020-03-17 13:41:53

操作场景

用户可通过域名绑定功能,将用户所拥有的独立域名绑定到服务,使得服务能以用户自身独立域名的方式提供。

前提条件

  • 确保需绑定的域名已经完成解析配置。
  • 确保您的域名已按照要求完成 备案

操作步骤

关联自定义域名

  1. 登录 API 网关控制台,在左侧导航栏单击【服务】。
  2. 在服务列表页,单击服务 ID,进入服务详情页。
  3. 在服务详情页,选择【自定义域名】,单击页面左上角的【新建】,填写配置信息后,单击【提交】。
    说明:

    • 如果需要支持独立域名的 HTTPS 协议,需要提交域名的 SSL 证书。证书可以通过文件上传的方式或通过填写证书名称、内容和私钥的方式提交,具体可查看 域名型(DV)免费 SSL 证书
    • 修改 CNAME 后过一段时间才能生效,请确保生效后再进行配置操作,否则会配置失败。
  4. 配置 CNAME 解析完成后,在服务内配置绑定独立域名(请确保先配置 CNAME 解析,再配置绑定)。
  5. 若需要解绑,需先删除服务内绑定的独立域名,再删除独立域名的 CNAME。

配置域名路径映射

  1. 在自定义域名列表页,单击操作列的【编辑路径映射】。
  2. 选择路径映射类型:
    • 默认路径映射:路径的 URL 为自定义域名/环境名,例如www.XXXXX.com/release指向本服务中的发布环境,www.XXXXX.com/prepub指向本服务中的预发布环境,www.XXXXX.com/test指向本服务中的测试环境。
    • 自定义路径映射:路径时的 URL 为自定义域名/自定义路径,这个 URL 则指向您所映射的环境。例如配置路径为/mypath,环境为发布环境,则发布环境的 URL 为www.XXXXX.com/mypath。当您想使用根路径时,可直接配置路径为/
      注意:

      使用自定义路径映射时,原本默认路径映射不生效,即自定义域名/环境名均不生效。
      配置后自定义路径映射与默认路径映射还可以进行编辑。

  3. 单击【提交】,完成配置。
目录