すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ロギング (Node.js SDK)

最終更新日:Nov 30, 2025

Object Storage Service (OSS) にアクセスすると、多数のアクセスログが生成されます。ロギング機能を使用すると、固定の命名規則に基づいて 1 時間ごとのログファイルを作成し、指定されたバケットに保存できます。

ロギングの有効化

次のコードは、ロギングを有効にする方法の例を示しています。

const OSS = require('ali-oss')
const client = new OSS({
  // バケットが配置されているリージョンに region を設定します。 たとえば、中国 (杭州) の場合は、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourregion',
  // 環境変数からアクセス認証情報を取得します。 このコードサンプルを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // bucket をご利用のバケット名に設定します。
  bucket: 'yourbucketname'
});
async function putBucketLogging () {
  try {
     const result = await client.putBucketLogging('bucket-name', 'logs/');
     console.log(result)
  } catch (e) {
    console.log(e)
  }
}
putBucketLogging();

ロギング設定の表示

次のコードは、ロギング設定を表示する方法の例を示しています。

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが配置されているリージョンに region を設定します。 たとえば、中国 (杭州) の場合は、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourregion',
  // 環境変数からアクセス認証情報を取得します。 このコードサンプルを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // bucket をご利用のバケット名に設定します。
  bucket: 'yourbucketname'
});

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

getBucketLogging();

ロギングの無効化

次のコードは、ロギング機能を無効にする方法の例を示しています。

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが配置されているリージョンに region を設定します。 たとえば、中国 (杭州) の場合は、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourregion',
  // 環境変数からアクセス認証情報を取得します。 このコードサンプルを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // bucket をご利用のバケット名に設定します。
  bucket: 'yourbucketname'
});

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

deleteBucketLogging();

関連ドキュメント

  • ロギングの完全なサンプルコードについては、「GitHub の例」をご参照ください。

  • ロギングを有効にする API 操作の詳細については、「PutBucketLogging」をご参照ください。

  • ロギング設定を表示する API 操作の詳細については、「GetBucketLogging」をご参照ください。

  • ロギングを無効にする API 操作の詳細については、「DeleteBucketLogging」をご参照ください。