Object Storage Service:Manage symbolic links using OSS SDK for Browser.js

Notas de uso

• Ao usar ferramentas de empacotamento como Webpack e Browserify, instale o OSS SDK for Browser.js e execute o comando npm install ali-oss.

• Se você acessar um bucket do OSS pelo navegador sem regras CORS configuradas, o navegador rejeitará a solicitação. Portanto, configure as regras CORS para um bucket caso precise acessá-lo pelo navegador. Para mais informações, consulte Installation.

• Na maioria dos casos, o OSS SDK for Browser.js é usado em navegadores. Para evitar expor seu par de AccessKey, recomendamos o uso de credenciais de acesso temporárias obtidas do Security Token Service (STS) para acessar o OSS.

  As credenciais de acesso temporárias consistem em um par de AccessKey e um token de segurança. O par de AccessKey é composto por um AccessKey ID e um AccessKey secret. Para mais informações sobre como obter credenciais de acesso temporárias, consulte Use STS for temporary access authorization.

Crie um link simbólico

O código a seguir mostra um exemplo de como criar um link simbólico:

<!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>  
  <!-- 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({
       // Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou. 
       region: 'yourRegion',
       authorizationV4: true,
       // Specify the temporary AccessKey pair obtained from STS. The AccessKey pair consists of an AccessKey ID and an AccessKey secret. 
       accessKeyId: 'yourAccessKeyId',
       accessKeySecret: 'yourAccessKeySecret',
       // Specify the security token obtained from STS. 
       stsToken: 'yourSecurityToken',
       // Specify the name of the bucket. Example: examplebucket. 
       bucket: "examplebucket",
     });

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

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

    // Upload the object. 
    upload.addEventListener('click', () => {
      client.put(fileName, file).then(r => console.log(r))
    })
    
    // Create a symbolic link named symlink.txt. 
    symlink.addEventListener('click', () => {
      client.putSymlink('symlink.txt', fileName).then(r => console.log(r))
    })

  </script>
</body>

</html>

Consulte o nome do objeto para o qual o link simbólico aponta

Para consultar um link simbólico, você precisa ter permissões de leitura nele. O código a seguir mostra um exemplo de como consultar o nome do objeto para o qual o link simbólico aponta:

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

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

<body>  
  <button id='getSymlink'>Query Symbolic Link</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({
       // Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou. 
       region: 'yourRegion',
       authorizationV4: true,
       // Specify the temporary AccessKey pair obtained from STS. The AccessKey pair consists of an AccessKey ID and an AccessKey secret. 
       accessKeyId: 'yourAccessKeyId',
       accessKeySecret: 'yourAccessKeySecret',
       // Specify the security token obtained from STS. 
       stsToken: 'yourSecurityToken',
       // Specify the name of the bucket. Example: examplebucket. 
       bucket: "examplebucket",
     });    
    
    const getSymlink = document.getElementById("getSymlink")

    // Query the name of the object to which the symbolic link points. 
    getSymlink.addEventListener('click', () => {
      client.getSymlink('symlink.txt').then(r => console.log(r))
    })

  </script>
</body>

</html>

Referências

• Crie um link simbólico

  • Para o código de exemplo completo usado para criar um link simbólico, visite o GitHub.

  • Para mais informações sobre a operação de API que você pode chamar para criar um link simbólico, consulte PutSymlink.

• Consulte o objeto para o qual um link simbólico aponta

  • Para o código de exemplo completo usado para consultar o objeto para o qual um link simbólico aponta, visite o GitHub.

  • Para mais informações sobre a operação de API que você pode chamar para consultar o objeto para o qual um link simbólico aponta, consulte GetSymlink.