云服务器内容精选

  • KooDrive权限 在华为云Console上开通KooDrive的企业租户使用的是华为云账号,开通KooDrive服务后,KooDrive会以该华为云账号创建一个系统管理员账号,用该账号登录KooDrive业务应用后,可以进行组织(部门和用户)和空间管理。通过该系统管理员创建的用户,需要给用户授予角色,才能使得用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限操作KooDrive对应拥有权限的资源。 KooDrive的权限管理采用的基于角色的访问控制的策略,权限与角色相关联,用户通过成为适当角色的成员而得到该角色所赋予的权限。当前KooDrive预置了3个系统角色,分别为系统管理员、部门管理员和普通用户,各个角色赋予的权限参考表1。当前版本不支持用户自定义角色。 表1 KooDrive系统角色 角色名称 赋予权限 角色类型 系统管理员 系统管理员,除不能查看非本人名下的个人空间下的文件以外,其他KooDrive所有的资源均能操作,详细的权限列表如下: 组织管理:组织下所有部门的创建、查询、修改、删除操作。 用户管理:组织下所有部门用户的创建、查询、修改、删除操作。 空间管理:组织下所有部门或个人空间的创建、查询、修改、删除操作。 团队空间:组织下所有部门空间内文件的所有操作,如文件/目录的创建、文件复制、删除等操作。 个人空间:仅能操作属于自己名下的个人空间的文件。 回收站:拥有个人回收站和所有团队回收站的操作权限。 系统角色 部门管理员 部门管理员,拥有该权限的用户可以拥有本部门的操作权限,如管理部门空间和部门成员的个人空间,详细的权限列表如下: 组织管理:查询组织下所有部门列表,部门信息。 用户管理:拥有本部门所有用户的管理权限,如查询本部门用户列表及详情,添加、禁用、删除用户等操作。 空间管理:查询组织下所有部门空间和本部门用户的个人空间,分配、修改、禁用、启用、删除本部门空间和部门成员个人空间。 团队空间:组织下所有部门空间内文件的所有操作,如文件/目录的创建、文件复制、删除等操作。 个人空间:仅能操作属于自己名下的个人空间的文件。 回收站:拥有个人回收站所有的操作权限;拥有本部门回收站所有操作权限。 系统角色 普通用户 普通用户,拥有自己名下个人空间的文件所有操作权限,和所在部门空间的受限操作权限,详细的权限列表如下: 个人空间:操作属于自己名下的个人空间的文件。 团队空间:除不能删除团队空间的文件,拥有其他所有所在部门的空间文件操作权限。 回收站:拥有个人回收站所有的操作权限,无团队回收站操作权限。 系统角色
  • 团队空间 团队空间包括部门空间和群组空间。团队空间是部门成员、群组成员共享文件的空间。 各部门空间之间、各群组空间之间相互隔离,部门空间仅部门成员用户可见,群组空间仅群组成员可见。创建部门时若分配了部门空间且空间为启用状态,则创建的部门空间在团队空间首页可见。 团队空间首页主要由团队空间辅助操作和团队空间卡片视图两部分组成。 图1 团队空间首页 团队空间辅助操作 操作按钮:提供创建群组空间操作。 :按照空间名称关键字搜索空间,支持模糊搜索。 :通过“全部空间”下拉框选择卡片视图中展示的空间,包括部门空间、我拥有的空间、我加入的空间。 团队空间卡片视图 展示部门空间和群组空间卡片,部门空间卡片内显示“部门空间”字样。默认展示10个空间,鼠标滚动可加载下一页。 部门卡片展示部门空间头像、部门名称、部门组织路径、部门人数、部门空间总容量、已使用容量。云空间的系统管理员可以看到企业内所有的部门空间,普通用户和部门管理员只能看到自己所属部门的团队空间。 群组卡片展示群组空间头像,群组名称、群组拥有者(若无则不展示)、群组人数、群组空间总容量、已使用容量。 群组空间卡片视图提供管理群组空间操作。 图2 团队空间页 团队空间页主要由文件(夹)辅助操作和团队空间文件列表/卡片视图两部分组成。 文件(夹)辅助操作 目录信息:左上角展示当前团队空间路径信息。 已选中X个文件/文件夹:以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 :按照文件(夹)名称关键字搜索当前团队空间下的文件(夹),支持模糊搜索。 :通过“全部类型”下拉框选择列表中展示的文件(夹)类型。 :单击后以列表视图展示当前团队空间文件(夹)。 :单击后以卡片视图展示当前团队空间文件(夹)。 团队空间文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件(夹)归属者、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则文件名中展示图片缩略图,单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间,根据文件(夹)格式展示对应图标。默认按照更新时间降序排列,文件夹排序始终在上方。若文件为图片文件,则卡片中展示图片缩略图,单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作,包括: 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 管理员转发团队空间文件至个人空间 普通用户转发团队空间文件至个人空间 查看文件(夹)详细信息 父主题: 用户中心界面一览
  • 包年/包月资源 对于包年/包月计费模式的云空间服务,用户在购买时会一次性付费,服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月的云空间服务,您可以执行退订操作,系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能,为避免继续产生费用,请在自动续费扣款日(默认为到期前7日)之前关闭自动续费。
  • 续费相关的功能 包年/包月云空间服务续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月云空间服务从购买到被自动删除之前,您可以随时在KooDrive控制台为云服务器续费,以延长云空间服务的使用时间。 自动续费 开通自动续费后,云空间服务会在每次到期前自动续费,避免因忘记手动续费而导致资源被自动删除。 在一台包年/包月云服务器生命周期的不同阶段,您可以根据需要选择一种方式进行续费,具体如图1所示。 图1 云空间服务生命周期 云空间服务从购买到到期前,处于正常运行阶段,资源状态为“运行中”。 到期后,资源状态变为“已过期”。 到期未续费时,云空间服务首先会进入宽限期,宽限期到期后仍未续费,资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期,如果保留期内仍未续费,资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在云空间服务到期前均可开通自动续费,到期前7日凌晨3:00首次尝试自动续费,如果扣款失败,每天凌晨3:00尝试一次,直至云空间服务到期或者续费成功。到期前7日自动续费扣款是系统默认配置,您也可以根据需要修改此扣款日。
  • 响应示例 状态码: 200 OK { "code" : "string", "msg" : "string", "taskInfo" : { "userId" : "string", "taskId" : "string", "taskType" : 0, "taskStatus" : 0, "taskResultCode" : 0, "resultCode" : 0, "createTime" : "string", "startTime" : "string", "endTime" : "string", "progress" : 0, "downloadUrl" : "string" } }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应信息 taskInfo TaskInfo object 异步任务信息 表4 TaskInfo 参数 参数类型 描述 userId String 用户id taskId String 任务id taskType Integer 任务类型 taskStatus Integer 任务状态,0:待处理,1:处理中,2:已完成,3:已取消 taskResultCode Integer 任务处理结果,1:全部成功,2:部分失败,3:全部失败 resultCode Integer 任务内容处理结果 createTime String 任务创建时间,格式为14位时间戳yyyyMMddHHmmss startTime String 任务开始时间,格式为14位时间戳yyyyMMddHHmmss endTime String 任务结束时间,格式为14位时间戳yyyyMMddHHmmss progress Integer 任务进度,进度百分比的值,如进度为70%时,返回的值是70 downloadUrl String 压缩包下载链接
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} X-Traceid 否 String 业务跟踪id(必须58位) 表2 请求Body参数 参数 是否必选 参数类型 描述 taskId 是 String 任务ID shareId 是 String 分享id kdstoken 否 String token
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应信息 nextCursor String 分页游标,如果不存在,代表已返回最后一个 relatedToMeInfos Array of RelatedToMeRecord objects 分享链接列表 total Long 总数 表4 RelatedToMeRecord 参数 参数类型 描述 operator String 操作员名称 operateType Integer 操作类型;1:分享 operateTime String 操作时间 id String 记录id,操作类型为分享则是分享id displayName String 展示名称 files Array of FileInfo objects expireTime String 失效时间 status Integer 0:根据失效时间判断;1:文件已被删除,2:空间已失效(空间已禁用删除或者当前用户无空间权限) operatorId String 操作员id containerId String 空间id tenantId String 租户id 表5 FileInfo 参数 参数类型 描述 id String 文件id size String 文件大小 fileType String 文件类型 downloadLinks Array of DownloadLink objects 图片类型需要,图片类型 fileType为15 recycled Boolean 是否在回收站 表6 DownloadLink 参数 参数类型 描述 usage String 用途默认:'content'-实体内容、'thumbnail'-缩略图,业务可以扩展改字段 downloadLink String 附件下载地址
  • 响应示例 状态码: 200 OK { "code" : "string", "msg" : "string", "nextCursor" : "string", "relatedToMeInfos" : [ { "operator" : "string", "operateType" : 0, "operateTime" : "2024-06-03T02:25:41.085Z", "id" : "string", "displayName" : "string", "files" : [ { "id" : "string", "size" : "string", "fileType" : "string", "downloadLinks" : [ { "usage" : "string", "downloadLink" : "string" } ], "recycled" : true } ], "expireTime" : "2024-06-03T02:25:41.085Z", "status" : 0, "operatorId" : "string", "containerId" : "string", "tenantId" : "string" } ], "total" : 0 }
  • 请求示例 查询与我有关的文件列表。 GET /koodrive/ose/v1/related?sortType=1&sortDirection=2&pageSize=2&pageCursor=&displayName=&relatedType=1 { "total" : 1, "relatedToMeInfos" : [ { "id" : "1427677119873431808", "operator" : "zujian1", "operatorId" : "1395664261493231745", "operateType" : 1, "operateTime" : "2024-05-23T11:39:35.000Z", "displayName" : "内容未审核.docx", "files" : [ { "id" : "Fv54zG8ha44HX2XRlrQlM76zD4KAN2uOB", "size" : 50383, "fileType" : "26", "recycled" : false, "downloadLinks" : [ { "usage" : "content", "downloadLink" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/6957916206ce4407ac9436567b14d719086?response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27%25E5%2586%2585%25E5%25AE%25B9%25E6%259C%25AA%25E5%25AE%25A1%25E6%25A0%25B8.docx&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240523T113937Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240523%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Signature=e130a202a80157e63583bd7597452eb1d30a70c610db86be68717541114e2bd0" }, { "usage" : "thumbnail", "downloadLink" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/6957916206ce4407ac9436567b14d719086?x-image-process=image%2Fresize%2Cm_lfit%2Ch_128%2Cw_128&response-content-disposition=attachment%3B%20filename%2A%3DUTF-8%27%27%25E5%2586%2585%25E5%25AE%25B9%25E6%259C%25AA%25E5%25AE%25A1%25E6%25A0%25B8.docx&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240523T113937Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240523%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Signature=e78515818612dbb024bf14300bd63bbb340e7f7476b988143089ce6d92d6d9f9" } ] } ], "expireTime" : "2024-05-30T11:39:35.000Z", "status" : 0, "containerId" : "IAAFfyRNd07vFgAAA1395504262720721025", "tenantId" : "d5ac574bd2934a69baa4f23c55daa8d4" } ], "code" : 0, "msg" : "成功" }
  • URI GET /koodrive/ose/v1/related 表1 Query参数 参数 是否必选 参数类型 描述 pageSize 否 Integer 每页返回的个数,默认是100,可接受值最大值是100。注意在到达最后的列表之前,实际有可能返回部分或者空结果 最大值:100 pageCursor 否 String 当前页游标,由前一个响应的nextCursor获取 sortType 否 Integer 排序类型,1:相关操作时间(默认) sortDirection 否 Integer 排序方向,1:升序,2:降序(默认) displayName 否 String 支持按照展示名称模糊匹配 relatedType 否 String 相关类型 0:所有 1、分享给我的,空和0表示查所有类型
  • 请求参数 表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表示美式英语,不传默认美式英语
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} X-Traceid 否 String 业务跟踪id(必须58位)
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 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:已失效 表5 SharePermission 参数 参数类型 描述 preview Boolean 预览权限 edit Boolean 编辑权限 download Boolean 下载权限
  • 响应示例 状态码: 200 OK { "code" : "string", "msg" : "string", "link" : { "shareId" : "string", "shortUrl" : "string", "shareTime" : "2024-06-03T02:20:24.274Z", "ownerId" : "string", "ownerName" : "string", "permission" : { "preview" : true, "edit" : true, "download" : true }, "expireTime" : "2024-06-03T02:20:24.274Z", "status" : 0 } }