连接器-华为云

ASTRO轻应用 ASTROZERO-使用Rest服务调用Rest协议接口:在脚本中，调用动作

在脚本中，调用动作创建一个脚本，通过在脚本中调用Rest服务中添加的动作，将第三方提供的业务功能集成到AstroZero中使用。参考登录AstroZero新版应用设计器中操作，登录应用设计器。在左侧导航栏中，选择“逻辑”。单击脚本后的，设置脚本名称，单击“添加”。图11 新增一个空脚本在脚本编辑器中，输入如下代码。 // Here's your code. import * as connector from "connector"; let client = connector.newClient("命名空间__test", "test1"); let result = client.invoke("命名空间_flapRefund", {}); console.log(result) 其中，“命名空间__test”表示连接器的名称，“test1”为创建自定义连接器对接Rest服务配置的认证信息名称，“命名空间__flapRefund”为创建并启用Rest动作中配置的动作名称。单击脚本编辑器页面上方的，保存脚本。脚本保存成功后，单击，运行脚本。在页面底部“输入参数”页签中，输入请求参数，单击测试窗口右上角的。在“日志”页签，查看打印的日志。

ASTRO轻应用 ASTROZERO 使用连接器调用第三方接口

ASTRO轻应用 ASTROZERO-对接OCR识别图片中文字:在脚本中调用连接器

在脚本中调用连接器在脚本中，调用连接器实现与OCR的对接。参考创建空白AstroZero脚本中操作，创建一个空白脚本。在脚本编辑器中，输入如下代码。通过脚本中的如下代码，可基于已上传身份证的URL，调用OCR接口进行识别，并输出识别的基本信息。 //导入该事件所依赖的标准库文件。ocr是系统预置的标准库。 import * as ocr from 'ocr'; let cli = ocr.newClient("OCR_Test"); try { let url = "https://obs-example.com:443/1.PNG?AccessKeyId=ZK87UUIONJF5ZHWBINUO&Expires=1556001233&Signature=DOwO6djb4Q3EBvCieQFaO3T2GKU%3D&x-obs-security-token=gQpjbi1ub3J0aC0xip******DCfJAazjA4wTnkbccr38k7eM%3D" let resp = cli.idCardWithURL(url, "front"); console.log(resp); } catch (e) { console.log("error: ", e) } 其中，ocr.newClient("OCR_Test")中，“OCR_Test”为连接器的名称，“url”取值是图片的URL， “front”表示识别的是身份证正面。单击脚本编辑器页面上方的，保存脚本。保存成功后，单击，运行脚本。不用设置输入参数，直接单击测试窗口右上角的。在输出参数页签，检查是否识别出身份证上文字信息。识别出身份证上的文字信息，表明成功调用连接器。单击脚本编辑器页面上方的，启用脚本。

ASTRO轻应用 ASTROZERO 使用连接器对接云服务

ASTRO大屏应用 ASTROCANVAS-新建连接器:操作步骤

