Skip to main content

MinIO Python SDK for Amazon S3 Compatible Cloud Storage Slack

MinIO Python SDK is Simple Storage Service (aka S3) client to perform bucket and object operations to any Amazon S3 compatible object storage service.

For a complete list of APIs and examples, please take a look at the Python Client API Reference

Minimum Requirements

Python 3.7 or higher.

Download using pip

pip3 install minio

Download source

git clone https://github.com/minio/minio-py
cd minio-py
python setup.py install

Quick Start Example - File Uploader

This example program connects to an S3-compatible object storage server, make a bucket on that server, and upload a file to the bucket.

You need the following items to connect to an S3-compatible object storage server:

Parameters Description
Endpoint URL to S3 service.
Access Key Access key (aka user ID) of an account in the S3 service.
Secret Key Secret key (aka password) of an account in the S3 service.

This example uses MinIO server playground https://play.min.io. Feel free to use this service for test and development.

file_uploader.py

from minio import Minio
from minio.error import S3Error


def main():
    # Create a client with the MinIO server playground, its access key
    # and secret key.
    client = Minio(
        "play.min.io",
        access_key="Q3AM3UQ867SPQQA43P2F",
        secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
    )

    # Make 'asiatrip' bucket if not exist.
    found = client.bucket_exists("asiatrip")
    if not found:
        client.make_bucket("asiatrip")
    else:
        print("Bucket 'asiatrip' already exists")

    # Upload '/home/user/Photos/asiaphotos.zip' as object name
    # 'asiaphotos-2015.zip' to bucket 'asiatrip'.
    client.fput_object(
        "asiatrip", "asiaphotos-2015.zip", "/home/user/Photos/asiaphotos.zip",
    )
    print(
        "'/home/user/Photos/asiaphotos.zip' is successfully uploaded as "
        "object 'asiaphotos-2015.zip' to bucket 'asiatrip'."
    )


if __name__ == "__main__":
    try:
        main()
    except S3Error as exc:
        print("error occurred.", exc)

Run File Uploader

$ python file_uploader.py
'/home/user/Photos/asiaphotos.zip' is successfully uploaded as object 'asiaphotos-2015.zip' to bucket 'asiatrip'.

$ mc ls play/asiatrip/
[2016-06-02 18:10:29 PDT]  82KiB asiaphotos-2015.zip

More References

Explore Further

Contribute

Please refer Contributors Guide

PYPI

Release files for minio 7.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for minio 7.1.9
File Size Uploaded
minio-7.1.9.tar.gz 115.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for minio 7.1.9
File Interpreter ABI Platform
minio-7.1.9-py3-none-any.whl Python 3 none any Details

Total release size: 191.5 kB

Release files / minio-7.1.9.tar.gz

Download URL minio-7.1.9.tar.gz
Size 115.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a711f3e6961ef083c161cee79f42a01d73369fc9111ccf76a74fb8d58b41d00a
BLAKE2b-256 checksum
How to use checksums
6643d2481bfa8eef0b336a97084ce2486d6b026373eca0bb7633a649a4a62f80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.4

Release files / minio-7.1.9-py3-none-any.whl

Download URL minio-7.1.9-py3-none-any.whl
Size 76.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f87ef2adf55e9beeb2216b41bbe1c8837fd1276e6bac2921f785f74e1b4e4a06
BLAKE2b-256 checksum
How to use checksums
4c871219dc23064a32e0e893309ead185c70f6520eba5a54d311ee932b5b630e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.10.4

Release history Release notifications | RSS feed

7.2.20

2 release files

7.2.19

2 release files

7.2.18

2 release files

7.2.17

2 release files

7.2.16

2 release files

7.2.15

2 release files

7.2.13

2 release files

7.2.12

2 release files

7.2.11

2 release files

7.2.10

2 release files

7.2.9

2 release files

7.2.8

2 release files

7.2.7

2 release files

7.2.6

2 release files

7.2.5

2 release files

7.2.4

2 release files

7.2.3

2 release files

7.2.2

2 release files

7.2.1

2 release files

7.2.0

2 release files

7.1.17

2 release files

7.1.16

2 release files

7.1.15

2 release files

7.1.14

2 release files

7.1.12

2 release files

7.1.11

2 release files

This release

7.1.9 This release

2 release files

7.1.8

2 release files

7.1.7

2 release files

7.1.6

2 release files

7.1.5

2 release files

7.1.4

2 release files

7.1.3

2 release files

7.1.2

2 release files

7.1.1

2 release files

7.1.0

2 release files

7.0.4

2 release files

7.0.3

2 release files

7.0.2

2 release files

7.0.1

2 release files

7.0.0

2 release files

6.0.2

3 release files

6.0.1

3 release files

6.0.0

3 release files

5.0.10

3 release files

5.0.9

3 release files

5.0.8

3 release files

5.0.7

3 release files

5.0.6

3 release files

5.0.5

3 release files

5.0.4

2 release files

5.0.3

3 release files

5.0.1

3 release files

5.0.0

3 release files

4.0.21

3 release files

4.0.20

3 release files

4.0.18

3 release files

4.0.17

3 release files

4.0.15

3 release files

4.0.14

3 release files

4.0.13

3 release files

4.0.12

3 release files

4.0.11

3 release files

4.0.10

3 release files

4.0.9

3 release files

4.0.8

3 release files

4.0.7

3 release files

4.0.6

3 release files

4.0.5

3 release files

4.0.4

3 release files

4.0.3

3 release files

4.0.2

3 release files

4.0.1

3 release files

4.0.0

3 release files

3.0.4

3 release files

3.0.3

3 release files

3.0.2

3 release files

3.0.1

3 release files

3.0.0

3 release files

2.2.6

4 release files

2.2.5

2 release files

2.2.4

2 release files

2.2.3

3 release files

2.2.2

3 release files

2.2.1

3 release files

2.2.0

3 release files

2.1.0

3 release files

2.0.8

3 release files

2.0.7

3 release files

2.0.6

3 release files

2.0.5

3 release files

2.0.4

3 release files

2.0.3

3 release files

2.0.2

3 release files

2.0.1

3 release files

2.0.0

3 release files

1.0.2

3 release files

1.0.1

3 release files

1.0.0

3 release files

0.2.9

3 release files

0.2.8

3 release files

0.2.6

3 release files

0.2.5

3 release files

0.2.4

3 release files

0.2.3

3 release files

0.2.2

3 release files

0.2.1

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page