使用SQL模式创建数据服务API
数据服务API是一种API类型,由云计算资源中的数据通过参数配置生成,生成的API便于后续调用,减少资源操作成本。本文介绍如何用SQL模式创建数据API。
前提条件
背景信息
不是所有的云计算资源类型都支持SQL模式创建数据API,具体请以界面展示为准。
操作步骤
登录数据资源平台控制台。
在页面左上角,单击
图标,选择研发工作台。
在顶部菜单栏,单击
图标,选择目标工作组,单击资产加工。
说明若您已在资产加工页面,请跳过“单击资产加工”的操作。
在左侧导航栏,单击
图标,选择API开发 > 数据服务API。
在API资源页面右上角,单击创建API。
在创建API向导页面,开始创建API。
设置API基础信息,单击下一步。
名称
说明
API名称
API的名称,自定义即可。
所属应用
选择API的归属应用。单击新增应用,可新建应用,更多信息请参见新建应用。
API Path
API调用时展示的固定路径,默认自动生成。
调用认证方式
简单身份认证和加密身份认证两种方式,更多信息,请参见认证方式说明。
简单身份认证:适用于工作组内、测试等场景下的API调用,工作组内调用时用API归属应用的AppCode调用。
加密身份认证:通过加密算法计算一个签名并放在请求的Header中即可调用API,具备更高的安全性,适用于API共享后,应用开发场景下API的调用。
标签
添加API的应用模块标签,便于后续统计分析。
添加方式:单击加号,在添加标签对话框,选择应用及模块标签,单击确认。
描述
自定义API的描述信息,必填。
配置API参数。
选择云计算资源类型、云计算资源。
新建模式选择SQL模式。
输入SQL代码,单击语法检查及格式化,语法或数据格式无错误提示后,单击运行,运行完成后单击下一步。
配置及测试API
(可选)在请求参数区域,选择是否需授权时筛选,并设置特殊参数和过滤器。
单击开始测试,核对返回内容无误后,单击下一步。
查看返回内容:核对信息无误后,单击下一步。
配置流量控制参数:填写API最大调用次数,选择超时配置和缓存,单击保存或保存并上线。
在API资源列表,可查看新建的API。
相关操作
操作项 | 说明 |
编辑API | 在API资源列表中,单击目标API操作列的编辑,在API编辑向导页面,可对API进行编辑修改。 说明 编辑API参数配置中的云计算资源时,需要查看当前使用表中字段是否与编辑前使用表中的字段存在部分一致,如果一致可能导致编辑完成后,编辑内容不生效。 |
复制API | 在API资源列表操作列,选择更多 > 复制,在API资源列表中生成一个新的草稿API。单击复制API操作列的编辑,对复制的API进行编辑修改。 |
删除API |
说明 已上线的API不支持删除。 |
后续步骤
API创建完成后,需要对API进行上线操作,具体操作,请参见上线API。