# 发布数据API 在数据后端创建后，您需要发布数据后端，生成数据API并发布到环境上，才可供其他用户调用。 #### 前提条件 - 每个API都要归属到某个API分组下，在发布函数API前您需要有可用的API分组，否则请提前[创建API分组](https://support.huaweicloud.com/usermanual-roma/roma_03_2103.html)。 - 如果需要使用自定义认证方式进行API的安全认证，请提前[创建前端自定义认证](https://support.huaweicloud.com/usermanual-roma/roma_03_2153.html)。 #### 限制与约束 如果为自定义后端发布的前端API的请求路径增加了请求参数，那么无法在自定义后端的发布页面进行发布，需要在前端API页面进行发布操作。如果只修改了自定义后端的内容，建议重新部署即可，无需重新发布。 #### 发布数据API 1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。 2. 在左侧的导航栏选择"服务集成 APIC \> 自定义后端"。 3. 在后端列表中单击自定义后端的名称，进入后端编辑器页面。 4. 在页面右上角单击"发布"。 5. 在发布弹窗中配置数据API的相关信息，完成后单击"立即发布"，为该后端创建一个对应的前端数据API，并发布到环境上。 表1发布配置 | 参数 | 说明 | |:---|:---| | 所属分组 | 选择前端API所属的API分组。若没有可用的API分组，可单击右侧的"创建分组"，创建一个API分组。 创建API后，将无法修改API所属的API分组，API分组关系到API的访问域名，请谨慎选择。 | | 发布环境 | 选择前端API要发布的环境。如果没有您需要的环境，可单击右侧的"创建环境"，创建一个环境。 | | 前端安全认证 | 选择前端API的安全认证方式，推荐使用APP认证方式。 - APP认证：表示由ROMA Connect对API请求进行安全认证。用户调用API时，使用集成应用的Key和Secret进行API请求的安全认证。 - 华为IAM认证：表示由IAM对API请求进行安全认证。用户调用API时，使用Token或AK/SK进行API请求的安全认证。 - 自定义认证：表示使用自定义的函数API对API请求进行安全认证。 - 无认证：表示API请求不需要认证。 | | 自定义认证 | **仅当"前端安全认证"选择"自定义认证"时需要配置。** 选择已创建的前端类型自定义认证。 | | 前端请求协议 | 选择前端API使用的请求协议，可选择"HTTP"、"HTTPS"和"HTTP\&HTTPS"，传输重要或敏感数据时推荐使用HTTPS。 | | 后端超时 (ms) | 后端服务请求的超时时间，默认为60000ms。 | | 重试次数 | ROMA Connect调用后端服务失败后的重试次数。 - 值为-1时，表示不开启重试功能，但除POST和PATCH外的其他请求类型会默认重试1次。 - 值为0-10时，表示开启重试功能，并根据设置的值执行重试。 | | 高级设置 || | 前端请求方法 | 选择前端API的请求方法。"ANY"表示该API支持任意请求方法。 | | 前端请求路径 | 填写前端API的请求路径，格式如：/getUserInfo/userId。 请求路径中的内容区分大小写。 | | 支持跨域(CORS) | 是否支持跨域访问API。 浏览器出于安全性考虑，限制从页面脚本内发起的跨域请求，此时页面只能访问同源的资源。而CORS允许浏览器向跨域服务器发送XMLHttpRequest请求，从而实现跨域访问。跨域访问API请参见[跨域调用APIC开放的API](https://support.huaweicloud.com/usermanual-roma/roma_03_2124.html)。 | #### 相关文档 - API发布完成后，API调用者就可以[调用API](https://support.huaweicloud.com/usermanual-roma/roma_03_2122.html)了。如果调用的是APP认证方式的API，还需要[配置API的调用授权（可选）](https://support.huaweicloud.com/usermanual-roma/roma_03_2121.html)才可调用API。 - 开放数据API的最佳实践，请参考[企业数据以API形式开放共享](https://support.huaweicloud.com/bestpractice-roma/roma_05_0011.html)。