产品简介

产品概述

功能介绍

产品优势

应用场景

基本概念

购买指南

快速入门

创建媒体库

发起请求

服务级 API 文档

History

Introduction

API Category

Making API Requests

PaaS Service APIs

Official Cloud Disk APIs

Data Types

Error Codes

业务级 API 文档

简介

访问令牌操作接口

租户空间操作接口

文件操作接口

目录或相簿操作接口

回收站操作接口

配额操作接口

查询任务操作接口

搜索操作接口

历史版本操作接口

目录和文件批量操作接口

收藏操作接口

Error Codes

SDK 文档

Android SDK

iOS SDK

鸿蒙 SDK

常见问题

企业网盘

产品简介

购买指南

快速入门

常见问题

Service Level Agreement

词汇表

创建符号链接

PDF

聚焦模式

字号

最后更新时间： 2026-01-07 14:15:07

功能描述
用于创建符号链接。
说明：
要求权限：admin、space_admin 或 upload_file/upload_file_force/create_symlink/create_symlink_force。有关权限详情可参考 生成访问令牌接口。
符号链接本身与文件的概念一致，可以通过删除文件、重命名或移动文件、复制文件等接口删除、重命名、移动或复制符号链接本身，而不会影响符号链接所指向的文件。
与标准文件系统略有不同，符号链接所指向的文件，不会因为重命名或移动而丢失指向。
当符号链接指向的文件被覆盖上传时，该符号链接将指向新上传的文件。
当符号链接所指向的文件被删除时，该符号链接本身也将被删除。
当符号链接指向的文件被移入回收站时，该符号链接将被同步删除，回收站的文件被恢复时，则同步恢复之前被删除的符号链接。
当符号链接指向的文件所在的目录被删除时，由于目录删除是异步操作，该符号链接的删除也将是异步的。
当符号链接指向的文件所在的目录被移入回收站时，该符号链接不受影响。
当回收站内的符号链接指向的文件被永久删除时，该符号链接将被永久删除。
请求
请求示例
PUT /api/v1/file/{LibraryId}/{SpaceId}/{FilePath}?conflict_resolution_strategy={ConflictResolutionStrategy}&access_token={AccessToken}&user_id={UserId}
请求参数
请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库﻿
String
是
SpaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见 创建租户空间﻿
String
是
FilePath
完整文件路径，例如 foo/bar2/file.docx
String
否
ConflictResolutionStrategy
文件名冲突时的处理方式，默认为 rename
ask：冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码
rename：冲突时自动重命名文件
overwrite：
如果目标为目录或相簿时，默认为 ask 且不支持 overwrite
如果目标为文件，覆盖已有文件
当目标空间的文件存在历史版本时，不支持移动覆盖
String
否
AccessToken
访问令牌，获取请参见 生成访问令牌﻿
String
是
UserId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见 生成访问令牌接口﻿
String
否
请求体
application/json，指定指向的源文件路径，暂不支持创建指向目录或相簿的符号链接。
请求体示例：
{
  "linkTo": "foo/bar/file.docx"
}
请求体字段说明：
请求参数
描述
类型
是否必选
linkTo
符号链接指向的源文件绝对路径，获取请参见 查看文件详情﻿
String
是
响应
响应码
创建成功，返回 HTTP 200 OK。
响应体
application/json
响应体示例：
{ "path": [ "foo", "bar2", "file (1).docx" ] }
响应体字段说明：
响应参数
描述
类型
path
字符串数组或 null
如果是字符串数组则表示最终的符号链接路径，数组中的最后一个元素代表最终的文件名，其他元素代表每一级目录名，因为可能存在同名文件自动重命名，所以这里的最终路径可能不等同于移动或重命名时指定的目标路径
如果是 null 则表示目标路径的某级父级目录已被删除，该目标符号链接已经无法访问
Array
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

智能媒资托管

创建符号链接

功能描述

请求

请求示例

请求参数

请求体

响应

响应码

响应体

错误码

帮助和支持

请求参数	描述	类型	是否必选
LibraryId	媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见创建媒体库	String	是
SpaceId	空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 ID，获取请参见创建租户空间	String	是
FilePath	完整文件路径，例如 `foo/bar2/file.docx`	String	否
ConflictResolutionStrategy	文件名冲突时的处理方式，默认为 rename ask：冲突时返回 HTTP 409 Conflict 及 SameNameDirectoryOrFileExists 错误码 rename：冲突时自动重命名文件 overwrite：如果目标为目录或相簿时，默认为 ask 且不支持 overwrite 如果目标为文件，覆盖已有文件当目标空间的文件存在历史版本时，不支持移动覆盖	String	否
AccessToken	访问令牌，获取请参见生成访问令牌	String	是
UserId	用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参见生成访问令牌接口	String	否

响应参数	描述	类型
path	字符串数组或 null 如果是字符串数组则表示最终的符号链接路径，数组中的最后一个元素代表最终的文件名，其他元素代表每一级目录名，因为可能存在同名文件自动重命名，所以这里的最终路径可能不等同于移动或重命名时指定的目标路径如果是 null 则表示目标路径的某级父级目录已被删除，该目标符号链接已经无法访问	Array