AWS SDK for C# With Wasabi

How do I use AWS SDK for C# with Wasabi?

AWS SDK for .NET is a framework used for C# coding and is validated for use with Wasabi. This framework can be used with Wasabi by simply pointing the endpoint to a service URL that corresponds to a Wasabi region. To use the C#/.NET SDK with Wasabi, proceed with the following steps.

This was tested with AWS SDK version 4.

1. Download JetBrains Rider IDE (you may use any IDE as per your requirements). In this example, we will be using NuGet packages.

2. Create a project in JetBrains. Navigate to NuGet to download and install the required AWS SDK packages.

   

3. Type “AWS” in the search bar to see a list of all AWS SDKs. For our use case with Wasabi S3, install the following packages:

   • AWSSDK.Core

   • AWSSDK.S3

   

4. Configure an additional AWS CLI profile for Wasabi account using the Wasabi keys.

   It is optional for you to use credential files to run your code; however it is always a best practice to use such an implementation wherein your credential keys are in a file stored on your local machine rather than part of your actual code.

   In this example, we set the profile name as "wasabi" in the "~/.aws/credentials" file.

5. Below is sample code to upload objects to Wasabi.

   This example discusses the use of Wasabi's us-east-1 storage region. To use other Wasabi storage regions, use the appropriate Wasabi service URL as described in Service URLs for Wasabi's Storage Regions.

   Wasabi currently does not support the value STREAMING-AWS4-HMAC-SHA256-PAYLOAD-TRAILER for the X-Amz-Content-Sha256 header. As a result, we recommend disabling chunked transfer encoding in applications while uploading the object using the .NET SDK by setting UseChunkEncoding = false until support is available.

   Be sure to use your own BucketName and Profile Name.

   using Amazon.Runtime;
   using Amazon.Runtime.CredentialManagement;
   using Amazon.S3;
   using Amazon.S3.Model;
   
   namespace AWSWasabi
   {
       public static class UploadWasabiObject
       {
           private static IAmazonS3 _s3Client = null!;
   
           private const string BucketName = "mt-aws-sdk-test";
           private const string ObjectName1 = "test.txt";
   
           // Updated to take any object from the desktop, just adjust the file name above
           private static readonly string PathToDesktop =
               Environment.GetFolderPath(Environment.SpecialFolder.Desktop);
   
           private static async Task Main()
           {
               // 1. Configure the S3-compatible endpoint (Wasabi) using the correct URL for your bucket's region
               var config = new AmazonS3Config
               {
                   ServiceURL = "https://s3.us-east-1.wasabisys.com"
               };
   
               // 2. Load credentials from a named profile (replaces StoredProfileAWSCredentials)
               var chain = new CredentialProfileStoreChain();
               if (!chain.TryGetAWSCredentials("wasabi", out AWSCredentials awsCredentials))
               {
                   Console.WriteLine("Could not find AWS profile 'wasabi'");
                   return;
               }
   
               // 3. Create S3 client with credentials and config
               _s3Client = new AmazonS3Client(awsCredentials, config);
   
               // The method expects the full path, including the file name.
               var path = Path.Combine(PathToDesktop, ObjectName1);
   
               await UploadObjectFromFileAsync(_s3Client, BucketName, ObjectName1, path);
           }
   
           private static async Task UploadObjectFromFileAsync(
               IAmazonS3 client,
               string bucketName,
               string objectName,
               string filePath)
           {
               try
               {
                   var putRequest = new PutObjectRequest
                   {
                       BucketName = bucketName,
                       Key = objectName,
                       FilePath = filePath,
                       UseChunkEncoding = false
                   };
   
                   putRequest.Metadata.Add("x-amz-meta-title", "someTitle");
   
                   await client.PutObjectAsync(putRequest);
                   Console.WriteLine("Upload completed.");
               }
               catch (AmazonS3Exception e)
               {
                   Console.WriteLine($"Error: {e.Message}");
               }
           }
       }
   }

6. Build and run your code in JetBrains. The exit code 0 indicates that everything ran successfully.

   

7. You can now see the object in your bucket by logging into the Wasabi Console.

   

8. The following is a download object script example for this document.