Boto3 library

Boto3 library is a Python Software Development Kit for S3 service. It allows developers to create, configure, and manage S3 services. The library provides a simple and intuitive interface for interacting with CESNET S3 resources.

Installation of Boto3

In order to use boto3 library, you need to install it first. You can do it by running the following command inside your Python environment:

pip install boto3

Or you can use the specific version of the library:

pip install boto3==1.35.99

Usage

First, you need to create an instance of the s3 client object with your credentials and the endpoint URL:

import boto3
 
access_key = "********************"
secret_key = "****************************************"
endpoint_url = "https://s3.clX.du.cesnet.cz"
 
s3 = boto3.client("s3", aws_access_key_id=access_key, aws_secret_access_key=secret_key, endpoint_url=endpoint_url)

Then you can use the s3 object to interact with the S3 storage. Below you can find several examples of usage Boto3 library.

List all the buckets

response = s3.list_buckets()
for bucket in response["Buckets"]:
    print(f"{bucket['Name']}")

Upload an object

s3.upload_file("/local/path/to/file", "bucket-name", "remote/path/to/object")

Download an object (be aware of the parameters order!)

s3.download_file("bucket-name", "remote/path/to/object", "/local/path/to/file")

Listing the objects within bucket

s3.list_objects_v2(Bucket=self.bucket) 

or alternatively,

s3.list_objects(Bucket=self.bucket)