创建组织 创建企业组织。 企业租户登录KooDrive服务控制台。 单击“云空间配置”，在云空间配置页面单击“创建组织”。 注意：如果该租户下已存在创建的企业组织，则页面展示该组织下的云空间信息。如果该租户下不存在企业组织，则页面展示创建组织操作入口。 在“创建组织”页面，输入组织名称。 名称由1~60个中文、英文、数字及合法字符组成。 设置组织的 域名 。 域名是指网址 (如www.example.com) 中“www”之后的内容，以及电子邮件地址 （如《用户名》@example.com）中“@”符号之后的内容。 没有域名，可以输入组织简称，使用2~30位字母、数字和.-或它们的组合，如abc，后缀名为固定的.orgid.top，如图1所示。 图1 设置组织域名 已有域名，单击“使用自有域名”，输入自有域名，例如example.com，如图2所示。 图2 使用自有域名 域名设置后管理员为组织创建成员时，成员的管理式华为账号默认带有域名后缀，如设置的组织域名为abc.orgid.top，创建的成员账号为xxx@abc.orgid.top，设置的组织域名为example.com，创建的成员账号为xxx@example.com。 组织创建完成后，KooDrive自动以该组织名称创建企业的一级部门，后续创建的部门都属于一级部门的子部门。 查看存储空间与用户数，参数如表1所示。 表1 存储空间与用户数 参数 说明 存储空间 “包年/包月”计费模式展示如下信息： 使用占比 = 已用存储空间/总存储空间。 总存储空间 = 套餐的存储空间 + 存储扩容包的存储空间。 “已用存储空间”为用户已分配的空间总量。 按需计费仅显示“已用XGB”，为已使用空间容量。 用户数 “包年/包月”计费模式展示如下信息： 创建占比 = 当前用户数/用户总数。 用户总数 = 套餐的用户数 + 用户扩容包的用户数。 “当前用户数”为已创建的用户数。 按需计费仅显示“已创建用户数X人”。 设置云空间默认配置。参考表2完成设置。 表2 云空间默认配置 参数 说明 是否默认开通个人空间 通过开启或关闭滑块，配置是否开启个人空间。 个人空间默认大小 配置开通个人空间时空间的默认值。系统管理员可自行设置个人空间容量缺省值，例如100GB。设置后，创建用户时默认自动为用户分配100GB的个人空间，系统管理员也可以在创建时修改该默认值。 选择“包年/包月”计费模式，缺省值为“总存储空间”的五分之一除以“用户总数”。 选择按需计费模式，缺省值为0。 单击可修改个人空间默认大小，修改完成后单击。 个人空间取值范围为一到套餐存储空间的五分之一之间的整数。 是否默认开通团队空间 通过开启或关闭滑块，配置是否在开启团队空间。 部门空间默认大小 配置开通部门空间时空间的默认值。当管理员在创建部门时云空间默认自动为部门分配已购买存储服务容量大小的团队空间。 选择“包年/包月”计费模式，缺省值为30GB。 选择按需计费模式，缺省值为0。 单击可修改部门空间默认大小，修改完成后单击。 部门空间取值范围为一到套餐存储空间五分之三之间的整数。 群组空间默认大小 配置开通群组空间时空间的默认值，缺省值为10GB。 单击可修改群组空间默认大小，修改完成后单击。 群组空间取值范围为一到套餐存储空间的五分之一之间的整数。 组织文件存储位置配置 只能看到一个“默认”选项，因此无需进行任何配置。 默认业务地址 Koodrive业务地址：云空间业务地址链接。 自定义业务链接：用户自定义的首页链接地址。 查看云空间订购详情。参考表3进行设置。 表3 云空间订购详情 参数 说明 套餐规格 选择“包年/包月”计费模式，显示已订购的套餐包规格。 基础版与基础版（轻量型）套餐订购完成后，两种套餐均支持在“套餐规格扩容”中切换或升级已购套餐。请注意，目标套餐的规格（即用户数或存储空间）不能小于当前规格，不满足条件的规格选项将被置灰，无法选择。 到期时间 选择“包年/包月”计费模式，显示订购的套餐包到期时间，可单击“续费”“查看订单”了解订购详情。当订购的资源状态为冻结时，此处显示冻结时间。 用户数扩容包 选择“包年/包月”计费模式，当已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。 存储空间扩容包 选择“包年/包月”计费模式，已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。 计费模式 选择“按需”计费模式，显示按需计费，可单击“查看订单”了解订购详情。 创建时间 选择“按需”计费模式，显示订购的创建时间。 配置完成后，可单击右上角“前往应用”即可进入KooDrive业务页面。在KooDrive业务页面用户可以完善企业组织架构，使用团队及个人空间。如果选择“自定义业务链接”，单击右上角“前往应用”即可进入用户自定义链接页面。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 业务跟踪id（必须58位） X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 业务跟踪id（必须58位） X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 shortUrl 是 String 分享shortUrl extractCode 是 String 分享码

