华为云用户手册

URI GET /koodrive/ose/v1/share/public/files 表1 Query参数 参数 是否必选 参数类型 描述 shortUrl 是 String 分享短码 parentFolder 否 String 父目录id kdstoken 否 String 分享临时token pageSize 否 Integer 每页返回的个数，默认是100，可接受值最大值是100。注意在到达最后的列表之前，实际有可能返回部分或者空结果 pageCursor 否 String 当前页游标，由前一个响应的nextCursor获取，默认为0 sortType 否 Integer 排序类型，1:文件名排序，2：文件大小排序，4：修改时间排序（默认） sortDirection 否 Integer 排序方向，1：升序，2：降序（默认） refreshCount 否 Boolean 是否刷新计数 fileName 否 String 文件名

请求示例 /koodrive/ose/v1/share/public/files?shortUrl= 1592********6141825&parentFolder= &pageSize= 100&pageCursor=&sortType=&sortDirection= 2&refreshCount= true&kdstoken= 561bd7f1a874*********4a18ec2554d3ed9e301f11ee46fAuthorization:Bearer+10f88*************5a544791e9ff

响应示例 状态码： 200 OK { "link" : { "shareId" : "15929**********1824", "shortUrl" : "1592**********1825", "shareTime" : "2025-01-06T11:42:37.037Z", "ownerId" : "1592**********54689", "ownerName" : "", "expireTime" : "2025-01-18T11:58:00.000Z", "expireDate" : "11", "status" : 0 }, "files" : [ { "id" : "FnpODb**********Jw-KX6fZi", "fileName" : "fileName", "fileSuffix" : "", "size" : 106437, "parentFolder" : [ "DFdpAjykCN**********I8pAjaA1592924124240415488" ], "containers" : [ "IAAEDB**********24240415488" ], "fileType" : "15", "downloadLinks" : [ { "usage" : "content", "downloadLink" : "https://obs-koodrive.obs.cn-north-4.myhuaweicloud.com/********************?response-content-disposition********************e535458df2e3a90bfa788" }, { "usage" : "thumbnail", "downloadLink" : "https://obs-koodrive.obs.cn-north-4.myhuaweicloud.com/********************?response-content-disposition********************e535458df2e3a90bfa788" } ], "editedTime" : "2025-01-06T11:41:58.806Z" }, { "id" : "Fh0x**********GJ5KWFrqSc5Cp", "fileName" : "590x400.jfif", "fileSuffix" : "jfif", "size" : 106437, "parentFolder" : [ "DFdp********************2924124240415488" ], "containers" : [ "IAAEDB**********40415488" ], "fileType" : "15", "downloadLinks" : [ { "usage" : "content", "downloadLink" : "https://obs-koodrive.obs.cn-north-4.myhuaweicloud.com/********************?response-content-disposition********************e535458df2e3a90bfa788" }, { "usage" : "thumbnail", "downloadLink" : "https://obs-koodrive.obs.cn-north-4.myhuaweicloud.com/********************?response-content-disposition********************e535458df2e3a90bfa788" } ], "editedTime" : "2025-01-06T11:41:10.790Z" } ], "code" : 0, "msg" : "成功"}

请求示例 /koodrive/ose/v1/share/public/tasks{ "shareId" : "1592**********0176", "kdstoken" : "904670a****************f38cd43956fd6a4730d", "taskType" : 2, "containerId" : "IAAFxIRXsf**********108629249", "fileIds" : [ "FrlsFsGy**********JAk7u3eua6ggXn", "FgjawcN**********2ZfazyYFvsZ7" ], "targetFileId" : { "fileId" : "root", "containerId" : "IAAFxIRX**********0108629249" }}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Traceid 否 String 业务跟踪id（必须58位） Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 taskType 是 Integer 批量操作任务类型；1：下载，2：转存 containerId 是 String 文件所在空间 fileIds 是 Array of strings 文件id列表 targetFileId 否 FileIdInfo object 目标目录信息，转存的时候不为空 zipName 否 String 压缩包名称，与文件管理的打包下载一致 shareId 是 String 分享id kdstoken 否 String 分享临时token 表3 FileIdInfo 参数 是否必选 参数类型 描述 fileId 是 String 文件id containerId 是 String 空间id

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Traceid 否 String 业务跟踪id（必须58位） Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