操作步骤参考登录AstroCanvas界面中操作，登录AstroCanvas界面。在主菜单中，选择“数据中心”。在左侧导航栏中，选择“连接器”。在连接器管理页面，单击“新建连接器”。设置基本信息。图2 基本信息（无身份验证）图3 基本信息（AK/SK）图4 基本信息（API Key）图5 API鉴权连接器名称：输入新建连接器的名称，长度为1~32个字符，可包括中文、字母、数字及下划线。类型：选择连接器类型，便于管理连接器。单击“新建类型”，可自定义连接器类型。上传图标：单击，可设置连接器显示的图标。描述：新建连接器的描述信息，可按需进行设置。请求协议：设置连接器请求协议。域名：请求的Host地址，不需要带上“http://”或“https://”协议头，同时也不需要“/”结尾。域名参数：配置域名参数，包含字段名称、默认值和字段描述。图6 配置域名参数连接器配置中，当域名中配置“{字段名}”参数时，才会显示该参数。接口鉴权方式：设置接口鉴权方式，支持API鉴权、AK/SK、API Key和无身份验证。 API鉴权：填写API鉴权信息后，可在连接器中选择其响应参数，作为连接器请求参数的值。无身份验证：不需要任何验证信息，直接调用接口，通常用于访问一些公开的接口。 AK/SK：通过访问密钥进行接口鉴权。访问密钥即AK/SK（Access Key ID/Secret Access Key），是您访问系统的身份凭证，系统通过AK识别访问用户的身份，通过SK进行签名验证，通过加密签名验证可以确保请求的机密性、完整性和请求者身份的正确性。 API Key：使用API密钥进行授权，鉴权信息可以附加在Query或Header中。鉴权信息：“接口鉴权方式”设置为“API鉴权”时，才会显示该参数。单击“新建鉴权信息”，设置鉴权信息。图7 新建鉴权信息 API鉴权名称：设置API鉴权名称，长度为1~32个字符，可包括中文、字母、数字及下划线。 API鉴权描述：设置API鉴权描述信息。 API鉴权地址：设置API鉴权地址，通过输入字符“{xx}”可在请求参数Path列表中使用变量“xx”。请求方式：设置接口请求方式，支持GET和POST。请求参数：设置接口请求参数。设置成功后，可单击“测试API接口”，可进行接口调试。返回参数：设置接口返回参数，此处的响应参数，可作为连接器请求参数的值。参数位置：把鉴权信息附加在Query或Header中，请根据实际需求进行配置。“接口鉴权方式”设置为“API Key”时，才会显示该参数。参数名称：API Key的名称，请根据实际需求进行配置。“接口鉴权方式”设置为“API Key”时，才会显示该参数。设置执行动作。图8 添加动作图9 将鉴权信息中返回的参数赋值给连接器中Header参数动作信息动作名称：设置新增动作的名称，长度为1~32个字符，可包括中文、字母、数字及下划线。动作描述：新增动作的描述信息。请求地址：设置请求地址，通过输入字符“{xx}”可在请求参数Path列表中使用变量“xx”。请求方法：请根据接口类型，选择请求方法。请求参数 Query：请求的参数，通常指的是URL中“?”后的附加参数。 Header：Header中需要的参数，支持“字符串”和“表达式”两种。“字段类型”设置为“表达式”时，单击“默认值”，可将5中鉴权信息中返回的参数赋值给连接器的请求参数。 Body：当请求类型为POST时，还需要设置Body，可以使用默认值也可以根据实际需求进行填写。 Path：URL中配置的带大括号的变量。例如{pathParam} ，其中pathParam会作为变量名。返回参数：设置返回参数。在Body中，可以贴一段预期结果的json，使用时可以解析出字段格式。认证信息设置完成后，单击“测试”，测试接口是否有效。测试成功后，单击“保存”，完成连接器的创建。

ASTRO大屏应用 ASTROCANVAS 连接器管理

ASTRO工作流 ASTROFLOW-创建自定义连接器:创建自定义连接器（从swagger导入）

创建自定义连接器（从swagger导入）参考如何登录AstroFlow中操作，登录AstroFlow界面。在主菜单中，选择“连接器”，进入连接器页面。创建连接器分类，便于集中管理连接器。图7 创建连接器分类单击创建后的，选择“从swagger导入”。设置连接器信息，单击“确定”。图8 从swagger导入连接器连接器名称：设置新建连接器的名称。描述：新建连接器的描述信息。分类：选择3中创建的连接器分类，便于集中管理连接器。 swagger文件：单击，选择待导入连接器的swagger文件。请上传json、yaml或yml格式的文件，且大小不超过1MB。

ASTRO工作流 ASTROFLOW 自定义连接器

ASTRO工作流 ASTROFLOW-创建自定义连接器:创建自定义连接器（手动创建）

创建自定义连接器（手动创建）参考如何登录AstroFlow中操作，登录AstroFlow界面。在主菜单中，选择“连接器”，进入连接器页面。创建连接器分类，便于集中管理连接器。图1 创建连接器分类单击创建后的，选择“手动创建”或者直接单击“创建自定义连接器”。图2 选择手动创建设置连接器信息，单击“确定”。图3 接口鉴权方式（无身份鉴权）图4 接口鉴权方式（AKSK）图5 接口鉴权方式（API鉴权）上传图片：单击，可设置连接器显示的图标。连接器名称：新建连接器的名称，请按需设置。分类：选择连接器的分类，便于集中管理连接器。可以选择3中创建的分类，也可以单击“创建分类”，自定义连接器分类。描述：新建连接器的描述信息。请求协议：设置连接器请求协议。域名：请求的Host地址，不需要带上“http://”或“https://”协议头，同时也不需要“/”结尾。接口鉴权方式：设置接口鉴权方式，支持API鉴权、AK/SK和无身份验证。 API鉴权：填写API鉴权信息后，可在连接器中选择其响应参数，作为连接器请求参数的值。无身份验证：不需要任何验证信息，直接调用的接口，通常用于访问一些公开的接口。 AK/SK：模板填写AK/SK后，可调用华为云开放平台的API，会通过签名认证算法自动生成鉴权参数，在请求时添加到Header参数Authorization中，无需用户再次生成。鉴权平台：选择系统预置的“华为云”。“接口鉴权方式”设置为“AK/SK”时，才会显示该参数。鉴权信息：“接口鉴权方式”设置为“API鉴权”时，才会显示该参数。单击“创建鉴权信息”，设置鉴权信息。图6 新建鉴权信息 API鉴权名称：设置API鉴权的名称。 API鉴权描述：设置API鉴权的描述信息。 API鉴权地址：设置API鉴权的地址，地址不能包含空格且长度不能超过2048个字符。请求方式：设置接口请求方式，支持GET和POST。请求参数：设置接口请求参数。返回响应：设置接口返回参数。

