aws-sdk-for-dotnet-with-minio.md

How to use AWS SDK for .NET with Minio Server

aws-sdk-dotnet is the official AWS SDK for the .NET Framework. In this recipe we will learn how to use aws-sdk-dotnet with Minio server.

1. Prerequisites

Install Minio Server from here.

Install Visual Studio 2015 or Visual Studio 2017. Find installation of Visual Studio 2015 Community edition here.

2. Installation

aws-sdk-dotnet installation is available as Nuget package. This package contains only libraries that are necessary for work with AWS S3. Installation of the Nuget package is performed using "Manage Nuget Packages..." UI or by using Nuget Manager Console by typing Install-Package AWSSDK.S3. The installation will automatically download the library for the .NET platform which is compatible with your project. The package exists for .NET Frameworks 3.5 and 4.5 and also for .NET Core 1.1.

The older (version 2) package is also available, but it is not recommended for use since it downloads all AWS SDK libraries and not only the S3 module.

3. Example

The example code should be copied instead of the generated code in the Program.cs file. Create a console project in Visual Studio IDE and replace the generated Program.cs with the code below. Update ServiceURL,accessKey and secretKey with information that matching your Minio server setup.

The example prints all buckets in the Minio server and lists all objects of the first bucket using aws-sdk-dotnet.

using Amazon.S3;
using System;

class Program
{
    private const string accessKey = "PLACE YOUR ACCESS KEY HERE";
    private const string secretKey = "PLACE YOUR SECRET KEY HERE"; // do not store secret key hardcoded in your production source code!
    
    static void Main(string[] args)
    {
        var amazonS3Client = new AmazonS3Client(accessKey, secretKey, new AmazonS3Config { ServiceURL = "http://localhost:9000", ForcePathStyle = true }); // replace http://localhost:9000 with URL of your minio server

        // uncomment the following line if you like to troubleshoot communication with S3 storage and implement private void OnAmazonS3Exception(object sender, Amazon.Runtime.ExceptionEventArgs e)
        // amazonS3Client.ExceptionEvent += OnAmazonS3Exception;

        var task = amazonS3Client.ListBucketAsync();
        task.Wait();

        foreach(var bucket in task.Result.Buckets)
        {
            Console.Out.WriteLine("bucket '" + bucket.BucketName + "' created at " + bucket.CreationTime);
        }
        if (task.Result.Buckets.Count > 0)
        {
            var bucketName = task.Result.Buckets[0].BucketName;

            var task2 = amazonS3Client.ListObjectsAsync(bucketName);
            task2.Wait();

            foreach(var obj in task2.Result.S3Objects)
            {
                Console.Out.WriteLine("key = '" + obj.Key+ "' | size = " + obj.Size + " | tags = '" + obj.ETag + "' | modified = " + obj.LastModified);
            }
        }
    }
}

The above example is using asynchronous API synchronously for the matter of example. The AmazonS3Config setting ForcePathStyle = true is essential in order to work correctly with Minio server.

5. Explore Further

• AWS SDK for .NET
• Configuring AWS SDK with .NET Core
• Amazon S3 for DotNet documentation