The AWS SDK for .NET V3 has entered maintenance mode. We recommend that you migrate to [AWS SDK for .NET V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). For additional details and information on how to migrate, please refer to our [maintenance mode announcement](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/). # 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/v3/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 3 (V3) of the AWS SDK for .NET. V3 isn't latest version of the SDK. For the latest version of the SDK, see the [AWS SDK for .NET (V4) Developer Guide](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). This documentation is 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 [Migrate your project](net-dg-migrating.md). 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 **Warning** Starting August 15th, 2024, the AWS SDK for .NET will end support for .NET Framework 3.5 and will change the minimum .NET Framework version to 4.7.2. For more information, see the blog post [Important changes coming for .NET Framework 3.5 and 4.5 targets of the AWS SDK for .NET](https://aws.amazon.com/blogs/developer/important-changes-coming-for-net-framework-3-5-and-4-5-targets-of-the-aws-sdk-for-net/). This version of the AWS SDK for .NET is compiled against .NET Framework 4.5 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 **Warning** Starting August 15th, 2024, the AWS SDK for .NET will end support for .NET Framework 3.5 and will change the minimum .NET Framework version to 4.7.2. For more information, see the blog post [Important changes coming for .NET Framework 3.5 and 4.5 targets of the AWS SDK for .NET](https://aws.amazon.com/blogs/developer/important-changes-coming-for-net-framework-3-5-and-4-5-targets-of-the-aws-sdk-for-net/). This version of the AWS SDK for .NET is compiled against .NET Framework 3.5, and runs in either the .NET 2.0 or .NET 4.0 runtime. AWS service clients support synchronous and asynchronous calling patterns and use the older Begin and End pattern. **Note** The AWS SDK for .NET is not Federal Information Processing Standard (FIPS) compliant when used by applications built against version 2.0 of the CLR. For details on how you can substitute a FIPS compliant implementation in that environment, refer to [CryptoConfig](https://learn.microsoft.com/en-us/archive/blogs/shawnfa/cryptoconfig) on the Microsoft blog and the [CLR Security](https://github.com/MicrosoftArchive/clrsecurity/) team's HMACSHA256 class ( HMACSHA256Cng ) in Security.Cryptography.dll. ## 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). ## More information [Migrating to version 3.5 of the AWS SDK for .NET](net-dg-v35.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/aws-sdk-net-v3.7/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 Version 4 of the AWS SDK for .NET is generally available\$1 For more information, see the [AWS SDK for .NET (V4) Developer Guide](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html), especially the topic for [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.What's new Added information about the first preview release of the AWS SDK for .NET version 4.What's new Updated information about upcoming changes to .NET Framework support.What's new Added information about the preview release of the AWS Message Processing Framework for .NETWhat's new Included information about support for .NET 8.What's new Included information about upcoming changes to .NET Framework support.What's new Added information about the preview release of the Distributed Cache Provider for DynamoDB. 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/aws-sdk-net-v3.7/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 this version (V3) of the AWS SDK for .NET has been announced. See the [V4 migration guide](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html) 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/). **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 more information, see the [AWS SDK for .NET (V4) Developer Guide](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html), especially the topic for [Migrating to version 4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html). **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/). **February 23, 2024: Added support for .NET 8** Support for .NET 8 was added to the AWS SDK for .NET. Use the latest [NuGet packages](https://www.nuget.org/packages?q=awssdk) or the [assemblies that support .NET 8 and later](net-dg-obtain-assemblies.md#download-zip-files). You can find additional information about this support, including [support for Lambda](https://aws.amazon.com/blogs/compute/introducing-the-net-8-runtime-for-aws-lambda/) in the blog post [.NET 8 Support on AWS.](https://aws.amazon.com/blogs/dotnet/net-8-support-on-aws/) **February 18, 2024: Upcoming changes to .NET Framework support** Starting August 15th, 2024, the AWS SDK for .NET will end support for .NET Framework 3.5 and will change the minimum .NET Framework version to 4.7.2. For more information, see the blog post [Important changes coming for .NET Framework 3.5 and 4.5 targets of the AWS SDK for .NET](https://aws.amazon.com/blogs/developer/important-changes-coming-for-net-framework-3-5-and-4-5-targets-of-the-aws-sdk-for-net/). **2023-07-17: The AWS Lambda Annotations framework has been released for general availability** The [AWS Lambda Annotations framework](aws-lambda-annotations.md) makes the experience of writing Lambda functions in C\$1 feel more natural for .NET developers by using C\$1 source generator technology. It is now generally available. **2023-07-15: The Distributed Cache Provider for DynamoDB has been released in preview** The Distributed Cache Provider library enables Amazon DynamoDB to be used as the storage for ASP.NET Core's distributed cache framework. For more information, see the blog post [Introducing the AWS .NET Distributed Cache Provider for DynamoDB (Preview)](https://aws.amazon.com/blogs/developer/introducing-the-aws-net-distributed-cache-provider-for-dynamodb-preview/) and the [GitHub repository](https://github.com/awslabs/aws-dotnet-distributed-cache-provider). **2022-07-13: The AWS Deploy Tool has been released** The AWS Deploy Tool has been released. This tool is an interactive tooling for the .NET CLI and the AWS Toolkit for Visual Studio that helps deploy .NET applications with minimum AWS knowledge, and with the fewest clicks or commands. For more information, see [Deploy applications to AWS](deploying.md). **2020-08-24: Version 3.5 of the SDK has been released** + Standardized the .NET experience by transitioning support for all non-Framework variations of the SDK to .NET Standard 2.0. See [Migrating to version 3.5](net-dg-v35.md) for more information. + Added paginators to many service clients, which make pagination of API results more convenient. For more information, see [Paginators](paginators.md). # 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/aws-sdk-net-v3.7/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/v3/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/aws-sdk-net-v3.7/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/)