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

Create a Device Pool in AWS Device Farm

You can use the Device Farm console, AWS CLI, or API to create a device pool.

Prerequisites

  • Create a run in the Device Farm console. Follow the instructions in Create a Test Run in AWS Device Farm. When you get to the Select devices page, continue with the instructions in this section.

Create a Device Pool (Console)

  1. On the Select devices page, choose Create new device pool.

  2. For Name, enter a name that makes this device pool easy to identify.

  3. For Description, enter a description that makes this device pool easy to identify.

  4. If you want to use one or more selection criteria for the devices in this device pool, do the following:

    1. Choose Add rule.

    2. For Field, choose one of the following:

      • To include devices by their manufacturer name, choose Manufacturer.

      • To include devices by their type value, choose Type.

    3. For Operator, choose EQUALS to include devices where the Field value equals the Operand value.

    4. For Operand, enter or choose the value you want to specify for the Field and Operator values. If you choose Platform for Field, the only available selections are ANDROID and IOS. Similarly, if you choose Type for Field, the only available selections are PHONE and TABLET.

    5. To add another rule, choose Add rule.

    6. To delete a rule, choose the X icon next to the rule.

    After you create the first rule, in the list of devices, the box next to each device that matches the rule is selected. After you create or change rules, in the list of devices, the box next to each device that matches those combined rules is selected. Devices with selected boxes are included in the device pool. Devices with cleared boxes are excluded.

  5. If you want to manually include or exclude individual devices, select or clear the box next to each device. You can select or clear the boxes only if you do not have any rules specified.

  6. If you want to include or exclude all displayed devices, select or clear the box in the column header row of the list.

    Important

    Although you can use the boxes in the column header row to change the list of displayed devices, this does not mean that the remaining displayed devices are the only ones included or excluded. To confirm which devices are included or excluded, be sure to clear the contents of all of the boxes in the column header row, and then browse the boxes.

  7. Choose Save device pool.

Create a Device Pool (AWS CLI)

  • Run the create-device-pool command.

    Note

    For Appium tests, you can use APPIUM_VERSION in the rules field.

For information about using Device Farm with the AWS CLI, see AWS CLI Reference.

Create a Device Pool (API)

  • Call the CreateDevicePool API.

    Note

    For Appium tests, you can use APPIUM_VERSION in the rules field.

For information about using the Device Farm API, see API Reference.