What Is the AWS SDK for .NET - AWS SDK for .NET (version 3)

This documentation is for version 3.0 of the AWS SDK for .NET, which is mostly centered around .NET Framework and ASP.NET 4.x, Windows, and Visual Studio.

The latest version of the documentation at https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/ is mostly centered around .NET Core and ASP.NET Core. In addition to Windows and Visual Studio, it gives equal consideration to cross-platform development.

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 AWS SDK for .NET supports .NET Framework 3.5, .NET Framework 4.5, .NET Standard 2.0, Portable Class Library, Xamarin, and Unity.

Unless stated otherwise, the information in this guide applies to all of the supported targets.

(Got it! I'm ready for a tutorial or to start setting up.)

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 Shared Configuration and Credentials Reference Guide:

AWS Tools Related to the SDK

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.

Toolkit for VS Code

The AWS Toolkit for Visual Studio Code 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.

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.

Version 3.5 of the AWS SDK for .NET

Version 3.5 of the AWS SDK for .NET further standardizes the .NET experience by transitioning support for all non-Framework variations of the SDK to .NET Standard 2.0.

Depending on your environment and code base, to take advantage of version 3.5 features, you might need to perform certain migration work. For details about version 3.5 and possible migration work, see Migrating to Version 3.5 of the AWS SDK for .NET.

How to Use This Guide

The AWS SDK for .NET Developer Guide describes how to implement applications for AWS using the AWS SDK for .NET, and includes the following tasks and resources.

Get started quickly with the AWS SDK for .NET

For someone who is new to .NET development on AWS, basic tutorials that show you a few common scenarios, as well as a minimal setup to support them.

Setting up the AWS SDK for .NET

How to install and configure the AWS SDK for .NET. If you have not used the AWS SDK for .NET before or are having trouble with its configuration, start here.

Programming with the AWS SDK for .NET

The basics of how to implement applications with the AWS SDK for .NET that apply to all AWS services. This section also includes information about how to migrate code to the latest version of the AWS SDK for .NET, and describes the differences between the earlier version and this one.

Code Examples

A set of tutorials, walkthroughs, and examples showing how to use the AWS SDK for .NET to create applications for particular AWS services. You can browse the AWS SDK for .NET examples in the AWS Code Sample Catalog.

The AWS SDK for .NET API Reference provides a detailed description of each namespace and class.

Additional Resources

More resources outside of this guide that provide valuable information about AWS and the AWS SDK for .NET. If you are unfamiliar with AWS services, see the Overview of Amazon Web Services.

Supported Services and Revision History

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.

To see what changed in a given release, see the SDK change log.