请求示例 通过“分片上传”方式创建文件元数据，该示例指定了对应文件从46到50分片的分片，后续响应会返回对应分片的上传地址，需要将对应分片通过PUT请求上传对应的分片。 POST /koodrive/ose/v1/files/multipart/uploadUrl Authorization:Bearer+10f88*********4791e9ff { "fileId": "Fqo2kYHmsgWg5whxzYHZLL7mebXbBr1no", "multiParts": [ { "hashCtx": [ 1748048713, 2644528514, 4267727253, 2252747490, 4036182088, 2253856463, 526139147, 2194267752 ], "partNumber": 46, "partOffset": 471859200, "partSize": 10485760 }, { "hashCtx": [ 1606212, 1743131457, 2392241618, 605997363, 3054356113, 673008609, 3509469858, 2186398707 ], "partNumber": 47, "partOffset": 482344960, "partSize": 10485760 }, { "hashCtx": [ 3734586607, 1407828785, 3243195625, 3451635323, 4031416500, 3005674269, 2829389145, 3478923465 ], "partNumber": 48, "partOffset": 492830720, "partSize": 10485760 }, { "hashCtx": [ 3677016828, 906610338, 3389225168, 2507561547, 1134075905, 3951513567, 1673174790, 3034719756 ], "partNumber": 49, "partOffset": 503316480, "partSize": 10485760 }, { "hashCtx": [ 1827691250, 2956926651, 1801460777, 4119662276, 4162375117, 187866976, 1789369655, 278284511 ], "partNumber": 50, "partOffset": 513802240, "partSize": 10485760 } ] }

