更新时间：2025-12-12 GMT+08:00
创建同步目录 - createSyncDir
功能介绍
创建同步目录
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/syncDir/create
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 创建与关联同步目录响应 |
父主题：同步目录
