Todos os produtos
Search
Central de documentação

Object Storage Service:Upload from the local memory using OSS SDK for Node.js

Última atualização: Jul 03, 2026

Este tópico descreve como fazer upload de conteúdo da memória local para o Object Storage Service (OSS).

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a essa conta não têm permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

API

Ação

Descrição

PutObject

oss:PutObject

Faz upload de um objeto.

oss:PutObjectTagging

Necessária ao especificar tags de objeto com o cabeçalho x-oss-tagging durante o upload.

kms:GenerateDataKey

Obrigatória se o cabeçalho X-Oss-Server-Side-Encryption: KMS estiver definido como KMS durante o upload.

kms:Decrypt

Código de exemplo

O código a seguir mostra como fazer upload de conteúdo da memória local para o OSS.

const OSS = require('ali-oss');

const client = new OSS({
  // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou. 
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before you run the sample code, make sure that you have configured environment variables OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET. 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the name of your bucket. 
  bucket: 'yourbucketname',
});

async function putBuffer () {
  try {
    const result = await client.put('object-name', new Buffer.from('hello world'));
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

putBuffer();

Referências

Para obter mais informações sobre a operação de API usada para fazer upload simples, consulte PutObject.