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
AWS Account and Credentials ................................................................................................. 3
.NET Development Environment .............................................................................................. 4
Installing the AWS SDK for .NET .............................................................................................. 4
Starting a New Project ............................................................................................................ 5
Programming with the AWS SDK for .NET ......................................................................................... 8
Configuring Your Application .................................................................................................... 8
Configuring AWS Credentials .......................................................................................... 9
Additional Application Parameters ................................................................................... 13
AWS Region Selection .......................................................................................................... 16
Asynchronous APIs .............................................................................................................. 16
Asynchronous API for .NET 4.5, Windows Store, and Windows Phone 8 ................................ 17
Asynchronous API for .NET 3.5 ...................................................................................... 17
Migrating Your Code to the Latest SDK .................................................................................... 24
Introduction ................................................................................................................ 24
What's New ................................................................................................................ 24
What's Different ........................................................................................................... 24
Platform Differences ............................................................................................................. 28
AWS SDK for .NET Framework 3.5 ................................................................................. 28
AWS SDK for .NET Framework 4.5 ................................................................................. 28
AWS SDK for Windows RT ............................................................................................ 28
AWS SDK for Windows Phone 8 ..................................................................................... 28
Install AWS Assemblies with NuGet ........................................................................................ 29
Installation .................................................................................................................. 29
NuGet from Solution Explorer ........................................................................................ 29
NuGet Package Manager Console .................................................................................. 30
Tutorials and Examples ................................................................................................................. 31
IAM Roles for Amazon EC2 Instances ..................................................................................... 31
Use IAM Roles for Amazon EC2 Instances to Manage Your Credentials ................................ 32
Walkthrough: Using IAM Roles to Retrieve an Amazon S3 Object from an Amazon EC2
Instance ..................................................................................................................... 33
Managing ASP.NET Session State with Amazon DynamoDB ....................................................... 39
Create the ASP.NET_SessionState Table ......................................................................... 40
Configure the Session State Provider .............................................................................. 41
Security Considerations ................................................................................................ 42
Tutorial: Creating Amazon EC2 Instances ................................................................................ 43
Create an Amazon EC2 Client ....................................................................................... 43
Specify an Amazon EC2 Security Group .......................................................................... 44
Authorize Security Group Ingress ................................................................................... 46
Specify an Amazon EC2 Key Pair ................................................................................... 47
Launch Amazon EC2 Instances ..................................................................................... 48
Terminate Amazon EC2 Instances .................................................................................. 51
Additional Amazon EC2 Resources ................................................................................. 51
Tutorial: Amazon EC2 Spot Instances ...................................................................................... 52
Overview .................................................................................................................... 52
Prerequisites .............................................................................................................. 53
Step 1: Setting Up Your Credentials ................................................................................. 53
Step 2: Setting Up a Security Group ................................................................................ 53
Step 3: Submitting Your Spot Request ............................................................................. 55
Step 4: Determining the State of Your Spot Request .......................................................... 57
Step 5: Cleaning up Your Spot Requests and Instances ...................................................... 59
Version v2.0.0
iii
AWS SDK for .NET Developer Guide