aws / dotnet

GitHub home for .NET development on AWS

aws/dotnet is the GitHub home for .NET development on AWS. You'll find libraries, tools, and resources to help you build .NET applications and services on AWS.

Click on the links below to jump to a section:

• Online Resources
• Software and Libraries
• .NET Development Tools
• AWS Cloud Resources for .NET
• Documentation

Online Resources

AWS Developer Center - Explore .NET on AWS
Find all the .NET code samples, step-by-step guides, videos, blog content, tools, and information about live events that you need in one place.

AWS Developer Blog - .NET
Come see what .NET developers at AWS are up to! Learn about new .NET software announcements, guides, and how-to's.

@dotnetonaws
Follow us on Twitter!

Software and Libraries

AWS SDK for .NET
The AWS SDK for .NET enables .NET developers to easily work with Amazon Web Services and build scalable solutions with Amazon S3, Amazon DynamoDB, Amazon Glacier, and more.

AWS Lambda for .NET Core
This repository contains tools and blueprints used to create C# and Powershell AWS Lambda functions.

AWS Extensions .NET Core Setup

This library is an extension for the AWS SDK for .NET to integrate with .NET Core configuration and dependency injection frameworks.

AWS Logging .NET

These libraries integrate Amazon CloudWatch Logs with popular .NET logging libraries.

Amazon Cognito Authentication Extension Library

The Amazon Cognito Extension Library simplifies the authentication process of Amazon Cognito User Pools for .NET developers. It allows you to use various authentication methods for Amazon Cognito User Pools with only a few short method calls, along with making the process intuitive.

AWS Secrets Manager Caching Library for .NET

The AWS Secrets Manager caching client enables in-process caching of secrets for .NET applications.

ASP.NET Core Identity Provider for Amazon Cognito

ASP.NET Core Identity Provider for Amazon Cognito simplifies using Amazon Cognito as a membership storage solution for building ASP.NET Core web applications using ASP.NET Core Identity.

AWS .NET Configuration Extension for Systems Manager

Configuration Extension for Systems Manager library simplifies using AWS SSM's Parameter Store as a source for configuration information for .NET Core applications. This project was contributed by @KenHundley.

Amazon ElastiCache Cluster Configuration for .NET

Amazon ElastiCache Cluster Configuration is an enhanced .NET library that supports connecting to an Amazon ElastiCache cluster for Auto Discovery. This client library is an extension built upon Enyim and is released under the Apache 2.0 License.

AWS Systems Manager ASP.NET Core Data Protection Provider

AWS Systems Manager ASP.NET Core Data Protection Provider library allows you to use AWS SSM's Parameter Store to store keys generated by ASP.NET's Data Protection API. This enables you to scale by allowing multiple web servers to share the keys.

Amazon.Lambda.RuntimeSupport

Amazon.Lambda.RuntimeSupport library makes it easy to create Lambda functions using .NET standard 2.0-compatible runtimes.

DynamoDB Accelerator (DAX) for Microsoft .NET

DynamoDB Accelerator (DAX) for Microsoft .NET -- DAX is a fully managed, in-memory cache for DynamoDB.

AWS X-Ray SDK for .NET
AWS X-Ray helps developers analyze and debug distributed applications. With X-Ray, you can understand how your application and its underlying services are performing to identify and troubleshoot the root cause of performance issues and errors.

Amazon S3 Encryption Client for .NET

Amazon S3 Encryption Client for .NET is a client-side encryption library designed to make it easy for everyone to encrypt and decrypt data using industry standards and best practices. It enables you to focus on the core functionality of your application, rather than on how to best encrypt and decrypt your data.

AWS .NET Distributed Cache Provider

The AWS .NET Distributed Cache Provider provides an implementation of the ASP.NET Core interface IDistributedCache backed by Amazon DynamoDB. A common use of an IDistributedCache implementation is to store ephemeral, non-critical session state data in ASP.NET Core applications.

AWS Message Processing Framework for .NET

The AWS Message Processing Framework for .NET is an AWS-native framework that simplifies the development of .NET message processing applications that use AWS services, such as Amazon Simple Queue Service (SQS), Amazon Simple Notification Service (SNS), and Amazon EventBridge. The framework reduces the amount of boiler-plate code developers need to write, allowing you to focus on your business logic when publishing and consuming messages.

.NET Development Tools

AWS Toolkit for Visual Studio 2022

The AWS Toolkit for Visual Studio 2022 is an extension for Microsoft Visual Studio 2022 on Microsoft Windows. The toolkit makes it easier for developers to develop, debug, and deploy .NET and .NET Core applications using Amazon Web Services.

AWS Toolkit for Visual Studio 2017 and 2019

