Todos os produtos
Search
Central de documentação

Object Storage Service:Change the storage class of an object (Node.js SDK)

Última atualização: Sep 24, 2026

O Object Storage Service (OSS) oferece as seguintes classes de armazenamento para atender a diversos cenários, desde dados quentes até dados frios: Standard, Infrequent Access (IA), Archive, Cold Archive e Deep Cold Archive. No OSS, após criar um objeto, não é possível modificar o conteúdo dele. Para alterar a classe de armazenamento de um objeto, use o método Bucket.CopyObject para copiar o objeto e criar um novo com a classe de armazenamento desejada.

Código de exemplo

O código a seguir mostra como alterar a classe de armazenamento de um objeto.

  • O código a seguir converte a classe de armazenamento de um objeto de Standard ou Infrequent Access para Archive:

    const OSS = require('ali-oss');
    
    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',
      // Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
      accessKeyId: process.env.OSS_ACCESS_KEY_ID,
      accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
      authorizationV4: true,
      // Set bucket to the name of your bucket.
      bucket: 'yourbucketname'
    })
    const options = {
        headers:{'x-oss-storage-class':'Archive'}
    }
    client.copy('Objectname','Objectname',options).then((res) => {
        console.log(res);
    }).catch(err => {
        console.log(err)
    })

Referências

Para mais informações, consulte CopyObject.