バケットの一覧表示 - Object Storage Service - Alibaba Cloud ドキュメントセンター

バケットは、Object Storage Service (OSS) に保存されているオブジェクトのコンテナです。 OSS内のすべてのオブジェクトはバケットに含まれています。バケツはアルファベット順にリストされています。すべてのリージョンで現在のAlibaba Cloudアカウントに属し、特定の条件を満たすバケットを一覧表示できます。

Alibaba Cloudアカウント内のすべてのバケットを一覧表示する

次のサンプルコードは、現在のAlibaba Cloudアカウント内のすべてのリージョンのバケットを一覧表示する方法の例を示しています。

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

const client = new OSS({
  // バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを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
});

async関数listBuckets() {
  try {
    // 現在のAlibaba Cloudアカウント内のすべてのリージョンのすべてのバケットを一覧表示します。 
    const result = await client.listBuckets();
    console.log (結果);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

名前に特定のプレフィックスが含まれるバケットの一覧表示

次のサンプルコードは、現在のAlibaba Cloudアカウント内のすべてのリージョンで、名前にサンプルプレフィックスが含まれているバケットを一覧表示する方法の例を示しています。

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

const client = new OSS({
  // バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを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
});

async関数listBuckets() {
  try {
    const result = await client.listBuckets({
      // 一覧表示するバケットの名前に含まれるプレフィックスを指定します。 
      プレフィックス: 'example' 
    });
    // 現在のAlibaba Cloudアカウント内のすべてのリージョンで、指定されたプレフィックスを名前に含むバケットをリストします。 
    console.log (結果);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

マーカーで指定されたバケットの後に名前がアルファベット順であるバケットを一覧表示する

次のサンプルコードは、現在のAlibaba Cloudアカウント内のすべてのリージョンで、名前がexamplebucketという名前のバケットの後にアルファベット順になっているバケットを一覧表示する方法の例を示しています。

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

const client = new OSS({
  // バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを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
});

async関数listBuckets() {
  try {
    const result = await client.listBuckets({
      // markerの値を指定します。 
      マーカー: 'examplebucket' 
    });
    // 現在のAlibaba Cloudアカウント内のすべてのリージョンで、名前がexamplebucketの後にアルファベット順になっているバケットを一覧表示します。 
    console.log (結果);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

特定の数のバケットを一覧表示する

次のサンプルコードは、現在のAlibaba Cloudアカウント内のすべてのリージョンのバケットを一覧表示し、一覧表示できるバケットの最大数を500に設定する方法の例を示しています。

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

const client = new OSS({
  // バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを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
});

async関数listBuckets() {
  try {
    const result = await client.listBuckets({
      // max-keysパラメーターを指定します。 このパラメーターは、一覧表示するバケットの最大数を指定するために使用されます。 max-keysの値は1000を超えることはできません。 デフォルトでは、max-keysが指定されていない場合、最大100個のバケットが返されます。 
      // 500バケットを一覧表示します。 
      'max-keys': 500
    });
    console.log (結果);
  } catch (err) {
    console.log(err);
  }
}

listBuckets();

参考資料

バケットの一覧表示に使用する完全なサンプルコードについては、『GitHub』をご参照ください。
バケットを一覧表示するために呼び出すAPI操作の詳細については、「ListBuckets (GetService) 」をご参照ください。