华为云用户手册

计费周期 按需计费模式下，KooDrive按小时计费结算。每一个小时结算一次费用（以UTC+8时间为准），结算完毕后进入新的计费周期。计费的起点以KooDrive服务开通成功的时间点为准，终点以服务退订时间为准。 例如，您在8:45:30购买了按需计费的云空间服务，然后在8:55:00将其退订，则计费周期为8:00:00 ~ 9:00:00，在8:45:30 ~ 8:55:30间产生费用，该计费周期内的计费时长为600秒。

包年/包月资源 对于包年/包月计费模式的云空间服务，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月的云空间服务，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

在续费管理页面开通自动续费 登录管理控制台。 单击“控制台”页面上方“费用”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”“到期转按需项”“到期不续费项”页签的资源开通自动续费。 选择需要开通自动续费的云空间服务，单击操作列“开通自动续费”。 选择续费时长，并根据需要设置自动续费次数，单击“开通”。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

计费示例 以下案例中出现的费用价格仅供参考，实际价格请参见各服务价格详情。 假设您在2023/03/08 15:50:04购买了基础版套餐（规格：5人/200GB）。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59 第二个计费周期为：2023/04/08 23:59:59 ~ 2023/05/08 23:59:59 费用计算过程如下： 首次订购费用：180元 手动续费费用：180元 综上，2个月的费用 = 360元

到期后影响 图1描述了包年/包月云空间服务各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月云空间服务生命周期 到期预警 包年/包月云空间服务在到期前第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 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" : "成功" }

响应参数 状态码： 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 附件下载地址

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表示美式英语，不传默认美式英语

响应示例 状态码： 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 } }

请求参数 表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", "nextCursor" : "string", "shareLinks" : [ { "shareId" : "string", "shortUrl" : "string", "linkUrl" : "string", "shareTime" : "2024-06-03T01:58:35.419Z", "scope" : 0, "files" : [ { "id" : "string", "fileName" : "string", "fileType" : "string", "mimeType" : "string", "size" : 0, "parentFolder" : [ "string" ], "fileSuffix" : "string", "containers" : [ "string" ] } ], "displayName" : "string", "permission" : { "preview" : true, "edit" : true, "download" : true }, "extractCode" : "string", "expireTime" : "2024-06-03T01:58:35.419Z", "status" : 0, "comment" : "string", "viewCnt" : 0, "downloadCnt" : 0, "saveCnt" : 0, "containerId" : "string", "containerName" : "string" } ] }

URI GET /koodrive/ose/v1/share 表1 Query参数 参数 是否必选 参数类型 描述 pageSize 否 Integer 每页返回的个数，默认是100，可接受值最大值是100。注意在到达最后的列表之前，实际有可能返回部分或者空结果 最大值：100 pageCursor 否 String 当前页游标，由前一个响应的nextCursor获取 sortType 否 Integer 排序类型，4：分享时间（默认） sortDirection 否 Integer 排序方向，1：升序，2：降序（默认） displayName 否 String 支持按照展示名称模糊匹配

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 响应码 msg String 响应信息 nextCursor String 分页游标，如果不存在，代表已返回最后一个 shareLinks Array of ShareByMeLink objects 分享链接列表 表4 ShareByMeLink 参数 参数类型 描述 shareId String 分享ID shortUrl String 分享短码 linkUrl String 分享链接 shareTime String 分享时间 scope Integer 分享范围，1：收到连接的所有用户，2：仅企业内用户可访问，3：指定企业用户访问 files Array of ShareFileInfo objects 分享的文件列表 displayName String 展示名称 permission SharePermission object 分享权限（后续支持） extractCode String 提取码 expireTime String 失效时间 status Integer 分享状态，0：根据失效时间判断，1：文件已被删除，2：已失效 comment String 分享留言 viewCnt Integer 浏览次数 downloadCnt Integer 下载次数（后续支持） saveCnt Integer 转存次数（后续支持） containerId String 分享文件所属空间id containerName String 分享文件所属空间 表5 ShareFileInfo 参数 参数类型 描述 id String *文件id fileName String *文件名，最长160个字节 fileType String 文件类型，外部输入 mimeType String *内容类型 size Integer 文件大小 parentFolder Array of strings 父目录ID列表，注意：当前只取第一个父母Id fileSuffix String 文件后缀，fullFileExtension最后一个字符串 containers Array of strings 空间标识 表6 SharePermission 参数 参数类型 描述 preview Boolean 预览权限 edit Boolean 编辑权限 download Boolean 下载权限

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

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

响应示例 状态码： 200 OK { "code" : "string", "msg" : "string", "shareLink" : { "shareId" : "string", "shortUrl" : "string", "linkUrl" : "string", "shareTime" : "string", "ownerId" : "string", "ownerName" : "string", "displayName" : "string", "permission" : { "preview" : true, "edit" : true, "download" : true }, "expireTime" : "2024-06-03T02:18:51.520Z", "status" : 0, "comment" : "string" } }

请求参数 表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 响应信息 shareLink ShareWithMeLinkDetail object 分享给我的链接信息 表4 ShareWithMeLinkDetail 参数 参数类型 描述 shareId String 分享ID shortUrl String 分享短码 linkUrl String 分享链接 shareTime String 分享时间 ownerId String 分享人id ownerName String 分享人姓名 displayName String 展示名称 permission SharePermission object 分享权限（后续支持） expireTime String 失效时间 status Integer 分享状态，0：根据失效时间判断，1：文件已被删除，2：已失效 comment String 分享留言 表5 SharePermission 参数 参数类型 描述 preview Boolean 预览权限 edit Boolean 编辑权限 download Boolean 下载权限

请求参数 表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参数 参数 是否必选 参数类型 描述 shortUrl 是 String 分享shortUrl extractCode 是 String 分享码

响应示例 状态码： 200 OK { "data" : { "taskId" : "1428103989525998336" }, "code" : 0, "msg" : "成功" } 状态码： 400 { "error" : { "errorData" : { "conflictFileId" : "string" }, "errorDetail" : [ { "domain" : "string", "reason" : "string", "errorCode" : "string", "description" : "string", "errorPos" : "string", "errorParam" : "string" } ], "code" : 0, "description" : "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参数 参数 是否必选 参数类型 描述 scope 是 Integer 分享范围，1：收到连接的所有用户，2：仅企业内用户可访问，3：指定企业用户访问 deptIds 否 Array of strings 部门id列表 groupIds 否 Array of strings 用户组id列表 userIds 否 Array of strings 用户id列表 fileIds 是 Array of strings 文件id列表 containerId 是 String 空间id permission 否 SharePermission object 分享权限（后续支持） extractCode 否 String 提取码 expireTime 否 String 失效时间 comment 否 String 分享留言 validDays 是 Integer 有效分享天数（1-365） 表3 SharePermission 参数 是否必选 参数类型 描述 preview 否 Boolean 预览权限 edit 否 Boolean 编辑权限 download 否 Boolean 下载权限