Version 4 (V4) of the AWS SDK for .NET has been released\$1 For information about breaking changes and migrating your applications, see the [migration topic](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html). [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html) # What is the AWS SDK for .NET The AWS SDK for .NET makes it easier to build .NET applications that tap into cost-effective, scalable, and reliable AWS services such as Amazon Simple Storage Service (Amazon S3) and Amazon Elastic Compute Cloud (Amazon EC2). The SDK simplifies the use of AWS services by providing a set of libraries that are consistent and familiar for .NET developers.. ![\[Overview of the AWS SDK for .NET\]](http://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/images/overview.png) (**OK, got it\$1** I'm ready to [set up](net-dg-config.md) and [take a quick tour](quick-start.md).) ## About this version **Current and past documentation** This documentation is for version 4.0 and later (V4) of the AWS SDK for .NET. It's mostly centered around .NET Core and ASP.NET Core, but also contains information about .NET Framework and ASP.NET 4.*x*. In addition to Windows and Visual Studio, it gives equal consideration to cross-platform development. For information about migrating from earlier versions of the SDK, see [Migrating your project](net-dg-migrating.md). For information about the previous version of the SDK, V3, which will be deprecated in the future, see the [AWS SDK for .NET (V3) Developer Guide](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/). To find deprecated content for earlier versions of the SDK, see the following item(s): [AWS SDK for .NET (version 2, deprecated) Developer Guide](samples/aws-sdk-net-v2-dg__deprecated-content.zip) [Deprecated API references for the AWS SDK for .NET](sdk-api-ref.md#about-api-versions) ## Maintenance and support for SDK major versions For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the [AWS SDKs and Tools Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html): + [AWS SDKs and tools maintenance policy](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html) + [AWS SDKs and tools version support matrix](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html) ## Common use cases The AWS SDK for .NET helps you realize several compelling use cases, including the following: + Manage users and roles with [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/). + Access [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) to create buckets and store objects. + Manage [Amazon Simple Notification Service (Amazon SNS)](https://docs.aws.amazon.com/sns/latest/dg/) HTTP subscriptions to topics. + Use the [S3 transfer utility](https://docs.aws.amazon.com/mobile/sdkforxamarin/developerguide/s3-integration-transferutility.html) to transfer files to Amazon S3 from your Xamarin applications. + Use [Amazon Simple Queue Service (Amazon SQS)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/) to process messages and workflows between components in a system. + Perform efficient Amazon S3 transfers by sending SQL statements to [Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html). + Create and launch [Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Instances.html) instances, and configure and request Amazon EC2 [spot instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html). ## Additional topics in this section + [AWS tools related to the AWS SDK for .NET](related-tools.md) + [Platforms supported by the AWS SDK for .NET](net-dg-supported-platforms.md) + [AWS SDKs and Tools Reference Guide](sdks-and-tools-ref.md) + [Revision history](revision-history.md) + [What's new in the AWS SDK for .NET](whats-new.md) + [Additional resources](net-dg-additional-resources.md) # AWS tools related to the AWS SDK for .NET Related AWS tools ## Tools for Windows PowerShell and Tools for PowerShell Core The AWS Tools for Windows PowerShell and AWS Tools for PowerShell Core are PowerShell modules that are built on the functionality exposed by the AWS SDK for .NET. The AWS PowerShell tools enable you to script operations on your AWS resources from the PowerShell prompt. Although the cmdlets are implemented using the service clients and methods from the SDK, the cmdlets provide an idiomatic PowerShell experience for specifying parameters and handling results. To get started, see [AWS Tools for Windows PowerShell](https://aws.amazon.com/powershell). ## Toolkit for VS Code The [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/) is a plugin for the Visual Studio Code (VS Code) editor. The toolkit makes it easier for you to develop, debug, and deploy applications that use AWS. With the toolkit, you can do such things as the following: + Create serverless applications that contain AWS Lambda functions, and then deploy the applications to an AWS CloudFormation stack. + Work with Amazon EventBridge schemas. + Use IntelliSense when working with Amazon ECS task-definition files. + Visualize an AWS Cloud Development Kit (AWS CDK) application. ## Toolkit for Visual Studio The AWS Toolkit for Visual Studio is a plugin for the Visual Studio IDE that makes it easier for you to develop, debug, and deploy .NET applications that use Amazon Web Services. The Toolkit for Visual Studio provides Visual Studio templates for services such as Lambda and deployment wizards for web applications and serverless applications. You can use the AWS Explorer to manage Amazon EC2 instances, work with Amazon DynamoDB tables, publish messages to Amazon Simple Notification Service (Amazon SNS) queues, and more, all within Visual Studio. To get started, see [Setting up the AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/setup.html). ## Toolkit for Azure DevOps The AWS Toolkit for Microsoft Azure DevOps adds tasks to easily enable build and release pipelines in Azure DevOps and Azure DevOps Server to work with AWS services. You can work with Amazon S3, AWS Elastic Beanstalk, AWS CodeDeploy, Lambda, AWS CloudFormation, Amazon Simple Queue Service (Amazon SQS), and Amazon SNS. You can also run commands using the Windows PowerShell module and the AWS Command Line Interface (AWS CLI). To get started with the AWS Toolkit for Azure DevOps, see the [AWS Toolkit for Microsoft Azure DevOps User Guide](https://docs.aws.amazon.com/vsts/latest/userguide/). # Platforms supported by the AWS SDK for .NET Supported platforms The AWS SDK for .NET provides distinct groups of assemblies for developers to target different platforms. However, not all SDK functionality is the same on each of these platforms. This topic describes the differences in support for each platform. ## .NET Core The AWS SDK for .NET supports applications written for .NET Core (.NET Core 3.1, .NET 5, .NET 6, and so on). AWS service clients only support asynchronous calling patterns in .NET core. This also affects many of the high level abstractions built on top of service clients, like the Amazon S3 `TransferUtility`, which will only support asynchronous calls in the .NET Core environment. ## .NET Standard 2.0 Non-Framework variations of the AWS SDK for .NET comply with [.NET Standard 2.0](https://learn.microsoft.com/en-us/dotnet/standard/net-standard). The AWS SDK for .NET provides only asynchronous methods for applications written against .NET Standard. ## .NET Framework 4.5 This version of the AWS SDK for .NET is compiled against .NET Framework 4.7.2 and runs in the .NET 4.0 runtime. AWS service clients support synchronous and asynchronous calling patterns and use the [async and await](https://learn.microsoft.com/en-us/previous-versions/hh191443(v=vs.140)) keywords introduced in [C\$1 5.0](https://en.wikipedia.org/wiki/C_Sharp_%28programming_language%29#Versions). ## .NET Framework 3.5 Version 4 of the AWS SDK for .NET doesn't support .NET Framework 3.5. ## Portable Class Library and Xamarin The AWS SDK for .NET also contains a Portable Class Library implementation. The Portable Class Library implementation can target multiple platforms, including Universal Windows Platform (UWP) and Xamarin on iOS and Android. See the [Mobile SDK for .NET and Xamarin](https://docs.aws.amazon.com/mobile/sdkforxamarin/developerguide/Welcome.html) for more details. AWS service clients only support asynchronous calling patterns. ## Unity support For information about Unity support, see [Special considerations for Unity support](unity-special.md). # AWS SDKs and Tools Reference Guide SDKs and Tools Reference The [AWS SDKs and Tools Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) contains information that's relevant and important for many of the AWS SDKs and toolkits and the AWS CLI. The following are some examples of the information that the reference contains: + Information about the [shared AWS `config` and `credentials` files](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) and their [location](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html). + [Setting up AWS accounts, users, and roles](https://docs.aws.amazon.com/sdkref/latest/guide/access-users.html) + [Configuration and authentication settings reference](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html) + [AWS Common Runtime (CRT) libraries](https://docs.aws.amazon.com/sdkref/latest/guide/common-runtime.html) + [AWS SDKs and tools maintenance policy](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html) + [AWS SDKs and tools version support matrix](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html) # Revision history To find out what has changed in various releases, see the following: + [SDK change logs](https://github.com/aws/aws-sdk-net/tree/main/changelogs) + [What's new in the AWS SDK for .NET](whats-new.md) + [Document history](document-history.md) # What's new in the AWS SDK for .NET What's newWhat's new Added a note about version 2.0 of the AWS Deploy Tool for .NET CLI.What's new End-of-support has been announced for V3 of the AWS SDK for .NET.What's new General availability for the Distributed Cache ProviderWhat's new Version 4 of the AWS SDK for .NET is generally available\$1 For information about migrating your applications to V4, see [Migrating to version 4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).What's new Added information about new default behavior for integrity protection.What's new Added information about the fourth preview release of the AWS SDK for .NET version 4. For high-level information about new developments related to the AWS SDK for .NET, see the product page at [https://aws.amazon.com/sdk-for-net/](https://aws.amazon.com/sdk-for-net/) and the [SDK change logs](https://github.com/aws/aws-sdk-net/tree/main/changelogs). The following is what's new in the AWS SDK for .NET. **October 17, 2025: Version 2.0 of the AWS Deploy Tool** Version 2.0 of the AWS Deploy Tool for .NET CLI has been released. For information about the Deploy Tool, see [Deploy applications to AWS](deploying.md). For information about version 2.0 of the Deploy Tool, see the blog post [What’s New in the AWS Deploy Tool for .NET](https://aws.amazon.com/blogs/developer/whats-new-in-the-aws-deploy-tool-for-net/). **August 21, 2025: Upcoming end-of-support for version 3 of the AWS SDK for .NET** The end-of-support for version 3 (V3) of the AWS SDK for .NET has been announced. See the [migration guide](net-dg-v4.md) to migrate your V3 applications and avoid disruptions. For more information, see the blog post [Announcing the end-of-support for the AWS SDK for .NET v3](https://aws.amazon.com/blogs/devops/announcing-the-end-of-support-for-the-aws-sdk-for-net-v3/). **July 2, 2025: General availability of the Distributed Cache Provider** The AWS .NET Distributed Cache Provider for Amazon DynamoDB is generally available\$1 This provider implements the ASP.NET Core [IDistributedCache](https://learn.microsoft.com/en-us/aspnet/core/performance/caching/distributed?view=aspnetcore-9.0#idistributedcache-interface) interface, letting you integrate the fully managed and durable infrastructure of DynamoDB into your caching layer with minimal code changes. The Distributed Cache Provider is available through the [AWS.AspNetCore.DistributedCacheProvider](https://www.nuget.org/packages/AWS.AspNetCore.DistributedCacheProvider) package on NuGet. For additional information, see the blog post [AWS .NET Distributed Cache Provider for Amazon DynamoDB now Generally Available](https://aws.amazon.com/blogs/developer/aws-net-distributed-cache-provider-for-amazon-dynamodb-now-generally-available/). **Note** The released version of the Distributed Cache Provider is supported only on V4 of the AWS SDK for .NET. If you tried the preview version of the Distributed Cache Provider, you might need to update package dependencies in your application. **May 5, 2025: General availability of the AWS Message Processing Framework for .NET** The [AWS Message Processing Framework for .NET](msg-proc-fw.md) is generally available\$1 The framework 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. **April 28, 2025: Version 4 of the AWS SDK for .NET** Version 4 of the AWS SDK for .NET is generally available\$1 For information about migrating your applications to V4, see [Migrating to version 4](net-dg-v4.md). Also see the blog post [General Availability of AWS SDK for .NET V4.0](https://aws.amazon.com/blogs/developer/general-availability-of-aws-sdk-for-net-v4-0/) that announces general availability. **February 15, 2025: Integrations with .NET Aspire** Integrations with .NET Aspire to improve the inner dev loop have been released. For information, see [Integrating AWS with .NET Aspire in the AWS SDK for .NET](aspire-integrations.md). **February 10, 2025: GA release for observability** Observability is the extent to which a system's current state can be inferred from the data it emits. Observability has been added to the AWS SDK for .NET, including an implementation of a telemetry provider. For more information, see [Observability](observability.md) in this guide and the blog post [Announcing the general availability of AWS .NET OpenTelemetry libraries](https://aws.amazon.com/blogs/dotnet/announcing-the-general-availability-of-aws-net-opentelemetry-libraries/). **January 15, 2025: New default behavior for integrity protection** Beginning with version 3.7.412.0 of the AWS SDK for .NET, the SDK provides default integrity protections by automatically calculating a `CRC32` checksum for uploads. For more information, see the announcement on GitHub at [https://github.com/aws/aws-sdk-net/issues/3610](https://github.com/aws/aws-sdk-net/issues/3610). The SDK also provides global settings for data integrity protections that you can set externally, which you can read about in [Data Integrity Protections](https://docs.aws.amazon.com/sdkref/latest/guide/feature-dataintegrity.html) in the [AWS SDKs and Tools Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/). **November 15, 2024: Blog post for preview 4 release for version 4** Preview 4 of the AWS SDK for .NET Version 4 was released on November 15, 2024. For more information about this preview, see the blog post [Preview 4 of AWS SDK for .NET V4](https://aws.amazon.com/blogs/developer/preview-4-of-aws-sdk-for-net-v4/). **August 16, 2024: Blog post for preview 1 release for version 4** The AWS SDK for .NET Version 4 was released as a first preview on August 16, 2024. For more information about this preview, see the blog post [Preview 1 of AWS SDK for .NET V4](https://aws.amazon.com/blogs/developer/preview-1-of-aws-sdk-for-net-v4/). # Additional resources **Supported services** The AWS SDK for .NET supports most AWS infrastructure products, and more services are added frequently. For a list of the AWS services supported by the SDK, see the [SDK README file](https://github.com/aws/aws-sdk-net/blob/main/README.md). **Home page for the AWS SDK for .NET** For more information about the AWS SDK for .NET, see the home page for the SDK at [https://aws.amazon.com/sdk-for-net/](https://aws.amazon.com/sdk-for-net/). **SDK reference documentation** The SDK reference documentation gives you the ability to browse and search across all code included with the SDK. It provides thorough documentation and usage examples. For more information, see the [AWS SDK for .NET API Reference](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/). **AWS re:Post (formerly AWS forums)** Visit [AWS re:Post](https://repost.aws/), specifically the [topic for the AWS SDK for .NET](https://repost.aws/topics/TAC3sZCeiYRViBUbM29z_2ZQ/net-on-aws), to ask questions or provide feedback about AWS. Each documentation page has a **Try AWS re:Post** link at the bottom of the page that takes you to the associated re:Post topic. AWS engineers monitor the topics and respond to questions, feedback, and issues. If you're signed in to re:Post, you can also follow a topic. To follow the topic for the AWS SDK for .NET, go to the [**All Topics** page](https://repost.aws/topics), find ".NET on AWS", and select the **Follow** button. **Toolkits** + AWS Toolkit for Visual Studio: If you use the Microsoft Visual Studio IDE, you should check out the [AWS Toolkit for Visual Studio User Guide](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/). + AWS Toolkit for Visual Studio Code: If you use the Microsoft Visual Studio IDE, you should check out the [AWS Toolkit for Visual Studio Code User Guide](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/). **Helpful libraries, extensions and tools** Visit the [aws/dotnet](https://github.com/aws/dotnet) and [aws/aws-sdk-net](https://github.com/aws/aws-sdk-net) repositories on the GitHub website for links to libraries, tools, and resources you can use to help build .NET applications and services on AWS. The following are some examples: + [AWS .NET Configuration Extension for Systems Manager](https://github.com/aws/aws-dotnet-extensions-configuration) + [AWS Extensions .NET Core Setup](https://github.com/aws/aws-sdk-net/tree/main/extensions/src/AWSSDK.Extensions.NETCore.Setup) + [AWS Logging .NET](https://github.com/aws/aws-logging-dotnet) + [Amazon Cognito Authentication Extension Library](https://github.com/aws/aws-sdk-net-extensions-cognito) + [AWS X-Ray SDK for .NET](https://github.com/aws/aws-xray-sdk-dotnet) **Other resources** The following are other resources that might prove useful: + [Developer net](https://aws.amazon.com/developer/language/net/) + [.NET Development Environment on the AWS Cloud - Quick Start Reference Deployment](https://aws-quickstart.github.io/quickstart-dotnet-devenvironment-setup/) + [Hello, Cloud\$1 blog](https://davidpallmann.hashnode.dev/hello-cloud) + AWS Whitepaper: [Developing and Deploying .NET Applications on AWS](https://docs.aws.amazon.com/whitepapers/latest/develop-deploy-dotnet-apps-on-aws/develop-deploy-dotnet-apps-on-aws.html) + [AWS Microservice Extractor for .NET](https://docs.aws.amazon.com/microservice-extractor/latest/userguide) + [Porting Assistant for .NET](https://docs.aws.amazon.com/portingassistant/latest/userguide) + [AWS SDKs and Tools Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/)