# DeviceSelectionConfiguration
<a name="API_DeviceSelectionConfiguration"></a>

Represents the device filters used in a test run and the maximum number of devices to be included in the run. It is passed in as the `deviceSelectionConfiguration` request parameter in [ScheduleRun](API_ScheduleRun.md).

## Contents
<a name="API_DeviceSelectionConfiguration_Contents"></a>

 ** filters **   <a name="devicefarm-Type-DeviceSelectionConfiguration-filters"></a>
Used to dynamically select a set of devices for a test run. A filter is made up of an attribute, an operator, and one or more values.  
+  **Attribute** 

  The aspect of a device such as platform or model used as the selection criteria in a device filter.

  Allowed values include:
  + ARN: The Amazon Resource Name (ARN) of the device (for example, `arn:aws:devicefarm:us-west-2::device:12345Example`).
  + PLATFORM: The device platform. Valid values are ANDROID or IOS.
  + OS\$1VERSION: The operating system version (for example, 10.3.2).
  + MODEL: The device model (for example, iPad 5th Gen).
  + AVAILABILITY: The current availability of the device. Valid values are AVAILABLE, HIGHLY\$1AVAILABLE, BUSY, or TEMPORARY\$1NOT\$1AVAILABLE.
  + FORM\$1FACTOR: The device form factor. Valid values are PHONE or TABLET.
  + MANUFACTURER: The device manufacturer (for example, Apple).
  + REMOTE\$1ACCESS\$1ENABLED: Whether the device is enabled for remote access. Valid values are TRUE or FALSE.
  + REMOTE\$1DEBUG\$1ENABLED: Whether the device is enabled for remote debugging. Valid values are TRUE or FALSE. Because remote debugging is [no longer supported](https://docs.aws.amazon.com/devicefarm/latest/developerguide/history.html), this filter is ignored.
  + INSTANCE\$1ARN: The Amazon Resource Name (ARN) of the device instance.
  + INSTANCE\$1LABELS: The label of the device instance.
  + FLEET\$1TYPE: The fleet type. Valid values are PUBLIC or PRIVATE.
+  **Operator** 

  The filter operator.
  + The EQUALS operator is available for every attribute except INSTANCE\$1LABELS.
  + The CONTAINS operator is available for the INSTANCE\$1LABELS and MODEL attributes.
  + The IN and NOT\$1IN operators are available for the ARN, OS\$1VERSION, MODEL, MANUFACTURER, and INSTANCE\$1ARN attributes.
  + The LESS\$1THAN, GREATER\$1THAN, LESS\$1THAN\$1OR\$1EQUALS, and GREATER\$1THAN\$1OR\$1EQUALS operators are also available for the OS\$1VERSION attribute.
+  **Values** 

  An array of one or more filter values.

**Operator Values**
  + The IN and NOT\$1IN operators can take a values array that has more than one element.
  + The other operators require an array with a single element.

**Attribute Values**
  + The PLATFORM attribute can be set to ANDROID or IOS.
  + The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY\$1AVAILABLE, BUSY, or TEMPORARY\$1NOT\$1AVAILABLE.
  + The FORM\$1FACTOR attribute can be set to PHONE or TABLET.
  + The FLEET\$1TYPE attribute can be set to PUBLIC or PRIVATE.
Type: Array of [DeviceFilter](API_DeviceFilter.md) objects  
Required: Yes

 ** maxDevices **   <a name="devicefarm-Type-DeviceSelectionConfiguration-maxDevices"></a>
The maximum number of devices to be included in a test run.  
Type: Integer  
Required: Yes

## See Also
<a name="API_DeviceSelectionConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devicefarm-2015-06-23/DeviceSelectionConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devicefarm-2015-06-23/DeviceSelectionConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devicefarm-2015-06-23/DeviceSelectionConfiguration)