シンボリックリンクの管理 (C++ SDK) - Object Storage Service

シンボリックリンク機能は、バケット内で頻繁に使用されるオブジェクトにアクセスするための便利な方法を提供します。シンボリックリンクをショートカットとして使用して、ターゲットオブジェクトにアクセスできます。

注意事項

このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient を作成する場合は、「OssClient インスタンスの作成」をご参照ください。
シンボリックリンクを作成するには、oss:PutObject 権限が必要です。シンボリックリンクを取得するには、oss:GetObject 権限が必要です。詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。

シンボリックリンクの作成

シンボリックリンクは複数のバージョンを持つことができ、各バージョンは異なるターゲットオブジェクトを指すことができます。OSS は自動的にバージョン ID を生成し、`x-oss-version-id` レスポンスヘッダーで返します。ターゲットオブジェクトの現在のバージョンを指すシンボリックリンクを作成できます。

説明

バージョン管理が有効なバケットでは、削除マーカーのシンボリックリンクを作成することはできません。

次のコードは、シンボリックリンクを作成する方法を示しています。

#include <alibabacloud/oss/OssClient.h>
#include <alibabacloud/oss/model/ObjectMetaData.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* OSS アカウント情報を初期化します。*/
            
    /* yourEndpoint を、バケットが所在するリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion を、バケットが所在するリージョンに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。*/
    std::string Region = "yourRegion";
    /* バケット名を指定します。例：examplebucket */
    std::string BucketName = "examplebucket";
    /* オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。例：exampledir/exampleobject.txt */
    std::string ObjectName = "exampledir/exampleobject.txt";
    /* シンボリックリンクの名前を指定します。*/
    std::string LinkName = "yourLinkName";

    /* ネットワークリソースを初期化します。*/
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* HTTP ヘッダーを設定します。*/
    auto meta = ObjectMetaData();
    meta.setContentType("text/plain");

    /* カスタムファイルメタデータを設定します。*/
    meta.UserMetaData()["meta"] = "meta-value";

    /* シンボリックリンクを作成します。*/
    CreateSymlinkRequest request(BucketName, ObjectName, meta);
    request.SetSymlinkTarget(LinkName);
    auto outcome = client.CreateSymlink(request);

    /* アップロードされたシンボリックリンクのバージョン ID を表示します。*/
    if (outcome.isSuccess()) {
        std::cout << "versionid:" << outcome.result().VersionId() << std::endl;
    }
    else {
        /* 例外を処理します。*/
        std::cout << "CreateSymlink fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* ネットワークリソースを解放します。*/
    ShutdownSdk();
    return 0;
}

シンボリックリンクの取得

GetSymlink 操作は、デフォルトでシンボリックリンクの現在のバージョンを取得します。バージョン ID を指定して特定のバージョンを取得できます。シンボリックリンクの現在のバージョンが削除マーカーの場合、OSS は 404 Not Found エラーを返します。レスポンスヘッダーには `x-oss-delete-marker = true` とバージョン ID `x-oss-version-id` が含まれます。

説明

シンボリックリンクを取得するには、そのシンボリックリンクに対する読み取り権限が必要です。

次のコードは、シンボリックリンクを取得する方法を示しています。

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
 {
    /* OSS アカウント情報を初期化します。*/
            
    /* yourEndpoint を、バケットが所在するリージョンのエンドポイントに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。*/
    std::string Endpoint = "yourEndpoint";
    /* yourRegion を、バケットが所在するリージョンに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。*/
    std::string Region = "yourRegion";
    /* バケット名を指定します。例：examplebucket */
    std::string BucketName = "examplebucket";
    /* シンボリックリンクの名前を指定します。*/
    std::string LinkName = "yourLinkName";

   /* ネットワークリソースを初期化します。*/
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* シンボリックリンクファイルの特定のバージョンを取得します。*/
    GetSymlinkRequest request(BucketName, LinkName);
    request.setVersionId("yourObjectVersionId");
    auto outcome = client.GetSymlink(request);

    /* 返されたシンボリックリンクファイルのバージョン ID を表示します。*/
    if (outcome.isSuccess()) {
        std::cout << "versionid:" << outcome.result().VersionId()
        << "Symlink name:" << outcome.result().SymlinkTarget() << std::endl;
    }
    else {
        /* 例外を処理します。*/
        std::cout << "GetSymlink fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* ネットワークリソースを解放します。*/
    ShutdownSdk();
    return 0;
}

Object Storage Service:シンボリックリンクの管理 (C++ SDK)

注意事項

シンボリックリンクの作成

シンボリックリンクの取得

関連ドキュメント