快速开始

MOS Python SDK是Amazon S3兼容的云存储的Simple Storage Service（S3）客户端，可对任何Amazon S3兼容的对象存储服务执行存储桶和对象操作。

有关API和示例的完整列表，请查看Python客户端API参考。

最低要求

Python 3.7或更高版本。

使用pip下载

pip3 install minio

从源代码安装

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

快速入门示例-文件上传器

此示例程序连接到S3兼容的对象存储服务器，在该服务器上创建一个存储桶，并将文件上传到该存储桶。

您需要以下项目才能连接到S3兼容的对象存储服务器：

参数	描述
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.

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="Q3A***********3P2F",
        secret_key="zuf+t************************KYY3TG",
    )

    # 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)

运行 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