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.

When running Minio server locally, the MINIO_REGION enviroment variable must be set.

Install Visual Studio 2015, Visual Studio 2017 or Visual Studio Code. Find installation of the Visual Studio editions 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;
using System.Threading.Tasks;
using Amazon;

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)
    {
        Task.Run(MainAsync).GetAwaiter().GetResult();
    }

    private static async Task MainAsync()
    {
        var config = new AmazonS3Config
        {
            RegionEndpoint = RegionEndpoint.USEast1, // MUST set this before setting ServiceURL and it should match the `MINIO_REGION` enviroment variable.
            ServiceURL = "http://localhost:9000", // replace http://localhost:9000 with URL of your minio server
            ForcePathStyle = true // MUST be true to work correctly with Minio server
        })
        var amazonS3Client = new AmazonS3Client(accessKey, secretKey, config); 

        // 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 listBucketResponse = await amazonS3Client.ListBucketsAsync();

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

            var listObjectsResponse = await amazonS3Client.ListObjectsAsync(bucketName);

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

5. Explore Further

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