Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Manage file metadata (Browser.js SDK)

Son Güncelleme:Oct 01, 2026

Object Storage Service (OSS) içinde depolanan nesneler; anahtarlardan, verilerden ve nesne meta verilerinden oluşur. Nesne meta verileri nesneyi açıklar ve standart HTTP üst bilgileri ile kullanıcı meta verilerini içerir. Standart HTTP üst bilgilerini kullanarak önbelleğe alma veya zorunlu indirme gibi bir nesne için HTTP istek ilkelerini belirtebilirsiniz. Ayrıca, bir nesnenin amacını veya niteliklerini belirtmek üzere kullanıcı meta verilerini yapılandırabilirsiniz.

Kullanım notları

  • Webpack ve Browserify gibi paketleme araçlarını kullanırken, npm install ali-oss komutunu çalıştırarak Browser.js için OSS SDK'sını yükleyin.

  • Bir tarayıcıdan bir OSS paketine erişmek istediğinizde ancak paket için CORS kuralları yapılandırılmadıysa tarayıcı isteği reddeder. Bu nedenle, bir pakete tarayıcıdan erişmek istiyorsanız paket için CORS kurallarını yapılandırmanız gerekir. Daha fazla bilgi için bkz. Kurulum.

  • Browser.js için OSS SDK'sı çoğunlukla tarayıcılarda kullanılır. AccessKey çiftinizin açığa çıkmasını önlemek amacıyla OSS'ye erişirken Security Token Service (STS) üzerinden alınan geçici erişim kimlik bilgilerini kullanmanızı öneririz.

    Geçici erişim kimlik bilgileri; bir AccessKey çifti ve bir güvenlik belirtecinden oluşur. AccessKey çifti, bir AccessKey ID ve bir AccessKey Secret'tan meydana gelir. Geçici erişim kimlik bilgilerini nasıl alacağınız hakkında daha fazla bilgi için bkz. Geçici erişim yetkilendirmesi için STS kullanma.

Örnek kod

Aşağıdaki kod, bir dosya yüklerken meta verilerin nasıl belirtileceğini ve dosya yüklendikten sonra bu meta verilerin nasıl güncelleneceğini ve görüntüleneceğini gösterir.

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

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

<body>
  <button id='upload'>Upload</button>
  <button id='update'>Update Metadata</button>
  <button id='check'>View Metadata</button>
    <!--Import the SDK file.-->
  <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({
       // Set region to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set region to oss-cn-hangzhou.
       region: 'yourRegion',
       authorizationV4: true,
       // The temporary AccessKey pair (AccessKey ID and AccessKey secret) obtained from Security Token Service (STS).
       accessKeyId: 'yourAccessKeyId',
       accessKeySecret: 'yourAccessKeySecret',
       // The security token (SecurityToken) obtained from STS.
       stsToken: 'yourSecurityToken',
       // Specify the bucket name. For example, examplebucket.
       bucket: "examplebucket",
     });

    const upload = document.getElementById('upload')
    const update = document.getElementById('update')
    const check = document.getElementById('check')

    // Specify the content of the file to upload.
    const file = new Blob(['examplecontent'])
    // Specify the name of the object to be uploaded to the bucket.
    const fileName = 'exampleobject.txt'

    // Upload the file.
    upload.addEventListener('click', () => {
     client.put(fileName, file, {
        // Specify custom metadata. A file can have multiple metadata entries, but the total size cannot exceed 8 KB.
        meta: {
          year: 2020,
          people: 'eliot'
        }
      }).then(r => console.log(r))
    })

    // Update the metadata.
    update.addEventListener('click', () => {
      client.putMeta(fileName, {
        year: 2021,
        people: 'evan'
      }
      ).then(r => {
        console.log(r)
      })
    })
    // View the metadata.
    check.addEventListener('click', () => {
      // Based on the metadata configured in the preceding code, add x-oss-meta-year to the ExposeHeaders configuration item in the cross-origin rule of the bucket. Otherwise, the meta printed to the console is null.
      client.head(fileName).then(m => console.log(m))
    })

  </script>
</body>

</html>

İlgili konular

  • Dosya meta verilerini yönetmeye ilişkin eksiksiz örnek kod için GitHub örneğine bakın.

  • Bir dosya yüklerken dosya meta verilerini ayarlama veya değiştirme API işlemi hakkında daha fazla bilgi için bkz. PutObject.

  • Dosya meta verilerini görüntüleme API işlemi hakkında daha fazla bilgi için bkz. HeadObject.