手順

1. 新しいノートブックセルで、以下を追加して必要なライブラリーをインポートします。

   import os
   import boto3
   from boto3 import session

2. 別の新規ノートブックセルで、以下を定義してセッションとクライアントを作成します。

   1. 認証情報を定義します。

      key_id = os.environ.get('AWS_ACCESS_KEY_ID')
      secret_key = os.environ.get('AWS_SECRET_ACCESS_KEY')

   2. クライアントセッションを定義します。

      session = boto3.session.Session(aws_access_key_id=key_id, aws_secret_access_key=secret_key)

   3. クライアント接続を定義します。

      s3_client = boto3.client('s3', aws_access_key_id=key_id, aws_secret_access_key=secret_key)

手順

1. 新しいノートブックセルを作成し、s3_client を使用して利用可能なバケットをリスト表示します。

   s3_client.list_buckets()

2. 完全な応答ではなく、名前のみを出力することで、このバケット一覧の可読性を高めます。次に例を示します。

   for bucket in s3_client.list_buckets()['Buckets']:
       print(bucket['Name'])

   これにより、以下のような出力が返されます。

   my-app-asdf3-image-registry-us-east-1-wbmlcvbasdgasdgtkpt
   cf-templates-18rxuasgasgvb-us-east-1

手順

1. 新しいノートブックセルを作成し、バケットのオブジェクトをリスト表示します。以下に例を示します。

   bucket_name = 'std-user-bucket1'
   s3_client.list_objects_v2(Bucket=bucket_name)

   以下の形式で複数のオブジェクトが返されます。

   {'Key': 'docker/registry/v2/blobs/sha256/00/0080913dd3f10aadb34asfgsgsdgasdga072049c93606b98bec84adb259b424f/data',
   'LastModified': datetime.datetime(2021, 4, 22, 1, 26, 1, tzinfo=tzlocal()),
   'ETag': '"6e02fad2deassadfsf900a4bd7344ffe"',
   'Size': 4052,
   'StorageClass': 'STANDARD'}

2. 完全な応答ではなくキーのみを出力するなどして、この一覧の読み取りを容易化できます。

   bucket_name = 'std-user-bucket1'
   for key in s3_client.list_objects_v2(Bucket=bucket_name)['Contents']:
       print(key['Key'])

   これにより、以下のような出力が返されます。

   docker/registry/v2/blobs/sha256/00/0080913dd3f10aadb34asfgsgsdgasdga072049c93606b98bec84adb259b424f/data

3. また、クエリーをフィルターして、特定の "パス" またはファイル名などを一覧表示できます。以下はその例です。

   bucket_name = 'std-user-bucket1'
   for key in s3_client.list_objects_v2(Bucket=bucket_name,Prefix='<start_of_file_path>')['Contents']:
       print(key['Key'])

   前の例で、<start_of_file_path> を独自の値に置き換えます。

手順

1. ノートブックセルに以下の詳細を定義します。

   1. ファイルが置かれているバケット。<name_of_the_bucket> を独自の値に置き換えます。

      bucket_name = '<name_of_the_bucket>'

   2. ダウンロードするファイルの名前。<name_of_the_file_to_download> を独自の値に置き換えます。

      file_name = '<name_of_the_file_to_download>' # Full path from the bucket

   3. ダウンロード後にファイルに使用される名前。完全パス、相対パス、または新しいファイル名のみ指定できます。<name_of_the_file_when_downloaded> を独自の値に置き換えます。

      new_file_name = '<name_of_the_file_when_downloaded>'

2. 以前の変数を引数として指定し、ファイルをダウンロードします。

   s3_client.download_file(bucket_name, file_name, new_file_name)

   注記

   ファイルをオブジェクトとして取得し、read() メソッドを使用して標準ファイルとしてストリーミングする場合は、Amazon Web Services get object command reference を参照してください。

手順

1. ノートブックセルに以下の詳細を定義します。

   1. アップロードするファイルの名前。ファイルへの完全なローカルパスを含める必要があります。<name_of_the_file_to_upload> を独自の値に置き換えます。

      file_name = '<name_of_the_file_to_upload>'

   2. ファイルをアップロードするバケットの名前。<name_of_the_bucket> を独自の値に置き換えます。

      bucket_name = '<name_of_the_bucket>'

   3. ファイルをバケットに保存するために使用する完全なキー。<full_path_and_file_name> を独自の値に置き換えます。

      key = '<full_path_and_file_name>'

2. 以前の変数を引数として指定し、ファイルをアップロードします。

   s3_client.upload_file(file_name, bucket_name, key)