ASTRO工作流 ASTROFLOW 自定义连接器

交换数据空间 EDS-申请开通并购买连接器:申请开通连接器

申请开通连接器登录交换数据空间官网。单击“管理控制台”，进入交换数据空间控制台界面。单击“我的空间”，在交换数据空间实例中，选择需要开通连接器的实例，单击实例卡片上的“连接器”。单击界面“申请新的连接器”，弹出“申请开通连接器”窗口。填写基本信息，具体参数说明如表1所示。表1 参数说明参数说明连接器规格仅支持“基础版”。连接器名称填写连接器的名称，根据规划自定义。要求如下：长度范围为1位~100位。名称由英文字母、数字、下划线（_）、中文、中划线（-）组成。只能以中文或者英文开头。连接器描述用户在文本框中输入对该连接器的描述信息。信息设置完成后，单击“确定”，此时连接器状态是“创建审批中”。待实例管理员审批通过后，连接器开通成功状态是“待创建”，单击连接器卡片购买连接器，具体参见购买连接器。单个用户可申请多个连接器，但申请的连接器的数量不能超过交换数据空间实例规格限定的数量。

交换数据空间 EDS 开通并购买/加入/转让连接器

交换数据空间 EDS-查询连接器数据主权保护倡议:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 data Object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。表4 ConnUserProtocol 参数参数类型描述 declaration_id String 协议ID。最小长度：8 最大长度：50 content String 协议内容。最小长度：0 最大长度：2048 状态码： 400 表5 响应Body参数参数参数类型描述 data Object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。状态码： 500 表6 响应Body参数参数参数类型描述 data Object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。

交换数据空间 EDS 连接器管理

交换数据空间 EDS-查询连接器数据主权保护倡议:URI

URI GET /v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id}/user-protocol 表1 路径参数参数是否必选参数类型描述 instance_id 是 String 实例ID，开通的交换数据平台实例ID。获取方法请参考获取实例ID。 connector_id 是 String 连接器ID，指定交换数据平台下连接器的ID。获取方法请参考获取连接器ID。 project_id 是 String 项目ID。获取方法请参考获取项目ID。

交换数据空间 EDS 连接器管理

交换数据空间 EDS-审批连接器申请:更多操作

更多操作连接器购买完成后，实例管理员还可以执行如表1所示的操作。表1 更多操作操作说明禁用连接器根据业务需求，对于当前不再使用的连接器，用户可以在交换数据空间实例控制台的“连接器管理”对连接器进行禁用。在“连接器管理”界面，选择待禁用的连接器，单击右侧“操作”列的“禁用”，可以将连接器禁用。恢复连接器禁用的连接器后续可以恢复，连接器中数据不受影响。在“连接器管理”界面，选择待恢复的连接器，单击右侧“操作”列的“恢复”，可以将连接器恢复。删除连接器将连接器进行删除，释放占用的资源，删除连接器之后，连接器中的数据将会被删除且无法找回，实例管理员只可以删除自己开通的实例。在“连接器管理”界面，选择“赠送版”的连接器，单击右侧“操作”列的“删除”，可以将连接器删除。退订连接器退订连接器，停止计费，连接器中的数据在退订后无法找回，实例管理员只可以退订自己购买的实例。在“连接器管理”界面，选择“基础版”的连接器，单击右侧“操作”列的“退订”，连接器停止计费。转让连接器支持将已经创建好的连接器转让给其他用户使用。在“连接器管理”界面，选择待转让的连接器，单击右侧“操作”列的“转让”，在弹框中选择接收者，接收者进入交换数据空间，签署“数据主权保护倡议”后，即可使用。扩容连接器若数据存储容量已用完，可通过“扩容”扩大容量，存放和交换更多的数据。在“连接器管理”界面，选择“基础版”的连接器，单击右侧“操作”列的“扩容”，进入“扩容连接器”界面，可通过拖动来选择结构化存储容量和非结构化存储容量，或在右侧输入扩容后的数值来完成扩容操作。

