API: /api/sync/setCloudSyncDir

HTTP Method: POST

认证: 需要登录 (model.CheckAuth), 管理员权限 (model.CheckAdminRole), 非只读模式 (model.CheckReadonly)

功能描述

设置当前工作空间在当前所选的云服务提供商（如 S3, WebDAV 等）上的同步根文件夹（或存储桶内的顶层路径）的名称。

例如，如果设置为 "MyNotes"，那么所有同步数据都会存放在云端的 MyNotes/ 目录下。

重要提示: 修改此设置后，下次同步时，思源笔记会尝试使用新的云端目录。如果该目录不存在，根据服务商和具体配置，可能会创建它或者同步失败。如果该目录已存在且包含其他非本工作空间的数据，可能会导致数据混乱或丢失。请谨慎操作，并确保理解所选云服务提供商的行为。

参数名	类型	是否必需	描述
`name`	string	是	要设置的云端同步目录的名称。例如 `"SiYuanCloudSync"`。

{
    "name": "SiYuanBackup"
}

成功时，HTTP 状态码为 200，响应体中的 code 为 0，msg 为空，data 为 null。

{
    "code": 0,
    "msg": "",
    "data": null
}

{
    "code": -1,
    "msg": "用户需要登录", // 或 "管理员才能操作", "readonly mode" 等
    "data": null
}

云端同步目录名称 (name):

等待请求...