AWS Device Farm
Developer Guide (API Version 2015-06-23)

Setting Up AWS Device Farm

Before you use Device Farm for the first time, you must complete the following tasks:

Step 1: Sign Up for AWS

Sign up for Amazon Web Services (AWS).

If you do not have an AWS account, use the following procedure to create one.

To sign up for AWS

  1. Open and choose Create an AWS Account.

  2. Follow the online instructions.

Step 2: Create or Use an IAM User in Your AWS Account

We recommend that you do not use your AWS root account to access Device Farm. Instead, create a new AWS Identity and Access Management (IAM) user (or use an existing IAM user) in your AWS account, and then access Device Farm with that IAM user.

To create a new IAM user, see Creating an IAM User (AWS Management Console).

Step 3: Give the IAM User Permission to Access Device Farm

Give the IAM user permission to access Device Farm. To do this, create a new access policy in IAM, and then assign the access policy to the IAM user, as follows.


The AWS root account or IAM user that you use to complete the following steps must have permission to create the following IAM policy and attach it to the IAM user. For more information, see Working with Policies

To create the access policy in IAM

  1. Open the IAM console at

  2. Choose Policies.

  3. Choose Create Policy. (If a Get Started button appears, choose it, and then choose Create Policy.)

  4. Next to Create Your Own Policy, choose Select.

  5. For Policy Name, type a name for the policy (for example, AWSDeviceFarmAccessPolicy).

  6. For Description, type Provides access to all Device Farm actions associated with the IAM user.

  7. For Policy Document, type the following statement:

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "devicefarm:*" ], "Resource": [ "*" ] } ] }
  8. Choose Create Policy.

To assign the access policy to the IAM user

  1. Open the IAM console at

  2. Choose Users.

  3. Choose the IAM user to whom you will assign the access policy.

  4. In the Permissions area, choose Add permissions.

  5. In the Grant permissions area, choose Attach existing policies directly.

  6. Select the policy you just created (for example, AWSDeviceFarmAccessPolicy).

  7. Choose Next: Review.

  8. In the Permissions summary area, choose Add permissions.


Attaching the policy provides the IAM user with access to all Device Farm actions associated with that IAM user. To learn how to restrict IAM users to a limited set of Device Farm actions, see Access Permissions Reference.

Next Step

You are now ready to start using Device Farm. See Getting Started.