请求示例 /koodrive/ose/v1/share/public/download?shareId=159***************1824&fileId=Fh0xWNbtxpimkQW***************Cp&kdstoken=216984f8888f7***************063d1d9f206cc30e6e8Authorization:Bearer+10f88*************5a544791e9ff

响应示例 状态码： 200 OK { "downloadUrl" : "https://obs-koodrive-obs.cn-north-4.myhuaweicloud.com/a*********************************ers=host&X-Amz-Expires=3600&X-Amz-Credential=CKJ3TYZ9M7QPX4SXS3", "code" : 0, "msg" : "成功"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Traceid 否 String 业务跟踪id（必须58位） Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 业务跟踪id（必须58位） language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code Integer 响应码 msg String 响应信息 jobInfo JobInfo object 工作信息 taskInfos TaskInfo object 任务信息 表4 JobInfo 参数 参数类型 描述 userId String 用户id taskId String 任务id taskType Integer 任务类型 taskStatus Integer 任务状态，0：待处理，1：处理中，2：已完成，3：已取消 taskResultCode Integer 任务处理结果，1：全部成功，2：部分失败，3：全部失败 createTime String 任务创建时间，格式为14位时间戳yyyyMMddHHmmss startTime String 任务开始时间，格式为14位时间戳yyyyMMddHHmmss endTime String 任务结束时间，格式为14位时间戳yyyyMMddHHmmss progress Integer 任务进度，进度百分比的值，如进度为70%时，返回的值是70 downloadUrl String 压缩包下载链接 表5 TaskInfo 参数 参数类型 描述 fileId String 老文件id status String 状态 newFileId String 新文件id srcContainerId String 源空间id

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Traceid 否 String 业务跟踪id（必须58位） Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

响应示例 状态码： 200 OK { "jobInfo" : { "userId" : "2838*******************cd451", "taskId" : "159********61056", "taskType" : 1, "taskStatus" : 2, "taskResultCode" : 3, "resultCode" : 99, "createTime" : "2025******034", "startTime" : "2025******5034", "endTime" : "2025******5034", "progress" : 100 }, "taskInfos" : [ { "fileId" : "Fh0xWNbt************FrqSc5Cp", "status" : "2", "srcContainerId" : "IAAED************0415488", "resultCode" : "******", "resultDesc" : "*******" }, { "fileId" : "FnpODb******w-KX6fZi", "status" : "2", "srcContainerId" : "IAAEDBRX******24240415488", "resultCode" : "******", "resultDesc" : "******************" } ], "code" : 0, "msg" : "success"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code Integer 响应码 msg String 响应信息 link CommonShareLink object 访问链接公共信息 表4 CommonShareLink 参数 参数类型 描述 shareId String 分享ID shortUrl String 分享短码 shareTime String 分享时间 ownerId String 分享人id ownerName String 分享人姓名 permission SharePermission object 分享权限（后续支持） expireTime String 失效时间 status Integer 分享状态，0：根据失效时间判断，1：文件已被删除，2：已失效 expireDate String 有效期 表5 SharePermission 参数 参数类型 描述 preview Boolean 预览权限 edit Boolean 编辑权限 download Boolean 下载权限

响应示例 状态码： 200 OK { "link" : { "shareId" : "1592**********1824", "shortUrl" : "1592**********825", "shareTime" : "2025-01-06T11:42:37.037Z", "ownerId" : "1592**********54689", "ownerName" : "", "expireTime" : "2025-01-18T11:58:00.000Z", "expireDate" : "11", "status" : 0 }, "code" : 0, "msg" : "成功"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Traceid 否 String 业务跟踪id（必须58位） Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

认证鉴权功能使用说明 数据建模引擎运行SDK支持通过如下两种认证方式调用接口，用户可根据实际业务场景进行自定义配置。 会话认证：通过Session认证调用数据建模引擎运行SDK的接口请求，具体操作请参见单点登录配置。 Token认证：通过Token认证调用数据建模引擎运行SDK的接口请求，具体操作请参见Token配置。 如果用户想关闭认证鉴权功能，可自主关闭会话（Session）认证和Token认证。关闭认证鉴权功能后，数据建模引擎运行SDK上的数据将不再受会话认证或Token认证保护，建议在上层应用中做好相应的权限管控，请谨慎操作。

创建 TICS 服务时依赖的IEF权限 如果您需要授予 IAM 用户基于“边缘节点部署”购买TI CS 服务的权限，则您需要为用户组配置IEF服务的自定义策略tics-ief-iam-min和系统角色IEF Administrator。 创建自定义策略tics-ief-iam-min，主要内容为创建IEF所需的iam权限。 图3 创建自定义策略 策略内容如下： { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "iam:agencies:listAgencies", "iam:permissions:listRolesForAgency", "iam:roles:getRole" ] } ]} 图4 策略内容 创建用户组tics_ief_min。 图5 创建用户组 为用户组授权。 单击用户组后的“授权”后进入选择策略界面，选择自定义策略tics-ief-iam-min和IEF Administrator系统角色完成授权。 图6 授权 将所需授权的用户加入用户组tics_ief_min，即可为用户授予相关权限。

