Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . devicefarm ]

list-runs

Description

Gets information about runs, given an AWS Device Farm project ARN.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

list-runs is a paginated operation. Multiple API calls may be issued in order to retrieve the entire data set of results. You can disable pagination by providing the --no-paginate argument. When using --output text and the --query argument on a paginated response, the --query argument must extract data from the results of the following query expressions: runs

Synopsis

  list-runs
--arn <value>
[--cli-input-json <value>]
[--starting-token <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]

Options

--arn (string)

The Amazon Resource Name (ARN) of the project for which you want to list runs.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--starting-token (string)

A token to specify where to start paginating. This is the NextToken from a previously truncated response.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--max-items (integer)

The total number of items to return in the command's output. If the total number of items available is more than the value specified, a NextToken is provided in the command's output. To resume pagination, provide the NextToken value in the starting-token argument of a subsequent command. Do not use the NextToken response element directly outside of the AWS CLI.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

runs -> (list)

Information about the runs.

(structure)

Represents a test run on a set of devices with a given app package, test parameters, etc.

arn -> (string)

The run's ARN.

name -> (string)

The run's name.

type -> (string)

The run's type.

Must be one of the following values:

  • BUILTIN_FUZZ: The built-in fuzz type.
  • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.
  • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.
  • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.
  • APPIUM_PYTHON: The Appium Python type.
  • APPIUM_NODE: The Appium Node.js type.
  • APPIUM_RUBY: The Appium Ruby type.
  • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for web apps.
  • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for web apps.
  • APPIUM_WEB_PYTHON: The Appium Python type for web apps.
  • APPIUM_WEB_NODE: The Appium Node.js type for web apps.
  • APPIUM_WEB_RUBY: The Appium Ruby type for web apps.
  • CALABASH: The Calabash type.
  • INSTRUMENTATION: The Instrumentation type.
  • UIAUTOMATION: The uiautomation type.
  • UIAUTOMATOR: The uiautomator type.
  • XCTEST: The Xcode test type.
  • XCTEST_UI: The Xcode UI test type.

platform -> (string)

The run's platform.

Allowed values include:

  • ANDROID: The Android platform.
  • IOS: The iOS platform.

created -> (timestamp)

When the run was created.

status -> (string)

The run's status.

Allowed values include:

  • PENDING: A pending status.
  • PENDING_CONCURRENCY: A pending concurrency status.
  • PENDING_DEVICE: A pending device status.
  • PROCESSING: A processing status.
  • SCHEDULING: A scheduling status.
  • PREPARING: A preparing status.
  • RUNNING: A running status.
  • COMPLETED: A completed status.
  • STOPPING: A stopping status.

result -> (string)

The run's result.

Allowed values include:

  • PENDING: A pending condition.
  • PASSED: A passing condition.
  • WARNED: A warning condition.
  • FAILED: A failed condition.
  • SKIPPED: A skipped condition.
  • ERRORED: An error condition.
  • STOPPED: A stopped condition.

started -> (timestamp)

The run's start time.

stopped -> (timestamp)

The run's stop time.

counters -> (structure)

The run's result counters.

total -> (integer)

The total number of entities.

passed -> (integer)

The number of passed entities.

failed -> (integer)

The number of failed entities.

warned -> (integer)

The number of warned entities.

errored -> (integer)

The number of errored entities.

stopped -> (integer)

The number of stopped entities.

skipped -> (integer)

The number of skipped entities.

message -> (string)

A message about the run's result.

totalJobs -> (integer)

The total number of jobs for the run.

completedJobs -> (integer)

The total number of completed jobs.

billingMethod -> (string)

Specifies the billing method for a test run: metered or unmetered . If the parameter is not specified, the default value is metered .

deviceMinutes -> (structure)

Represents the total (metered or unmetered) minutes used by the test run.

total -> (double)

When specified, represents the total minutes used by the resource to run tests.

metered -> (double)

When specified, represents only the sum of metered minutes used by the resource to run tests.

unmetered -> (double)

When specified, represents only the sum of unmetered minutes used by the resource to run tests.

networkProfile -> (structure)

The network profile being used for a test run.

arn -> (string)

The Amazon Resource Name (ARN) of the network profile.

name -> (string)

The name of the network profile.

description -> (string)

The description of the network profile.

type -> (string)

The type of network profile. Valid values are listed below.

uplinkBandwidthBits -> (long)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

downlinkBandwidthBits -> (long)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

uplinkDelayMs -> (long)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

downlinkDelayMs -> (long)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

uplinkJitterMs -> (long)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

downlinkJitterMs -> (long)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

uplinkLossPercent -> (integer)

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

downlinkLossPercent -> (integer)

