put-symlink用于为OSS的目标文件(TargetObject)创建软链接(Symlink)。
注意事项
使用put-symlink命令创建软链接时不会检查目标文件是否存在、目标文件类型是否合法以及目标文件是否有访问权限。Symlink自身的访问权限(ACL)以及目标文件的ACL检查仅会在GetObject等需要访问目标文件的API中进行。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
PutSymlink |
| 为OSS的目标文件(TargetObject)创建软链接(Symlink)。 |
| 为OSS的目标文件(TargetObject)创建软链接(Symlink)时,如果通过x-oss-tagging指定Object的标签,则需要此操作的权限。 |
命令格式
ossutil api put-symlink --bucket value --key value --symlink-target value [flags]
参数 | 类型 | 说明 |
--bucket | string | Bucket名称。 |
--key | string | Object的完整路径。 |
--object-acl | string | 指定OSS创建Object时的访问权限。 |
--forbid-overwrite | string | 指定PutSymlink操作时是否覆盖同名Object。 |
--storage-class | string | 指定Object的存储类型。 |
--symlink-target | string | 软链接指向的目标文件。 |
put-symlink命令对应API接口PutSymlink。关于API中的具体参数含义,请参见PutSymlink。
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
创建到目标对象targetobject
的软链接examplelink。
ossutil api put-symlink --bucket examplebucket --key examplelink --symlink-target targetobject