文档首页/ 云空间服务 KooDrive/ API参考/ API/ 同步目录/ 创建同步目录 - createSyncDir
更新时间:2025-12-12 GMT+08:00
分享

创建同步目录 - createSyncDir

功能介绍

创建同步目录

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/syncDir/create

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

container

String

空间ID

fileName

String

同步目录名称

注:传入后会检查根目录(root)下是否有同名目录,如果有则将该目录设置为同步目录,如果没有则通过fileName在root下创建同步目录;与fileId互斥;传了fileId时非必填,否则必填

hidden

Boolean

是否隐藏

缺省默认为false

parentFolder

String

父目录ID

不支持传入根目录(root、sbox),如果不传则默认在根目录(root)创建

注:与fileId互斥

fileId

String

需要设置为同步目录的目录ID

传入后会将该目录设置为同步目录;与fileName、hidden、parentFolder互斥

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

container

String

空间ID

fileId

String

文件ID

fileName

String

同步目录名称

exist

Boolean

同步目录是否已存在

仅当同步目录已存在时返回

请求示例

创建同步目录请求示例

POST /koodrive/ose/v1/syncDir/create

Authorization:Bearer+10f88*********4791e9ff
{
  "container": "K*****",
  "fileName": "K*****",
  "parentFolder": "K*****",
  "fileId": "K*****",
  "hidden": true
}

响应示例

状态码:200

创建与关联同步目录响应

{
  "container" : "K*****",
  "fileName" : "K*****",
  "fileId" : "K*****",
  "exist" : true
}

状态码

状态码

描述

200

创建与关联同步目录响应

相关文档