The AWS Toolkit for Visual Studio 2017 and 2019 is an extension for Microsoft Visual Studio 2017 and 2019 on Microsoft Windows. The toolkit makes it easier for developers to develop, debug, and deploy .NET and .NET Core applications using Amazon Web Services.

AWS Toolkit for JetBrains

The AWS Toolkit for JetBrains works with Rider and adds support for working with AWS services such as AWS Lambda and S3.

AWS Toolkit for Visual Studio Code

The AWS Toolkit for Visual Studio Code is a VS Code extension that lets you work with AWS services such as AWS Lambda.

AWS Toolkit for Azure DevOps

Tasks for Amazon S3, AWS Elastic Beanstalk, AWS CodeDeploy, AWS Lambda and AWS CloudFormation and more, and running commands in the AWS Tools for Windows PowerShell module and the AWS CLI.

AWS Tools for Windows PowerShell and PowerShell Core


The AWS Tools for Windows PowerShell and PowerShell Core let developers and administrators manage their AWS services from the PowerShell scripting environment.

AWS .NET Mock Lambda Test Tool - Preview

The AWS .NET Mock Lambda Test Tool is a tool that can be used to load a .NET Core Lambda project and execute the selected code inside an emulated Lambda environment. An IDE that is attached to the process hosting this tool can then debug and step through the .NET Core Lambda code. The tool is optimized for quick local debugging with minimal dependencies.

AWS Lambda Tools for Powershell
The AWS Lambda Tools for Powershell can be used to create and deploy AWS Lambda functions written in PowerShell.

AWS Extensions for dotnet CLI

This repository contains AWS tool extensions to the .NET CLI. These tool extensions are focused on building .NET Core and ASP.NET Core applications and deploying them to AWS services. Many of these deployment commands are the same commands the AWS Toolkit for Visual Studio uses to perform its deployment features.

AWS .NET deployment tool

This repository contains the AWS .NET deployment tool for .NET CLI - the opinionated tooling that simplifies deployment of .NET applications with minimum AWS knowledge. The tool suggests the right AWS compute service to deploy your application to. It then builds and packages your application as required by the chosen compute service, generates the deployment infrastructure, deploys your application by using the Cloud Development Kit (CDK), and displays the endpoint.

AWS Cloud Resources for .NET

.NET Core EC2 AMIs
Amazon Web Services offers Amazon Machine Images (AMI) with .NET Core on Amazon Linux 2 and Ubuntu.

.NET Core CodeBuild Images
This repository holds Dockerfiles of official AWS CodeBuild curated Docker images. Please refer to the AWS CodeBuild User Guide for list of environments supported by AWS CodeBuild.

Documentation

AWS .NET Developer Guide
The AWS SDK for .NET Developer Guide describes how to implement applications for AWS using the AWS SDK for .NET

AWS SDK for .NET V3 API Reference
Official AWS SDK for .NET API reference.

AWS Tools for Powershell Cmdlet Reference
Official AWS Tools for Powershell Cmdlet reference.

AWS Elastic Beanstalk - Working with .NET
Learn about creating and deploying Elastic Beanstalk Applications in .NET Using AWS Toolkit for Visual Studio

