User guide

Note that after unzipping, there will be three files: AWSSDK.dll, AWSSDK.pdb, and AWSSDK.xml.

To enable robust debugging and help within Visual Studio, make sure that these three files remain

together in the same folder.

3. From the project in Visual Studio that you want to use the resource APIs with, set a reference to the

AWS Resource APIs for .NET library file that you just unzipped. To do this for example in Solution

Explorer in Visual Studio, right-click the References folder; click Add Reference; click Browse;

browse to and select the AWSSDK.dll file that you just unzipped; click Add and then click OK.

4. Import the specific resource APIs in the AWS Resource APIs for .NET that you want to use in your

project's code.These APIs typically take the format Amazon.ServiceName.Resources, where

ServiceName is typically some recognizable phrase that corresponds to the specific service. For

example for the AWS Identity and Access Management resource APIs, in C# you would include the

following using directive at the top of a class file:

using Amazon.IdentityManagement.Resources;

5. As needed, import any corresponding low-level APIs that the specific resource APIs rely upon.These

APIs typically take the format Amazon.ServiceName.Model and sometimes also

Amazon.ServiceName, where ServiceName is typically some recognizable phrase that corresponds

to the specific service. For example for the AWS Identity and Access Management low-level APIs,

in C# you would include the following using directives at the top of a class file:

using Amazon.IdentityManagement.Model;

// Possibly also the following, depending on which of the resource APIs that

you use:

using Amazon.IdentityManagement

6. Because the resource APIs are currently provided as a preview, you should be cautious about writing

production-quality code that relies on them, especially as the resource APIs may undergo frequent

changes during the preview stage. However, if you choose to distribute the project anyway, make

sure to include a copy of the AWS Resource APIs for .NET library file. To do this for example in

Solution Explorer in Visual Studio, within the References folder, click AWSSDK; in the Properties

window, next to Copy Local, select True if it is not already selected.

Note

If you distribute a project that has a copy of the resource APIs library file included, and then

the resource library APIs change, the only way for your project to include the new changes

is to redistribute your project with an updated resource APIs library file copied locally.

Code Examples for Resource APIs

The following links provide code examples for AWS services that support resource-level APIs in the SDK

for .NET.

• AWS CloudFormation (p. 46)

• Amazon Glacier (p. 90)

• AWS Identity and Access Management (IAM) (p. 94)

• Amazon Simple Notification Service (Amazon SNS) (p. 118)

• Amazon Simple Queue Service (Amazon SQS) (p. 121)

Version v2.0.0

AWS SDK for .NET Developer Guide

Code Examples for Resource APIs