Manage symlinks (C++ SDK V2)-Object Storage Service(OSS)-阿里云帮助中心

A symlink is a shortcut to an object. You can use the OSS C++ SDK V2 to create and retrieve symlinks.

Usage notes

Before you run the sample code, replace <region> with a valid region, such as cn-hangzhou.
The sample code retrieves access credentials from environment variables.
To create a symlink, you must have the oss:PutObject permission.
To retrieve a symlink, you must have the oss:GetObject permission.

Sample code

Create a symlink

The following code creates a symlink for a specified object:

#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region>";
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();

    oss::OSSClient client(conf);

    auto outcome = client.putSymlink(
        oss::models::PutSymlinkRequest()
            .setBucket("examplebucket")
            .setKey("example-symlink.txt")
            .setSymlinkTarget("exampleobject.txt"));

    if (!outcome.has_value()) {
        auto& e = outcome.error();
        std::cerr << "Failed to create the symlink"
                  << ", code: " << e.getCode()
                  << ", message: " << e.getMessage()
                  << ", requestId: " << e.getRequestId() << std::endl;
        return 1;
    }

    auto& result = outcome.value();
    std::cout << "Symlink created successfully"
              << ", status: " << result.getStatusCode()
              << ", requestId: " << result.getRequestId() << std::endl;
    return 0;
}

Retrieve a symlink

The following code retrieves the target object of a symlink:

#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"

namespace oss = alibabacloud::oss2;

int main() {
    auto conf = oss::ClientConfiguration::loadDefault();
    conf.region = "<region>";
    conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();

    oss::OSSClient client(conf);

    auto outcome = client.getSymlink(
        oss::models::GetSymlinkRequest()
            .setBucket("examplebucket")
            .setKey("example-symlink.txt"));

    if (!outcome.has_value()) {
        auto& e = outcome.error();
        std::cerr << "Failed to retrieve the symlink"
                  << ", code: " << e.getCode()
                  << ", message: " << e.getMessage()
                  << ", requestId: " << e.getRequestId() << std::endl;
        return 1;
    }

    auto& result = outcome.value();
    std::cout << "Symlink retrieved successfully"
              << ", Target object: " << result.getSymlinkTarget() << std::endl;
    return 0;
}

References

For the complete sample code for creating a symlink, see PutSymlink.cpp.
For the complete sample code for retrieving a symlink, see GetSymlink.cpp.