交换数据空间 EDS 连接器管理

交换数据空间 EDS-概述:菜单栏说明

菜单栏说明连接器管理控制台菜单如图1所示，菜单栏说明请参考表1。图1 连接器菜单表1 菜单栏说明菜单说明工作台用户通过快捷入口、统计概览、我的任务快速上手和操作EDS，详细介绍请参考工作台。数据目录数据目录提供了对数据资源文件的一系列操作方式，方便用户管理上传和接收的资源，详情介绍请参见数据目录。数据offer 数据offer提供了上架offer到数据市场的功能，同时用户可以查看offer编码、offer名称以及上架状态等详细信息，详细介绍请参见数据offer。数据合约通过数据合约，可查看当前用户提供和收到合约的详细信息，详细介绍请参见数据合约。数据市场数据市场提供数据搜索、数据订阅、数据收藏等功能，帮助用户快速、高效地找到有价值的数据，详细介绍请参见数据市场。连接器管理连接器管理提供了应用管理、数据源管理、策略模板、业务权限、连接器分组、用户、角色以及申请待办等的管理功能。应用管理详细介绍请参见应用管理。数据源管理详细介绍请参见数据源管理。策略模板、业务权限管理、连接器分组管理等详细介绍请参见数据源管理。查证&运营 EDS从数据、合约、用户三个维度提供查证追溯，让用户明确数据资产的流向和使用规范。同时展示空间实例中操作的TOP5用户看板、被操作最多的TOP5数据看板，详细介绍请参见查证&运营。任务管理任务管理记录了上传任务、采集任务、交换任务、下载任务的任务清单，详细介绍请参见任务管理。

交换数据空间 EDS 连接器管理员指南

交换数据空间 EDS-本连接器操作日志:查看本连接器操作日志

查看本连接器操作日志登录交换数据空间官网。单击“管理控制台”，进入交换数据空间控制台界面。单击“我的空间”，在交换数据空间实例中，选择实例，单击实例卡片上的“连接器”。然后选择连接器，单击连接器卡片上的“前往”，进入连接器控制台界面。选择界面左侧导航栏中的“连接器日志”，进入“连接器日志”界面。单击“连接器日志”界面上方“本连接器操作日志”，在“最热数据”下方按照时间顺序展示被操作的数据名称、数据编码、操作人、操作人连接器、操作时间和操作动作。本连接器操作日志记录了本连接器内对数据合约的创建、终止和审批的操作记录，以及对归档数据的下载、查看、加工和加工另存的操作记录。

交换数据空间 EDS 连接器日志

交换数据空间 EDS-本连接器操作日志:查看本连接器全部数据排名

查看本连接器全部数据排名登录交换数据空间官网。单击“管理控制台”，进入交换数据空间控制台界面。单击“我的空间”，在交换数据空间实例中，选择实例，单击实例卡片上的“连接器”。然后选择连接器，单击连接器卡片上的“前往”，进入连接器控制台界面。选择界面左侧导航栏中的“连接器日志”，进入“连接器日志”界面。单击“连接器日志”界面上方“本连接器操作日志”，单击“最热数据”右侧“全部数据排名”，进入“全部数据排名界面”，用户可查看排名、名称和操作次数。

交换数据空间 EDS 连接器日志

交换数据空间 EDS-本连接器操作日志:查看本连接器全部用户排名

查看本连接器全部用户排名登录交换数据空间官网。单击“管理控制台”，进入交换数据空间控制台界面。单击“我的空间”，在交换数据空间实例中，选择实例，单击实例卡片上的“连接器”。然后选择连接器，单击连接器卡片上的“前往”，进入连接器控制台界面。选择界面左侧导航栏中的“连接器日志”，进入“连接器日志”界面。单击“连接器日志”界面上方“本连接器操作日志”，单击“最热用户”右侧“全部用户排名”，进入“全部用户排名界面”，用户可查看排名、用户名称和操作次数。

