软链接功能用于便捷访问存储空间内的常用文件。设置软链接后,您可以使用类似于Windows的快捷方式,通过软链接打开文件。本文介绍如何使用OSS Go SDK创建软链接和获取软链接。
注意事项
本文示例代码以华东1(杭州)的地域ID
cn-hangzhou
为例,默认使用外网Endpoint,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见OSS地域和访问域名。本文以从环境变量读取访问凭证为例。如何配置访问凭证,请参见配置访问凭证。
要创建软链接,您必须具有
oss:PutObject
权限;要获取软链接,您必须具有oss:GetObject
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
方法定义
创建软链接
func (c *Client) PutSymlink(ctx context.Context, request *PutSymlinkRequest, optFns ...func(*Options)) (*PutSymlinkResult, error)
获取软链接
func (c *Client) GetSymlink(ctx context.Context, request *GetSymlinkRequest, optFns ...func(*Options)) (*GetSymlinkResult, error)
请求参数列表
参数名 | 类型 | 说明 |
ctx | context.Context | 请求的上下文,可以用来设置请求的总时限 |
request | *PutSymlinkRequest | 创建软链接接口的请求参数,具体请参见PutSymlinkRequest |
*GetSymlinkRequest | 获取软链接接口的请求参数,具体请参见GetSymlinkRequest | |
optFns | ...func(*Options) | (可选)接口级的配置参数, 具体请参见Options |
返回值列表
返回值名 | 类型 | 说明 |
result | *PutSymlinkResult | 创建软链接接口的返回值,当 err 为nil 时有效,具体请参见RestoreObjectResult |
*GetSymlinkResult | 获取软链接接口的返回值,当err为nil时有效,具体请参见GetSymlinkResult | |
err | error | 请求的状态,当请求失败时,err 不为 nil |
示例代码
相关文档
关于软链接的完整示例代码,请参见GitHub示例put_symlink.go和get_symlink.go。
关于软链接的更多操作信息,请参见软链接。
关于创建软链接的API接口,请参见PutSymlink。
关于获取软链接的API接口,请参见GetSymlink。