User guide

Table of Contents
AWS SDK for .NET Developer Guide ................................................................................................ 1
How to Use This Guide ........................................................................................................... 1
Supported Services and Revision History .................................................................................. 2
About Amazon Web Services .................................................................................................. 2
Getting Started ............................................................................................................................. 3
Create an AWS Account and Credentials ................................................................................... 3
Install the .NET Development Environment ................................................................................ 4
Install the AWS SDK for .NET .................................................................................................. 4
Start a New Project ................................................................................................................ 5
Programming with the AWS SDK for .NET ......................................................................................... 8
Configuring Your Application .................................................................................................... 8
Configuring AWS Credentials .......................................................................................... 9
AWS Region Selection .................................................................................................. 13
Additional Application Parameters ................................................................................... 14
Configuration Files Reference ........................................................................................ 18
Asynchronous APIs .............................................................................................................. 26
Asynchronous API for .NET 4.5, Windows Store, and Windows Phone 8 ................................ 26
Asynchronous API for .NET 3.5 ...................................................................................... 26
Migrating Your Code to the Latest SDK .................................................................................... 33
Introduction ................................................................................................................ 33
What's New ................................................................................................................ 33
What's Different ........................................................................................................... 34
Platform Differences ............................................................................................................. 37
AWS SDK for .NET Framework 3.5 ................................................................................. 37
AWS SDK for .NET Framework 4.5 ................................................................................. 38
AWS SDK for Windows RT ............................................................................................ 38
AWS SDK for Windows Phone 8 ..................................................................................... 38
Install AWS Assemblies with NuGet ........................................................................................ 39
Installation .................................................................................................................. 39
NuGet from Solution Explorer ........................................................................................ 39
NuGet Package Manager Console .................................................................................. 40
Programming with AWS Services ................................................................................................... 41
AWS Resource APIs for .NET ................................................................................................ 41
Download and Reference the AWS Resource APIs for .NET ................................................ 43
Code Examples for Resource APIs ................................................................................. 44
AWS CloudFormation ........................................................................................................... 45
Programming Models ................................................................................................... 45
Amazon DynamoDB ............................................................................................................. 46
Programming Models ................................................................................................... 47
Additional Resources ................................................................................................... 52
Using Expressions with DynamoDB ................................................................................ 52
JSON Support in Amazon DynamoDB ............................................................................. 63
Managing ASP.NET Session State with Amazon DynamoDB ............................................... 65
Amazon Elastic Compute Cloud (Amazon EC2) ........................................................................ 68
Tutorial: Creating Amazon EC2 Instances ........................................................................ 68
Tutorial: Amazon EC2 Spot Instances .............................................................................. 80
Amazon Glacier ................................................................................................................... 87
Programming Models ................................................................................................... 87
AWS Identity and Access Management (IAM) ........................................................................... 91
Programming Models ................................................................................................... 92
IAM Resource API Examples ......................................................................................... 94
Tutorial: Using an IAM Role .......................................................................................... 108
Amazon Route 53 .............................................................................................................. 112
Updating Amazon Route 53 Resource Record Sets ......................................................... 112
Amazon Simple Storage Service (Amazon S3) ........................................................................ 116
Version v2.0.0
iii
AWS SDK for .NET Developer Guide