华为云用户手册

  • 响应参数 状态码: 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 错误描述。
  • 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。
  • URI DELETE /v1/{project_id}/eds/instances/{instance_id}/domains/{domain_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参考获取项目ID。 instance_id 是 String 实例ID,开通的交换数据平台实例ID。 获取方法请参考获取实例ID。 domain_id 是 String 租户ID。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 data String 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 data Object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。 状态码: 500 表5 响应Body参数 参数 参数类型 描述 data Object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。
  • 查看任务详情 登录 交换数据空间 官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“任务管理”,在“任务管理”界面记录了上传任务、采集任务、交换任务、下载任务的任务清单。 单击需要查看任务详情的页签,系统展示页签下的任务列表,可以查看该页签下的任务号、数据名称、状态、子任务、操作等。 以“上传任务”为例说明。 单击“上传任务”页签,通过状态、任务号等进行精确搜索。 单击任务号,展示子任务详情,单击操作列的“详情”,查看任务详情记录。 图1 任务管理
  • 还原数据 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“删除的数据”,进入“删除的数据”界面。 支持单个数据还原以及批量多个数据还原。 还原单个数据。单击已删除数据操作列的“还原”,将数据还原在原归档路径。 批量还原多个数据。勾选需要还原的多个数据,单击列表上方“还原”,将数据还原在原归档路径。
  • 清空数据 已删除的目录中的数据为软删除,清空后不影响“收到的数据、发出的数据、offer管理、合约管理、申请待办”中的数据。 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“删除的数据”,进入“删除的数据”界面。 支持单个数据清空以及批量多个数据清空。 清空单个数据。单击已删除数据操作列的“清空”,然后单击“确定”,将单个数据清空移除。 批量清空多个数据。勾选需要清空的多个数据,单击列表上方“清空”,然后单击“确定”,将多个数据清空移除。
  • 按合约查询团队收发的合约 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要查询团队收发合约的团队卡片,单击团队卡片上的“团队收发”,进入团队收发的合约页面。 单击界面中的“按合约”,即可看到按合约展示的团队收发合约。 单击合约右上角“消息”,支持输入留言信息,并查看交换方与接收方之前的留言消息。 单击合约下的批次名称,查看该批次下的数据信息及批次信息。
  • 按批次查询团队收发的合约 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要查询团队收发合约的团队卡片,单击团队卡片上的“团队收发”,进入团队收发的合约页面。 单击界面中的“按批次”,即可看到按批次展示的团队收发合约。 单击合约右上角“消息”,支持输入留言信息,并查看交换方与接收方之前的留言消息。 单击合约下的批次名称,查看该批次下的数据信息及批次信息。
  • 按交换方查询团队收发的合约 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要查询团队收发合约的团队卡片,单击团队卡片上的“团队收发”,进入团队收发的合约页面。 单击界面中的“按交换方”,即可看到按交换方展示的团队收发合约。 单击合约操作列“详情”,查看合约详情信息,在合约详情页面,单击“全部消息”页签,支持输入留言信息,并查看交换方与接收方之前的留言消息。
  • 添加成员 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要添加成员的团队卡片,在团队卡片右上方单击“成员管理”,进入“团队成员管理”页面。 在“团队成员管理”页面单击“添加成员”,在弹出的窗口中选择用户,然后单击“确定”。 设置用户的数据范围和角色,用户可以根据需求选择数据范围和角色,或复制已有用户的数据范围和角色。 选择数据范围和角色:分为按团队维度设置和按文件夹维度设置。 按团队维度设置:负责团队成员管理、文件夹增删改、移动、授权;负责在团队目录独立完成数据交换作业。 可添加角色有成员管理员、数据源管理员、合约管理员、资源管理员、数据发送人、数据消费者、成员。 按文件夹维度设置:负责文件夹成员管理、文件夹增删改、移动、授权,在所选文件夹下进行资源上传、消费数据、发送数据。可添加角色的有成员管理员(文件夹)、数据源管理员、数据发送人、数据消费者、成员。 复制数据范围和角色:通过复制已有用户的数据范围和角色来设置本成员的数据范围和角色。输入要复制的成员名称或账号,搜索选择即可。 单击“确定”,成员添加完成。
  • 查看成员 进入交换数据空间控制台界面,单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 然后选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要添加成员的团队卡片,在团队卡片右上方单击“成员管理”,进入“团队成员管理”页面。 在“团队成员管理”页面展示成员列表,查看成员的角色以及数据范围。
  • 修改成员角色 进入交换数据空间控制台界面,单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 然后选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要添加成员的团队卡片,在团队卡片右上方单击“成员管理”,进入“团队成员管理”页面。 在“团队成员管理”页面,单击成员列表操作列“编辑”,在编辑角色页面,重新设置数据范围和角色,单击“确定”。
  • 删除成员 进入交换数据空间控制台界面,单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 然后选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“团队数据”,进入“我的团队”页面。 在“我的团队”页面找到需要添加成员的团队卡片,在团队卡片右上方单击“成员管理”,进入“团队成员管理”页面。 在“团队成员管理”页面,单击成员列表操作列“删除”,然后在弹框中单击“确定”,成员删除成功。
  • 相关操作 创建连接器分组后,可对连接器分组进行如表2的操作。 表2 更多操作 操作 说明 查看连接器分组详情 选择对应连接器分组,单击“操作”列的“详情”,弹出“连接器分组详情”页面,可查看连接器分组的基本信息以及分组内连接器信息。 编辑连接器分组 选择对应连接器分组,单击“操作”列的“编辑”,在“编辑连接器”对话框中,对如表1参数进行修改,还可对分组中的连接器进行增加和删除,修改完成后,单击“保存”,编辑连接器分组成功。 删除连接器分组 选择对应连接器分组,单击“操作”列的“删除”,弹出“确认删除”对话框,单击“确定”,删除连接器分组成功。
  • 为收藏的文件创建文件夹 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“我的收藏”,进入“我的收藏”界面。 单击“新建文件夹”,自定义配置文件夹名称,把收藏的文件夹或资源移动归类,方便管理。
  • 查看收藏的资源文件 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据目录”,选择“我的收藏”,进入“我的收藏”界面。 页面展示已收藏的资源或文件,单击资源或文件名称,页面跳转到对应的资源或文件夹目录,方便快速查看。
  • 审批加入实例申请 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在“我的空间”界面中,选择购买交换数据空间中购买的实例,单击实例卡片上的“控制台”,跳转至实例控制台界面。 在控制台界面中,选择左侧导航栏中的“成员管理”,进入“成员管理”界面。 选择需要审批的申请,单击“操作”列的“审批”。 在弹出的审批窗口中,确认申请信息无误后,选择“审批选项”的“通过”,填写审批理由,单击“确定”,审批通过。
  • EDS自定义策略样例 示例1:授权用户申请加入连接器的权限 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "eds:connector:list", "eds:connector:join" ] } ] } 示例2:拒绝用户删除云服务 拒绝策略需要同时配合其他策略使用,否则没有实际作用。用户被授予的策略中,一个授权项的作用如果同时存在Allow和Deny,则遵循Deny优先。 如果您给用户授予EDS FullAccess的系统策略,但不希望用户拥有EDS FullAccess中定义的删除交换数据空间实例的权限,您可以创建一条拒绝删除云服务的自定义策略,然后同时将EDS FullAccess和拒绝策略授予用户,根据Deny优先原则,则用户可以对EDS执行除了删除交换数据空间实例外的所有操作。拒绝策略示例如下: { "Version": "1.1", "Statement": [ { "Effect": "Deny", "Action": [ "eds:instance:delete" ] } ] }
  • 示例流程 图1 给用户授予EDS权限流程 创建用户组并授权 在 IAM 控制台创建用户组,并授予交换数据空间服务的权限“EDS ReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户,并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台,切换至授权区域,验证权限,用户权限包含“EDS ReadOnlyAccess”。在“服务列表”中选择交换数据空间,进入交换数据空间首页,单击界面右上角“开通交换数据空间实例”,如果无法开通交换数据空间实例,表示“EDS ReadOnlyAccess”已生效。 在“服务列表”中选择除交换数据空间外(假设当前策略仅包含EDS ReadOnlyAccess)的任一服务,若提示权限不足,表示“EDS ReadOnlyAccess”已生效。
  • 支持审计的关键操作列表 表1 云审计 服务支持的交换数据空间操作列表 操作名称 资源类型 事件名称 创建空间实例 instance createInstance 删除空间实例 instance deleteInstance 申请加入空间实例 instance applyInstance 空间实例的加入审批 instance changeApproveRecord 创建连接器 connector createConnector 删除连接器 connector deleteConnector 更新连接器状态 connector updateConnector 申请开通连接器 connector createEdsConnectorApproval 申请加入连接器 connector applyConnector 连接器开通审批 connector updateConnectorApproval 连接器加入审批 connector approveConnectorApplication 上架offer offer createofferWithInstance 订阅offer offer createSubscriptionRecord 收藏offer offer createFavourite 下架offer offer deleteoffer 审批合约 agreement sendAgreementApproveWithInstance 终止合约 agreement terminateAgreement 点对点交换 data_resource createOneToOneData 上传文件 file uploadFile 上传数据源 data_source createJdbcDataSet 创建数据源 data_source createDataSource 删除数据源 data_source deleteDataSource 编辑数据源 data_source updateDataSource 测试数据源连接 data_source validateDataSourceConnection 添加用户 user createConnectorUser 删除用户 user deleteConnectorUser 用户授权 user_role updateConnectorUserRole
  • 概述 交换数据空间支持把FTP作为一种数据源类型,并用于数据上传和下载。在使用FTP数据源前,需要先接入数据源。 使用FTP数据源存在一定的安全风险,如:FTP客户端与服务器所有的数据传送都是通过明文的方式,包括用户名和密码等敏感信息。 如需关闭FTP服务,可参考如下操作。 在Windows中关闭FTP服务:打开“控制面板”,选择“程序”,然后单击“打开或关闭 Windows功能”。 在“Windows功能”窗口中找到“Internet Information Services”,展开它并找到“FTP服务器”,将其取消选中,然后单击“确定”。 在Linux系统(Red Hat)中关闭FTP服务: ps -ef | grep ftp # 查看本地是否有包含FTP的进程开启 service vsftpd stop # 停止FTP服务 FTP数据源在华为云的E CS 上建立,在使用之前需要根据FTP配置文件的配置项来确定ECS主机安全组放通的端口范围,如不放开相应的端口范围,数据传输将会失败。 pasv_max_port=0,设置在PASV工作方式下,数据连接可以使用的端口范围的上界。默认值为0,表示任意端口。 pasv_mim_port=0,设置在PASV工作方式下,数据连接可以使用的端口范围的下界。默认值为0,表示任意端口。 如上配置项是限制数据传输的具体端口,ECS主机安全组入方向的端口需要针对该端口范围开放。如全为0,则需要将端口全部放开。如不为0,则根据端口范围的上界和下界确定需要放开的端口。
  • 接入数据源 上传Oracle需要上传表所在的schema的只读权限,同时需要赋予该用户DBA_CONSTRAINTS 、DBA_CONS_COLUMNS、DBA_TAB_COLUMNS、DBA_TABLES这四个表的查询权限。 上传mysql需要具有数据库的只读权限。 上传dws需要上传表所在的schema的只读权限。 下载结构化数据到mysql需要数据库的建表(create)和写入(insert)权限,而下载到Oracle和dws需要下载至目标schema的写入(insert)和建表(create)权限。 接入DWS数据源 接入OBS数据源 接入ORACLE数据源 接入 MRS _HIVE数据源 接入FTP数据源 接入MYSQL数据源 接入API数据源 父主题: 数据源管理
  • 工作台概述 EDS工作台界面展示了快捷入口、统计概览、我的任务、账号详情等内容,方便用户快速了解、上手和操作EDS,如图1所示。 快捷入口 包含上传资源、上架offer、创建合约、发送数据,方便用户快捷使用。 统计概览 统计我的资源(上传的)、我的Offer(上架的)、我的合约(发出的)数据,单击后展示数据详情。 我的任务 展示待办和申请数据概览,相关说明请参考我的任务。 账号详情 工作台界面右侧展示了账号详情信息,包含账号名称、账号ID、连接器信息以及我的收藏。 图1 EDS工作台 父主题: 工作台
  • 订阅offer 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据市场”,在搜索框中输入需要查询的offer关键字,单击跳转到数据offer列表界面。 用户可通过筛选“热度”来获得最近的热门数据,也可以通过选择“提供方”进行进一步筛选。 筛选到所需的数据offer后,单击offer名称,进入“offer详情”界面,可查看数据基本信息和数据列表信息。 单击界面右上角“订阅”,在“订阅详情”界面中,编辑使用策略,相关参数说明如表1。 表1 参数说明 参数 说明 已选操作 数据消费方自定义数据使用的限制方法,通过“约束条件”对查看、加工和下载进一步限制。 查看:用户可以查看资源文件详细信息。 加工:用户可以在预览的时候处理数据资源文件。 下载:用户可以下载数据资源文件到本地。 约束条件 通过Who、When、How to、How many等几个方面限制数据消费方对数据的使用。 Who:限定消费方的用户或团队进行数据交换。选择的用户需拥有数据接收者角色,才可以接收数据。选择的团队为消费方连接器下的某个团队。 When:控制使用的时间,包括起始时间和截止时间。 How many:限制可用操作的次数,默认不输入,则不限制次数。 订阅offer时,数据消费方可以在数据上架offer时提供的使用控制策略上申请新的策略,覆盖提供方的策略。 输入订阅原因后,单击“确定”。 公开offer直接订阅成功,受控offer等待数据提供方审批。用户可在“工作台”的“我的任务”中选择“申请”页签查看申请任务的状态。
  • 终止合约 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”页签。 选择待终止的合约,单击右侧“操作”列的“终止”。 在弹出的提示框,单击“确认”。 双方合约信息已删除。数据消费方处的资源文件已删除。
  • 查看合约详情 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”或“收到的合约”页签。 在对应的合约列表中,单击合约编码,可以查看合约的详细信息。 可选:用户还可以在合约列表右上方,选择合约状态,或在搜索框中输入合约名称,单击快速筛选合约。
  • 创建(查看)合约消息 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据合约”,选择“发出的合约”或“收到的合约”页签。 在对应的合约列表中,单击“操作”列的“消息”。 在弹出的“消息”页签中输入留言的内容,单击“提交消息”,即可在该合约上发起消息会话。 留言成功后,除创建消息的用户外,合约相关用户在合约对应“操作”列的“消息”都会看到红点新消息提示,并可对此留言进行回复。 已生效的合约支持评论消息相关操作。 提前终止、到期关闭、发送失败的合约支持查看历史消息。 可查看合约的用户都可以查看合约中的所有评论消息,生效的合约可以新增评论以及删除自己创建的评论消息。
  • 查看offer详情 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据offer”,在offer列表中,单击“操作”列的“详情”,查看offer的详细信息。 在数据offer详情中,单击数据清单区域数据列表“操作”列的“查看”,查看数据资源文件的详细信息,目前只支持查看Excel和PDF格式的文件。
  • 重新上架offer 登录交换数据空间官网。 单击“管理控制台”,进入交换数据空间控制台界面。 单击“我的空间”,在交换数据空间实例中,选择实例,单击实例卡片上的“连接器”。 选择连接器,单击连接器卡片上的“前往”,进入连接器控制台界面。 选择界面左侧导航栏中的“数据offer”,选择已下架的数据offer,单击“操作”列的“重新上架”。 在弹出的确认框中,单击“确定”。 该offer状态变为“已上架”,从数据市场中重新上架。 当前仅支持对“已下架”的offer进行重新上架操作。
共100000条