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: Sep 24, 2026

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

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não possuem permissões 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 de RAM ou Política de Bucket.

API

Ação

Descrição

PutObject

oss:PutObject

Realiza o upload de um objeto.

oss:PutObjectTagging

Necessário se você especificar tags de objeto usando o cabeçalho x-oss-tagging ao realizar o upload de um objeto.

kms:GenerateDataKey

Necessário se você definir o cabeçalho X-Oss-Server-Side-Encryption: KMS como KMS ao realizar o upload de um objeto.

kms:Decrypt

Código de exemplo

O código de exemplo a seguir mostra como realizar o 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 que você pode chamar para realizar um upload simples, consulte PutObject.