Amazon SDK for .NET Developer Guide
Total Page:16
File Type:pdf, Size:1020Kb
Amazon SDK for .NET Developer Guide Amazon SDK for .NET: Developer Guide Amazon SDK for .NET Developer Guide Table of Contents ....................................................................................................................................................... vi What is the Amazon 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 ................................................................................................... 1 Related Amazon 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 .................................................................................................... 2 Additional resources ................................................................................................................... 2 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 ......................................................................................................................... 13 Where to go next ............................................................................................................. 13 Next steps ............................................................................................................................... 13 Setting up your environment ............................................................................................................. 14 Create an Amazon account ........................................................................................................ 14 Next step ........................................................................................................................ 14 Additional information ...................................................................................................... 14 Install and configure your toolchain ............................................................................................ 15 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 Amazon credentials .................................................................................................... 18 Important warnings and guidelines ..................................................................................... 19 Using the shared Amazon credentials file ............................................................................ 20 Using the SDK Store (Windows only) .................................................................................. 22 Credential and profile resolution ........................................................................................ 24 Configure the Amazon 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 Amazon services .................................................................. 27 Install AWSSDK packages with NuGet ......................................................................................... 27 ii Amazon 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 Amazon SDK for .NET ........................................................ 39 SDK features .................................................................................................................................... 48 Asynchronous APIs ................................................................................................................... 48 Retries and timeouts ................................................................................................................. 49 Retries ............................................................................................................................ 49 Timeouts ......................................................................................................................... 51 Example .......................................................................................................................... 51 Paginators ............................................................................................................................... 51 Where do I find paginators? .............................................................................................. 52 What do paginators give me? ............................................................................................ 52 Synchronous vs. asynchronous pagination ........................................................................... 52 Example .........................................................................................................................