首页 数据资源平台 操作指南 统一服务 API开发 创建API 使用SQL模式创建数据服务API

使用SQL模式创建数据服务API

更新时间: 2023-08-31 11:17:56

数据服务API是一种API类型,由云计算资源中的数据通过参数配置生成,生成的API便于后续调用,减少资源操作成本。SQL模式创建数据服务API适用于多表关联、复杂筛选过滤的查询,通过编写SQL代码的方式完成API封装。本文介绍如何用SQL模式创建数据API。

前提条件

操作步骤

  1. 登录数据资源平台控制台

  2. 在页面左上角,单击导航图标 图标,选择协同

  3. 在顶部菜单栏,单击选择工作组图标,选择目标工作组,单击资产加工

  4. 在左侧导航栏,单击API图标,选择API开发 > 数据服务API

  5. API资源页面右上角,单击创建API

  6. 在创建API向导页面,开始创建API。

    1. 设置API基础信息,单击下一步image

      名称

      说明

      API名称

      API的名称,自定义即可。

      所属应用

      选择API的归属应用。单击新增应用,可新建应用,更多信息请参见新建应用

      API Path

      API调用时展示的固定路径,默认自动生成。

      调用认证方式

      简单身份认证加密身份认证两种方式,更多信息,请参见认证方式说明

      • 简单身份认证:适用于工作组内、测试等场景下的API调用,工作组内调用时用API归属应用的AppCode调用。

      • 加密身份认证:通过加密算法计算一个签名并放在请求的Header中即可调用API,具备更高的安全性,适用于API共享后,应用开发场景下API的调用。

      标签

      添加API的应用模块标签,便于后续统计分析。

      添加方式:单击加号,在添加标签对话框,选择应用及模块标签,单击确认

      描述

      自定义API的描述信息,必填。

    2. 配置API参数。

      1. 选择云计算资源类型、云计算资源。

      2. 新建模式选择SQL模式

        说明

        不是所有的云计算资源类型都支持SQL模式创建数据API,具体请以界面展示为准。

      3. 输入SQL代码,单击语法检查及格式化,语法或数据格式无错误提示后,单击运行,运行完成后单击下一步121

        说明

        SQL语法使用目前仅支持SELECT操作,更多信息请参见SQL语法指南

    3. 配置及测试API

      1. (可选)在请求参数区域,选择是否需授权时筛选,并设置特殊参数过滤器image

        说明
        • 授权时筛选若选择,在授权页面,会展示授权过滤配置项,具体操作,请参见授权API

        • 特殊参数支持指定query参数对查询到的数据做进一步处理,更多信息,请参见API调用特殊参数

        • 过滤器是API数据适配器开关,设置信息模块展示隐藏,更多信息,请参见API结果过滤器

      2. 单击开始测试,核对返回内容无误后,单击下一步222

    4. 查看返回内容:核对信息无误后,单击下一步

    5. 配置流量控制参数:填写API最大调用次数,选择超时配置和缓存,单击保存保存并上线image

      在API资源列表,可查看新建的API。

相关操作

操作项

说明

编辑API

API资源列表中,单击目标API操作列的编辑,在API编辑向导页面,可对API进行编辑修改。

说明

编辑API参数配置中的云计算资源时,需要查看当前使用表中字段是否与编辑前使用表中的字段存在部分一致,如果一致可能导致编辑完成后,编辑内容不生效。

复制API

API资源列表操作列,选择更多 > 复制,在API资源列表中生成一个新的草稿API。单击复制API操作列的编辑,对复制的API进行编辑修改。

删除API

  • 单个删除:在API资源列表操作列,选择更多 > 删除,在删除对话框中,单击确定

  • 批量删除:在API资源列表中选选中删除API,单击列表下方的批量删除,在批量删除对话框,单击确定

说明

已上线的API不支持删除。

后续步骤

API创建完成后,需要对API进行上线操作,具体操作,请参见上线API

阿里云首页 数据资源平台 相关技术圈