Proportion of received packets that fail to arrive from 0 to 100 percent.

parsingResultUrl -> (string)

Read-only URL for an object in S3 bucket where you can get the parsing results of the test package. If the test package doesn't parse, the reason why it doesn't parse appears in the file that this URL points to.

resultCode -> (string)

Supporting field for the result field. Set only if result is SKIPPED . PARSING_FAILED if the result is skipped because of test package parsing failure.

seed -> (integer)

For fuzz tests, this is a seed to use for randomizing the UI fuzz test. Using the same seed value between tests ensures identical event sequences.

appUpload -> (string)

An app to upload or that has been uploaded.

eventCount -> (integer)

For fuzz tests, this is the number of events, between 1 and 10000, that the UI fuzz test should perform.

jobTimeoutMinutes -> (integer)

The number of minutes the job will execute before it times out.

devicePoolArn -> (string)

The ARN of the device pool for the run.

locale -> (string)

Information about the locale that is used for the run.

radios -> (structure)

Information about the radio states for the run.

wifi -> (boolean)

True if Wi-Fi is enabled at the beginning of the test; otherwise, false.

bluetooth -> (boolean)

True if Bluetooth is enabled at the beginning of the test; otherwise, false.

nfc -> (boolean)

True if NFC is enabled at the beginning of the test; otherwise, false.

gps -> (boolean)

True if GPS is enabled at the beginning of the test; otherwise, false.

location -> (structure)

Information about the location that is used for the run.

latitude -> (double)

The latitude.

longitude -> (double)

The longitude.

customerArtifactPaths -> (structure)

Output CustomerArtifactPaths object for the test run.

iosPaths -> (list)

Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.

(string)

androidPaths -> (list)

Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.

(string)

deviceHostPaths -> (list)

Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.

(string)

webUrl -> (string)

The Device Farm console URL for the recording of the run.

skipAppResign -> (boolean)

When set to true , for private devices, Device Farm will not sign your app again. For public devices, Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in the AWS Device Farm FAQs .

testSpecArn -> (string)

The ARN of the YAML-formatted test specification for the run.

deviceSelectionResult -> (structure)

The results of a device filter used to select the devices for a test run.

filters -> (list)

The filters in a device selection result.

(structure)

Represents a device filter used to select a set of devices to be included in a test run. This data structure is passed in as the deviceSelectionConfiguration parameter to ScheduleRun. For an example of the JSON request syntax, see ScheduleRun .

It is also passed in as the filters parameter to ListDevices. For an example of the JSON request syntax, see ListDevices .

attribute -> (string)

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

The supported operators for each attribute are provided in the following list.

ARN

The Amazon Resource Name (ARN) of the device. For example, "arn:aws:devicefarm:us-west-2::device:12345Example".

Supported operators : EQUALS , IN , NOT_IN

PLATFORM

The device platform. Valid values are "ANDROID" or "IOS".

Supported operators : EQUALS

OS_VERSION

The operating system version. For example, "10.3.2".

Supported operators : EQUALS , GREATER_THAN , GREATER_THAN_OR_EQUALS , IN , LESS_THAN , LESS_THAN_OR_EQUALS , NOT_IN

MODEL

The device model. For example, "iPad 5th Gen".

Supported operators : CONTAINS , EQUALS , IN , NOT_IN

AVAILABILITY

The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".

Supported operators : EQUALS

FORM_FACTOR

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

Supported operators : EQUALS

MANUFACTURER

The device manufacturer. For example, "Apple".

Supported operators : EQUALS , IN , NOT_IN

REMOTE_ACCESS_ENABLED

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

Supported operators : EQUALS

REMOTE_DEBUG_ENABLED

Ignored. Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".

Supported operators : EQUALS

This filter will be ignored, as remote debugging is `no longer supported <https://docs.aws.amazon.com/devicefarm/latest/developerguide/history.html>`__ .

INSTANCE_ARN

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

Supported operators : EQUALS , IN , NOT_IN

INSTANCE_LABELS

The label of the device instance.

Supported operators : CONTAINS

FLEET_TYPE

The fleet type. Valid values are "PUBLIC" or "PRIVATE".

Supported operators : EQUALS

operator -> (string)

Specifies how Device Farm compares the filter's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.

values -> (list)

An array of one or more filter values used in a device filter.

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".

(string)

matchedDevicesCount -> (integer)

The number of devices that matched the device filter selection criteria.

maxDevices -> (integer)

The maximum number of devices to be selected by a device filter and included in a test run.

nextToken -> (string)

If the number of items that are returned is significantly large, this is an identifier that is also returned, which can be used in a subsequent call to this operation to return the next set of items in the list.