AWS Lambda - Lambda Functions (C#)
Lambda Developer guide describes in detail on how to write C# Lambda functions and how to deploy them.

AWS Lambda - Lambda Functions (PowerShell)
Lambda Developer guide describes in detail on how to write PowerShell Lambda functions and how to deploy them.

dotnet's Issues

DescribeInstanceStatusRequest returns nothing when instance is off even tough property IncludeAllInstances is set to true

why does this code:

private static void GetInstanceState(AmazonEC2Client amazonEc2Client, string instanceId)
{
DescribeInstanceStatusRequest describeInstancesRequest = new DescribeInstanceStatusRequest();
describeInstancesRequest.InstanceIds.Add(instanceId);
describeInstancesRequest.IncludeAllInstances = true;
var response = amazonEc2Client.DescribeInstanceStatusAsync();
int responseTime = 0;
while (response.IsCompleted != true)
{
Thread.Sleep(1);
responseTime += 1;
}
Console.WriteLine("Successfully received instance state in "+ responseTime + " ms || " + responseTime/1000f + " s \n Response: "+response.Result.InstanceStatuses[0].InstanceState.Name);
}

returns error that InstanceStatuses is empty while my EC2 instance is off but when I turn it on it retrieves all data and displays it normally ?
I specifically use DescribeInstanceStatusRequest.IncludeAllInstances = true; to get status of all instances as it is pointed out in the docs

https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceStatus.html

Amazon Pinpoint - Higher Level Library Support

This is the tracking issue for gauging interest in a higher level library for interfacing with Amazon Pinpoint Analytics. This is the preferred service for gathering analytics information on AWS.

If you are interested, please +1 this issue and include relevant comments.

Amazon AppSync - Higher Level Library/Amplify Support

This is the tracking issue for gauging interest in a higher level library / Amplify Framework port for interfacing with Amazon AppSync. This is the preferred service for doing offline data synchronization and cross-device data management.

If you are interested, please +1 this issue and include relevant comments.

Aws S3 ListBucketContentsAsync() works on windows and ios not on android (Unity)

I have created a application in Unity and it uses the AWSSDK specifically S3.
Using this function works well in the Editor and on ios but it does not work on android. Is it just me that has this issue with android and the aws sdk in Unity?

The error that occurs on android is this.
Info IL2CPP AmazonS3Client 17|2023-04-17T11:27:52.299Z|ERROR|An exception of type HttpRequestException was handled in ErrorHandler. --> System.Net.Http.HttpRequestException: An error occurred while sending the request ---> System.Net.WebException: Error getting response stream (ReadDoneAsync2): ReceiveFailure

The function being run is this

public async Task<bool> ListBucketContentsAsync()
    {
        try
        {
            var request = new ListObjectsV2Request
            {
                BucketName = S3BucketName,
                MaxKeys = 100,
            };

            Debug.Log("--------------------------------------");
            Debug.Log($"Listing the contents of {S3BucketName}:");
            Debug.Log("--------------------------------------");

            ListObjectsV2Response response;

            do
            {
                response = await Client.ListObjectsV2Async(request);

                response.S3Objects
                    .ForEach(obj => Debug.Log($"{obj.Key,-35}{obj.LastModified.ToShortDateString(),10}{obj.Size,10}"));

                // If the response is truncated, set the request ContinuationToken
                // from the NextContinuationToken property of the response.
                request.ContinuationToken = response.NextContinuationToken;
            }
            while (response.IsTruncated);

            return true;
        }
        catch (AmazonS3Exception ex)
        {
            Debug.Log($"Error encountered on server. Message:'{ex.Message}' getting list of objects.");
            return false;
        }
    }

AWS SDK for .NET Satisfaction Survey

Hello AWS .NET SDK community!

We are conducting a survey to learn about your recent experiences working with the AWS SDK for .NET and its learning resources. It will take less than 10 minutes to answer survey questions. We look forward to hearing from you!

Click HERE to take the survey

#26 @Support close-ancient-label

Design Doc: AWS Messaging Framework

The AWS .NET team is exploring creating an AWS native framework that simplifies development of .NET message processing applications using AWS services.

The design doc can be viewed and commented on in PR #41 (rendered view).

The purpose of the framework would be to reduce the amount of boiler-plate code developers need to write. The primary responsibilities of the proposed framework are:

• Handling the message routing - In a publisher, the framework will handle routing the messages to the correct queue/topic/eventbus. In a consumer process, it will route the particular message type to the appropriate business logic.
• Handling the overall message lifecycle - The framework will handle serializing/deserializing the message to .NET objects, keeping track of the message visibility while it is being processed, and deleting the message when completed.

Here is an example showing a sample publisher and handler for a hypothetical OrderInfo message.

Sample publisher:

[ApiController]
[Route("[controller]")]
public class OrderController : ControllerBase
{
    // See later in the design for how this was configured and mapped to the queue
    private readonly IMessagePublisher _publisher;

    public OrderController(IMessagePublisher publisher)
    {
        _publisher = publisher;
    }

    [HttpPost]
    public async Task Post([FromBody] OrderInfo orderInfo)
    {
        // Add internal metadata to the OrderInfo object 
        // we received, or any other business logic
        orderInfo.OrderTime = DateTime.UtcNow;
        orderInfo.OrderStatus = OrderStatus.Recieved;

        // The updated OrderInfo object will also be serialized as the SQS message
        await _publisher.PublishAsync(orderInfo);
    }
}

Sample handler:

// See later in the design for how this was configured and mapped to the queue
public class OrderInfoHandler : IMessageHandler<OrderInfo>
{
    public async Task<MessageStatus> HandleAsync(MessageEnvelope<OrderReceived> message, CancellationToken cancellationToken = default(CancellationToken))
    {
        // Here we're reading from the message within the metadata envelope
        var productId = message.Message.ProductId;
        
        // Here we can do our business logic based on what is in the message
        await UpdateInventory(productId);
        await PrintShippingLabel(productId, message.Message.CustomerId);

        // Indicate that OrderInfo has been processed successfully
        return MessageStatus.Success;
    }
}

On either this issue or on specific section(s) of the design in the PR #41, please comment with:

• What are your thoughts and feedback on the proposed framework design?
• What are your thoughts on the initial MVP scope?
• Which AWS messaging services do you use?
  • Amazon SQS
  • Amazon SNS
  • Amazon EventBridge
  • Amazon Kinesis
  • Amazon MQ
  • Other (specify which ones)