全部产品
Search
文档中心

Object Storage Service:Mengelola tautan simbolik (Browser.js SDK)

更新时间:Nov 30, 2025

Tautan simbolik menyediakan cara praktis untuk mengakses objek yang sering digunakan dalam bucket. Setelah membuat tautan simbolik, Anda dapat menggunakannya seperti shortcut Windows untuk mengakses objek target.

Usage notes

  • Saat menggunakan alat packaging seperti Webpack dan Browserify, instal OSS SDK untuk Browser.js dengan menjalankan perintah npm install ali-oss.

  • Jika Anda ingin mengakses bucket OSS dari browser tetapi bucket tersebut belum dikonfigurasi dengan aturan CORS, browser akan menolak permintaan tersebut. Oleh karena itu, Anda harus mengonfigurasi aturan CORS pada bucket untuk mengaksesnya dari browser. Untuk informasi selengkapnya, lihat Installation.

  • Dalam kebanyakan kasus, OSS SDK untuk Browser.js digunakan di browser. Untuk mencegah pasangan AccessKey Anda terpapar, kami menyarankan agar Anda menggunakan kredensial akses temporary yang diperoleh dari Security Token Service (STS) untuk mengakses OSS.

    Kredensial akses temporary terdiri atas pasangan AccessKey dan token keamanan. Pasangan AccessKey mencakup ID AccessKey dan Rahasia AccessKey. Untuk informasi selengkapnya tentang cara memperoleh kredensial akses temporary, lihat Use STS for temporary access authorization.

Create a symbolic link

Gunakan kode berikut untuk membuat tautan simbolik:

<!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>  
  <!--Impor file 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({
       // Atur region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur region ke oss-cn-hangzhou.
       region: 'yourRegion',
       authorizationV4: true,
       // ID AccessKey dan Rahasia AccessKey temporary yang diperoleh dari STS.
       accessKeyId: 'yourAccessKeyId',
       accessKeySecret: 'yourAccessKeySecret',
       // Token keamanan (SecurityToken) yang diperoleh dari STS.
       stsToken: 'yourSecurityToken',
       // Tentukan nama bucket. Contoh: examplebucket.
       bucket: "examplebucket",
     });

    const upload = document.getElementById('upload')
    const symlink = document.getElementById('symlink')
    const getSymlink = document.getElementById("getSymlink")

    // Tentukan konten file yang akan diunggah.
    const file = new Blob(['examplecontent'])
    // Tentukan nama objek di dalam bucket.
    const fileName = 'exampleobject.txt'

    // Unggah file.
    upload.addEventListener('click', () => {
      client.put(fileName, file).then(r => console.log(r))
    })
    
    // Buat tautan simbolik bernama symlink.txt.
    symlink.addEventListener('click', () => {
      client.putSymlink('symlink.txt', fileName).then(r => console.log(r))
    })

  </script>
</body>

</html>

Get the name of the target object of a symbolic link

Untuk mengambil nama objek target dari tautan simbolik, Anda harus memiliki izin baca pada tautan simbolik tersebut. Gunakan kode berikut untuk mengambil nama objek target:

<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8" />
  <title>Document</title>
</head>

<body>  
  <button id='getSymlink'>Get Symbolic Link</button>  
  <!--Impor file 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({
       // Atur region ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur region ke oss-cn-hangzhou.
       region: 'yourRegion',
       authorizationV4: true,
       // ID AccessKey dan Rahasia AccessKey temporary yang diperoleh dari STS.
       accessKeyId: 'yourAccessKeyId',
       accessKeySecret: 'yourAccessKeySecret',
       // Token keamanan (SecurityToken) yang diperoleh dari STS.
       stsToken: 'yourSecurityToken',
       // Tentukan nama bucket. Contoh: examplebucket.
       bucket: "examplebucket",
     });    
    
    const getSymlink = document.getElementById("getSymlink")

    // Dapatkan nama objek target dari tautan simbolik.
    getSymlink.addEventListener('click', () => {
      client.getSymlink('symlink.txt').then(r => console.log(r))
    })

  </script>
</body>

</html>

References

  • Create a symbolic link

    • Untuk kode contoh lengkap tentang cara membuat tautan simbolik, lihat GitHub example.

    • Untuk informasi selengkapnya tentang operasi API untuk membuat tautan simbolik, lihat PutSymlink.

  • Retrieve the target object of a symbolic link

    • Untuk kode contoh lengkap tentang cara mengambil objek target dari tautan simbolik, lihat GitHub example.

    • Untuk informasi selengkapnya tentang operasi API untuk mengambil objek target dari tautan simbolik, lihat GetSymlink.