AWS SDK for .NET Developer Guide AWS SDK for .NET: Developer Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. AWS SDK for .NET Developer Guide Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. AWS SDK for .NET Developer Guide Table of Contents ...................................................................................................................................................... vii What is the AWS SDK for .NET ............................................................................................................. 1 About this version ...................................................................................................................... 1 Maintenance and support for SDK major versions .......................................................................... 1 Common use cases ..................................................................................................................... 1 Additional topics in this section ................................................................................................... 2 Related AWS tools ..................................................................................................................... 2 Tools for Windows PowerShell and Tools for PowerShell Core .................................................. 2 Toolkit for VS Code ............................................................................................................ 2 Toolkit for Visual Studio ..................................................................................................... 2 Toolkit for Azure DevOps .................................................................................................... 3 Additional resources ................................................................................................................... 3 Quick start ........................................................................................................................................ 4 Simple cross-platform app .......................................................................................................... 4 Steps ................................................................................................................................ 4 Setup for this tutorial ......................................................................................................... 4 Create the project .............................................................................................................. 5 Create the code ................................................................................................................. 6 Run the application ............................................................................................................ 8 Clean up ........................................................................................................................... 8 Where to go next ............................................................................................................... 8 Simple Windows-based app ......................................................................................................... 8 Steps ................................................................................................................................ 8 Setup for this tutorial ......................................................................................................... 9 Create the project ............................................................................................................ 10 Create the code ............................................................................................................... 10 Run the application .......................................................................................................... 12 Clean up ......................................................................................................................... 12 Where to go next ............................................................................................................. 13 Next steps ............................................................................................................................... 13 Setting up your environment ............................................................................................................. 14 Create an AWS account ............................................................................................................. 14 Next step ........................................................................................................................ 14 Additional information ...................................................................................................... 14 Install and configure your toolchain ............................................................................................ 14 Cross-platform development .............................................................................................. 15 Windows with Visual Studio and .NET Core .......................................................................... 15 Next step ........................................................................................................................ 15 Setting up your project ..................................................................................................................... 16 Start a new project .................................................................................................................. 16 Create users and roles .............................................................................................................. 17 User accounts .................................................................................................................. 17 Service roles .................................................................................................................... 18 Configure AWS credentials ........................................................................................................ 18 Important warnings and guidelines ..................................................................................... 19 Using the shared AWS credentials file ................................................................................. 19 Using the SDK Store (Windows only) .................................................................................. 22 Credential and profile resolution ........................................................................................ 23 Configure the AWS Region ........................................................................................................ 25 Create a service client with a particular Region .................................................................... 26 Specify a Region for all service clients ................................................................................ 26 Special information about the China (Beijing) Region ............................................................ 27 Special information about new AWS services ....................................................................... 27 Install AWSSDK packages with NuGet ......................................................................................... 27 iii AWS SDK for .NET Developer Guide Using NuGet from the Command prompt or terminal ........................................................... 28 Using NuGet from Visual Studio Solution Explorer ................................................................ 28 Using NuGet from the Package Manager Console ................................................................. 29 Install AWSSDK assemblies without NuGet .................................................................................. 29 Advanced configuration ............................................................................................................. 30 AWSSDK.Extensions.NETCore.Setup and IConfiguration ......................................................... 31 Configuring Other Application Parameters ........................................................................... 34 Configuration Files Reference for AWS SDK for .NET ............................................................. 39 SDK features .................................................................................................................................... 48 Asynchronous APIs ................................................................................................................... 48 Retries and timeouts ................................................................................................................. 49 Retries ............................................................................................................................ 49 Timeouts ......................................................................................................................... 50 Example .......................................................................................................................... 51 Paginators ..............................................................................................................................