创建IAM用户并授予TICS权限 创建用户组并授权。使用华为账号登录IAM控制台，创建用户组，并授予TICS的普通用户操作权限，如“TICS CommonOperations”。 创建用户组并授权的具体操作，请参见创建用户组并授权。 配置用户组的TICS权限时，注意选择权限的作用范围为“区域级项目”，搜索框中输入权限名“TICS”进行搜索，然后勾选需要授予用户组的权限，如“TICS CommonOperations”。 创建用户并加入用户组。在IAM控制台创建用户，并将其加入步骤1中创建的用户组。 创建用户并加入用户组的具体操作，请参见创建用户并加入用户组。

创建TICS服务时依赖的CCE权限 如果您需要授予IAM用户基于“云租户部署”购买TICS服务的权限，则您需要为用户组配置系统角色CCE Administrator和OBS Administrator。 创建用户组tics_cce_min。 图1 创建用户组 为用户组授权。 单击用户组后的“授权”后进入选择策略界面，选择系统角色CCE Administrator和OBS Administrator完成授权。 选择CCE Administrator和OBS Administrator系统角色后，系统会自动勾选其依赖的其他系统角色，因此实际中授权更多的系统角色。 图2 授权 将所需授权的用户加入用户组tics_cce_min，即可为用户授予相关权限。 创建cce类型的计算节点之后，假如需要缩小权限，可自行把子用户从tics_cce_min用户组中删除。

注册账号并实名认证 账号是您访问华为云的责任主体，有关账号的详细介绍请参见账号中心。此处介绍如何注册一个华为账号。若您已有华为账号，可以略过此部分内容。 打开华为云网站www.huaweicloud.com。 单击页面右上角的“注册”按钮。 在注册页面，根据页面提示完成账号注册。 为了能够给您提供更好的云服务使用体验，建议您优先完成实名认证。实名认证分为个人账号和企业账号认证，不同账号类型认证的方法请参考以下链接。若您的账号已通过实名认证，可以略过此部分内容。 个人账号如何完成实名认证 企业账号如何完成实名认证 实名认证信息提交后，请耐心等待审核结果，最长3个工作日内完成审核。 实名认证通过后需要40分钟才能生效。 父主题： 准备工作

