Todos los productos
Search
Centro de documentos

Object Storage Service:Almacenamiento de registros (SDK de Node.js)

Última actualización: Sep 05, 2026

El registro de accesos de Object Storage Service (OSS) captura información detallada sobre las solicitudes que se envían a sus buckets. Cuando habilita el registro en un bucket de origen, OSS genera y entrega automáticamente archivos de registro cada hora al bucket de destino que especifique. Este proceso utiliza una convención de nombres predefinida.

Habilitar el almacenamiento de registros

A continuación se muestra un ejemplo de código para habilitar el almacenamiento de registros.

const OSS = require('ali-oss')
const client = new OSS({
  // Set region to the region where the bucket is located. For example, for China (Hangzhou), set region to oss-cn-hangzhou.
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before running this code sample, 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'
});
async function putBucketLogging () {
  try {
     const result = await client.putBucketLogging('bucket-name', 'logs/');
     console.log(result)
  } catch (e) {
    console.log(e)
  }
}
putBucketLogging();

Consultar la configuración de almacenamiento de registros

A continuación se muestra un ejemplo de código para consultar la configuración de almacenamiento de registros.

const OSS = require('ali-oss')

const client = new OSS({
  // Set region to the region where the bucket is located. For example, for China (Hangzhou), set region to oss-cn-hangzhou.
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before running this code sample, 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'
});

async function getBucketLogging() {
  try {
     const result = await client.getBucketLogging('bucket-name');
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getBucketLogging();

Deshabilitar el almacenamiento de registros

A continuación se muestra un ejemplo de código para deshabilitar la función de almacenamiento de registros.

const OSS = require('ali-oss')

const client = new OSS({
  // Set region to the region where the bucket is located. For example, for China (Hangzhou), set region to oss-cn-hangzhou.
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before running this code sample, 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'
});

async function deleteBucketLogging () {
  try {
    const result = await client.deleteBucketLogging('bucket-name');
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

deleteBucketLogging();

Referencias

  • Para obtener el código de ejemplo completo del almacenamiento de registros, consulte ejemplos en GitHub.

  • Para más información sobre la operación de API que permite habilitar el almacenamiento de registros, consulte PutBucketLogging.

  • Si desea conocer más detalles sobre la operación de API para consultar la configuración de almacenamiento de registros, consulte GetBucketLogging.

  • En cuanto a la operación de API para deshabilitar el almacenamiento de registros, consulte DeleteBucketLogging.