MinIO Python Client SDK提供简单的API来访问任何与Amazon S3兼容的对象存储服务。
本文我们将学习如何安装MinIO client SDK，并运行一个python的示例程序。对于完整的API以及示例，请参考Python Client API Reference。
本文假设你已经有一个可运行的 Python开发环境。
- Python 2.7或更高版本
pip install miniogit clone https://github.com/minio/minio-py
cd minio-py
python setup.py installMinIO client需要以下4个参数来连接MinIO对象存储服务。
| 参数 | 描述 |
|---|---|
| endpoint | 对象存储服务的URL。 |
| access_key | Access key是唯一标识你的账户的用户ID。 |
| secret_key | Secret key是你账户的密码。 |
| secure | true代表使用HTTPS。 |
from minio import Minio
from minio.error import ResponseError
minioClient = Minio('play.min.io',
access_key='Q3AM3UQ867SPQQA43P2F',
secret_key='zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG',
secure=True)本示例连接到一个MinIO对象存储服务，创建一个存储桶并上传一个文件到存储桶中。
我们在本示例中使用运行在 https://play.min.io 上的MinIO服务，你可以用这个服务来开发和测试。示例中的访问凭据是公开的。
# 引入MinIO包。
from minio import Minio
from minio.error import (ResponseError, BucketAlreadyOwnedByYou,
BucketAlreadyExists)
# 使用endpoint、access key和secret key来初始化minioClient对象。
minioClient = Minio('play.min.io',
access_key='Q3AM3UQ867SPQQA43P2F',
secret_key='zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG',
secure=True)
# 调用make_bucket来创建一个存储桶。
try:
minioClient.make_bucket("maylogs", location="us-east-1")
except BucketAlreadyOwnedByYou as err:
pass
except BucketAlreadyExists as err:
pass
except ResponseError as err:
raise
else:
try:
minioClient.fput_object('maylogs', 'pumaserver_debug.log', '/tmp/pumaserver_debu
903A
g.log')
except ResponseError as err:
print(err)python file_uploader.py
mc ls play/maylogs/
[2016-05-27 16:41:37 PDT] 12MiB pumaserver_debug.log完整的API文档在这里。
make_bucketlist_bucketsbucket_existsremove_bucketlist_objectslist_objects_v2list_incomplete_uploads
set_bucket_notificationget_bucket_notificationremove_all_bucket_notificationlisten_bucket_notification
get_objectput_objectstat_objectcopy_objectget_partial_objectremove_objectremove_objectsremove_incomplete_upload
- make_bucket.py
- list_buckets.py
- bucket_exists.py
- list_objects.py
- remove_bucket.py
- list_incomplete_uploads.py
- set_bucket_notification.py
- get_bucket_notification.py
- remove_all_bucket_notification.py
- listen_bucket_notification.py
- get_object.py
- put_object.py
- stat_object.py
- copy_object.py
- get_partial_object.py
- remove_object.py
- remove_objects.py
- remove_incomplete_upload.py
