User guide

var response = client.CreateUser(request);
Console.WriteLine("User Name = '{0}', ARN = '{1}'",
response.User.UserName, response.User.Arn);
}
catch (EntityAlreadyExistsException)
{
Console.WriteLine("User 'DemoUser' already exists.");
}
Even with this brief code example, you'll see that the resource APIs code is a bit easier to comprehend
than the low-level code, and the resource APIs code is a bit shorter and more compact than its low-level
counterpart.
There are a few limitations to note when using the resource APIs as compared to the low-level APIs in
the SDK for .NET:
• Not all of the AWS services currently have resource APIs (although this number is growing). Currently,
the following AWS services have resource APIs in the SDK for .NET:
• AWS CloudFormation
• Amazon Glacier
• AWS Identity and Access Management (IAM)
• Amazon Simple Notification Service (Amazon SNS)
• Amazon Simple Queue Service (Amazon SQS)
• The resource APIs are currently provided as a preview. Please be cautious about writing and distributing
production-quality code that relies on these resource APIs, especially as the resource APIs may undergo
frequent changes during the preview stage.
The following information describes how to download and reference the resource APIs. Links to code
examples and related programming concepts for supported AWS services are also provided.
Download and Reference the AWS Resource APIs
for .NET
1. If you have an existing project in Visual Studio that you want to use the resource APIs with, and that
project is already referencing the AWS .NET library file (AWSSDK.dll), you must remove this reference.
This reference is set by default if you have the AWS Toolkit for Visual Studio installed and you have
created a project based upon one of the AWS project templates (for example, the Visual C# AWS
Console Project template). Or, you may have previously set a reference to the library explicitly, which
the SDK for .NET typically installs to drive:\Program Files (x86)\AWS SDK for .NET\bin.
To remove the reference for example in Solution Explorer in Visual Studio, in the References folder,
right-click AWSSDK and then click Remove.
2. Download the AWS Resource APIs for .NET library file from the resourceAPI-preview branch of the
aws-sdk-net GitHub repository onto your development machine. To do this, in the binaries folder
at that location, download and then unzip the file named dotnet35.zip (for projects that rely on
the .NET Framework 3.5) or dotnet45.zip (for projects that rely on the .NET Framework 4.5). Note
that because these zip files contains a file that is also named AWSSDK.dll, make sure to unzip the
file to a location other than where your AWS .NET library file is already installed. For example, unzip
the file to any location other than drive:\Program Files (x86)\AWS SDK for .NET\bin.
The unzipped contents contain both .NET Framework 3.5 and 4.5 versions of the AWS Resource
APIs for .NET library file (AWSSDK.dll), which you can set a reference to from your projects.
Version v2.0.0
43
AWS SDK for .NET Developer Guide
Download and Reference the AWS Resource APIs for
.NET