绑定域名

操作场景

开放API前，您需要为API分组绑定一个或多个独立域名，API网关通过独立域名定位到此分组。

• 共享版中，不同分组下不能绑定相同的独立域名。

在绑定域名前，您需要理解以下2个概念：

• 子域名：API分组创建后，系统为分组自动分配一个内部测试用的子域名，此子域名唯一且不可更改，每天最多可以访问1000次。
• 独立域名：您自定义的域名，最多可以添加5个独立域名，不限访问次数。API调用者通过访问独立域名来调用您开放的API。

前提条件

1. 已有独立域名。可通过域名注册服务申请新的域名。
2. 公网独立域名需要备案，未备案的独立域名无法被访问。备案时长需几个工作日，建议您提前进行备案。
3. 共享版：已将独立域名CNAME解析到分组的子域名上，具体方法请参见增加CNAME类型记录集。
4. 如果API分组中的API支持HTTPS请求协议，那么在独立域名中需要添加SSL证书，请您提前准备SSL证书。此证书不支持导入，您需要填写证书的名称、内容和密钥。

操作步骤

1. 进入共享版控制台。
2. 单击“开放API > API分组”，进入到API分组信息页面。
3. 通过以下任意一种方式，进入“域名管理”页签。
   • 单击“分组名称”，进入分组详细信息页面。单击“域名管理”。
   • 在待绑定域名的分组所在行，单击“更多 > 域名管理”。

4. 单击“绑定独立域名”，设置域名信息。
5. 单击“确定”，将独立域名与API分组绑定。

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

6. （可选）绑定SSL证书。API分组中的API支持HTTPS请求协议时，需要添加SSL证书。
   1. 单击“添加SSL证书”，弹出“添加SSL证书”对话框。
   2. 根据已获取SSL证书，输入证书名称、证书内容和密钥，单击“确定”，完成SSL证书的添加。
   图1 添加SSL证书
   
   

   • SSL证书目前仅支持pem类型，如需添加其它证书类型，可转换成pem类型后添加。
   • 如果需要更换/编辑此SSL证书，单击证书名称后的，修改证书信息。由于证书内容和密钥已经加密，不支持再次查看，如果需要修改，请重新输入新的证书内容或者密钥。
   • 如果不再需要此SSL证书，在域名所在行，单击“删除SSL证书”。

常见问题

• 绑定域名失败常见原因：未将独立域名CNAME解析到分组的子域名上或域名重复。
• 添加SSL证书失败常见原因：生成证书的域名和实际添加证书所用的域名不一致。

后续操作

绑定独立域名后，您可以开始创建API，将API接口配置在API网关中，开放后端能力。