3.1 API 分组管理
3.1.2 绑定域名
操作场景
开放API前,您需要为API分组绑定一个或多个独立域名,API网关通过独立域名定位到 此分组。如果您未绑定独立域名,那么调用API时默认使用子域名,API网关对子域名 的访问次数做了限制,每天最多可以访问1000次。
说明
● 专享版中,同一实例下的不同分组不能绑定相同的独立域名。共享版中,不同分组下不能绑 定相同的独立域名。
在绑定域名前,您需要理解以下2个概念:
● 子域名:API分组创建后,系统为分组自动分配一个内部测试用的子域名,此子域
前提条件
1. 已有独立域名。可通过域名注册服务申请新的域名。
2. 已备案独立域名,未备案的独立域名无法被访问。
3. 已将独立域名CNAME解析到分组的子域名上,具体方法请参见增加CNAME类型 记录集。
4. 如果API分组中的API支持HTTPS请求协议,那么在独立域名中需要添加SSL证书,
请您提前准备SSL证书。此证书不支持导入,您需要填写证书的名称、内容和密 钥。
操作步骤
步骤1 登录管理控制台。
步骤2 在管理控制台左上角单击 ,选择区域。
步骤3 单击管理控制台左上角 ,然后单击“API网关 APIG”。
步骤4 在左侧选择您的API版本,单击并进入到对应版本的API开发与调用管理页面。
● “共享版”指直接创建并管理API,如涉及到费用,以API调用次数计费。
● “专享版”指在API专享版实例中创建并管理API,如涉及到费用,按实例运行时 间计费。
步骤5 单击“开放API > API分组”,进入到API分组信息页面。
步骤6 通过以下任意一种方式,进入“域名管理”页签。
● 单击分组名称,进入分组详细信息页面。单击“域名管理”。
● 在待绑定域名的分组所在行,单击“更多 > 域名管理”。
步骤7 单击,设置域名信息。
专享版实例可设置域名支持的最小TLS版本:TLS1.1或TLS1.2。推荐使用TLS1.2。
步骤8 单击“确定”,将独立域名与API分组绑定。
如果不再需要此域名时,在域名所在行,单击“解除绑定”。
步骤9 (可选)绑定SSL证书。API分组中的API支持HTTPS请求协议时,需要添加SSL证书。
1. 单击“添加SSL证书”,弹出“添加SSL证书”对话框。
2. 根据已获取SSL证书,输入证书名称、证书内容和密钥,单击“确定”,完成SSL 证书的添加。
图3-1 添加 SSL 证书
说明
● SSL证书目前仅支持pem类型,如需添加其它证书类型,可转换成pem类型后添加。
● 如果需要编辑此SSL证书,单击证书名称后的 ,修改证书名称。由于证书内容和密钥已经 加密,不支持再次查看,如果需要修改,请重新输入新的证书内容或者密钥。
● 如果不再需要此SSL证书,在域名所在行,单击“删除SSL证书”。
----结束
使用 API 方式绑定域名
您还可以使用API的方式绑定域名,具体操作请查看以下链接。
绑定域名 绑定证书
常见问题
● 绑定域名失败常见原因:未将独立域名CNAME解析到分组的子域名上或域名重 复。
● 添加SSL证书失败常见原因:生成证书的域名和实际添加证书所用的域名不一致。