查看空间操作记录 TICS提供透明的空间操作记录。空间的创建、部署、删除、升级回滚操作都会被详细记录。 在详情中，操作进程以可视化的方式展示，清晰展示空间的部署、升级、回滚、删除步骤，在出现问题时便于分析排查。 用户登录TICS控制台。 进入TICS控制台后，单击页面左侧“空间管理”，进入空间管理页面。 单击页面右上角的“操作记录”按钮，查看操作记录。 图8 入口 单击“查看详情”，可查看空间操作的具体信息。 图9 查看详情 操作详情以可视化的形式展示，使操作进程更直观、更清晰。 图10 可视化页面

使用TICS的用户角色 根据人员的职能进行划分，使用TICS的用户主要可以分为以下两类。 组织方 面向熟悉业务并具有管理、决策、审核权限的管理人员。组织方具有TICS的所有权限，包括创建空间、邀请空间成员、删除空间等权限。例如，在创建空间模块中，组织方可以对合作方人员发布的数据进行审核，把好质量关。 合作方 合作方使用数据源计算节点模块实现自主可控的数据源注册、隐私策略（脱敏、加密、水印）的设定、元数据的发布等，为数据源计算节点提供全生命周期的可靠性监控、运维管理。

管理实例 实例管理是 可信智能计算服务 提供的一项查看计算节点作业实例的功能。通过实例管理，用户可以查看到该计算节点所有作业的执行实例，并查看作业的状态、计算过程、执行结果。 用户登录TICS控制台。 进入TICS控制台后，单击页面左侧“计算节点管理”，进入计算节点管理页面。 在“计算节点管理”页面，查找需要发布数据的计算节点名称，单击“计算节点名称”进入计算节点详情页。 图1 选择计算节点 在“计算节点详情”页，单击“前往计算节点”，在登录页正确输入部署计算节点时设置的“登录用户名”和“密码”。 图2 前往计算节点 进入计算节点管理界面后，选择左侧“实例管理”。 实例管理页面上方展示了计算节点资源使用概况，分别为当前节点的多方安全计算和可信联邦学习的CPU资源当前使用量，并每分钟刷新一次。下方列表默认优先展示失败状态的实例，可通过列表调整按照执行时间排序，并支持以下筛选条件： 实例ID：全匹配或前N位模糊匹配 作业ID：全匹配 作业名称：模糊匹配 实例类型、执行状态：列表筛选 图3 实例管理页面 在实例列表中，单击操作栏的“编辑”，可在弹出页面修改对应作业；单击操作栏的“查看结果”或者“作业报告”，可在弹出的页面查看执行结果和作业报告； 在实例列表中，查找待查看计算过程的作业，单击实例ID展开，在操作栏单击“计算过程”。 图4 在计算节点侧查看作业计算过程 计算过程页面可以单击任务节点，查看开始和结束时间等信息。在计算过程页面下方详情列表打开任务详情，可以查看更详细的计算过程信息。 图5 作业计算过程信息详情（截图为多方安全计算作业示例，请以实际作业为准） 父主题： 计算节点管理

CCE服务委托授权 由于CCE在运行中对计算、存储、网络以及监控等各类云服务资源都存在依赖关系，因此当您首次登录CCE控制台时，CCE将自动请求获取当前区域下的云资源权限，从而更好地为您提供服务。 CCE的服务授权为全局配置，只要您所使用的账号在当前Region曾经进行过服务授权，则无需重新配置，可以跳过本节操作。 图1 服务授权 当您同意授权后，CCE将在IAM中创建名为“cce_admin_trust”委托，统一使用系统账户“op_svc_cce”对您的其他云服务资源进行操作，cce_admin_trust委托具有Tenant Administrator权限。Tenant Administrator拥有除IAM管理外的全部云服务管理员权限，用于对CCE所依赖的其他云服务资源进行调用，且该授权仅在当前区域生效。关于资源委托详情，您可参考委托进行了解。