响应示例 状态码：200 对应分片的上传信息 { "multiParts" : [ { "partNumber" : 46, "partSize" : 10485760, "partOffset" : 471859200, "hashCtx" : [ 1748048713, 2644528514, 4267727253, 2252747490, 4036182088, 2253856463, 526139147, 2194267752 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=46&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxNzQ4MDQ4NzEzLDI2NDQ1Mjg1MTQsNDI2NzcyNzI1MywyMjUyNzQ3NDkwLDQwMzYxODIwODgsMjI1Mzg1NjQ2Myw1MjYxMzkxNDcsMjE5NDI2Nzc1Ml0sIm5oIjowLCJubCI6Mzc3NDg3MzYwMCwiaGFzaF90eXBlIjoic2hhMjU2In0%3D&X-Amz-Signature=d3e7f60f45c8fd3960e697c57bb7d1c386dd20940b860fd976ba77425767d65e" }, { "partNumber" : 47, "partSize" : 10485760, "partOffset" : 482344960, "hashCtx" : [ 1606212, 1743131457, 2392241618, 605997363, 3054356113, 673008609, 3509469858, 2186398707 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=47&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxNjA2MjEyLDE3NDMxMzE0NTcsMjM5MjI0MTYxOCw2MDU5OTczNjMsMzA1NDM1NjExMyw2NzMwMDg2MDksMzUwOTQ2OTg1OCwyMTg2Mzk4NzA3XSwibmgiOjAsIm5sIjozODU4NzU5NjgwLCJoYXNoX3R5cGUiOiJzaGEyNTYifQ%3D%3D&X-Amz-Signature=38980d3be00e528ee11c366ae69e950d673528203f3869a26f39dae42b4dabbb" }, { "partNumber" : 48, "partSize" : 10485760, "partOffset" : 492830720, "hashCtx" : [ 3734586607, 1407828785, 3243195625, 3451635323, 4031416500, 3005674269, 2829389145, 3478923465 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=48&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlszNzM0NTg2NjA3LDE0MDc4Mjg3ODUsMzI0MzE5NTYyNSwzNDUxNjM1MzIzLDQwMzE0MTY1MDAsMzAwNTY3NDI2OSwyODI5Mzg5MTQ1LDM0Nzg5MjM0NjVdLCJuaCI6MCwibmwiOjM5NDI2NDU3NjAsImhhc2hfdHlwZSI6InNoYTI1NiJ9&X-Amz-Signature=d5608f38d6afdfee117be1243870b63f46ff11676633e0630d122f0c4145e8ae" }, { "partNumber" : 49, "partSize" : 10485760, "partOffset" : 503316480, "hashCtx" : [ 3677016828, 906610338, 3389225168, 2507561547, 1134075905, 3951513567, 1673174790, 3034719756 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=49&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlszNjc3MDE2ODI4LDkwNjYxMDMzOCwzMzg5MjI1MTY4LDI1MDc1NjE1NDcsMTEzNDA3NTkwNSwzOTUxNTEzNTY3LDE2NzMxNzQ3OTAsMzAzNDcxOTc1Nl0sIm5oIjowLCJubCI6NDAyNjUzMTg0MCwiaGFzaF90eXBlIjoic2hhMjU2In0%3D&X-Amz-Signature=52eb71278fc9310f13a5b92641b5a726d0006be8dd89a242f9c4ce09c360e1f7" }, { "partNumber" : 50, "partSize" : 10485760, "partOffset" : 513802240, "hashCtx" : [ 1827691250, 2956926651, 1801460777, 4119662276, 4162375117, 187866976, 1789369655, 278284511 ], "uploadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/4e8108ee15fa471cbe5f18f03e8b555b086?partNumber=50&uploadId=0000019039E1E8520006EBE63B492EDB&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240621T082041Z&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20240621%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Iteration-Hash-Ctx=eyJtZF9sZW4iOjMyLCJudW0iOjAsImgiOlsxODI3NjkxMjUwLDI5NTY5MjY2NTEsMTgwMTQ2MDc3Nyw0MTE5NjYyMjc2LDQxNjIzNzUxMTcsMTg3ODY2OTc2LDE3ODkzNjk2NTUsMjc4Mjg0NTExXSwibmgiOjAsIm5sIjo0MTEwNDE3OTIwLCJoYXNoX3R5cGUiOiJzaGEyNTYifQ%3D%3D&X-Amz-Signature=154bcd4ad7774f20e196666d403bf3d4359dd151b9cb1cc1f604c6517c4a287b" } ], "code" : 0, "msg" : "成功" }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} language 否 String 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 X-Traceid 否 String 消息日志跟踪标识（必须58位） X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权 表2 请求Body参数 参数 是否必选 参数类型 描述 fileId 是 String 文件id multiParts 是 Array of MultiPartInfo objects 分片信息列表 表3 MultiPartInfo 参数 是否必选 参数类型 描述 partNumber 是 Integer 分片编号 partSize 是 Long 分片长度，取值范围[5242880, 5368709120]，最后一个分片取值范围[0, 5368709120] minimum: 0 maximum: 5368709120 partOffset 否 Long 到上一个数据块为止的总长度，单位为字节，该字段仅在分片并行上传时有效，分片并行上传时，除最后一个分片外，分片并行上传的其它分片大小，必须是 64字节的倍数 hashCtx 否 Array of longs 用于迭代计算SHA256的上下文，该字段仅在分片并行上传时有效。对于SHA1，取值为上一个数据块SHA1的第1-5个32位变量。对于SHA256，取值为上一个数据块SHA256的第1-8个32位变量。 注：分片并行上传时除第一个分片外其他分片必填。 uploadUrl 否 String 文件上传的URL，返回参数，上传文件需要使用PUT方法 partId 否 String 分片对象ID

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 multiParts Array of MultiPartInfo objects 分片信息 code Integer 响应码 msg String 响应消息 表5 MultiPartInfo 参数 参数类型 描述 partNumber Integer 分片编号 partSize Long 分片长度，取值范围[5242880, 5368709120]，最后一个分片取值范围[0, 5368709120] minimum: 0 maximum: 5368709120 partOffset Long 到上一个数据块为止的总长度，单位为字节，该字段仅在分片并行上传时有效，分片并行上传时，除最后一个分片外，分片并行上传的其它分片大小，必须是 64字节的倍数 hashCtx Array of longs 用于迭代计算SHA256的上下文，该字段仅在分片并行上传时有效。对于SHA1，取值为上一个数据块SHA1的第1-5个32位变量。对于SHA256，取值为上一个数据块SHA256的第1-8个32位变量。 注：分片并行上传时除第一个分片外其他分片必填。 uploadUrl String 文件上传的URL，返回参数，上传文件需要使用PUT方法 partId String 分片对象ID

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 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 { "code" : "string", "msg" : "string", "shareLink" : { "shareId" : "string", "shortUrl" : "string", "extractCode" : "string", "createTime" : "2024-06-03T02:00:39.953Z", "updateTime" : "2024-06-03T02:00:39.953Z", "expireTime" : "2024-06-03T02:00:39.953Z" } }

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应信息 shareLink shareLink object 分享链接信息 表6 shareLink 参数 参数类型 描述 shareId String 分享id shortUrl String 分享链接 extractCode String 提取码 createTime String 创建时间 updateTime String 修改时间 expireTime String 失效时间 linkUrl String 分享链接 shareTime String 分享时间 scope Integer 范围 displayName String 显示名称 status Integer 状态 viewCnt String 浏览次数 downloadCnt String 下载次数 saveCnt String 保存次数

请求示例 PUT /koodrive/ose/v1/share/{shareId} { "deptIds" : [ "string" ], "groupIds" : [ "string" ], "userIds" : [ "string" ], "permission" : { "preview" : true, "edit" : true, "download" : true }, "expireTime" : "2024-06-03T02:00:39.952Z", "extractCode" : "string", "comment" : "string", "validDays" : 0 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} X-Traceid 否 String 业务跟踪id（必须58位） X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 是 String 地址,用于app鉴权 表3 请求Body参数 参数 是否必选 参数类型 描述 deptIds 否 Array of strings 部门id列表 groupIds 否 Array of strings 用户组id列表 userIds 否 Array of strings 用户id列表 permission 否 SharePermission object 分享权限（后续支持） expireTime 否 String 失效时间 extractCode 否 String 提取码 comment 否 String 分享留言 validDays 是 Integer 分享有效天数0-365. 0表示不变 表4 SharePermission 参数 是否必选 参数类型 描述 preview 否 Boolean 预览权限 edit 否 Boolean 编辑权限 download 否 Boolean 下载权限

请求示例 将空间标识为IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4 空间下，文件id为FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y的文件重命名为“下载”。 POST /koodrive/ose/v1/files/rename/FtSCRFXCYtFjo315lPfRHeKRiqrDdmm_Y Authorization:Bearer+10f88*********4791e9ff { "name": "下载", "containerId": "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4", "renameMode": 2 }

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 格式“Bearer {app_access_token}”，需传入应用级token，用于应用服务端调用，通过创建应用时获得的clientid及clientSecret调用接口获取 X-User-Id 是 String 用户id,用于app鉴权 X-Date 是 String 日期,用于app鉴权 Host 否 String 地址,用于app鉴权