软链接功能用于便捷访问Bucket内的常用Object。设置软链接后,您可以使用类似于Windows的快捷方式,通过软链接文件打开Object。
创建软链接
以下代码用于创建软链接:
const OSS = require('ali-oss')
const client = new OSS({
// yourregion填写Bucket所在地域。以华东1(杭州)为例,Region填写为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名称。
bucket: 'examplebucket',
});
const headers = {
// 指定Object的存储类型。
'x-oss-storage-class':'Standard',
// 指定Object的访问权限。
'x-oss-object-acl':'private',
// 指定创建软链接时是否覆盖同名Object。设置为true,表示禁止覆盖同名Object。
'x-oss-forbid-overwrite': 'true '
};
async function put () {
try {
// 分别指定软链接名称为symlinkobject.txt、软链接指向的目标Object名称为exampleobject.txt。
const result = await client.putSymlink('symlinkobject.txt', 'exampleobject.txt'
// ,{ headers }
);
console.log(result);
} catch (e) {
console.log(e);
}
}
put();
获取软链接指向的目标Object名称
获取软链接要求您对该软链接有读权限。以下代码用于获取软链接指向的目标Object名称:
const OSS = require('ali-oss')
const client = new OSS({
// yourregion填写Bucket所在地域。以华东1(杭州)为例,Region填写为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名称。
bucket: 'examplebucket',
});
// 填写软链接名称,并获取软链接指向的目标Object名称。
client.getSymlink('symlinkobject.txt').then(r=>console.log(r))
相关文档
关于创建软链接的API接口说明,请参见PutSymlink。
关于获取软链接的API接口说明,请参见GetSymlink。