交换数据空间 EDS 连接器日志

联接 CODEARTSLINK-OpenAPI连接器:创建OpenAPI连接

创建OpenAPI连接登录CodeArts Link控制台。在左侧导航栏选择“连接器”，在连接器页面单击“自定义连接”页签。单击一个OpenAPI连接器的“新建连接”。在“新建连接”弹窗中配置信息。表5 新建连接参数说明（Basic鉴权）参数说明连接名称输入连接名称。 url地址输入连接地址。用户名输入用户名。密码输入密码。描述输入描述信息。此处以OpenAPI连接器选择“Basic”鉴权类型为例，当OpenAPI连接器选择其它鉴权类型，那么在新建连接时，则配置对应的鉴权参数。如果自定义连接器为无鉴权方式，则无需新增连接。单击“确定”，完成创建OpenAPI连接。

联接 CODEARTSLINK 自定义连接器

联接 CODEARTSLINK-OpenAPI连接器:创建OpenAPI连接器

创建OpenAPI连接器登录CodeArts Link控制台。在左侧导航栏选择“连接器”，在连接器页面单击“自定义连接”页签。单击“新建连接器”，弹出“新建OpenAPI连接器”弹窗。选择导入文件。表1 导入文件说明参数说明选择一个OpenAPI标准的文件选择OpenAPI标准版本，可选择2.0或3.0。单击“下载模板”可下载对应版本的OpenAPI标准模板文件。根据业务需求修改模板文件并上传文件。鉴权类型选择连接器创建连接时，所需的认证类型。认证类型从OpenAPI规范中的安全方式中提取。此处以导入3.0版本模板文件为例，可选如下鉴权类型。 api_key：API KEY认证。当选择API KEY鉴权类型时，支持编辑鉴权参数。 x-bfs-iam-token： IAM 用户Token认证。 x-bfs-iam-aksk：IAM用户AK/SK认证。 Basic：Basic认证。无认证：无认证。动作选择需要配置的动作，动作将从OpenAPI规范中的API中提取。生成连接器后，可以添加触发器。配置基本信息。表2 基本信息说明参数说明图标自定义连接器的图标。单击“上传图标”，可从本地上传一个图标。不上传则默认使用根据连接器名称首字母生成的标准图标。连接器名称填写连接器的名称。标签填写连接器的标签。类别选择连接器的类别。 HTTP 数据库华为云服务 SaaS应用邮箱其他消息系统描述填写连接器的描述信息，用于识别不同的连接器。单击“创建并配置详情”，进入连接器的动作配置页面。单击，在“新建动作”弹窗中配置动作信息，并单击“确定”。表3 新建动作说明参数说明动作名填写动作名称。类型选择动作类型。 GET POST PUT DELETE 路径填写路径，例如“/history”。描述输入动作描述。新增动作完成后，配置动作参数。表4 动作参数说明参数说明输入参数配置输入参数，可配置“Query”、“Header”两种类型的输入参数。参数名：输入参数名。参数展示名：输入参数展示名。类型：选择参数类型，可选择“string”、“integer”、“number”。是否必填：配置此参数是否为必填参数。描述：输入参数描述。单击“操作”栏下的，可以新增参数。请求体配置请求体参数。当动作类型配置为“POST”、“PUT”、“DELETE”时，需要配置请求体参数。参数名：输入参数名。参数展示名：输入参数展示名。类型：选择参数类型，可选择“object”、“string”、“integer”、“number”。是否必填：配置此参数是否为必填参数。描述：输入参数描述。单击“操作”栏下的，可以新增参数。说明：第一个参数的参数名默认为“根节点”，参数类型默认为“object”，均不支持修改。返回值配置返回值参数。在“返回值”栏下单击后在下拉框可以新增不同的返回值。参数名：输入参数名。参数展示名：输入参数展示名。类型：选择参数类型，可选择“object”、“array”、“string”、“integer”。是否必填：配置此参数是否为必填参数。描述：输入参数描述。单击“操作”栏下的，可以新增参数。说明：第一个参数的参数名默认为“根节点”，参数类型默认为“object”，均不支持修改。单击“保存”，完成OpenAPI连接器的创建。

联接 CODEARTSLINK 自定义连接器

云服务器内容精选

连接器

7*24

备案

专业服务

退订

建议反馈

售前咨询热线