PythonのBoto3ライブラリを使ってAWS S3のバケット一覧を取得する方法

問題の概要： Pythonのboto3ライブラリを使用して、AWSアカウント内に存在するすべてのS3バケットの一覧を取得します。

例： BUCKET_1、BUCKET_2、BUCKET_3 のようなバケット名の一覧を取得します。

boto3とは

boto3は、PythonからAWSの各種サービスを操作するための公式SDKです。S3やEC2、DynamoDBなど、多くのAWSリソースをPythonコードから簡単に扱えます。使用前には pip install boto3 でインストールしておき、AWSの認証情報（アクセスキー・シークレットキー）が適切に設定されていることを確認してください。

解決のための手順（アルゴリズム）

ステップ1： boto3と、例外処理のためのbotocore.exceptions をインポートします。
ステップ2： Boto3ライブラリを使用してAWSセッションを作成します。
ステップ3： S3用のAWSリソースオブジェクトを作成します。
ステップ4： buckets.all() 関数を使ってバケット名を一覧表示します。
ステップ5： 予期しない例外が発生した場合には適切に処理します。
ステップ6： バケット名のリストを返します。

サンプルコード

以下のコードは、S3に存在するバケットの一覧を取得します。

import boto3
from botocore.exceptions import ClientError

# S3リソースを使ってAWS上のバケット一覧を取得する
def get_buckets_resource():
    session = boto3.session.Session()
    # カスタムのアクセスキー、シークレットキー、トークンを渡すことも可能
    s3_resource = session.resource('s3')
    try:
        buckets = list(s3_resource.buckets.all())
        print("Got buckets using resource:", buckets)
    except ClientError:
        print("Couldn't get buckets.")
        raise
    else:
        return buckets

get_buckets_resource()

実行結果

Got buckets using resource:[s3.Bucket(name='BUCKET_1'),
s3.Bucket(name='BUCKET_2'), s3.Bucket(name='BUCKET_3')…… ]

補足：クライアントAPIを使う方法

リソースAPIの代わりにクライアントAPIを利用すると、list_buckets() メソッドで同様にバケット一覧を取得できます。この場合、バケット名を文字列のリストとして直接受け取れるため、用途に応じて使い分けると便利です。

import boto3

def get_buckets_client():
    s3_client = boto3.client('s3')
    response = s3_client.list_buckets()
    return [bucket['Name'] for bucket in response['Buckets']]