MinIO Client SDK for .NET

MinIO Client SDK provides higher level APIs for MinIO and Amazon S3 compatible cloud storage services.For a complete list of APIs and examples, please take a look at the Dotnet Client API Reference.This document assumes that you have a working VisualStudio development environment.

Minimum Requirements

• .NET 4.5.2, .NetStandard 2.0 or higher
• Visual Studio 2017

Install from NuGet

To install MinIO .NET package, run the following command in Nuget Package Manager Console.

PM> Install-Package Minio

MinIO Client Example

To connect to an Amazon S3 compatible cloud storage service, you will need to specify the following parameters.

The following examples uses a freely hosted public MinIO service 'play.min.io' for development purposes.

using Minio;

// Initialize the client with access credentials.
private static MinioClient minio = new MinioClient("play.min.io",
                "Q3AM3UQ867SPQQA43P2F",
                "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
                ).WithSSL();

// Create an async task for listing buckets.
var getListBucketsTask = minio.ListBucketsAsync();

// Iterate over the list of buckets.
foreach (Bucket bucket in getListBucketsTask.Result.Buckets)
{
    Console.WriteLine(bucket.Name + " " + bucket.CreationDateDateTime);
}

Complete File Uploader Example

This example program connects to an object storage server, creates a bucket and uploads a file to the bucket. To run the following example, click on [Link] and start the project

using System;
using Minio;
using Minio.Exceptions;
using Minio.DataModel;
using System.Threading.Tasks;

namespace FileUploader
{
    class FileUpload
    {
        static void Main(string[] args)
        {
            var endpoint  = "play.min.io";
            var accessKey = "Q3AM3UQ867SPQQA43P2F";
            var secretKey = "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG";
            try
            {
                var minio = new MinioClient(endpoint, accessKey, secretKey).WithSSL();
                FileUpload.Run(minio).Wait();
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            Console.ReadLine();
        }

        // File uploader task.
        private async static Task Run(MinioClient minio)
        {
            var bucketName = "mymusic";
            var location   = "us-east-1";
            var objectName = "golden-oldies.zip";
            var filePath = "C:\\Users\\username\\Downloads\\golden_oldies.mp3";
            var contentType = "application/zip";

            try
            {
                // Make a bucket on the server, if not already present.
                bool found = await minio.BucketExistsAsync(bucketName);
                if (!found)
                {
                    await minio.MakeBucketAsync(bucketName, location);
                }
                // Upload a file to bucket.
                await minio.PutObjectAsync(bucketName, objectName, filePath, contentType);
                Console.WriteLine("Successfully uploaded " + objectName );
            }
            catch (MinioException e)
            {
                Console.WriteLine("File Upload Error: {0}", e.Message);
            }
        }
    }
}

Running MinIO Client Examples

On Windows

• Clone this repository and open the Minio.Sln in Visual Studio 2017.

• Enter your credentials and bucket name, object name etc.in Minio.Examples/Program.cs Uncomment the example test cases such as below in Program.cs to run an example.

  //Cases.MakeBucket.Run(minioClient, bucketName).Wait();

• Run the Minio.Client.Examples project from Visual Studio

On Linux (Ubuntu 16.04)

Setting up Mono and .NETCore on Linux

NOTE: minio-dotnet requires mono 5.0.1 stable release and .NET Core 2.0 SDK to build on Linux.

• Install .NETCore and Mono for your distro. See sample script to install .NETCore and Mono for Ubuntu Xenial mono_install.sh

$ ./mono_install.sh

Running Minio.Examples

• Clone this project.

$ git clone https://github.com/minio/minio-dotnet && cd minio-dotnet

• Enter your credentials and bucket name, object name etc. in Minio.Examples/Program.cs Uncomment the example test cases such as below in Program.cs to run an example.

  //Cases.MakeBucket.Run(minioClient, bucketName).Wait();

$ cd Minio.Examples
$ dotnet build -c Release
$ dotnet run

Bucket Operations

• MakeBucket.cs
• ListBuckets.cs
• BucketExists.cs
• RemoveBucket.cs
• ListObjects.cs
• ListIncompleteUploads.cs
• ListenBucketNotifications.cs

Bucket policy Operations

• GetPolicy.cs
• SetPolicy.cs

Bucket notification Operations

• GetBucketNotification.cs
• SetBucketNotification.cs
• RemoveAllBucketNotifications.cs

File Object Operations

• FGetObject.cs
• FPutObject.cs

Object Operations

• GetObject.cs

• GetPartialObject.cs

• SelectObjectContent.cs

• PutObject.cs

• StatObject.cs

• RemoveObject.cs

• RemoveObjects.cs

• CopyObject.cs

• CopyObject.cs

• RemoveIncompleteUpload.cs

Presigned Operations

• PresignedGetObject.cs
• PresignedPutObject.cs
• PresignedPostPolicy.cs

Client Custom Settings

• SetAppInfo
• SetTraceOn
• SetTraceOff

Explore Further

• Complete Documentation
• MinIO .NET SDK API Reference