启用 区块链 审计服务（可选） 若您希望空间启用区块链服务（ BCS ）来审计任务信息，请仔细阅读本章节。 空间发起方需要根据基于CCE集群创建联盟链完成联盟链的创建过程。 “区块链类型”参数值需要选择“联盟链”，否则将影响后续操作。 发起方按照组建联盟链中“邀请成员”部分的描述，邀请参与方加入联盟链。 参与方登录区块链服务（BCS）按照组建联盟链中“同意/拒绝邀请”部分的描述，创建BCS实例并加入联盟链。 发起方、参与方各自根据合约仓库章节中下载模板的描述，下载“数据上链存证和查询合约模板（又称链代码）”并保存到本地。 发起方、参与方各自按照链代码管理章节中“安装链代码”部分的描述，上传步骤4中已保存至本地的链代码压缩包。 注意事项： “链代码名称”参数值须为“ticsrule”。 “链代码版本”须为“1.0”。 勾选需要背书的组织及Peer节点。 链代码背书的组织名称必须选择organization。 发起方按照链代码管理章节中“实例化链代码”部分的描述，完成实例化链代码操作。 注意事项： “初始化函数”参数值须为“init”。 “背书策略”勾选“任意组织背书” 完成上述步骤后用户可前往区块浏览器查看上链的初始化日志信息。 父主题： 准备工作

验证安全沙箱防护能力 接下来模拟篡改文件的恶意行为，来验证安全沙箱防护能力。 发起方获取某个横向联邦训练作业的训练结果路径。 图1 获取作业结果路径 发起方执行恶意脚本，试图篡改所获取的路径中的作业训练结果。 图2 执行恶意脚本 发起方执行恶意脚本后，由于安全沙箱确保每个横向联邦作业都是隔离的，当某个作业想去访问或篡改其他作业相关的文件时，无法找到作业执行结果文件，因此脚本执行失败、无法篡改，从而实现安全防护。 图3 恶意脚本执行结果

计算节点侧查看审计日志 用户登录TICS控制台。 进入TICS控制台后，单击页面左侧“计算节点管理”，进入计算节点管理页面。 在“计算节点管理”页面，查找需要发布数据的计算节点名称，单击“计算节点名称”进入计算节点详情页。 图1 选择计算节点 在“计算节点详情”页，单击“前往计算节点”，在登录页正确输入部署计算节点时设置的“登录用户名”和“密码”。 图2 前往计算节点 在界面左侧选择“审计日志”，在弹出的界面查看详细信息。 图3 审计日志 事件信息内容主要有：参与方[参与方别名]创建[作业类型]作业[作业名称:作业实例id]，使用数据集[数据集名称]，耗费[时间]，输出[条数]。 多方安全计算作业中的作业详情信息，即SQL语句也会参与审计，但该信息属于敏感信息不会上链。

约束限制 只有空间升级失败或者回滚失败，才能进行回滚。 删除中的空间无法进行空间回滚。 空间回滚的过程中会导致空间的不可用。 回滚过程的相关操作记录将会保存。 由于1.20.0版本架构变化，如果需要跨1.20.0版本回滚，则需要联系客服或技术支持人员，先刷新后台数据库，再通过TICS控制台进行空间回滚。 如果未刷新数据库，直接通过TICS控制台将TICS 1.20.0及后续版本回滚到1.20.0之前版本，则会导致回滚后业务功能故障。

使用场景 连接器使用场景：参与方的数据信息分布在不同的资源服务上，即可通过连接器管理功能来快速连接到名下的各类资源服务。 数据创建使用场景：参与方加入空间后，需要提供自己的数据集信息，用户即可通过数据创建功能，获取到名下详细的资源列表。同时，有敏感信息的数据，还可以单独设置隐私策略，并在发布到空间侧后对其他参与方生效，限制敏感信息的使用。 数据预处理使用场景：训练机器学习模型前，可通过转换函数将特征数据转换成更加适合算法模型的特征数据。