com.amazonaws.services.devicefarm.model

Class DeviceSelectionConfiguration

java.lang.Object

com.amazonaws.services.devicefarm.model.DeviceSelectionConfiguration

All Implemented Interfaces:

StructuredPojo, Serializable, Cloneable

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class DeviceSelectionConfiguration
extends Object
implements Serializable, Cloneable, StructuredPojo

Represents the device filters used in a test run as well as the maximum number of devices to be included in the run. It is passed in as the deviceSelectionConfiguration request parameter in ScheduleRun.

See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors

Constructor and Description
DeviceSelectionConfiguration()

Method Summary

Modifier and Type	Method and Description
DeviceSelectionConfiguration	clone()
boolean	equals(Object obj)
List<DeviceFilter>	getFilters() Used to dynamically select a set of devices for a test run.
Integer	getMaxDevices() The maximum number of devices to be included in a test run.
int	hashCode()
void	marshall(ProtocolMarshaller protocolMarshaller)
void	setFilters(Collection<DeviceFilter> filters) Used to dynamically select a set of devices for a test run.
void	setMaxDevices(Integer maxDevices) The maximum number of devices to be included in a test run.
String	toString() Returns a string representation of this object.
DeviceSelectionConfiguration	withFilters(Collection<DeviceFilter> filters) Used to dynamically select a set of devices for a test run.
DeviceSelectionConfiguration	withFilters(DeviceFilter... filters) Used to dynamically select a set of devices for a test run.
DeviceSelectionConfiguration	withMaxDevices(Integer maxDevices) The maximum number of devices to be included in a test run.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DeviceSelectionConfiguration

public DeviceSelectionConfiguration()

Method Detail

getFilters

public List<DeviceFilter> getFilters()

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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

Returns:

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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

setFilters

public void setFilters(Collection<DeviceFilter> filters)

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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

Parameters:

filters - 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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

withFilters

public DeviceSelectionConfiguration withFilters(DeviceFilter... filters)

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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

NOTE: This method appends the values to the existing list (if any). Use setFilters(java.util.Collection) or withFilters(java.util.Collection) if you want to override the existing values.

Parameters:

filters - 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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

Returns:

Returns a reference to this object so that method calls can be chained together.

withFilters

public DeviceSelectionConfiguration withFilters(Collection<DeviceFilter> filters)

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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

Parameters:

filters - 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_VERSION: 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • FORM_FACTOR: The device form factor. Valid values are "PHONE" or "TABLET".

  • MANUFACTURER: The device manufacturer. For example, "Apple".

  • REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".

  • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE". This filter will be ignored, as remote debugging is no longer supported.

  • INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.

  • INSTANCE_LABELS: The label of the device instance.

  • FLEET_TYPE: The fleet type. Valid values are "PUBLIC" or "PRIVATE".

• Operator

  The filter operator.

  • The EQUALS operator is available for every attribute except INSTANCE_LABELS.

  • The CONTAINS operator is available for the INSTANCE_LABELS and MODEL attributes.

  • The IN and NOT_IN operators are available for the ARN, OS_VERSION, MODEL, MANUFACTURER, and INSTANCE_ARN attributes.

  • The LESS_THAN, GREATER_THAN, LESS_THAN_OR_EQUALS, and GREATER_THAN_OR_EQUALS operators are also available for the OS_VERSION attribute.

• Values

  An array of one or more filter values.

  Operator Values

  • The IN and NOT_IN 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_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

  • The FORM_FACTOR attribute can be set to "PHONE" or "TABLET".

  • The FLEET_TYPE attribute can be set to "PUBLIC" or "PRIVATE".

Returns:

Returns a reference to this object so that method calls can be chained together.

setMaxDevices

public void setMaxDevices(Integer maxDevices)

The maximum number of devices to be included in a test run.

Parameters:

maxDevices - The maximum number of devices to be included in a test run.

getMaxDevices

public Integer getMaxDevices()

The maximum number of devices to be included in a test run.

Returns:

The maximum number of devices to be included in a test run.

withMaxDevices

public DeviceSelectionConfiguration withMaxDevices(Integer maxDevices)

The maximum number of devices to be included in a test run.

Parameters:

maxDevices - The maximum number of devices to be included in a test run.

Returns:

Returns a reference to this object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public DeviceSelectionConfiguration clone()

Overrides:

clone in class Object

marshall

public void marshall(ProtocolMarshaller protocolMarshaller)

Specified by:

marshall in interface StructuredPojo