软链接是一种特殊的文件，它指向某个具体的文件，类似于Windows上使用的快捷方式。本文介绍如何创建软链接并获取软链接指向的目标文件（Object）名称。

说明
  • 如果需要删除软链接，请参见 C++删除文件 。
  • 删除软链接指向的目标文件后，软链接仍存在，但是通过该软链接将无法访问目标文件。

注意事项

  • 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见 访问域名和数据中心 。
  • 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见 新建OssClient 。
  • 要创建软链接，您必须具有 oss:PutObject 权限；要获取软链接，您必须具有 oss:GetObject 权限。具体操作，请参见 为RAM用户授权自定义的权限策略 。

创建软链接

以下代码用于创建软链接，创建软链接时支持自定义元信息。 

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
    /* 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。*/
    std::string AccessKeyId = "yourAccessKeyId";
    std::string AccessKeySecret = "yourAccessKeySecret";
    /* yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    /* 填写Bucket名称，例如examplebucket。*/
    std::string BucketName = "examplebucket";
    /* 填写Object完整路径，例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。*/
    std::string ObjectName = "exampledir/exampleobject.txt";
    /* 填写软链接完整路径，例如shortcut/myobject.txt。*/
    std::string LinkName = "shortcut/myobject.txt";
    /* 初始化网络等资源。*/
    InitializeSdk();
    ClientConfiguration conf;
    OssClient client(Endpoint, AccessKeyId, AccessKeySecret, conf);
    /* 设置HTTP header。*/
    auto meta = ObjectMetaData();
    meta.setContentType("text/plain");
    /* 设置自定义文件元信息。*/
    meta.UserMetaData()["meta"] = "meta-value";
    /* 创建软链接。*/
    CreateSymlinkRequest request(BucketName, ObjectName, meta);
    request.SetSymlinkTarget(LinkObjectName);
    auto outcome = client.CreateSymlink(request);
    if (!outcome.isSuccess()) {
        /* 异常处理。*/
        std::cout << "CreateSymlink fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    /* 释放网络等资源。*/
    ShutdownSdk();
    return 0;
}

获取软链接

要获取软链接指向的目标文件名称，您必须有对该软链接的读权限。

以下代码用于获取软链接指向的目标文件名称。 

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
    /* 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。*/
    std::string AccessKeyId = "yourAccessKeyId";
    std::string AccessKeySecret = "yourAccessKeySecret";
    /* yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    /* 填写Bucket名称，例如examplebucket。*/
    std::string BucketName = "examplebucket";
    /* 填写软链接完整路径，例如shortcut/myobject.txt。*/
    std::string LinkName = "shortcut/myobject.txt";
    /* 初始化网络等资源。*/
    InitializeSdk();
    ClientConfiguration conf;
    OssClient client(Endpoint, AccessKeyId, AccessKeySecret, conf);
    /* 获取软链接指向的目标文件名称。*/
    GetSymlinkRequest request(BucketName, LinkName);
    auto outcome = client.GetSymlink(request);
    if (!outcome.isSuccess()) {
        /* 异常处理。*/
        std::cout << "GetSymlink fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    else { 
        std::cout << " GetSymlink success Symlink name:" << outcome.result().SymlinkTarget() << std::endl;
    /* 释放网络等资源。*/
    ShutdownSdk();
    return 0;
}

相关文档

  • 关于创建软链接的API接口说明，请参见 PutSymlink 。
  • 关于获取软链接的API接口说明，请参见 GetSymlink 。