文档首页/ 对象存储服务 OBS/ API参考/ 对象API/ 软链接/ 获取软链接-GetSymlink
更新时间：2026-07-30 GMT+08:00
查看PDF
分享

获取软链接-GetSymlink

功能介绍

调用此接口获取软链接，您可以获取软链接对象本身的信息，以及软链接对象指向目标对象的对象名。

版本控制

默认获取软链接当前版本指向的目标对象。允许通过指定versionId来获取指定版本。

如果软链接的当前版本为删除标记，且不指定versionId，OBS会返回404，在响应头中返回x-obs-delete-marker为true以及版本ID（x-obs-version-id）。因为删除标记没有关联数据，因此也没有软链接指向的目标对象。

如果软链接的当前版本为删除标记，且指定versionId，OBS会返回200，在响应头中不会返回x-obs-delete-marker。

授权信息

您必须是对象拥有者或拥有获取对象元数据的权限，才能调用本接口，建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。

  • 如果使用IAM授权，那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种，并配置相应权限：
    • 如果使用角色与策略授权（旧版IAM，即IAM v3接口），需具备obs:object:getObject（未开启多版本）、obs:object:getObjectVersion（开启或暂停多版本）权限，授权操作请参见创建IAM自定义策略。
    • 如果使用身份策略授权（新版IAM，即IAM v5接口），如下表所示，需具备obs:object:GetObject（未开启多版本）、obs:object:GetObjectVersion（开启或暂停多版本）权限，授权操作请参见创建IAM自定义身份策略。

      授权项

      Action

      访问级别

      Access Level

      资源类型（*为必须）

      Resource Type (*: required)

      条件键

      Condition Key

      别名

      Alias

      依赖的授权项

      Dependencies

      obs:object:getObject（未开启多版本）

      obs:object:getObjectVersion（开启或暂停多版本）

      Read

      object *

      -

      obs:object:getObjectRetention

      -
      • obs:EpochTime
      • obs:SourceIp
      • obs:TlsVersion
      • obs:CustomDomain
  • 如果使用桶策略进行授权，需具备obs:object:GetObject（未开启多版本）、obs:object:GetObjectVersion（开启或暂停多版本）权限，具体操作请参见自定义创建桶策略。

URI

GET /

调用方法

请参见如何调用API。调用前需要先计算API签名，并将签名添加到请求中。

请求消息样式

GET /objectName?symlink HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: Date
Authorization: SignatureValue

URI参数（URI Parameters）

请求参数说明如表1所示。

表1 URI参数（URI Parameters）

参数名称

参数类型

是否必选

描述

versionId

String

否

参数解释：

软链接对象的版本号。

约束限制：

不涉及

取值范围：

长度为32的字符串。

默认取值：

不涉及

symlink

是

String

参数解释：

用于标识API接口与软链接有关。

约束限制：

计算签名时，请在CanonicalizedResource中添加“/BucketName/ObjectName?symlink”，详情参见签名计算。

取值范围：

symlink

默认取值：

不涉及

请求头参数（Request headers）

该请求使用公共请求头，具体参见表3。

响应消息样式

1
2
3
4
5
6
7
 
HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time
x-obs-symlink-target: target object name

响应头 (Response Headers)

本接口的响应头 (Response Headers)如表2所示。

表2 响应头 (Response Headers)

消息头名称

消息头类型

描述

x-obs-symlink-target

String

参数解释：

软链接指向的目标对象的对象名。如果软链接为删除标记，则不返回此头域。

取值范围：

不涉及

请求示例

GET /link-to-obs.jpg?symlink HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: Fri, 24 Feb 2012 06:38:30 GMT
Authorization: authorization

响应示例

HTTP/1.1 200 OK
Server: OBS
Date: Fri, 24 Feb 2012 06:38:30 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 0
Connection: keep-alive
x-obs-request-id: 5650BD72207FB30443962F9A
x-obs-symlink-target: example.jpg
ETag: "A797938C31D59EDD08D86188F6D5****"

请求示例：指定versionId获取软链接

GET /link-to-obs.jpg?symlink&versionId=G0011196D3FBD85400005304000000ED HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: Fri, 24 Feb 2012 06:38:30 GMT
Authorization: authorization

响应示例：指定versionId获取软链接

HTTP/1.1 200 OK
Server: OBS
Date: Fri, 24 Feb 2012 06:38:30 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 0
Connection: keep-alive
x-obs-request-id: G0011196D3FBD85400005304000000ED
x-obs-symlink-target: example.jpg
ETag: "A797938C31D59EDD08D86188F6D5****"

请求示例：软链接对象为delete-marker对象

GET /delete-marker-Symlink-object?symlink HTTP/1.1
Host: bucketname.obs.cn-north-4.myhuaweicloud.com 
Date: Fri, 24 Feb 2012 06:38:30 GMT
Authorization: authorization

响应示例：软链接对象为delete-marker对象

HTTP/1.1 404 Not Found
Server: OBS
Date: Fri, 24 Feb 2012 06:38:30 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "A797938C31D59EDD08D86188F6D5****"
Content-Length: 0
Connection: keep-alive
x-obs-request-id: 5650BD72207FB30443962F9A
x-obs-delete-marker: true
x-obs-version-id:  xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
父主题： 软链接

相关文档