Boto3 Library

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

Installation of Boto3

To use the boto3 library, you must first install it. You can do so by running the following command in 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 using 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)

You can then use the s3 object to interact with the S3 storage. Below are several examples of how to use the 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)