Python Boto3

This guide details the steps needed to install and use the Boto3 library for Python.

The SDK is composed of two key Python packages: Botocore (the library providing the low-level functionality), and Boto3 (the package implementing the Python SDK itself).

Installation

Install the latest Boto3 release via pip:

pip install boto3

Using Boto3

To use Boto3, you must first import it. After you have imported Boto3, indicate that you are going to use the S3 service, provide the Key and Secret access details, and set the Tebi S3 endpoint URL:

import boto3

# Let's use S3
s3 = boto3.resource(
    service_name='s3',
    aws_access_key_id='<PUT_YOUR_KEY>',
    aws_secret_access_key='<PUT_YOUR_SECRET>',
    endpoint_url='https://s3.tebi.io'
)

Now that you have an S3 resource, you can send requests to the service. The following code uses the buckets collection to print out all bucket names:

# Print out bucket names
for bucket in s3.buckets.all():
    print(bucket.name)

You can also upload and download binary data. For example, the following uploads a new file to S3, assuming that the bucket my-bucket already exists:

# Upload a new file
data = open('test.jpg', 'rb')
s3.Bucket('my-bucket').put_object(Key='test.jpg', Body=data)

For more examples, please refer to the official Boto3 documentation examples. Full Boto3 S3 reference is available here.