-
更多操作 连接器创建完成后,您可以执行如表3的操作。 表3 相关操作 操作 说明 查看连接器基本信息 在我的连接器列表中,单击连接器名称进入基本信息页签,即可查看连接器身份验证、ID、状态、创建时间、修改时间等基本信息。 查看触发事件 在我的连接器列表中,单击“触发事件”列的数字,可跳转至触发事件列表页面,您可以创建、编辑或删除触发事件。 查看执行动作 在我的连接器列表中,单击“执行动作”列的数字,可跳转至执行动作列表页面,您可以创建、编辑或删除执行动作。 编辑连接器 在我的连接器列表中,单击“操作”列的“编辑”可编辑连接器。编辑完成后需要重新发布才能在流中使用该连接器。 发布连接器 在我的连接器列表中,单击“操作”列的“发布”。连接器有任何更新,均需要重新发布后才能在流中使用,新建流默认使用新版本连接器。 共享连接器 连接器创建成功后,您可以共享连接器给其他华为云租户账号。共享连接器的操作请参见共享连接器。 创建触发事件 连接器至少需包含一个触发事件或一个执行动作。创建触发事件的操作请参见创建触发事件。 创建执行动作 连接器至少需包含一个触发事件或一个执行动作。创建触发事件的操作请参见创建连接器。 导入OpenAPI文件更新连接器 连接器需要更新修改时,您可以通过导入OpenAPI的方式更新连接器。更新完成后需要重新发布才能在流中使用该连接器。 下载连接器 在我的连接器列表中,单击“操作”列的“下载”,可下载连接器的JSON文件。 上架连接器 在我的连接器列表中,单击“操作”列的“上架”,可申请连接器上架。上架操作请参见上架连接器。 创建连接 连接器存在各种的认证配置,而连接就是来填写这些认证信息,只有在连接创建完成后,才可以正常使用连接器。创建连接的操作请参见连接管理。 删除连接器 在我的连接器列表中,单击“操作”列的“删除”,可以删除单个连接器。 在我的连接器列表中,可以批量选择待删除的连接器,单击连接器上方的“删除”。 说明: 用户只能删自己创建的本地连接器,而公共连接器无法删除,在执行删除操作前,请确保将云服务器上的数据已完成备份或者迁移,删除数据后,数据无法找回,请谨慎操作。 批量删除连接器时,系统会自动提示正在被使用的连接器名称以及备注信息,正在被使用的连接器不允许删除。 删除单个连接器时,系统会自动提示“该连接器正在被使用,请先删除正在使用的资源”,单击当前正在使用的引用资源的名称,进入资源界面进行处理,处理完毕后再进行删除。 连接器未被使用时,可以直接删除。 复制连接器 在我的连接器列表中,单击“操作”列的“复制”。 系统会自动弹出复制连接器的弹框,并自动生成复制后的连接器名称,单击“确定”,复制成功。 说明: 复制后的连接器名称支持自定义修改,同时系统会对复制后的连接器名称进行校验。 连接器名称长度不能超过60个字符,可包含中文、大小写字母、数字及下划线、中划线、英文小括号,名称开头不能是下划线、中划线、英文小括号。
-
创建(查看)合约消息 登录
交换数据空间 官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”或“收到的合约”页签。 在对应的合约列表中,单击“操作”列的“消息”。 在弹出的“消息”页签中输入留言的内容,单击“提交消息”,即可在该合约上发起消息会话。 留言成功后,除创建消息的用户外,合约相关用户在合约对应“操作”列的“消息”都会看到红点新消息提示,并可对此留言进行回复。 已生效的合约支持评论消息相关操作。 可查看合约的用户都可以查看合约中的所有评论消息,生效的合约可以新增评论以及删除自己创建的评论消息。
-
查看合约详情 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”或“收到的合约”页签。 在对应的合约列表中,单击合约编码,可以查看合约的详细信息。 可选:用户还可以在合约列表右上方,选择合约状态,或在搜索框中输入合约名称,单击快速筛选合约。
-
相关操作 创建连接器分组后,可对连接器分组进行如表2的操作。 表2 更多操作 操作 说明 查看连接器分组详情 选择对应连接器分组,单击“操作”列的“详情”,弹出“连接器分组详情”页面,可查看连接器分组的基本信息以及分组内连接器信息。 编辑连接器分组 选择对应连接器分组,单击“操作”列的“编辑”,在“编辑连接器”对话框中,对如表1参数进行修改,还可对分组中的连接器进行增加和删除,修改完成后,单击“保存”,编辑连接器分组成功。 删除连接器分组 选择对应连接器分组,单击“操作”列的“删除”,弹出“确认删除”对话框,单击“确定”,删除连接器分组成功。
-
新建连接器 参考登录华为云Astro大屏应用界面中操作,登录华为云Astro大屏应用界面。 在主菜单中,选择“数据中心”。 在左侧导航栏中,选择“连接器”。 在连接器管理页面,单击“新建连接器”。 设置基本信息。 图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,使用时可以解析出字段格式。 认证信息设置完成后,单击“测试”,测试接口是否有效。 测试成功后,单击“保存”,完成连接器的创建。
-
终止合约 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”页签。 选择待终止的合约,单击右侧“操作”列的“终止”。 在弹出的提示框,单击“确认”。 双方合约信息已删除。数据消费方处的资源文件已删除。
-
响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 data ConnectorDetail object 连接器详情。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。 表4 ConnectorDetail 参数 参数类型 描述 connector_id String 连接器ID。 connector_name String 连接器名称。 connector_description String 连接器描述。 create_time String 连接器创建时间。 connector_status String 连接器当前状态。 枚举值: ACTIVE INACTIVE create_user_name String 连接器创建人名称。 create_user_id String 连接器创建人ID。 connector_owner_name String 连接器管理员名称。 connector_owner_Id String 连接器管理员ID。 protocol_signed Boolean 签署ids协议标识。 状态码: 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 错误描述。
-
URI GET /v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参考获取项目ID。 instance_id 是 String 实例ID,开通的交换数据平台实例ID。 获取方法请参考获取实例ID。 connector_id 是 String 连接器ID,指定交换数据平台下连接器的ID。 获取方法请参考获取连接器ID。
-
响应示例 状态码: 200 OK 连接器详情。 { "data" : { "connector_id" : "c1bf9bd7-52fc-435b-ae55-************", "connector_name" : "连接器B", "connector_description" : "测试连接器", "create_time" : "2023-10-09T11:15:48Z", "connector_status" : "ACTIVE", "create_user_name" : "pa*******135", "create_user_id" : "0574************", "connector_owner_name" : "pa*******135", "connector_owner_Id" : "0574************", "protocol_signed" : true }, "total" : 0, "error_code" : null, "error_msg" : null}