Object Storage Service (OSS) のシンボリックリンクは、Windows のファイルショートカットのように機能し、関連付けられたオブジェクトにすばやくアクセスできます。
使用上の注意
標準ストレージオブジェクトまたは低頻度アクセス (IA) オブジェクトを指すシンボリックリンクを使用すると、オブジェクトにすぐにアクセスできます。
シンボリックリンクを使用してアーカイブ、コールドアーカイブ、またはディープコールドアーカイブオブジェクトにアクセスする場合は、まずオブジェクトをリストアする必要があります。 詳細については、「オブジェクトのリストア」をご参照ください。
シンボリックリンクは、オブジェクトの内容ではなくオブジェクトパスを格納します。 したがって、シンボリックリンクで使用されるストレージ容量は、オブジェクトの実際のサイズではなく、シンボリックリンクが指すオブジェクトのパス長によって決まります。 たとえば、シンボリックリンクが image.jpg という名前の 1 MB のオブジェクトを指している場合、シンボリックリンクのストレージ容量は約 0.009 KB です。
シンボリックリンクのアクセス権限は、最小権限の原則に準拠しています。 シンボリックリンクのアクセス制御リスト (ACL) が非公開に設定されている場合、ユーザーは公開読み取りに設定されているターゲットオブジェクトにアクセスできません。 シンボリックリンクのアクセス制御リスト (ACL) が公開読み取りに設定されている場合、ユーザーは非公開に設定されているターゲットオブジェクトにアクセスできません。
手順
OSS コンソールを使用する
OSS コンソール にログインします。
左側のナビゲーションウィンドウで、バケットリスト をクリックします。 [バケット] ページで、目的のバケットを見つけてクリックします。
左側のナビゲーションツリーで、ファイル > オブジェクト を選択します。
シンボリックリンクを作成するオブジェクトを見つけ、[アクション] 列で
> シンボリックリンクの設定 を選択します。
シンボリックリンクの設定 パネルで、ソフトリンクファイル を設定し、OK をクリックします。
シンボリックリンク ファイルまたはフォルダ パラメータに指定する値は、命名要件に準拠している必要があります。シンボリックリンクを作成するオブジェクトが /test/ ディレクトリにあると仮定します。
[絶対パス] が選択され、シンボリックリンクの名前が t1-symlink の場合、シンボリックリンクのパスは
/t1-symlink
です。[相対パス] が選択され、シンボリックリンクの名前が t2-symlink の場合、シンボリックリンクのパスは
/test/t2-symlink
です。
重要シンボリックリンク オブジェクトの名前に myphoto.jpg オブジェクトの myphoto などの拡張子が含まれていない場合、OSS コンソールでオブジェクトにアクセスするか、URL を使用してアクセスするときに、シンボリックリンク オブジェクトをプレビューできます。 OSS ツールまたは OSS コンソールを使用してシンボリックリンク オブジェクトをダウンロードする場合、ダウンロードされたオブジェクトのフォーマットは不明であり、オブジェクトを直接開くことはできません。オブジェクトを開くには、正しいオブジェクト名拡張子をシンボリックリンク オブジェクトに追加する必要があります。
ossbrowser を使用する
ossbrowser を使用して、OSS コンソールで実行するのと同じオブジェクトレベルの操作を実行できます。 ossbrowser の画面上の指示に従って、シンボリックリンクを作成できます。 詳細については、「ossbrowser の使用」をご参照ください。
OSS SDK を使用する
次のサンプルコードは、一般的なプログラミング言語の OSS SDK を使用してシンボリックリンクを作成する方法の例を示しています。 他のプログラミング言語の OSS SDK を使用してシンボリックリンクを作成する方法の詳細については、「概要」をご参照ください。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
public class Demo {
public static void main(String[] args) throws Exception {
// この例では、中国 (杭州) リージョンのエンドポイントが使用されています。 実際のエンドポイントを指定してください。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// バケットの名前を指定します。 例: examplebucket。
String bucketName = "examplebucket";
// 作成するシンボリックリンクの名前を指定します。
String symLink = "yourSymLink";
// シンボリックリンクが指すオブジェクトの名前を指定します。
String destinationObjectName = "yourDestinationObjectName";
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
String region = "cn-hangzhou";
// OSSClient インスタンスを作成します。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
// アップロードするオブジェクトのメタデータを作成します。
ObjectMetadata metadata = new ObjectMetadata();
metadata.setContentType("text/plain");
// ユーザーメタデータのプロパティパラメータを property-value に設定します。
metadata.addUserMetadata("property", "property-value");
// シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。
// metadata.setHeader("x-oss-forbid-overwrite", "true");
// オブジェクトのアクセス制御リスト (ACL) を指定します。
// metadata.setHeader(OSSHeaders.OSS_OBJECT_ACL, CannedAccessControlList.Default);
// オブジェクトのストレージクラスを指定します。
// metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard);
// CreateSymlinkRequest を作成してシンボリックリンクを作成します。
CreateSymlinkRequest createSymlinkRequest = new CreateSymlinkRequest(bucketName, symLink, destinationObjectName);
// メタデータを構成します。
createSymlinkRequest.setMetadata(metadata);
// シンボリックリンクを作成します。
ossClient.createSymlink(createSymlinkRequest);
} catch (OSSException oe) {
System.out.println("OSSException がキャッチされました。これは、リクエストが OSS に到達したものの、"
+ "何らかの理由でエラー応答で拒否されたことを意味します。");
System.out.println("エラーメッセージ:" + oe.getErrorMessage());
System.out.println("エラーコード:" + oe.getErrorCode());
System.out.println("リクエスト ID:" + oe.getRequestId());
System.out.println("ホスト ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("ClientException がキャッチされました。これは、クライアントが OSS と通信しようとしているときに、"
+ "ネットワークにアクセスできないなど、重大な内部問題が発生したことを意味します。");
System.out.println("エラーメッセージ:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;
// 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
$provider = new EnvironmentVariableCredentialsProvider();
// この例では、中国 (杭州) リージョンのエンドポイントが使用されています。 ビジネス要件に基づいてエンドポイントを指定してください。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket。
$bucket= "examplebucket";
// シンボリックリンクが指すオブジェクトの名前を指定します。 例: exampleobject.txt。
$object = "exampleobject.txt";
// シンボリックリンクの名前を指定します。 例: examplesymlink.txt。
$symlink = "examplesymlink.txt";
$options[OssClient::OSS_HEADERS] = array(
// シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。 この例では、このパラメータは true に設定されています。これは、同じ名前のオブジェクトを上書きできないことを示します。
'x-oss-forbid-overwrite'=>"true",
// オブジェクトの ACL を指定します。 この例では、このパラメータは private に設定されています。これは、オブジェクトの所有者と承認されたユーザーのみがオブジェクトに対する読み取りおよび書き込み権限を持っていることを示します。
'x-oss-object-acl' =>"private",
// オブジェクトのストレージクラスを指定します。 この例では、ストレージクラスは Standard に設定されています。
'x-oss-storage-class' =>"Standard"
);
try {
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region"=> "cn-hangzhou"
);
$ossClient = new OssClient($config);
$ossClient->putSymlink($bucket, $symlink, $object,$options);
} catch (OssException $e) {
printf($e->getMessage() . "\n");
return;
}
const OSS = require('ali-oss')
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
region: 'yourRegion',
// 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET を構成していることを確認してください。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// バケットの名前を指定します。
bucket: 'examplebucket',
});
const headers = {
// オブジェクトのストレージクラスを指定します。
'x-oss-storage-class':'Standard',
// オブジェクトのアクセス制御リスト (ACL) を指定します。
'x-oss-object-acl':'private',
// シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。 この例では、このパラメータは true に設定されています。これは、同じ名前のオブジェクトを上書きできないことを示します。
'x-oss-forbid-overwrite': 'true '
};
async function put () {
try {
// symlinkobject.txt をシンボリックリンクの名前として指定し、exampleobject.txt をシンボリックリンクが指すオブジェクトの名前として指定します。
const result = await client.putSymlink('symlinkobject.txt', 'exampleobject.txt'
// ,{ headers }
);
console.log(result);
} catch (e) {
console.log(e);
}
}
put();
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# エンドポイントにマップするリージョンの ID を指定します。 例: cn-hangzhou。 このパラメータは、署名アルゴリズム V4 を使用する場合は必須です。
region = "cn-hangzhou"
# バケットの名前を指定します。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# シンボリックリンクが指すオブジェクトの名前を指定します。 例: exampleobject.txt。 // オブジェクトの命名規則の詳細については、「オブジェクトの命名規則」を参照してください。
object_name = 'exampleobject.txt'
# シンボリックリンクの名前を指定します。 例: examplesymlick.txt。
symlink = 'examplesymlick.txt'
# headers = dict()
# シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。 この例では、x-oss-forbid-overwrite は true に設定されています。 これは、同じ名前のオブジェクトを上書きできないことを示します。
# headers['x-oss-forbid-overwrite'] = 'true'
# オブジェクトのアクセス制御リスト (ACL) を指定します。 この例では、このパラメータは OBJECT_ACL_PRIVATE に設定されています。これは、オブジェクトの ACL が非公開であることを示します。 オブジェクトの所有者と承認されたユーザーのみがオブジェクトに対する読み取りおよび書き込み権限を持っています。
# headers[OSS_OBJECT_ACL] = oss2.OBJECT_ACL_PRIVATE
# オブジェクトのストレージクラスを指定します。 この例では、ストレージクラスは Standard に設定されています。
# headers['x-oss-storage-class'] = oss2.BUCKET_STORAGE_CLASS_STANDARD
# bucket.put_symlink(object_name, symlink, headers=headers)
# シンボリックリンクを作成します。
bucket.put_symlink(object_name, symlink)
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>Document</title>
</head>
<body>
<button id='upload'>Upload</button>
<button id='symlink'>Create Symbolic Link</button>
<!-- SDK ファイルをインポートします -->
<script type="text/javascript" src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"></script>
<script type="text/javascript">
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
region: 'yourRegion',
authorizationV4: true,
// STS から取得した一時的な AccessKey ペアを指定します。 AccessKey ペアは、AccessKey ID と AccessKey シークレットで構成されます。
accessKeyId: 'yourAccessKeyId',
accessKeySecret: 'yourAccessKeySecret',
// STS から取得したセキュリティトークンを指定します。
stsToken: 'yourSecurityToken',
// バケットの名前を指定します。 例: examplebucket。
bucket: "examplebucket",
});
const upload = document.getElementById('upload')
const symlink = document.getElementById('symlink')
const getSymlink = document.getElementById("getSymlink")
// アップロードするオブジェクトのコンテンツを指定します。
const file = new Blob(['examplecontent'])
// バケットにアップロードするオブジェクトの名前を指定します。
const fileName = 'exampleobject.txt'
// オブジェクトをアップロードします。
upload.addEventListener('click', () => {
client.put(fileName, file).then(r => console.log(r))
})
// symlink.txt という名前のシンボリックリンクを作成します。
symlink.addEventListener('click', () => {
client.putSymlink('symlink.txt', fileName).then(r => console.log(r))
})
</script>
</body>
</html>
using Aliyun.OSS;
using System.Text;
// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
var endpoint = "yourEndpoint";
// 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。 例: examplebucket。
var bucketName = "examplebucket";
var targetObjectName = "yourTargetObjectName";
var symlinkObjectName = "yourSymlinkObjectName";
var objectContent = "More than just cloud.";
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
const string region = "cn-hangzhou";
// ClientConfiguration インスタンスを作成し、要件に基づいてデフォルトパラメータを変更します。
var conf = new ClientConfiguration();
// 署名アルゴリズム V4 を使用します。
conf.SignatureVersion = SignatureVersion.V4;
// OSSClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
// シンボリックリンクが指すオブジェクトをアップロードします。
byte[] binaryData = Encoding.ASCII.GetBytes(objectContent);
MemoryStream requestContent = new MemoryStream(binaryData);
client.PutObject(bucketName, targetObjectName, requestContent);
// シンボリックリンクを作成します。
client.CreateSymlink(bucketName, symlinkObjectName, targetObjectName);
// シンボリックリンクが指すオブジェクトの名前をクエリします。
var ossSymlink = client.GetSymlink(bucketName, symlinkObjectName);
Console.WriteLine("Target object is {0}", ossSymlink.Target);
}
catch (Exception ex)
{
Console.WriteLine("Failed with error info: {0}", ex.Message);
}
// リクエストを作成します。
PutSymlinkRequest putSymlink = new PutSymlinkRequest();
// バケット名を指定します。
putSymlink.setBucketName("yourBucketName");
// シンボリックリンク名を指定します。
putSymlink.setObjectKey("yourSymLink");
// シンボリックリンクのターゲット オブジェクト名を指定します。
putSymlink.setTargetObjectName("yourTargetObjectName");
ObjectMetadata metadata = new ObjectMetadata();
// 同じ名前のオブジェクトを上書きするかどうかを指定します。この例では、このパラメーターは true に設定されており、同じ名前のオブジェクトを上書きできないことを示します。
//metadata.setHeader("x-oss-forbid-overwrite", "true");
// オブジェクトのアクセス制御リスト (ACL) を指定します。この例では、ACL は非公開に設定されています。
//metadata.setHeader("x-oss-object-acl", "private");
// オブジェクトのストレージタイプを指定します。この例では、ストレージタイプは標準に設定されています。
//metadata.setHeader("x-oss-storage-class", "Standard");
putSymlink.setMetadata(metadata);
OSSAsyncTask task = oss.asyncPutSymlink(putSymlink, new OSSCompletedCallback<PutSymlinkRequest, PutSymlinkResult>() {
@Override
public void onSuccess(PutSymlinkRequest request, PutSymlinkResult result) {
Log.d("PutSymlink", "PutSymlink success");
}
@Override
public void onFailure(PutSymlinkRequest request, ClientException clientException,
ServiceException serviceException) {
// リクエストの例外を処理します。
if (clientException != null) {
// ネットワーク例外などのクライアント例外を処理します。
clientException.printStackTrace();
}
if (serviceException != null) {
// サーバー側の例外を処理します。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
task.waitUntilFinished();
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID 環境変数と OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("認証情報プロバイダーの作成に失敗しました: %v", err)
}
// OSSClient インスタンスを作成します。
// バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。実際のエンドポイントを指定してください。
// バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。実際のリージョンを指定してください。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 署名アルゴリズムのバージョンを指定します。
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
log.Fatalf("OSS クライアントの作成に失敗しました: %v", err)
}
// バケットの名前を指定します。例: examplebucket。
bucketName := "examplebucket"
// シンボリックリンクの名前を指定します。例: examplesymlink。
symObjectKey := "examplesymlink.txt"
// シンボリックリンクが指すオブジェクトの名前を指定します。例: exampleobject.txt。
objectName := "exampleobject.txt"
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("バケット '%s' の取得に失敗しました: %v", bucketName, err)
}
// シンボリックリンクを作成します。
options := []oss.Option{
// シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。true の値は、オブジェクトが上書きされることを指定します。false の値は、オブジェクトが上書きされないことを指定します。
oss.ForbidOverWrite(true),
// オブジェクトのアクセス制御リスト (ACL) を指定します。この例では、ACL は非公開に設定されています。
oss.ObjectACL(oss.ACLPrivate),
// オブジェクトのストレージタイプを指定します。この例では、ストレージタイプは標準に設定されています。
oss.StorageClass(oss.StorageStandard),
}
err = bucket.PutSymlink(symObjectKey, objectName, options...)
if err != nil {
log.Fatalf("'%s' を指すシンボリックリンク '%s' の作成に失敗しました: %v", symObjectKey, objectName, err)
}
log.Println("シンボリックリンクが正常に作成されました")
}
OSSPutSymlinkRequest *request = [OSSPutSymlinkRequest new];
// バケット名を指定します。例:examplebucket。
request.bucketName = @"examplebucket";
// シンボリックリンクの名前を指定します。
request.objectKey = @"examplesymlink";
// シンボリックリンクのリンク先となるオブジェクトの完全なパスを指定します。完全なパスには、バケット名を含めないでください。
request.targetObjectName = @"exampleobject.txt";
OSSTask *putSymlinkTask = [client putSymlink: request];
[putSymlinkTask continueWithBlock: ^id _Nullable(OSSTask * _Nonnull task) {
if (!task.error) {
NSLog(@"put symlink success");
} else {
NSLog(@"put symlink failed, error: %@", task.error);
}
return nil;
}];
// タスクが完了するまで同期的にブロックする処理を実装します。
// [putSymlinkTask waitUntilFinished];
#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
{
/* バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 */
std::string Endpoint = "yourEndpoint";
/* バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。 */
std::string Region = "yourRegion";
/* バケットの名前を指定します。例: examplebucket。 */
std::string BucketName = "examplebucket";
/* オブジェクトの完全なパスを指定します。例: exampledir/exampleobject.txt。完全なパスにバケット名を含めないでください。 */
std::string ObjectName = "exampledir/exampleobject.txt";
/* シンボリックリンクの完全なパスを指定します。例: shortcut/myobject.txt。 */
std::string LinkName = "shortcut/myobject.txt";
/* ネットワークリソースなどのリソースを初期化します。 */
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);
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 "oss_api.h"
#include "aos_http_io.h"
/* バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。 */
const char *endpoint = "yourEndpoint";
/* バケットの名前を指定します。例: examplebucket。 */
const char *bucket_name = "examplebucket";
/* オブジェクトの完全なパスを指定します。完全なパスにはバケット名を含めないでください。例: exampledir/exampleobject.txt。 */
const char *object_name = "exampledir/exampleobject.txt";
/* 作成するシンボリックリンクの完全なパスを指定します。 */
const char *link_object_name = "yourLinkObjectName";
/* バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。 */
const char *region = "yourRegion";
void init_options(oss_request_options_t *options)
{
options->config = oss_config_create(options->pool);
/* char* 文字列を使用して aos_string_t 型のデータを初期化します。 */
aos_str_set(&options->config->endpoint, endpoint);
/* 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID 環境変数と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。 */
aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
// 2 つの追加パラメーターを指定します。
aos_str_set(&options->config->region, region);
options->config->signature_version = 4;
/* CNAME を使用するかどうかを指定します。値 0 は、CNAME が使用されていないことを示します。 */
options->config->is_cname = 0;
/* タイムアウト期間などのネットワークパラメーターを指定します。 */
options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char *argv[])
{
/* main() で aos_http_io_initialize メソッドを呼び出して、ネットワークリソースやメモリリソースなどのグローバルリソースを初期化します。 */
if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
exit(1);
}
/* メモリを管理するためのメモリプールを作成します。 aos_pool_t は apr_pool_t と同等です。メモリプールを作成するために使用されるコードは、APR ライブラリに含まれています。 */
aos_pool_t *pool;
/* メモリプールを作成します。2 番目のパラメーターの値は NULL です。この値は、プールが他のメモリプールを継承しないことを示します。 */
aos_pool_create(&pool, NULL);
/* オプションを作成して初期化します。このパラメーターには、エンドポイント、access_key_id、access_key_secret、is_cname、curl などのグローバル構成情報が含まれます。 */
oss_request_options_t *oss_client_options;
/* メモリプール内のメモリリソースをオプションに割り当てます。 */
oss_client_options = oss_request_options_create(pool);
/* oss_client_options を初期化します。 */
init_options(oss_client_options);
/* パラメーターを初期化します。 */
aos_string_t bucket;
aos_string_t object;
aos_string_t sym_object;
aos_table_t *resp_headers = NULL;
aos_status_t *resp_status = NULL;
aos_str_set(&bucket, bucket_name);
aos_str_set(&object, object_name);
aos_str_set(&sym_object, link_object_name);
resp_status = oss_put_symlink(oss_client_options, &bucket, &sym_object, &object, &resp_headers);
if (aos_status_is_ok(resp_status)) {
printf("シンボリックリンクの作成に成功しました\n");
} else {
printf("シンボリックリンクの作成に失敗しました\n");
}
/* メモリプールを解放します。この操作により、リクエストに割り当てられたメモリリソースが解放されます。 */
aos_pool_destroy(pool);
/* 割り当てられたグローバルリソースを解放します。 */
aos_http_io_deinitialize();
return 0;
}
ossutil を使用する
ossutil を使用してシンボリックリンクを作成できます。 詳細については、「create-symlink」をご参照ください。
OSS API を使用する
ビジネスで高度なカスタマイズが必要な場合は、RESTful API を直接呼び出すことができます。 API を直接呼び出すには、コードに署名計算を含める必要があります。 詳細については、「PutSymlink」をご参照ください。
FAQ
非公開オブジェクトを指すシンボリックリンクを作成できますか?
はい、非公開オブジェクトを指すシンボリックリンクを作成できます。 ACL が非公開、公開読み取り、または公開読み書きのオブジェクトを指すシンボリックリンクを作成できます。
オブジェクトがシンボリックリンクかどうかを判断するにはどうすればよいですか?
オブジェクトに対して HeadObject または GetObject 操作を呼び出し、応答を確認できます。
リクエストされたオブジェクトがシンボリックリンクの場合、シンボリックリンクが指すオブジェクトのコンテンツが返されます。 Content-Length
、ETag
、および Content-Md5
レスポンスヘッダーは、リクエストされたオブジェクトのメタデータを示します。
シンボリックリンクを削除すると、シンボリックリンクが指すオブジェクトも削除されますか?
いいえ、シンボリックリンクを削除しても、シンボリックリンクが指すオブジェクトは削除されません。