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 https://aws.amazon.com/, and then choose Create an AWS Account.

    Note

    If you previously signed in to the AWS Management Console using AWS account root user credentials, choose Sign in to a different account. If you previously signed in to the console using IAM credentials, choose Sign-in using root account credentials. Then choose Create a new AWS account.

  2. Follow the online instructions.

    Part of the sign-up procedure involves receiving a phone call and entering a verification code using the phone keypad.

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 an AWS Identity and Access Management (IAM) user (or use an existing one) in your AWS account, and then access Device Farm with that IAM user.

For more information, 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 an access policy in IAM, and then assign the access policy to the IAM user, as follows.

Note

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 https://console.aws.amazon.com/iam/.

  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. In Policy Name, enter a name for the policy (for example, AWSDeviceFarmAccessPolicy).

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

  7. In Policy Document, enter 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 https://console.aws.amazon.com/iam/.

  2. Choose Users.

  3. Choose your IAM user.

  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.

Note

Attaching the policy provides the IAM user with access to all Device Farm actions associated with that IAM user. For information about 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.