Repository files navigation

The MinIO Rust SDK is a Simple Storage Service (aka S3) client for performing bucket and object operations to any Amazon S3 compatible object storage service.It provides a strongly-typed, async-first interface to the MinIO and Amazon S3-compatible object storage APIs.

Each supported S3 operation has a corresponding request builder (for example: [BucketExists], [PutObject], [UploadPartCopy]), which allows users to configure request parameters using a fluent builder pattern.

All request builders implement the [S3Api] trait, which provides the asyncsend method to execute the request and return a typed response.

use minio::s3::Client;use minio::s3::types::S3Api;use minio::s3::response::BucketExistsResponse;#[tokio::main]async fn main() {    let client: Client = Default::default(); // configure your client    let exists: BucketExistsResponse = client        .bucket_exists("my-bucket")        .send()        .await        .expect("request failed");    println!("Bucket exists: {}", exists.exists);}

• Request builder pattern for ergonomic API usage
• Full async/await support via [tokio]
• Strongly-typed responses
• Transparent error handling viaResult<T, Error>

• Each API method on the [Client] returns a builder struct
• Builders implement [ToS3Request] for request conversion and [S3Api] for execution
• Responses implement [FromS3Response] for consistent deserialization

You can run the examples from the command line with:

cargo run --example <example_name>

The examples below cover several common operations.You can find the complete list of examples in theexamples directory.

• Upload a file to MinIO
• Upload a file to MinIO with CLI

• Download a file from MinIO

• Prompt a file on MinIO

This SDK is distributed under theApache License, Version 2.0, seeLICENSE for more information.