更新时间:2022-03-30 GMT+08:00
分享

绑定域名

您需要为API服务绑定一个或多个独立域名,每个API服务最多可以绑定5个独立域名,同一独立域名只能绑定一个服务。绑定域名即在域名和服务之间建立映射关系,将已有的独立域名绑定到API服务上。当客户端发送请求时,根据HTTP请求中的域名定位到所属的API服务,再通过HTTPMethod和PATH确定唯一的API。

在绑定域名前,您需要了解以下2个概念:

  • 调试域名:API服务创建后,系统为服务自动分配一个内部测试用的调试域名,此域名唯一且不可更改。如果您未绑定独立域名,那么调用API时默认使用调试域名,ROMA API对调试域名的访问次数做了限制,每天最多可以访问1000次。
  • 独立域名:您自定义的域名,API调用者通过访问独立域名来调用您开放的API。

前提条件

  1. 已备案独立域名,未备案的独立域名无法被访问。
  2. 已经将独立的域名解析到该服务的实例IP上,具体方法请参考增加A类型记录集
  3. 如果API服务中的API支持HTTPS请求协议,那么在独立域名中需要添加SSL证书,请您提前准备SSL证书。此证书不支持导入,您需要填写证书的名称、内容和密钥。

操作步骤

  1. 登录ROMA API控制台。
  2. 在控制台单击,选择区域,在“ROMA API”下选择待操作的应用。
  1. 在左侧导航栏选择“API管理 > API服务”。
  2. 在当前应用关联的实例中,根据实际业务选择实例。
  1. 在页面上单击服务名称,进入API服务详情页面。
  2. 在“域名管理”区域,单击“绑定独立域名”,并在弹窗中配置域名信息。

    表1 独立域名配置

    信息项

    描述

    域名

    填写要绑定的域名。

    支持最小TLS版本

    选择域名访问所使用的最小TLS版本,TLS1.1或TLS1.2,推荐使用TLS1.2。

    该配置仅对HTTPS生效,不影响HTTP或者其他访问方式。

  3. 单击“确定”,将独立域名与API服务绑定。

    如果不再需要此域名时,在域名所在行,单击“解绑域名”。

  4. (可选)如果API服务中的API支持HTTPS请求协议,则需要为独立域名绑定SSL证书。否则跳过此步骤。

    1. 在域名所在行单击“选择SSL证书”。
    1. 在选择SSL证书弹窗中勾选要绑定的SSL证书,然后单击“确定”,完成SSL证书的绑定。

      若证书列表中无可用的SSL证书,可单击“创建SSL证书”,新增SSL证书,具体操作配置请参考创建SSL证书

常见问题

  • 绑定域名失败常见原因

    未将独立域名CNAME解析到服务的子域名上或域名重复。

  • 添加SSL证书失败常见原因

    生成证书的域名和实际添加证书所用的域名不一致。

相关文档