全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

PutSymlink

更新时间:2017-07-18 08:58:05

Put Symlink

Put Symlink用于创建符号链接。

请求语法

  1. PUT /ObjectName?symlink HTTP/1.1
  2. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  3. Date: GMT Date
  4. Authorization: SignatureValue
  5. x-oss-symlink-target: TargetObjectName

请求Header

名称 描述
x-oss-symlink-target 符号链接指向的目标文件。
类型:字符串
合法值:命名规范同Object。

细节分析

  1. TargetObjectName同ObjectName一样,需要URL encode。
  2. 符号链接的目标文件类型不能为符号链接。
  3. 创建符号链接时,
    • 不检查目标文件是否存在
    • 不检查目标文件类型是否合法
    • 不检查目标文件是否有权限访问
      以上检查,都推迟到GetObject等需要访问目标文件的API。
  4. 如果试图添加的文件已经存在,并且有访问权限。新添加的文件将覆盖原来的文件,成功返回200 OK。
  5. 如果在PutSymlink的时候,携带以x-oss-meta-为前缀的参数,则视为user meta,比如x-oss-meta-location。一个Object可以有多个类似的参数,但所有的user meta总大小不能超过8k。
  6. 如果Bucket的类型为Archive,则不能调用该接口,否则返回400错误,错误码为OperationNotSupported。

示例

请求示例:

  1. PUT /link-to-oss.jpg?symlink HTTP/1.1
  2. Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  3. Cache-control: no-cache
  4. Content-Disposition: attachment;filename=oss_download.jpg
  5. Date: Tue, 08 Nov 2016 02:00:25 GMT
  6. Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:kZoYNv66bsmc10+dcGKw5x2PRrk=
  7. x-oss-symlink-target: oss.jpg

返回示例:

  1. HTTP/1.1 200 OK
  2. Server: AliyunOSS
  3. Date: Tue, 08 Nov 2016 02:00:25 GMT
  4. Content-Length: 0
  5. Connection: keep-alive
  6. x-oss-request-id: 582131B9109F4EE66CDE56A5
  7. ETag: "0A477B89B4602AA8DECB8E19BFD447B6"
本文导读目录