Table of Contents
A low-level client representing AWS Device Farm:
import boto3
client = boto3.client('devicefarm')
These are the available methods:
Check if an operation can be paginated.
Creates a device pool.
See also: AWS API Documentation
Request Syntax
response = client.create_device_pool(
projectArn='string',
name='string',
description='string',
rules=[
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
maxDevices=123
)
[REQUIRED]
The ARN of the project for the device pool.
[REQUIRED]
The device pool's name.
[REQUIRED]
The device pool's rules.
Represents a condition for a device pool.
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINSARN
The Amazon Resource Name (ARN) of the device. For example, "arn:aws:devicefarm:us-west-2::device:12345Example".
Supported operators : EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_ININSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INMODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_INOS_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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
The rule's value.
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
dict
Response Syntax
{
'devicePool': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'rules': [
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
'maxDevices': 123
}
}
Response Structure
(dict) --
Represents the result of a create device pool request.
devicePool (dict) --
The newly created device pool.
arn (string) --
The device pool's ARN.
name (string) --
The device pool's name.
description (string) --
The device pool's description.
type (string) --
The device pool's type.
Allowed values include:
rules (list) --
Information about the device pool's rules.
(dict) --
Represents a condition for a device pool.
attribute (string) --
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINS
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
AVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALS
FLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
FORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_IN
INSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_IN
INSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINS
MANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_IN
MODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_IN
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
PLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
operator (string) --
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
value (string) --
The rule's value.
maxDevices (integer) --
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
Examples
The following example creates a new device pool named MyDevicePool inside an existing project.
response = client.create_device_pool(
# A device pool contains related devices, such as devices that run only on Android or that run only on iOS.
name='MyDevicePool',
description='My Android devices',
# You can get the project ARN by using the list-projects CLI command.
projectArn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
rules=[
],
)
print(response)
Expected Output:
{
'devicePool': {
},
'ResponseMetadata': {
'...': '...',
},
}
Creates a profile that can be applied to one or more private fleet device instances.
See also: AWS API Documentation
Request Syntax
response = client.create_instance_profile(
name='string',
description='string',
packageCleanup=True|False,
excludeAppPackagesFromCleanup=[
'string',
],
rebootAfterUse=True|False
)
[REQUIRED]
The name of your instance profile.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
dict
Response Syntax
{
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
}
Response Structure
(dict) --
instanceProfile (dict) --
An object containing information about your instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
Creates a network profile.
See also: AWS API Documentation
Request Syntax
response = client.create_network_profile(
projectArn='string',
name='string',
description='string',
type='CURATED'|'PRIVATE',
uplinkBandwidthBits=123,
downlinkBandwidthBits=123,
uplinkDelayMs=123,
downlinkDelayMs=123,
uplinkJitterMs=123,
downlinkJitterMs=123,
uplinkLossPercent=123,
downlinkLossPercent=123
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to create a network profile.
[REQUIRED]
The name you wish to specify for the new network profile.
dict
Response Syntax
{
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
}
}
Response Structure
(dict) --
networkProfile (dict) --
The network profile that is returned by the create network profile request.
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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.
Creates a new project.
See also: AWS API Documentation
Request Syntax
response = client.create_project(
name='string',
defaultJobTimeoutMinutes=123
)
[REQUIRED]
The project's name.
dict
Response Syntax
{
'project': {
'arn': 'string',
'name': 'string',
'defaultJobTimeoutMinutes': 123,
'created': datetime(2015, 1, 1)
}
}
Response Structure
(dict) --
Represents the result of a create project request.
project (dict) --
The newly created project.
arn (string) --
The project's ARN.
name (string) --
The project's name.
defaultJobTimeoutMinutes (integer) --
The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.
created (datetime) --
When the project was created.
Examples
The following example creates a new project named MyProject.
response = client.create_project(
# A project in Device Farm is a workspace that contains test runs. A run is a test of a single app against one or more devices.
name='MyProject',
)
print(response)
Expected Output:
{
'project': {
'name': 'MyProject',
'arn': 'arn:aws:devicefarm:us-west-2:183774035805:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE',
'created': datetime(2016, 8, 31, 16, 28, 59, 2, 244, 0),
},
'ResponseMetadata': {
'...': '...',
},
}
Specifies and starts a remote access session.
See also: AWS API Documentation
Request Syntax
response = client.create_remote_access_session(
projectArn='string',
deviceArn='string',
instanceArn='string',
sshPublicKey='string',
remoteDebugEnabled=True|False,
remoteRecordEnabled=True|False,
remoteRecordAppArn='string',
name='string',
clientId='string',
configuration={
'billingMethod': 'METERED'|'UNMETERED',
'vpceConfigurationArns': [
'string',
]
},
interactionMode='INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
skipAppResign=True|False
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to create a remote access session.
[REQUIRED]
The Amazon Resource Name (ARN) of the device for which you want to create a remote access session.
The configuration information for the remote access session request.
The billing method for the remote access session.
An array of Amazon Resource Names (ARNs) included in the VPC endpoint configuration.
The interaction mode of the remote access session. Valid values are:
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 .
dict
Response Syntax
{
'remoteAccessSession': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'remoteDebugEnabled': True|False,
'remoteRecordEnabled': True|False,
'remoteRecordAppArn': 'string',
'hostAddress': 'string',
'clientId': 'string',
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'endpoint': 'string',
'deviceUdid': 'string',
'interactionMode': 'INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
'skipAppResign': True|False
}
}
Response Structure
(dict) --
Represents the server response from a request to create a remote access session.
remoteAccessSession (dict) --
A container that describes the remote access session when the request to create a remote access session is sent.
arn (string) --
The Amazon Resource Name (ARN) of the remote access session.
name (string) --
The name of the remote access session.
created (datetime) --
The date and time the remote access session was created.
status (string) --
The status of the remote access session. Can be any of the following:
result (string) --
The result of the remote access session. Can be any of the following:
message (string) --
A message about the remote access session.
started (datetime) --
The date and time the remote access session was started.
stopped (datetime) --
The date and time the remote access session was stopped.
device (dict) --
The device (phone or tablet) used in the remote access session.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
instanceArn (string) --
The Amazon Resource Name (ARN) of the instance.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the remote access session.
remoteRecordEnabled (boolean) --
This flag is set to true if remote recording is enabled for the remote access session.
remoteRecordAppArn (string) --
The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.
hostAddress (string) --
IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.
clientId (string) --
Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.
billingMethod (string) --
The billing method of the remote access session. Possible values include METERED or UNMETERED . For more information about metered devices, see AWS Device Farm terminology ."
deviceMinutes (dict) --
The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
endpoint (string) --
The endpoint for the remote access sesssion.
deviceUdid (string) --
Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.
interactionMode (string) --
The interaction mode of the remote access session. Valid values are:
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 .
Examples
The following example creates a remote access session named MySession.
response = client.create_remote_access_session(
name='MySession',
configuration={
'billingMethod': 'METERED',
},
# You can get the device ARN by using the list-devices CLI command.
deviceArn='arn:aws:devicefarm:us-west-2::device:123EXAMPLE',
# You can get the project ARN by using the list-projects CLI command.
projectArn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'remoteAccessSession': {
},
'ResponseMetadata': {
'...': '...',
},
}
Uploads an app or test scripts.
See also: AWS API Documentation
Request Syntax
response = client.create_upload(
projectArn='string',
name='string',
type='ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
contentType='string'
)
[REQUIRED]
The ARN of the project for the upload.
[REQUIRED]
The upload's file name. The name should not contain the '/' character. If uploading an iOS app, the file name needs to end with the .ipa extension. If uploading an Android app, the file name needs to end with the .apk extension. For all others, the file name must end with the .zip file extension.
[REQUIRED]
The upload's upload type.
Must be one of the following values:
Note If you call CreateUpload with WEB_APP specified, AWS Device Farm throws an ArgumentException error.
dict
Response Syntax
{
'upload': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
}
}
Response Structure
(dict) --
Represents the result of a create upload request.
upload (dict) --
The newly created upload.
arn (string) --
The upload's ARN.
name (string) --
The upload's file name.
created (datetime) --
When the upload was created.
type (string) --
The upload's type.
Must be one of the following values:
status (string) --
The upload's status.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
metadata (string) --
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
contentType (string) --
The upload's content type (for example, "application/octet-stream").
message (string) --
A message about the upload's result.
category (string) --
The upload's category. Allowed values include:
Examples
The following example creates a new Appium Python test package upload inside an existing project.
response = client.create_upload(
name='MyAppiumPythonUpload',
type='APPIUM_PYTHON_TEST_PACKAGE',
# You can get the project ARN by using the list-projects CLI command.
projectArn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'upload': {
'name': 'MyAppiumPythonUpload',
'type': 'APPIUM_PYTHON_TEST_PACKAGE',
'arn': 'arn:aws:devicefarm:us-west-2:183774035805:upload:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE',
'created': datetime(2016, 8, 31, 16, 36, 44, 2, 244, 0),
'status': 'INITIALIZED',
'url': 'https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A183774035805%3Aproject%3A5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A183774035805%3Aupload%3A5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE/MyAppiumPythonUpload?AWSAccessKeyId=1234567891011EXAMPLE&Expires=1472747804&Signature=1234567891011EXAMPLE',
},
'ResponseMetadata': {
'...': '...',
},
}
Creates a configuration record in Device Farm for your Amazon Virtual Private Cloud (VPC) endpoint.
See also: AWS API Documentation
Request Syntax
response = client.create_vpce_configuration(
vpceConfigurationName='string',
vpceServiceName='string',
serviceDnsName='string',
vpceConfigurationDescription='string'
)
[REQUIRED]
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
[REQUIRED]
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
[REQUIRED]
The DNS name of the service running in your VPC that you want Device Farm to test.
dict
Response Syntax
{
'vpceConfiguration': {
'arn': 'string',
'vpceConfigurationName': 'string',
'vpceServiceName': 'string',
'serviceDnsName': 'string',
'vpceConfigurationDescription': 'string'
}
}
Response Structure
(dict) --
vpceConfiguration (dict) --
An object containing information about your VPC endpoint configuration.
arn (string) --
The Amazon Resource Name (ARN) of the VPC endpoint configuration.
vpceConfigurationName (string) --
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
vpceServiceName (string) --
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
serviceDnsName (string) --
The DNS name that maps to the private IP address of the service you want to access.
vpceConfigurationDescription (string) --
An optional description, providing more details about your VPC endpoint configuration.
Deletes a device pool given the pool ARN. Does not allow deletion of curated pools owned by the system.
See also: AWS API Documentation
Request Syntax
response = client.delete_device_pool(
arn='string'
)
[REQUIRED]
Represents the Amazon Resource Name (ARN) of the Device Farm device pool you wish to delete.
{}
Response Structure
Represents the result of a delete device pool request.
Examples
The following example deletes a specific device pool.
response = client.delete_device_pool(
# You can get the device pool ARN by using the list-device-pools CLI command.
arn='arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Deletes a profile that can be applied to one or more private device instances.
See also: AWS API Documentation
Request Syntax
response = client.delete_instance_profile(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the instance profile you are requesting to delete.
{}
Response Structure
Deletes a network profile.
See also: AWS API Documentation
Request Syntax
response = client.delete_network_profile(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the network profile you want to delete.
{}
Response Structure
Deletes an AWS Device Farm project, given the project ARN.
Note Deleting this resource does not stop an in-progress run.
See also: AWS API Documentation
Request Syntax
response = client.delete_project(
arn='string'
)
[REQUIRED]
Represents the Amazon Resource Name (ARN) of the Device Farm project you wish to delete.
{}
Response Structure
Represents the result of a delete project request.
Examples
The following example deletes a specific project.
response = client.delete_project(
# You can get the project ARN by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Deletes a completed remote access session and its results.
See also: AWS API Documentation
Request Syntax
response = client.delete_remote_access_session(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the sesssion for which you want to delete remote access.
{}
Response Structure
The response from the server when a request is made to delete the remote access session.
Examples
The following example deletes a specific remote access session.
response = client.delete_remote_access_session(
# You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Deletes the run, given the run ARN.
Note Deleting this resource does not stop an in-progress run.
See also: AWS API Documentation
Request Syntax
response = client.delete_run(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) for the run you wish to delete.
{}
Response Structure
Represents the result of a delete run request.
Examples
The following example deletes a specific test run.
response = client.delete_run(
# You can get the run ARN by using the list-runs CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Deletes an upload given the upload ARN.
See also: AWS API Documentation
Request Syntax
response = client.delete_upload(
arn='string'
)
[REQUIRED]
Represents the Amazon Resource Name (ARN) of the Device Farm upload you wish to delete.
{}
Response Structure
Represents the result of a delete upload request.
Examples
The following example deletes a specific upload.
response = client.delete_upload(
# You can get the upload ARN by using the list-uploads CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Deletes a configuration for your Amazon Virtual Private Cloud (VPC) endpoint.
See also: AWS API Documentation
Request Syntax
response = client.delete_vpce_configuration(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to delete.
{}
Response Structure
Generate a presigned url given a client, its method, and arguments
The presigned url
Returns the number of unmetered iOS and/or unmetered Android devices that have been purchased by the account.
See also: AWS API Documentation
Request Syntax
response = client.get_account_settings()
{
'accountSettings': {
'awsAccountNumber': 'string',
'unmeteredDevices': {
'string': 123
},
'unmeteredRemoteAccessDevices': {
'string': 123
},
'maxJobTimeoutMinutes': 123,
'trialMinutes': {
'total': 123.0,
'remaining': 123.0
},
'maxSlots': {
'string': 123
},
'defaultJobTimeoutMinutes': 123,
'skipAppResign': True|False
}
}
Response Structure
Represents the account settings return values from the GetAccountSettings request.
The account settings.
The AWS account number specified in the AccountSettings container.
Returns the unmetered devices you have purchased or want to purchase.
Returns the unmetered remote access devices you have purchased or want to purchase.
The maximum number of minutes a test run will execute before it times out.
Information about an AWS account's usage of free trial device minutes.
The total number of free trial minutes that the account started with.
The number of free trial minutes remaining in the account.
The maximum number of device slots that the AWS account can purchase. Each maximum is expressed as an offering-id:number pair, where the offering-id represents one of the IDs returned by the ListOfferings command.
The default number of minutes (at the account level) a test run will execute before it times out. Default value is 60 minutes.
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 .
Examples
The following example returns information about your Device Farm account settings.
response = client.get_account_settings(
)
print(response)
Expected Output:
{
'accountSettings': {
'awsAccountNumber': '123456789101',
'unmeteredDevices': {
'ANDROID': 1,
'IOS': 2,
},
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about a unique device type.
See also: AWS API Documentation
Request Syntax
response = client.get_device(
arn='string'
)
[REQUIRED]
The device type's ARN.
{
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
}
}
Response Structure
Represents the result of a get device request.
An object containing information about the requested device.
The device's ARN.
The device's display name.
The device's manufacturer name.
The device's model name.
The device's model ID.
The device's form factor.
Allowed values include:
The device's platform.
Allowed values include:
The device's operating system type.
Information about the device's CPU.
The CPU's frequency.
The CPU's architecture, for example x86 or ARM.
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
The resolution of the device.
The screen resolution's width, expressed in pixels.
The screen resolution's height, expressed in pixels.
The device's heap size, expressed in bytes.
The device's total memory size, expressed in bytes.
The device's image name.
The device's carrier.
The device's radio.
Specifies whether remote access has been enabled for the specified device.
This flag is set to true if remote debugging is enabled for the device.
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
The name of the fleet to which this device belongs.
The instances belonging to this device.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
Examples
The following example returns information about a specific device.
response = client.get_device(
arn='arn:aws:devicefarm:us-west-2::device:123EXAMPLE',
)
print(response)
Expected Output:
{
'device': {
'name': 'LG G2 (Sprint)',
'arn': 'arn:aws:devicefarm:us-west-2::device:A0E6E6E1059E45918208DF75B2B7EF6C',
'cpu': {
'architecture': 'armeabi-v7a',
'clock': 2265.6,
'frequency': 'MHz',
},
'formFactor': 'PHONE',
'heapSize': 256000000,
'image': '75B2B7EF6C12345EXAMPLE',
'manufacturer': 'LG',
'memory': 16000000000,
'model': 'G2 (Sprint)',
'os': '4.2.2',
'platform': 'ANDROID',
'resolution': {
'height': 1920,
'width': 1080,
},
},
'ResponseMetadata': {
'...': '...',
},
}
Returns information about a device instance belonging to a private device fleet.
See also: AWS API Documentation
Request Syntax
response = client.get_device_instance(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the instance you're requesting information about.
{
'deviceInstance': {
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
}
}
Response Structure
An object containing information about your device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Gets information about a device pool.
See also: AWS API Documentation
Request Syntax
response = client.get_device_pool(
arn='string'
)
[REQUIRED]
The device pool's ARN.
{
'devicePool': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'rules': [
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
'maxDevices': 123
}
}
Response Structure
Represents the result of a get device pool request.
An object containing information about the requested device pool.
The device pool's ARN.
The device pool's name.
The device pool's description.
The device pool's type.
Allowed values include:
Information about the device pool's rules.
Represents a condition for a device pool.
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINSARN
The Amazon Resource Name (ARN) of the device. For example, "arn:aws:devicefarm:us-west-2::device:12345Example".
Supported operators : EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_ININSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INMODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_INOS_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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
The rule's value.
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
Examples
The following example returns information about a specific device pool, given a project ARN.
response = client.get_device_pool(
# You can obtain the project ARN by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'devicePool': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about compatibility with a device pool.
See also: AWS API Documentation
Request Syntax
response = client.get_device_pool_compatibility(
devicePoolArn='string',
appArn='string',
testType='BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
test={
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'testPackageArn': 'string',
'testSpecArn': 'string',
'filter': 'string',
'parameters': {
'string': 'string'
}
},
configuration={
'extraDataPackageArn': 'string',
'networkProfileArn': 'string',
'locale': 'string',
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'vpceConfigurationArns': [
'string',
],
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'auxiliaryApps': [
'string',
],
'billingMethod': 'METERED'|'UNMETERED'
}
)
[REQUIRED]
The device pool's ARN.
The test type for the specified device pool.
Allowed values include the following:
Information about the uploaded test to be run against the device pool.
The test's type.
Must be one of the following values:
The ARN of the uploaded test that will be run.
The ARN of the YAML-formatted test specification.
The test's filter.
The test's parameters, such as test framework parameters and fixture settings. Parameters are represented by name-value pairs of strings.
For all tests:
For Calabash tests:
For Appium tests (all types):
For Fuzz tests (Android only):
For Explorer tests:
For Instrumentation:
For XCTest and XCTestUI:
For UIAutomator:
An object containing information about the settings for a run.
The ARN of the extra data for the run. The extra data is a .zip file that AWS Device Farm will extract to external data for Android or the app's sandbox for iOS.
Reserved for internal use.
Information about the locale that is used for the run.
Information about the location that is used for the run.
The latitude.
The longitude.
An array of Amazon Resource Names (ARNs) for your VPC endpoint configurations.
Input CustomerArtifactPaths object for the scheduled run configuration.
Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.
Information about the radio states for the run.
True if Wi-Fi is enabled at the beginning of the test; otherwise, false.
True if Bluetooth is enabled at the beginning of the test; otherwise, false.
True if NFC is enabled at the beginning of the test; otherwise, false.
True if GPS is enabled at the beginning of the test; otherwise, false.
A list of auxiliary apps for the run.
Specifies the billing method for a test run: metered or unmetered . If the parameter is not specified, the default value is metered .
dict
Response Syntax
{
'compatibleDevices': [
{
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'compatible': True|False,
'incompatibilityMessages': [
{
'message': 'string',
'type': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY'
},
]
},
],
'incompatibleDevices': [
{
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'compatible': True|False,
'incompatibilityMessages': [
{
'message': 'string',
'type': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY'
},
]
},
]
}
Response Structure
(dict) --
Represents the result of describe device pool compatibility request.
compatibleDevices (list) --
Information about compatible devices.
(dict) --
Represents a device pool compatibility result.
device (dict) --
The device (phone or tablet) that you wish to return information about.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
compatible (boolean) --
Whether the result was compatible with the device pool.
incompatibilityMessages (list) --
Information about the compatibility.
(dict) --
Represents information about incompatibility.
message (string) --
A message about the incompatibility.
type (string) --
The type of incompatibility.
Allowed values include:
incompatibleDevices (list) --
Information about incompatible devices.
(dict) --
Represents a device pool compatibility result.
device (dict) --
The device (phone or tablet) that you wish to return information about.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
compatible (boolean) --
Whether the result was compatible with the device pool.
incompatibilityMessages (list) --
Information about the compatibility.
(dict) --
Represents information about incompatibility.
message (string) --
A message about the incompatibility.
type (string) --
The type of incompatibility.
Allowed values include:
Examples
The following example returns information about the compatibility of a specific device pool, given its ARN.
response = client.get_device_pool_compatibility(
appArn='arn:aws:devicefarm:us-west-2::app:123-456-EXAMPLE-GUID',
# You can get the device pool ARN by using the list-device-pools CLI command.
devicePoolArn='arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID',
testType='APPIUM_PYTHON',
)
print(response)
Expected Output:
{
'compatibleDevices': [
],
'incompatibleDevices': [
],
'ResponseMetadata': {
'...': '...',
},
}
Returns information about the specified instance profile.
See also: AWS API Documentation
Request Syntax
response = client.get_instance_profile(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of your instance profile.
{
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
}
Response Structure
An object containing information about your instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Gets information about a job.
See also: AWS API Documentation
Request Syntax
response = client.get_job(
arn='string'
)
[REQUIRED]
The job's ARN.
{
'job': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'videoEndpoint': 'string',
'videoCapture': True|False
}
}
Response Structure
Represents the result of a get job request.
An object containing information about the requested job.
The job's ARN.
The job's name.
The job's type.
Allowed values include the following:
When the job was created.
The job's status.
Allowed values include:
The job's result.
Allowed values include:
The job's start time.
The job's stop time.
The job's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the job's result.
The device (phone or tablet).
The device's ARN.
The device's display name.
The device's manufacturer name.
The device's model name.
The device's model ID.
The device's form factor.
Allowed values include:
The device's platform.
Allowed values include:
The device's operating system type.
Information about the device's CPU.
The CPU's frequency.
The CPU's architecture, for example x86 or ARM.
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
The resolution of the device.
The screen resolution's width, expressed in pixels.
The screen resolution's height, expressed in pixels.
The device's heap size, expressed in bytes.
The device's total memory size, expressed in bytes.
The device's image name.
The device's carrier.
The device's radio.
Specifies whether remote access has been enabled for the specified device.
This flag is set to true if remote debugging is enabled for the device.
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
The name of the fleet to which this device belongs.
The instances belonging to this device.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
The Amazon Resource Name (ARN) of the instance.
Represents the total (metered or unmetered) minutes used by the job.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The endpoint for streaming device video.
This value is set to true if video capture is enabled; otherwise, it is set to false.
Examples
The following example returns information about a specific job.
response = client.get_job(
# You can get the job ARN by using the list-jobs CLI command.
arn='arn:aws:devicefarm:us-west-2::job:123-456-EXAMPLE-GUID',
)
print(response)
Expected Output:
{
'job': {
},
'ResponseMetadata': {
'...': '...',
},
}
Returns information about a network profile.
See also: AWS API Documentation
Request Syntax
response = client.get_network_profile(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the network profile you want to return information about.
{
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
}
}
Response Structure
The network profile.
The Amazon Resource Name (ARN) of the network profile.
The name of the network profile.
The description of the network profile.
The type of network profile. Valid values are listed below.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Proportion of transmitted packets that fail to arrive from 0 to 100 percent.
Proportion of received packets that fail to arrive from 0 to 100 percent.
Gets the current status and future status of all offerings purchased by an AWS account. The response indicates how many offerings are currently available and the offerings that will be available in the next period. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.get_offering_status(
nextToken='string'
)
{
'current': {
'string': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
}
},
'nextPeriod': {
'string': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
}
},
'nextToken': 'string'
}
Response Structure
Returns the status result for a device offering.
When specified, gets the offering status for the current period.
The status of the offering.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
When specified, gets the offering status for the next period.
The status of the offering.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Examples
The following example returns information about Device Farm offerings available to your account.
response = client.get_offering_status(
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=',
)
print(response)
Expected Output:
{
'current': {
'D68B3C05-1BA6-4360-BC69-12345EXAMPLE': {
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
},
'nextPeriod': {
'D68B3C05-1BA6-4360-BC69-12345EXAMPLE': {
'effectiveOn': datetime(2016, 9, 1, 0, 0, 0, 3, 245, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
},
'ResponseMetadata': {
'...': '...',
},
}
Create a paginator for an operation.
Gets information about a project.
See also: AWS API Documentation
Request Syntax
response = client.get_project(
arn='string'
)
[REQUIRED]
The project's ARN.
{
'project': {
'arn': 'string',
'name': 'string',
'defaultJobTimeoutMinutes': 123,
'created': datetime(2015, 1, 1)
}
}
Response Structure
Represents the result of a get project request.
The project you wish to get information about.
The project's ARN.
The project's name.
The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.
When the project was created.
Examples
The following example gets information about a specific project.
response = client.get_project(
# You can get the project ARN by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE',
)
print(response)
Expected Output:
{
'project': {
'name': 'My Project',
'arn': 'arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE',
'created': datetime(2016, 8, 31, 16, 28, 59, 2, 244, 0),
},
'ResponseMetadata': {
'...': '...',
},
}
Returns a link to a currently running remote access session.
See also: AWS API Documentation
Request Syntax
response = client.get_remote_access_session(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the remote access session about which you want to get session information.
{
'remoteAccessSession': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'remoteDebugEnabled': True|False,
'remoteRecordEnabled': True|False,
'remoteRecordAppArn': 'string',
'hostAddress': 'string',
'clientId': 'string',
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'endpoint': 'string',
'deviceUdid': 'string',
'interactionMode': 'INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
'skipAppResign': True|False
}
}
Response Structure
Represents the response from the server that lists detailed information about the remote access session.
A container that lists detailed information about the remote access session.
The Amazon Resource Name (ARN) of the remote access session.
The name of the remote access session.
The date and time the remote access session was created.
The status of the remote access session. Can be any of the following:
The result of the remote access session. Can be any of the following:
A message about the remote access session.
The date and time the remote access session was started.
The date and time the remote access session was stopped.
The device (phone or tablet) used in the remote access session.
The device's ARN.
The device's display name.
The device's manufacturer name.
The device's model name.
The device's model ID.
The device's form factor.
Allowed values include:
The device's platform.
Allowed values include:
The device's operating system type.
Information about the device's CPU.
The CPU's frequency.
The CPU's architecture, for example x86 or ARM.
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
The resolution of the device.
The screen resolution's width, expressed in pixels.
The screen resolution's height, expressed in pixels.
The device's heap size, expressed in bytes.
The device's total memory size, expressed in bytes.
The device's image name.
The device's carrier.
The device's radio.
Specifies whether remote access has been enabled for the specified device.
This flag is set to true if remote debugging is enabled for the device.
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
The name of the fleet to which this device belongs.
The instances belonging to this device.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
The Amazon Resource Name (ARN) of the instance.
This flag is set to true if remote debugging is enabled for the remote access session.
This flag is set to true if remote recording is enabled for the remote access session.
The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.
IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.
Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.
The billing method of the remote access session. Possible values include METERED or UNMETERED . For more information about metered devices, see AWS Device Farm terminology ."
The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The endpoint for the remote access sesssion.
Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.
The interaction mode of the remote access session. Valid values are:
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 .
Examples
The following example gets a specific remote access session.
response = client.get_remote_access_session(
# You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'remoteAccessSession': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about a run.
See also: AWS API Documentation
Request Syntax
response = client.get_run(
arn='string'
)
[REQUIRED]
The run's ARN.
{
'run': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'platform': 'ANDROID'|'IOS',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'totalJobs': 123,
'completedJobs': 123,
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
'parsingResultUrl': 'string',
'resultCode': 'PARSING_FAILED'|'VPC_ENDPOINT_SETUP_FAILED',
'seed': 123,
'appUpload': 'string',
'eventCount': 123,
'jobTimeoutMinutes': 123,
'devicePoolArn': 'string',
'locale': 'string',
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'webUrl': 'string',
'skipAppResign': True|False,
'testSpecArn': 'string',
'deviceSelectionResult': {
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'matchedDevicesCount': 123,
'maxDevices': 123
}
}
}
Response Structure
Represents the result of a get run request.
The run you wish to get results from.
The run's ARN.
The run's name.
The run's type.
Must be one of the following values:
The run's platform.
Allowed values include:
When the run was created.
The run's status.
Allowed values include:
The run's result.
Allowed values include:
The run's start time.
The run's stop time.
The run's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the run's result.
The total number of jobs for the run.
The total number of completed jobs.
Specifies the billing method for a test run: metered or unmetered . If the parameter is not specified, the default value is metered .
Represents the total (metered or unmetered) minutes used by the test run.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The network profile being used for a test run.
The Amazon Resource Name (ARN) of the network profile.
The name of the network profile.
The description of the network profile.
The type of network profile. Valid values are listed below.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Proportion of transmitted packets that fail to arrive from 0 to 100 percent.
Proportion of received packets that fail to arrive from 0 to 100 percent.
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.
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.
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.
An app to upload or that has been uploaded.
For fuzz tests, this is the number of events, between 1 and 10000, that the UI fuzz test should perform.
The number of minutes the job will execute before it times out.
The ARN of the device pool for the run.
Information about the locale that is used for the run.
Information about the radio states for the run.
True if Wi-Fi is enabled at the beginning of the test; otherwise, false.
True if Bluetooth is enabled at the beginning of the test; otherwise, false.
True if NFC is enabled at the beginning of the test; otherwise, false.
True if GPS is enabled at the beginning of the test; otherwise, false.
Information about the location that is used for the run.
The latitude.
The longitude.
Output CustomerArtifactPaths object for the test run.
Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.
The Device Farm console URL for the recording of the run.
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 .
The ARN of the YAML-formatted test specification for the run.
The results of a device filter used to select the devices for a test run.
The filters in a device selection result.
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 .
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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALSOS_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_INMODEL
The device model. For example, "iPad 5th Gen".
Supported operators : CONTAINS , EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSINSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : EQUALS , IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
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.
An array of one or more filter values used in a device filter.
Operator Values
Attribute Values
The number of devices that matched the device filter selection criteria.
The maximum number of devices to be selected by a device filter and included in a test run.
Examples
The following example gets information about a specific test run.
response = client.get_run(
# You can get the run ARN by using the list-runs CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE',
)
print(response)
Expected Output:
{
'run': {
'name': 'My Test Run',
'type': 'BUILTIN_EXPLORER',
'arn': 'arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE',
'billingMethod': 'METERED',
'completedJobs': 0,
'counters': {
'errored': 0,
'failed': 0,
'passed': 0,
'skipped': 0,
'stopped': 0,
'total': 0,
'warned': 0,
},
'created': datetime(2016, 8, 31, 18, 18, 29, 2, 244, 0),
'deviceMinutes': {
'metered': 0.0,
'total': 0.0,
'unmetered': 0.0,
},
'platform': 'ANDROID',
'result': 'PENDING',
'status': 'RUNNING',
'totalJobs': 3,
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about a suite.
See also: AWS API Documentation
Request Syntax
response = client.get_suite(
arn='string'
)
[REQUIRED]
The suite's ARN.
{
'suite': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
}
}
Response Structure
Represents the result of a get suite request.
A collection of one or more tests.
The suite's ARN.
The suite's name.
The suite's type.
Must be one of the following values:
When the suite was created.
The suite's status.
Allowed values include:
The suite's result.
Allowed values include:
The suite's start time.
The suite's stop time.
The suite's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the suite's result.
Represents the total (metered or unmetered) minutes used by the test suite.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
Examples
The following example gets information about a specific test suite.
response = client.get_suite(
# You can get the suite ARN by using the list-suites CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:suite:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'suite': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about a test.
See also: AWS API Documentation
Request Syntax
response = client.get_test(
arn='string'
)
[REQUIRED]
The test's ARN.
{
'test': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
}
}
Response Structure
Represents the result of a get test request.
A test condition that is evaluated.
The test's ARN.
The test's name.
The test's type.
Must be one of the following values:
When the test was created.
The test's status.
Allowed values include:
The test's result.
Allowed values include:
The test's start time.
The test's stop time.
The test's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the test's result.
Represents the total (metered or unmetered) minutes used by the test.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
Examples
The following example gets information about a specific test.
response = client.get_test(
# You can get the test ARN by using the list-tests CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'test': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about an upload.
See also: AWS API Documentation
Request Syntax
response = client.get_upload(
arn='string'
)
[REQUIRED]
The upload's ARN.
{
'upload': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
}
}
Response Structure
Represents the result of a get upload request.
An app or a set of one or more tests to upload or that have been uploaded.
The upload's ARN.
The upload's file name.
When the upload was created.
The upload's type.
Must be one of the following values:
The upload's status.
Must be one of the following values:
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
The upload's content type (for example, "application/octet-stream").
A message about the upload's result.
The upload's category. Allowed values include:
Examples
The following example gets information about a specific upload.
response = client.get_upload(
# You can get the test ARN by using the list-uploads CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'upload': {
},
'ResponseMetadata': {
'...': '...',
},
}
Returns information about the configuration settings for your Amazon Virtual Private Cloud (VPC) endpoint.
See also: AWS API Documentation
Request Syntax
response = client.get_vpce_configuration(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to describe.
{
'vpceConfiguration': {
'arn': 'string',
'vpceConfigurationName': 'string',
'vpceServiceName': 'string',
'serviceDnsName': 'string',
'vpceConfigurationDescription': 'string'
}
}
Response Structure
An object containing information about your VPC endpoint configuration.
The Amazon Resource Name (ARN) of the VPC endpoint configuration.
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
The DNS name that maps to the private IP address of the service you want to access.
An optional description, providing more details about your VPC endpoint configuration.
Returns an object that can wait for some condition.
Installs an application to the device in a remote access session. For Android applications, the file must be in .apk format. For iOS applications, the file must be in .ipa format.
See also: AWS API Documentation
Request Syntax
response = client.install_to_remote_access_session(
remoteAccessSessionArn='string',
appArn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.
[REQUIRED]
The Amazon Resource Name (ARN) of the app about which you are requesting information.
dict
Response Syntax
{
'appUpload': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
}
}
Response Structure
(dict) --
Represents the response from the server after AWS Device Farm makes a request to install to a remote access session.
appUpload (dict) --
An app to upload or that has been uploaded.
arn (string) --
The upload's ARN.
name (string) --
The upload's file name.
created (datetime) --
When the upload was created.
type (string) --
The upload's type.
Must be one of the following values:
status (string) --
The upload's status.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
metadata (string) --
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
contentType (string) --
The upload's content type (for example, "application/octet-stream").
message (string) --
A message about the upload's result.
category (string) --
The upload's category. Allowed values include:
Examples
The following example installs a specific app to a device in a specific remote access session.
response = client.install_to_remote_access_session(
appArn='arn:aws:devicefarm:us-west-2:123456789101:app:EXAMPLE-GUID-123-456',
# You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
remoteAccessSessionArn='arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'appUpload': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about artifacts.
See also: AWS API Documentation
Request Syntax
response = client.list_artifacts(
arn='string',
type='SCREENSHOT'|'FILE'|'LOG',
nextToken='string'
)
[REQUIRED]
The Run, Job, Suite, or Test ARN.
[REQUIRED]
The artifacts' type.
Allowed values include:
dict
Response Syntax
{
'artifacts': [
{
'arn': 'string',
'name': 'string',
'type': 'UNKNOWN'|'SCREENSHOT'|'DEVICE_LOG'|'MESSAGE_LOG'|'VIDEO_LOG'|'RESULT_LOG'|'SERVICE_LOG'|'WEBKIT_LOG'|'INSTRUMENTATION_OUTPUT'|'EXERCISER_MONKEY_OUTPUT'|'CALABASH_JSON_OUTPUT'|'CALABASH_PRETTY_OUTPUT'|'CALABASH_STANDARD_OUTPUT'|'CALABASH_JAVA_XML_OUTPUT'|'AUTOMATION_OUTPUT'|'APPIUM_SERVER_OUTPUT'|'APPIUM_JAVA_OUTPUT'|'APPIUM_JAVA_XML_OUTPUT'|'APPIUM_PYTHON_OUTPUT'|'APPIUM_PYTHON_XML_OUTPUT'|'EXPLORER_EVENT_LOG'|'EXPLORER_SUMMARY_LOG'|'APPLICATION_CRASH_REPORT'|'XCTEST_LOG'|'VIDEO'|'CUSTOMER_ARTIFACT'|'CUSTOMER_ARTIFACT_LOG'|'TESTSPEC_OUTPUT',
'extension': 'string',
'url': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list artifacts operation.
artifacts (list) --
Information about the artifacts.
(dict) --
Represents the output of a test. Examples of artifacts include logs and screenshots.
arn (string) --
The artifact's ARN.
name (string) --
The artifact's name.
type (string) --
The artifact's type.
Allowed values include the following:
extension (string) --
The artifact's file extension.
url (string) --
The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the artifact's file.
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.
Examples
The following example lists screenshot artifacts for a specific run.
response = client.list_artifacts(
type='SCREENSHOT',
# Can also be used to list artifacts for a Job, Suite, or Test ARN.
arn='arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Returns information about the private device instances associated with one or more AWS accounts.
See also: AWS API Documentation
Request Syntax
response = client.list_device_instances(
maxResults=123,
nextToken='string'
)
dict
Response Syntax
{
'deviceInstances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
deviceInstances (list) --
An object containing information about your device instances.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
nextToken (string) --
An identifier that can be used in the next call to this operation to return the next set of items in the list.
Gets information about device pools.
See also: AWS API Documentation
Request Syntax
response = client.list_device_pools(
arn='string',
type='CURATED'|'PRIVATE',
nextToken='string'
)
[REQUIRED]
The project ARN.
The device pools' type.
Allowed values include:
dict
Response Syntax
{
'devicePools': [
{
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'rules': [
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
'maxDevices': 123
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list device pools request.
devicePools (list) --
Information about the device pools.
(dict) --
Represents a collection of device types.
arn (string) --
The device pool's ARN.
name (string) --
The device pool's name.
description (string) --
The device pool's description.
type (string) --
The device pool's type.
Allowed values include:
rules (list) --
Information about the device pool's rules.
(dict) --
Represents a condition for a device pool.
attribute (string) --
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINS
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
AVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALS
FLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
FORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_IN
INSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_IN
INSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINS
MANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_IN
MODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_IN
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
PLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
operator (string) --
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
value (string) --
The rule's value.
maxDevices (integer) --
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
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.
Examples
The following example returns information about the private device pools in a specific project.
response = client.list_device_pools(
type='PRIVATE',
# You can get the project ARN by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'devicePools': [
{
'name': 'Top Devices',
'arn': 'arn:aws:devicefarm:us-west-2::devicepool:082d10e5-d7d7-48a5-ba5c-12345EXAMPLE',
'description': 'Top devices',
'rules': [
{
'value': '["arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE"]',
'attribute': 'ARN',
'operator': 'IN',
},
],
},
{
'name': 'My Android Device Pool',
'arn': 'arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/bf96e75a-28f6-4e61-b6a7-12345EXAMPLE',
'description': 'Samsung Galaxy Android devices',
'rules': [
{
'value': '["arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE","arn:aws:devicefarm:us-west-2::device:123456789EXAMPLE"]',
'attribute': 'ARN',
'operator': 'IN',
},
],
},
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about unique device types.
See also: AWS API Documentation
Request Syntax
response = client.list_devices(
arn='string',
nextToken='string',
filters=[
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
]
)
Used to select a set of devices. A filter is made up of an attribute, an operator, and one or more values.
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 .
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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALSOS_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_INMODEL
The device model. For example, "iPad 5th Gen".
Supported operators : CONTAINS , EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSINSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : EQUALS , IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
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.
An array of one or more filter values used in a device filter.
Operator Values
Attribute Values
dict
Response Syntax
{
'devices': [
{
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list devices operation.
devices (list) --
Information about the devices.
(dict) --
Represents a device type that an app is tested against.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
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.
Examples
The following example returns information about the available devices in a specific project.
response = client.list_devices(
# You can get the project ARN by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Returns information about all the instance profiles in an AWS account.
See also: AWS API Documentation
Request Syntax
response = client.list_instance_profiles(
maxResults=123,
nextToken='string'
)
dict
Response Syntax
{
'instanceProfiles': [
{
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
instanceProfiles (list) --
An object containing information about your instance profiles.
(dict) --
Represents the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
nextToken (string) --
An identifier that can be used in the next call to this operation to return the next set of items in the list.
Gets information about jobs for a given test run.
See also: AWS API Documentation
Request Syntax
response = client.list_jobs(
arn='string',
nextToken='string'
)
[REQUIRED]
The run's Amazon Resource Name (ARN).
dict
Response Syntax
{
'jobs': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'videoEndpoint': 'string',
'videoCapture': True|False
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list jobs request.
jobs (list) --
Information about the jobs.
(dict) --
Represents a device.
arn (string) --
The job's ARN.
name (string) --
The job's name.
type (string) --
The job's type.
Allowed values include the following:
created (datetime) --
When the job was created.
status (string) --
The job's status.
Allowed values include:
result (string) --
The job's result.
Allowed values include:
started (datetime) --
The job's start time.
stopped (datetime) --
The job's stop time.
counters (dict) --
The job'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 job's result.
device (dict) --
The device (phone or tablet).
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
instanceArn (string) --
The Amazon Resource Name (ARN) of the instance.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the job.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
videoEndpoint (string) --
The endpoint for streaming device video.
videoCapture (boolean) --
This value is set to true if video capture is enabled; otherwise, it is set to false.
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.
Examples
The following example returns information about jobs in a specific project.
response = client.list_jobs(
# You can get the project ARN by using the list-jobs CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'ResponseMetadata': {
'...': '...',
},
}
Returns the list of available network profiles.
See also: AWS API Documentation
Request Syntax
response = client.list_network_profiles(
arn='string',
type='CURATED'|'PRIVATE',
nextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list network profiles.
dict
Response Syntax
{
'networkProfiles': [
{
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
networkProfiles (list) --
A list of the available network profiles.
(dict) --
An array of settings that describes characteristics of a network profile.
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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.
nextToken (string) --
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Returns a list of offering promotions. Each offering promotion record contains the ID and description of the promotion. The API returns a NotEligible error if the caller is not permitted to invoke the operation. Contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.list_offering_promotions(
nextToken='string'
)
{
'offeringPromotions': [
{
'id': 'string',
'description': 'string'
},
],
'nextToken': 'string'
}
Response Structure
Information about the offering promotions.
Represents information about an offering promotion.
The ID of the offering promotion.
A string describing the offering promotion.
An identifier to be used in the next call to this operation, to return the next set of items in the list.
Returns a list of all historical purchases, renewals, and system renewal transactions for an AWS account. The list is paginated and ordered by a descending timestamp (most recent transactions are first). The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.list_offering_transactions(
nextToken='string'
)
{
'offeringTransactions': [
{
'offeringStatus': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
},
'transactionId': 'string',
'offeringPromotionId': 'string',
'createdOn': datetime(2015, 1, 1),
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
}
},
],
'nextToken': 'string'
}
Response Structure
Returns the transaction log of the specified offerings.
The audit log of subscriptions you have purchased and modified through AWS Device Farm.
Represents the metadata of an offering transaction.
The status of an offering transaction.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
The transaction ID of the offering transaction.
The ID that corresponds to a device offering promotion.
The date on which an offering transaction was created.
The cost of an offering transaction.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Examples
The following example returns information about Device Farm offering transactions.
response = client.list_offering_transactions(
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=',
)
print(response)
Expected Output:
{
'offeringTransactions': [
{
'cost': {
'amount': 0,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 8, 1, 3, 17, 0, 0, 214, 0),
'offeringStatus': {
'type': 'RENEW',
'effectiveOn': datetime(2016, 9, 1, 0, 0, 0, 3, 245, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 0,
},
'transactionId': '03728003-d1ea-4851-abd6-12345EXAMPLE',
},
{
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 8, 1, 3, 17, 0, 0, 214, 0),
'offeringStatus': {
'type': 'PURCHASE',
'effectiveOn': datetime(2016, 8, 1, 3, 17, 0, 0, 214, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
'transactionId': '56820b6e-06bd-473a-8ff8-12345EXAMPLE',
},
{
'cost': {
'amount': 175,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 6, 10, 6, 2, 0, 4, 162, 0),
'offeringStatus': {
'type': 'PURCHASE',
'effectiveOn': datetime(2016, 6, 10, 6, 2, 0, 4, 162, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Unmetered Device Slot',
'id': '8980F81C-00D7-469D-8EC6-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
'transactionId': '953ae2c6-d760-4a04-9597-12345EXAMPLE',
},
{
'cost': {
'amount': 8.07,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 3, 30, 13, 25, 0, 2, 90, 0),
'offeringStatus': {
'type': 'PURCHASE',
'effectiveOn': datetime(2016, 3, 30, 13, 25, 0, 2, 90, 0),
'offering': {
'type': 'RECURRING',
'description': 'iOS Unmetered Device Slot',
'id': 'A53D4D73-A6F6-4B82-A0B0-12345EXAMPLE',
'platform': 'IOS',
},
'quantity': 1,
},
'transactionId': '2baf9021-ae3e-47f5-ab52-12345EXAMPLE',
},
],
'ResponseMetadata': {
'...': '...',
},
}
Returns a list of products or offerings that the user can manage through the API. Each offering record indicates the recurring price per unit and the frequency for that offering. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.list_offerings(
nextToken='string'
)
{
'offerings': [
{
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
],
'nextToken': 'string'
}
Response Structure
Represents the return values of the list of offerings.
A value representing the list offering results.
Represents the metadata of a device offering.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Examples
The following example returns information about available device offerings.
response = client.list_offerings(
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=',
)
print(response)
Expected Output:
{
'offerings': [
{
'type': 'RECURRING',
'description': 'iOS Unmetered Device Slot',
'id': 'A53D4D73-A6F6-4B82-A0B0-12345EXAMPLE',
'platform': 'IOS',
'recurringCharges': [
{
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'frequency': 'MONTHLY',
},
],
},
{
'type': 'RECURRING',
'description': 'Android Unmetered Device Slot',
'id': '8980F81C-00D7-469D-8EC6-12345EXAMPLE',
'platform': 'ANDROID',
'recurringCharges': [
{
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'frequency': 'MONTHLY',
},
],
},
{
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
'recurringCharges': [
{
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'frequency': 'MONTHLY',
},
],
},
{
'type': 'RECURRING',
'description': 'iOS Remote Access Unmetered Device Slot',
'id': '552B4DAD-A6C9-45C4-94FB-12345EXAMPLE',
'platform': 'IOS',
'recurringCharges': [
{
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'frequency': 'MONTHLY',
},
],
},
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about projects.
See also: AWS API Documentation
Request Syntax
response = client.list_projects(
arn='string',
nextToken='string'
)
dict
Response Syntax
{
'projects': [
{
'arn': 'string',
'name': 'string',
'defaultJobTimeoutMinutes': 123,
'created': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list projects request.
projects (list) --
Information about the projects.
(dict) --
Represents an operating-system neutral workspace for running and managing tests.
arn (string) --
The project's ARN.
name (string) --
The project's name.
defaultJobTimeoutMinutes (integer) --
The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.
created (datetime) --
When the project was created.
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.
Examples
The following example returns information about the specified project in Device Farm.
response = client.list_projects(
arn='arn:aws:devicefarm:us-west-2:123456789101:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'projects': [
{
'name': 'My Test Project',
'arn': 'arn:aws:devicefarm:us-west-2:183774035805:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE',
'created': datetime(2016, 1, 19, 0, 27, 42, 1, 19, 0),
},
{
'name': 'Hello World',
'arn': 'arn:aws:devicefarm:us-west-2:183774035805:project:d6b087d9-56db-4e44-b9ec-12345EXAMPLE',
'created': datetime(2016, 8, 4, 22, 35, 12, 3, 217, 0),
},
],
'ResponseMetadata': {
'...': '...',
},
}
Returns a list of all currently running remote access sessions.
See also: AWS API Documentation
Request Syntax
response = client.list_remote_access_sessions(
arn='string',
nextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.
dict
Response Syntax
{
'remoteAccessSessions': [
{
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'remoteDebugEnabled': True|False,
'remoteRecordEnabled': True|False,
'remoteRecordAppArn': 'string',
'hostAddress': 'string',
'clientId': 'string',
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'endpoint': 'string',
'deviceUdid': 'string',
'interactionMode': 'INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
'skipAppResign': True|False
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the response from the server after AWS Device Farm makes a request to return information about the remote access session.
remoteAccessSessions (list) --
A container representing the metadata from the service about each remote access session you are requesting.
(dict) --
Represents information about the remote access session.
arn (string) --
The Amazon Resource Name (ARN) of the remote access session.
name (string) --
The name of the remote access session.
created (datetime) --
The date and time the remote access session was created.
status (string) --
The status of the remote access session. Can be any of the following:
result (string) --
The result of the remote access session. Can be any of the following:
message (string) --
A message about the remote access session.
started (datetime) --
The date and time the remote access session was started.
stopped (datetime) --
The date and time the remote access session was stopped.
device (dict) --
The device (phone or tablet) used in the remote access session.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
instanceArn (string) --
The Amazon Resource Name (ARN) of the instance.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the remote access session.
remoteRecordEnabled (boolean) --
This flag is set to true if remote recording is enabled for the remote access session.
remoteRecordAppArn (string) --
The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.
hostAddress (string) --
IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.
clientId (string) --
Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.
billingMethod (string) --
The billing method of the remote access session. Possible values include METERED or UNMETERED . For more information about metered devices, see AWS Device Farm terminology ."
deviceMinutes (dict) --
The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
endpoint (string) --
The endpoint for the remote access sesssion.
deviceUdid (string) --
Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.
interactionMode (string) --
The interaction mode of the remote access session. Valid values are:
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 .
nextToken (string) --
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Examples
The following example returns information about a specific Device Farm remote access session.
response = client.list_remote_access_sessions(
# You can get the Amazon Resource Name (ARN) of the session by using the list-sessions CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=',
)
print(response)
Expected Output:
{
'remoteAccessSessions': [
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about runs, given an AWS Device Farm project ARN.
See also: AWS API Documentation
Request Syntax
response = client.list_runs(
arn='string',
nextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list runs.
dict
Response Syntax
{
'runs': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'platform': 'ANDROID'|'IOS',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'totalJobs': 123,
'completedJobs': 123,
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
'parsingResultUrl': 'string',
'resultCode': 'PARSING_FAILED'|'VPC_ENDPOINT_SETUP_FAILED',
'seed': 123,
'appUpload': 'string',
'eventCount': 123,
'jobTimeoutMinutes': 123,
'devicePoolArn': 'string',
'locale': 'string',
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'webUrl': 'string',
'skipAppResign': True|False,
'testSpecArn': 'string',
'deviceSelectionResult': {
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'matchedDevicesCount': 123,
'maxDevices': 123
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list runs request.
runs (list) --
Information about the runs.
(dict) --
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:
platform (string) --
The run's platform.
Allowed values include:
created (datetime) --
When the run was created.
status (string) --
The run's status.
Allowed values include:
result (string) --
The run's result.
Allowed values include:
started (datetime) --
The run's start time.
stopped (datetime) --
The run's stop time.
counters (dict) --
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 (dict) --
Represents the total (metered or unmetered) minutes used by the test run.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
networkProfile (dict) --
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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 (dict) --
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 (dict) --
Information about the location that is used for the run.
latitude (float) --
The latitude.
longitude (float) --
The longitude.
customerArtifactPaths (dict) --
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.
androidPaths (list) --
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
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.
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 (dict) --
The results of a device filter used to select the devices for a test run.
filters (list) --
The filters in a device selection result.
(dict) --
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
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
Attribute Values
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.
Examples
The following example returns information about a specific test run.
response = client.list_runs(
# You can get the Amazon Resource Name (ARN) of the run by using the list-runs CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'runs': [
{
'name': 'My Test Run',
'type': 'BUILTIN_EXPLORER',
'arn': 'arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE',
'billingMethod': 'METERED',
'completedJobs': 0,
'counters': {
'errored': 0,
'failed': 0,
'passed': 0,
'skipped': 0,
'stopped': 0,
'total': 0,
'warned': 0,
},
'created': datetime(2016, 8, 31, 18, 18, 29, 2, 244, 0),
'deviceMinutes': {
'metered': 0.0,
'total': 0.0,
'unmetered': 0.0,
},
'platform': 'ANDROID',
'result': 'PENDING',
'status': 'RUNNING',
'totalJobs': 3,
},
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about samples, given an AWS Device Farm job ARN.
See also: AWS API Documentation
Request Syntax
response = client.list_samples(
arn='string',
nextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the job used to list samples.
dict
Response Syntax
{
'samples': [
{
'arn': 'string',
'type': 'CPU'|'MEMORY'|'THREADS'|'RX_RATE'|'TX_RATE'|'RX'|'TX'|'NATIVE_FRAMES'|'NATIVE_FPS'|'NATIVE_MIN_DRAWTIME'|'NATIVE_AVG_DRAWTIME'|'NATIVE_MAX_DRAWTIME'|'OPENGL_FRAMES'|'OPENGL_FPS'|'OPENGL_MIN_DRAWTIME'|'OPENGL_AVG_DRAWTIME'|'OPENGL_MAX_DRAWTIME',
'url': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list samples request.
samples (list) --
Information about the samples.
(dict) --
Represents a sample of performance data.
arn (string) --
The sample's ARN.
type (string) --
The sample's type.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the sample's file.
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.
Examples
The following example returns information about samples, given a specific Device Farm project.
response = client.list_samples(
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'samples': [
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about test suites for a given job.
See also: AWS API Documentation
Request Syntax
response = client.list_suites(
arn='string',
nextToken='string'
)
[REQUIRED]
The job's Amazon Resource Name (ARN).
dict
Response Syntax
{
'suites': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list suites request.
suites (list) --
Information about the suites.
(dict) --
Represents a collection of one or more tests.
arn (string) --
The suite's ARN.
name (string) --
The suite's name.
type (string) --
The suite's type.
Must be one of the following values:
created (datetime) --
When the suite was created.
status (string) --
The suite's status.
Allowed values include:
result (string) --
The suite's result.
Allowed values include:
started (datetime) --
The suite's start time.
stopped (datetime) --
The suite's stop time.
counters (dict) --
The suite'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 suite's result.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the test suite.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
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.
Examples
The following example returns information about suites, given a specific Device Farm project.
response = client.list_suites(
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'suites': [
],
'ResponseMetadata': {
'...': '...',
},
}
List the tags for an AWS Device Farm resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
ResourceARN='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource(s) for which to list tags. You can associate tags with the following Device Farm resources: PROJECT , RUN , NETWORK_PROFILE , INSTANCE_PROFILE , DEVICE_INSTANCE , SESSION , DEVICE_POOL , DEVICE , and VPCE_CONFIGURATION .
{
'Tags': [
{
'Key': 'string',
'Value': 'string'
},
]
}
Response Structure
The tags to add to the resource. A tag is an array of key-value pairs. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
The metadata that you apply to a resource to help you categorize and organize it. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).
Gets information about tests in a given test suite.
See also: AWS API Documentation
Request Syntax
response = client.list_tests(
arn='string',
nextToken='string'
)
[REQUIRED]
The test suite's Amazon Resource Name (ARN).
dict
Response Syntax
{
'tests': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list tests request.
tests (list) --
Information about the tests.
(dict) --
Represents a condition that is evaluated.
arn (string) --
The test's ARN.
name (string) --
The test's name.
type (string) --
The test's type.
Must be one of the following values:
created (datetime) --
When the test was created.
status (string) --
The test's status.
Allowed values include:
result (string) --
The test's result.
Allowed values include:
started (datetime) --
The test's start time.
stopped (datetime) --
The test's stop time.
counters (dict) --
The test'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 test's result.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the test.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
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.
Examples
The following example returns information about tests, given a specific Device Farm project.
response = client.list_tests(
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'tests': [
],
'ResponseMetadata': {
'...': '...',
},
}
Gets information about unique problems.
See also: AWS API Documentation
Request Syntax
response = client.list_unique_problems(
arn='string',
nextToken='string'
)
[REQUIRED]
The unique problems' ARNs.
dict
Response Syntax
{
'uniqueProblems': {
'string': [
{
'message': 'string',
'problems': [
{
'run': {
'arn': 'string',
'name': 'string'
},
'job': {
'arn': 'string',
'name': 'string'
},
'suite': {
'arn': 'string',
'name': 'string'
},
'test': {
'arn': 'string',
'name': 'string'
},
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string'
},
]
},
]
},
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list unique problems request.
uniqueProblems (dict) --
Information about the unique problems.
Allowed values include:
(string) --
(list) --
(dict) --
A collection of one or more problems, grouped by their result.
message (string) --
A message about the unique problems' result.
problems (list) --
Information about the problems.
(dict) --
Represents a specific warning or failure.
run (dict) --
Information about the associated run.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
job (dict) --
Information about the associated job.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
suite (dict) --
Information about the associated suite.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
test (dict) --
Information about the associated test.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
device (dict) --
Information about the associated device.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
result (string) --
The problem's result.
Allowed values include:
message (string) --
A message about the problem's result.
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.
Examples
The following example returns information about unique problems, given a specific Device Farm project.
response = client.list_unique_problems(
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'uniqueProblems': {
},
'ResponseMetadata': {
'...': '...',
},
}
Gets information about uploads, given an AWS Device Farm project ARN.
See also: AWS API Documentation
Request Syntax
response = client.list_uploads(
arn='string',
type='ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
nextToken='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list uploads.
The type of upload.
Must be one of the following values:
dict
Response Syntax
{
'uploads': [
{
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list uploads request.
uploads (list) --
Information about the uploads.
(dict) --
An app or a set of one or more tests to upload or that have been uploaded.
arn (string) --
The upload's ARN.
name (string) --
The upload's file name.
created (datetime) --
When the upload was created.
type (string) --
The upload's type.
Must be one of the following values:
status (string) --
The upload's status.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
metadata (string) --
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
contentType (string) --
The upload's content type (for example, "application/octet-stream").
message (string) --
A message about the upload's result.
category (string) --
The upload's category. Allowed values include:
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.
Examples
The following example returns information about uploads, given a specific Device Farm project.
response = client.list_uploads(
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
# A dynamically generated value, used for paginating results.
nextToken='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE',
)
print(response)
Expected Output:
{
'uploads': [
],
'ResponseMetadata': {
'...': '...',
},
}
Returns information about all Amazon Virtual Private Cloud (VPC) endpoint configurations in the AWS account.
See also: AWS API Documentation
Request Syntax
response = client.list_vpce_configurations(
maxResults=123,
nextToken='string'
)
dict
Response Syntax
{
'vpceConfigurations': [
{
'arn': 'string',
'vpceConfigurationName': 'string',
'vpceServiceName': 'string',
'serviceDnsName': 'string',
'vpceConfigurationDescription': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
vpceConfigurations (list) --
An array of VPCEConfiguration objects containing information about your VPC endpoint configuration.
(dict) --
Represents an Amazon Virtual Private Cloud (VPC) endpoint configuration.
arn (string) --
The Amazon Resource Name (ARN) of the VPC endpoint configuration.
vpceConfigurationName (string) --
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
vpceServiceName (string) --
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
serviceDnsName (string) --
The DNS name that maps to the private IP address of the service you want to access.
vpceConfigurationDescription (string) --
An optional description, providing more details about your VPC endpoint configuration.
nextToken (string) --
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Immediately purchases offerings for an AWS account. Offerings renew with the latest total purchased quantity for an offering, unless the renewal was overridden. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.purchase_offering(
offeringId='string',
quantity=123,
offeringPromotionId='string'
)
dict
Response Syntax
{
'offeringTransaction': {
'offeringStatus': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
},
'transactionId': 'string',
'offeringPromotionId': 'string',
'createdOn': datetime(2015, 1, 1),
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
}
}
}
Response Structure
(dict) --
The result of the purchase offering (e.g., success or failure).
offeringTransaction (dict) --
Represents the offering transaction for the purchase result.
offeringStatus (dict) --
The status of an offering transaction.
type (string) --
The type specified for the offering status.
offering (dict) --
Represents the metadata of an offering status.
id (string) --
The ID that corresponds to a device offering.
description (string) --
A string describing the offering.
type (string) --
The type of offering (e.g., "RECURRING") for a device.
platform (string) --
The platform of the device (e.g., ANDROID or IOS).
recurringCharges (list) --
Specifies whether there are recurring charges for the offering.
(dict) --
Specifies whether charges for devices will be recurring.
cost (dict) --
The cost of the recurring charge.
amount (float) --
The numerical amount of an offering or transaction.
currencyCode (string) --
The currency code of a monetary amount. For example, USD means "U.S. dollars."
frequency (string) --
The frequency in which charges will recur.
quantity (integer) --
The number of available devices in the offering.
effectiveOn (datetime) --
The date on which the offering is effective.
transactionId (string) --
The transaction ID of the offering transaction.
offeringPromotionId (string) --
The ID that corresponds to a device offering promotion.
createdOn (datetime) --
The date on which an offering transaction was created.
cost (dict) --
The cost of an offering transaction.
amount (float) --
The numerical amount of an offering or transaction.
currencyCode (string) --
The currency code of a monetary amount. For example, USD means "U.S. dollars."
Examples
The following example purchases a specific device slot offering.
response = client.purchase_offering(
# You can get the offering ID by using the list-offerings CLI command.
offeringId='D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
quantity=1,
)
print(response)
Expected Output:
{
'offeringTransaction': {
'cost': {
'amount': 8.07,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 8, 31, 12, 59, 0, 2, 244, 0),
'offeringStatus': {
'type': 'PURCHASE',
'effectiveOn': datetime(2016, 8, 31, 12, 59, 0, 2, 244, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
'transactionId': 'd30614ed-1b03-404c-9893-12345EXAMPLE',
},
'ResponseMetadata': {
'...': '...',
},
}
Explicitly sets the quantity of devices to renew for an offering, starting from the effectiveDate of the next period. The API returns a NotEligible error if the user is not permitted to invoke the operation. Please contact aws-devicefarm-support@amazon.com if you believe that you should be able to invoke this operation.
See also: AWS API Documentation
Request Syntax
response = client.renew_offering(
offeringId='string',
quantity=123
)
dict
Response Syntax
{
'offeringTransaction': {
'offeringStatus': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
},
'transactionId': 'string',
'offeringPromotionId': 'string',
'createdOn': datetime(2015, 1, 1),
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
}
}
}
Response Structure
(dict) --
The result of a renewal offering.
offeringTransaction (dict) --
Represents the status of the offering transaction for the renewal.
offeringStatus (dict) --
The status of an offering transaction.
type (string) --
The type specified for the offering status.
offering (dict) --
Represents the metadata of an offering status.
id (string) --
The ID that corresponds to a device offering.
description (string) --
A string describing the offering.
type (string) --
The type of offering (e.g., "RECURRING") for a device.
platform (string) --
The platform of the device (e.g., ANDROID or IOS).
recurringCharges (list) --
Specifies whether there are recurring charges for the offering.
(dict) --
Specifies whether charges for devices will be recurring.
cost (dict) --
The cost of the recurring charge.
amount (float) --
The numerical amount of an offering or transaction.
currencyCode (string) --
The currency code of a monetary amount. For example, USD means "U.S. dollars."
frequency (string) --
The frequency in which charges will recur.
quantity (integer) --
The number of available devices in the offering.
effectiveOn (datetime) --
The date on which the offering is effective.
transactionId (string) --
The transaction ID of the offering transaction.
offeringPromotionId (string) --
The ID that corresponds to a device offering promotion.
createdOn (datetime) --
The date on which an offering transaction was created.
cost (dict) --
The cost of an offering transaction.
amount (float) --
The numerical amount of an offering or transaction.
currencyCode (string) --
The currency code of a monetary amount. For example, USD means "U.S. dollars."
Examples
The following example renews a specific device slot offering.
response = client.renew_offering(
# You can get the offering ID by using the list-offerings CLI command.
offeringId='D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
quantity=1,
)
print(response)
Expected Output:
{
'offeringTransaction': {
'cost': {
'amount': 250,
'currencyCode': 'USD',
},
'createdOn': datetime(2016, 8, 31, 13, 8, 0, 2, 244, 0),
'offeringStatus': {
'type': 'RENEW',
'effectiveOn': datetime(2016, 9, 1, 0, 0, 0, 3, 245, 0),
'offering': {
'type': 'RECURRING',
'description': 'Android Remote Access Unmetered Device Slot',
'id': 'D68B3C05-1BA6-4360-BC69-12345EXAMPLE',
'platform': 'ANDROID',
},
'quantity': 1,
},
'transactionId': 'e90f1405-8c35-4561-be43-12345EXAMPLE',
},
'ResponseMetadata': {
'...': '...',
},
}
Schedules a run.
See also: AWS API Documentation
Request Syntax
response = client.schedule_run(
projectArn='string',
appArn='string',
devicePoolArn='string',
deviceSelectionConfiguration={
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'maxDevices': 123
},
name='string',
test={
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'testPackageArn': 'string',
'testSpecArn': 'string',
'filter': 'string',
'parameters': {
'string': 'string'
}
},
configuration={
'extraDataPackageArn': 'string',
'networkProfileArn': 'string',
'locale': 'string',
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'vpceConfigurationArns': [
'string',
],
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'auxiliaryApps': [
'string',
],
'billingMethod': 'METERED'|'UNMETERED'
},
executionConfiguration={
'jobTimeoutMinutes': 123,
'accountsCleanup': True|False,
'appPackagesCleanup': True|False,
'videoCapture': True|False,
'skipAppResign': True|False
}
)
[REQUIRED]
The ARN of the project for the run to be scheduled.
The filter criteria used to dynamically select a set of devices for a test run, as well as the maximum number of devices to be included in the run.
Either ** devicePoolArn ** or ** deviceSelectionConfiguration ** is required in a request.
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 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".
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 .
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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALSOS_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_INMODEL
The device model. For example, "iPad 5th Gen".
Supported operators : CONTAINS , EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSINSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : EQUALS , IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
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.
An array of one or more filter values used in a device filter.
Operator Values
Attribute Values
The maximum number of devices to be included in a test run.
[REQUIRED]
Information about the test for the run to be scheduled.
The test's type.
Must be one of the following values:
The ARN of the uploaded test that will be run.
The ARN of the YAML-formatted test specification.
The test's filter.
The test's parameters, such as test framework parameters and fixture settings. Parameters are represented by name-value pairs of strings.
For all tests:
For Calabash tests:
For Appium tests (all types):
For Fuzz tests (Android only):
For Explorer tests:
For Instrumentation:
For XCTest and XCTestUI:
For UIAutomator:
Information about the settings for the run to be scheduled.
The ARN of the extra data for the run. The extra data is a .zip file that AWS Device Farm will extract to external data for Android or the app's sandbox for iOS.
Reserved for internal use.
Information about the locale that is used for the run.
Information about the location that is used for the run.
The latitude.
The longitude.
An array of Amazon Resource Names (ARNs) for your VPC endpoint configurations.
Input CustomerArtifactPaths object for the scheduled run configuration.
Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.
Information about the radio states for the run.
True if Wi-Fi is enabled at the beginning of the test; otherwise, false.
True if Bluetooth is enabled at the beginning of the test; otherwise, false.
True if NFC is enabled at the beginning of the test; otherwise, false.
True if GPS is enabled at the beginning of the test; otherwise, false.
A list of auxiliary apps for the run.
Specifies the billing method for a test run: metered or unmetered . If the parameter is not specified, the default value is metered .
Specifies configuration information about a test run, such as the execution timeout (in minutes).
The number of minutes a test run will execute before it times out.
True if account cleanup is enabled at the beginning of the test; otherwise, false.
True if app package cleanup is enabled at the beginning of the test; otherwise, false.
Set to true to enable video capture; otherwise, set to false. The default is true.
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 .
dict
Response Syntax
{
'run': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'platform': 'ANDROID'|'IOS',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'totalJobs': 123,
'completedJobs': 123,
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
'parsingResultUrl': 'string',
'resultCode': 'PARSING_FAILED'|'VPC_ENDPOINT_SETUP_FAILED',
'seed': 123,
'appUpload': 'string',
'eventCount': 123,
'jobTimeoutMinutes': 123,
'devicePoolArn': 'string',
'locale': 'string',
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'webUrl': 'string',
'skipAppResign': True|False,
'testSpecArn': 'string',
'deviceSelectionResult': {
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'matchedDevicesCount': 123,
'maxDevices': 123
}
}
}
Response Structure
(dict) --
Represents the result of a schedule run request.
run (dict) --
Information about the scheduled run.
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:
platform (string) --
The run's platform.
Allowed values include:
created (datetime) --
When the run was created.
status (string) --
The run's status.
Allowed values include:
result (string) --
The run's result.
Allowed values include:
started (datetime) --
The run's start time.
stopped (datetime) --
The run's stop time.
counters (dict) --
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 (dict) --
Represents the total (metered or unmetered) minutes used by the test run.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
networkProfile (dict) --
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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 (dict) --
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 (dict) --
Information about the location that is used for the run.
latitude (float) --
The latitude.
longitude (float) --
The longitude.
customerArtifactPaths (dict) --
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.
androidPaths (list) --
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
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.
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 (dict) --
The results of a device filter used to select the devices for a test run.
filters (list) --
The filters in a device selection result.
(dict) --
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
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
Attribute Values
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.
Examples
The following example schedules a test run named MyRun.
response = client.schedule_run(
name='MyRun',
# You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command.
devicePoolArn='arn:aws:devicefarm:us-west-2:123456789101:pool:EXAMPLE-GUID-123-456',
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
projectArn='arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456',
test={
'type': 'APPIUM_JAVA_JUNIT',
'testPackageArn': 'arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456',
},
)
print(response)
Expected Output:
{
'run': {
},
'ResponseMetadata': {
'...': '...',
},
}
Initiates a stop request for the current job. AWS Device Farm will immediately stop the job on the device where tests have not started executing, and you will not be billed for this device. On the device where tests have started executing, Setup Suite and Teardown Suite tests will run to completion before stopping execution on the device. You will be billed for Setup, Teardown, and any tests that were in progress or already completed.
See also: AWS API Documentation
Request Syntax
response = client.stop_job(
arn='string'
)
[REQUIRED]
Represents the Amazon Resource Name (ARN) of the Device Farm job you wish to stop.
{
'job': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'videoEndpoint': 'string',
'videoCapture': True|False
}
}
Response Structure
The job that was stopped.
The job's ARN.
The job's name.
The job's type.
Allowed values include the following:
When the job was created.
The job's status.
Allowed values include:
The job's result.
Allowed values include:
The job's start time.
The job's stop time.
The job's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the job's result.
The device (phone or tablet).
The device's ARN.
The device's display name.
The device's manufacturer name.
The device's model name.
The device's model ID.
The device's form factor.
Allowed values include:
The device's platform.
Allowed values include:
The device's operating system type.
Information about the device's CPU.
The CPU's frequency.
The CPU's architecture, for example x86 or ARM.
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
The resolution of the device.
The screen resolution's width, expressed in pixels.
The screen resolution's height, expressed in pixels.
The device's heap size, expressed in bytes.
The device's total memory size, expressed in bytes.
The device's image name.
The device's carrier.
The device's radio.
Specifies whether remote access has been enabled for the specified device.
This flag is set to true if remote debugging is enabled for the device.
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
The name of the fleet to which this device belongs.
The instances belonging to this device.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
The Amazon Resource Name (ARN) of the instance.
Represents the total (metered or unmetered) minutes used by the job.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The endpoint for streaming device video.
This value is set to true if video capture is enabled; otherwise, it is set to false.
Ends a specified remote access session.
See also: AWS API Documentation
Request Syntax
response = client.stop_remote_access_session(
arn='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the remote access session you wish to stop.
{
'remoteAccessSession': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'remoteDebugEnabled': True|False,
'remoteRecordEnabled': True|False,
'remoteRecordAppArn': 'string',
'hostAddress': 'string',
'clientId': 'string',
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'endpoint': 'string',
'deviceUdid': 'string',
'interactionMode': 'INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
'skipAppResign': True|False
}
}
Response Structure
Represents the response from the server that describes the remote access session when AWS Device Farm stops the session.
A container representing the metadata from the service about the remote access session you are stopping.
The Amazon Resource Name (ARN) of the remote access session.
The name of the remote access session.
The date and time the remote access session was created.
The status of the remote access session. Can be any of the following:
The result of the remote access session. Can be any of the following:
A message about the remote access session.
The date and time the remote access session was started.
The date and time the remote access session was stopped.
The device (phone or tablet) used in the remote access session.
The device's ARN.
The device's display name.
The device's manufacturer name.
The device's model name.
The device's model ID.
The device's form factor.
Allowed values include:
The device's platform.
Allowed values include:
The device's operating system type.
Information about the device's CPU.
The CPU's frequency.
The CPU's architecture, for example x86 or ARM.
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
The resolution of the device.
The screen resolution's width, expressed in pixels.
The screen resolution's height, expressed in pixels.
The device's heap size, expressed in bytes.
The device's total memory size, expressed in bytes.
The device's image name.
The device's carrier.
The device's radio.
Specifies whether remote access has been enabled for the specified device.
This flag is set to true if remote debugging is enabled for the device.
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
The name of the fleet to which this device belongs.
The instances belonging to this device.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
The Amazon Resource Name (ARN) of the instance.
This flag is set to true if remote debugging is enabled for the remote access session.
This flag is set to true if remote recording is enabled for the remote access session.
The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.
IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.
Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.
The billing method of the remote access session. Possible values include METERED or UNMETERED . For more information about metered devices, see AWS Device Farm terminology ."
The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The endpoint for the remote access sesssion.
Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.
The interaction mode of the remote access session. Valid values are:
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 .
Initiates a stop request for the current test run. AWS Device Farm will immediately stop the run on devices where tests have not started executing, and you will not be billed for these devices. On devices where tests have started executing, Setup Suite and Teardown Suite tests will run to completion before stopping execution on those devices. You will be billed for Setup, Teardown, and any tests that were in progress or already completed.
See also: AWS API Documentation
Request Syntax
response = client.stop_run(
arn='string'
)
[REQUIRED]
Represents the Amazon Resource Name (ARN) of the Device Farm run you wish to stop.
{
'run': {
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'platform': 'ANDROID'|'IOS',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'totalJobs': 123,
'completedJobs': 123,
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
'parsingResultUrl': 'string',
'resultCode': 'PARSING_FAILED'|'VPC_ENDPOINT_SETUP_FAILED',
'seed': 123,
'appUpload': 'string',
'eventCount': 123,
'jobTimeoutMinutes': 123,
'devicePoolArn': 'string',
'locale': 'string',
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'webUrl': 'string',
'skipAppResign': True|False,
'testSpecArn': 'string',
'deviceSelectionResult': {
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'matchedDevicesCount': 123,
'maxDevices': 123
}
}
}
Response Structure
Represents the results of your stop run attempt.
The run that was stopped.
The run's ARN.
The run's name.
The run's type.
Must be one of the following values:
The run's platform.
Allowed values include:
When the run was created.
The run's status.
Allowed values include:
The run's result.
Allowed values include:
The run's start time.
The run's stop time.
The run's result counters.
The total number of entities.
The number of passed entities.
The number of failed entities.
The number of warned entities.
The number of errored entities.
The number of stopped entities.
The number of skipped entities.
A message about the run's result.
The total number of jobs for the run.
The total number of completed jobs.
Specifies the billing method for a test run: metered or unmetered . If the parameter is not specified, the default value is metered .
Represents the total (metered or unmetered) minutes used by the test run.
When specified, represents the total minutes used by the resource to run tests.
When specified, represents only the sum of metered minutes used by the resource to run tests.
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
The network profile being used for a test run.
The Amazon Resource Name (ARN) of the network profile.
The name of the network profile.
The description of the network profile.
The type of network profile. Valid values are listed below.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
The data throughput rate in bits per second, as an integer from 0 to 104857600.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
Proportion of transmitted packets that fail to arrive from 0 to 100 percent.
Proportion of received packets that fail to arrive from 0 to 100 percent.
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.
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.
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.
An app to upload or that has been uploaded.
For fuzz tests, this is the number of events, between 1 and 10000, that the UI fuzz test should perform.
The number of minutes the job will execute before it times out.
The ARN of the device pool for the run.
Information about the locale that is used for the run.
Information about the radio states for the run.
True if Wi-Fi is enabled at the beginning of the test; otherwise, false.
True if Bluetooth is enabled at the beginning of the test; otherwise, false.
True if NFC is enabled at the beginning of the test; otherwise, false.
True if GPS is enabled at the beginning of the test; otherwise, false.
Information about the location that is used for the run.
The latitude.
The longitude.
Output CustomerArtifactPaths object for the test run.
Comma-separated list of paths on the iOS device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests will be pulled from.
The Device Farm console URL for the recording of the run.
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 .
The ARN of the YAML-formatted test specification for the run.
The results of a device filter used to select the devices for a test run.
The filters in a device selection result.
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 .
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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALSOS_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_INMODEL
The device model. For example, "iPad 5th Gen".
Supported operators : CONTAINS , EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSINSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : EQUALS , IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
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.
An array of one or more filter values used in a device filter.
Operator Values
Attribute Values
The number of devices that matched the device filter selection criteria.
The maximum number of devices to be selected by a device filter and included in a test run.
Examples
The following example stops a specific test run.
response = client.stop_run(
# You can get the Amazon Resource Name (ARN) of the test run by using the list-runs CLI command.
arn='arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456',
)
print(response)
Expected Output:
{
'run': {
},
'ResponseMetadata': {
'...': '...',
},
}
Associates the specified tags to a resource with the specified resourceArn . If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are deleted as well.
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
ResourceARN='string',
Tags=[
{
'Key': 'string',
'Value': 'string'
},
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource(s) to which to add tags. You can associate tags with the following Device Farm resources: PROJECT , RUN , NETWORK_PROFILE , INSTANCE_PROFILE , DEVICE_INSTANCE , SESSION , DEVICE_POOL , DEVICE , and VPCE_CONFIGURATION .
[REQUIRED]
The tags to add to the resource. A tag is an array of key-value pairs. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
The metadata that you apply to a resource to help you categorize and organize it. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.
One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).
dict
Response Syntax
{}
Response Structure
Deletes the specified tags from a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
ResourceARN='string',
TagKeys=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the resource(s) from which to delete tags. You can associate tags with the following Device Farm resources: PROJECT , RUN , NETWORK_PROFILE , INSTANCE_PROFILE , DEVICE_INSTANCE , SESSION , DEVICE_POOL , DEVICE , and VPCE_CONFIGURATION .
[REQUIRED]
The keys of the tags to be removed.
dict
Response Syntax
{}
Response Structure
Updates information about an existing private device instance.
See also: AWS API Documentation
Request Syntax
response = client.update_device_instance(
arn='string',
profileArn='string',
labels=[
'string',
]
)
[REQUIRED]
The Amazon Resource Name (ARN) of the device instance.
An array of strings that you want to associate with the device instance.
dict
Response Syntax
{
'deviceInstance': {
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
}
}
Response Structure
(dict) --
deviceInstance (dict) --
An object containing information about your device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
Modifies the name, description, and rules in a device pool given the attributes and the pool ARN. Rule updates are all-or-nothing, meaning they can only be updated as a whole (or not at all).
See also: AWS API Documentation
Request Syntax
response = client.update_device_pool(
arn='string',
name='string',
description='string',
rules=[
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
maxDevices=123,
clearMaxDevices=True|False
)
[REQUIRED]
The Amazon Resourc Name (ARN) of the Device Farm device pool you wish to update.
Represents the rules you wish to modify for the device pool. Updating rules is optional; however, if you choose to update rules for your request, the update will replace the existing rules.
Represents a condition for a device pool.
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINSARN
The Amazon Resource Name (ARN) of the device. For example, "arn:aws:devicefarm:us-west-2::device:12345Example".
Supported operators : EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_ININSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INMODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_INOS_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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
The rule's value.
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
If you use this parameter in your request, you cannot use the clearMaxDevices parameter in the same request.
Sets whether the maxDevices parameter applies to your device pool. If you set this parameter to true , the maxDevices parameter does not apply, and Device Farm does not limit the number of devices that it adds to your device pool. In this case, Device Farm adds all available devices that meet the criteria that are specified for the rules parameter.
If you use this parameter in your request, you cannot use the maxDevices parameter in the same request.
dict
Response Syntax
{
'devicePool': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'rules': [
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
'maxDevices': 123
}
}
Response Structure
(dict) --
Represents the result of an update device pool request.
devicePool (dict) --
The device pool you just updated.
arn (string) --
The device pool's ARN.
name (string) --
The device pool's name.
description (string) --
The device pool's description.
type (string) --
The device pool's type.
Allowed values include:
rules (list) --
Information about the device pool's rules.
(dict) --
Represents a condition for a device pool.
attribute (string) --
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINS
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
AVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALS
FLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
FORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_IN
INSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_IN
INSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINS
MANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_IN
MODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_IN
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
PLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
operator (string) --
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
value (string) --
The rule's value.
maxDevices (integer) --
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
Examples
The following example updates the specified device pool with a new name and description. It also enables remote access of devices in the device pool.
response = client.update_device_pool(
name='NewName',
# You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command.
arn='arn:aws:devicefarm:us-west-2::devicepool:082d10e5-d7d7-48a5-ba5c-12345EXAMPLE',
description='NewDescription',
rules=[
{
'value': 'True',
'attribute': 'REMOTE_ACCESS_ENABLED',
'operator': 'EQUALS',
},
],
)
print(response)
Expected Output:
{
# Note: you cannot update curated device pools.
'devicePool': {
},
'ResponseMetadata': {
'...': '...',
},
}
Updates information about an existing private device instance profile.
See also: AWS API Documentation
Request Syntax
response = client.update_instance_profile(
arn='string',
name='string',
description='string',
packageCleanup=True|False,
excludeAppPackagesFromCleanup=[
'string',
],
rebootAfterUse=True|False
)
[REQUIRED]
The Amazon Resource Name (ARN) of the instance profile.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
dict
Response Syntax
{
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
}
Response Structure
(dict) --
instanceProfile (dict) --
An object containing information about your instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
Updates the network profile with specific settings.
See also: AWS API Documentation
Request Syntax
response = client.update_network_profile(
arn='string',
name='string',
description='string',
type='CURATED'|'PRIVATE',
uplinkBandwidthBits=123,
downlinkBandwidthBits=123,
uplinkDelayMs=123,
downlinkDelayMs=123,
uplinkJitterMs=123,
downlinkJitterMs=123,
uplinkLossPercent=123,
downlinkLossPercent=123
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to update network profile settings.
dict
Response Syntax
{
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
}
}
Response Structure
(dict) --
networkProfile (dict) --
A list of the available network profiles.
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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.
Modifies the specified project name, given the project ARN and a new name.
See also: AWS API Documentation
Request Syntax
response = client.update_project(
arn='string',
name='string',
defaultJobTimeoutMinutes=123
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project whose name you wish to update.
dict
Response Syntax
{
'project': {
'arn': 'string',
'name': 'string',
'defaultJobTimeoutMinutes': 123,
'created': datetime(2015, 1, 1)
}
}
Response Structure
(dict) --
Represents the result of an update project request.
project (dict) --
The project you wish to update.
arn (string) --
The project's ARN.
name (string) --
The project's name.
defaultJobTimeoutMinutes (integer) --
The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.
created (datetime) --
When the project was created.
Examples
The following example updates the specified project with a new name.
response = client.update_project(
name='NewName',
# You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
arn='arn:aws:devicefarm:us-west-2:183774035805:project:8f75187d-101e-4625-accc-12345EXAMPLE',
)
print(response)
Expected Output:
{
'project': {
'name': 'NewName',
'arn': 'arn:aws:devicefarm:us-west-2:183774035805:project:8f75187d-101e-4625-accc-12345EXAMPLE',
'created': datetime(2015, 11, 24, 21, 31, 49, 1, 328, 0),
},
'ResponseMetadata': {
'...': '...',
},
}
Update an uploaded test specification (test spec).
See also: AWS API Documentation
Request Syntax
response = client.update_upload(
arn='string',
name='string',
contentType='string',
editContent=True|False
)
[REQUIRED]
The Amazon Resource Name (ARN) of the uploaded test spec.
dict
Response Syntax
{
'upload': {
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
}
}
Response Structure
(dict) --
upload (dict) --
A test spec uploaded to Device Farm.
arn (string) --
The upload's ARN.
name (string) --
The upload's file name.
created (datetime) --
When the upload was created.
type (string) --
The upload's type.
Must be one of the following values:
status (string) --
The upload's status.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
metadata (string) --
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
contentType (string) --
The upload's content type (for example, "application/octet-stream").
message (string) --
A message about the upload's result.
category (string) --
The upload's category. Allowed values include:
Updates information about an existing Amazon Virtual Private Cloud (VPC) endpoint configuration.
See also: AWS API Documentation
Request Syntax
response = client.update_vpce_configuration(
arn='string',
vpceConfigurationName='string',
vpceServiceName='string',
serviceDnsName='string',
vpceConfigurationDescription='string'
)
[REQUIRED]
The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to update.
dict
Response Syntax
{
'vpceConfiguration': {
'arn': 'string',
'vpceConfigurationName': 'string',
'vpceServiceName': 'string',
'serviceDnsName': 'string',
'vpceConfigurationDescription': 'string'
}
}
Response Structure
(dict) --
vpceConfiguration (dict) --
An object containing information about your VPC endpoint configuration.
arn (string) --
The Amazon Resource Name (ARN) of the VPC endpoint configuration.
vpceConfigurationName (string) --
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
vpceServiceName (string) --
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
serviceDnsName (string) --
The DNS name that maps to the private IP address of the service you want to access.
vpceConfigurationDescription (string) --
An optional description, providing more details about your VPC endpoint configuration.
The available paginators are:
paginator = client.get_paginator('get_offering_status')
Creates an iterator that will paginate through responses from DeviceFarm.Client.get_offering_status().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'current': {
'string': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
}
},
'nextPeriod': {
'string': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
}
},
'NextToken': 'string'
}
Response Structure
Returns the status result for a device offering.
When specified, gets the offering status for the current period.
The status of the offering.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
When specified, gets the offering status for the next period.
The status of the offering.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
A token to resume pagination.
paginator = client.get_paginator('list_artifacts')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_artifacts().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
type='SCREENSHOT'|'FILE'|'LOG',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Run, Job, Suite, or Test ARN.
[REQUIRED]
The artifacts' type.
Allowed values include:
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'artifacts': [
{
'arn': 'string',
'name': 'string',
'type': 'UNKNOWN'|'SCREENSHOT'|'DEVICE_LOG'|'MESSAGE_LOG'|'VIDEO_LOG'|'RESULT_LOG'|'SERVICE_LOG'|'WEBKIT_LOG'|'INSTRUMENTATION_OUTPUT'|'EXERCISER_MONKEY_OUTPUT'|'CALABASH_JSON_OUTPUT'|'CALABASH_PRETTY_OUTPUT'|'CALABASH_STANDARD_OUTPUT'|'CALABASH_JAVA_XML_OUTPUT'|'AUTOMATION_OUTPUT'|'APPIUM_SERVER_OUTPUT'|'APPIUM_JAVA_OUTPUT'|'APPIUM_JAVA_XML_OUTPUT'|'APPIUM_PYTHON_OUTPUT'|'APPIUM_PYTHON_XML_OUTPUT'|'EXPLORER_EVENT_LOG'|'EXPLORER_SUMMARY_LOG'|'APPLICATION_CRASH_REPORT'|'XCTEST_LOG'|'VIDEO'|'CUSTOMER_ARTIFACT'|'CUSTOMER_ARTIFACT_LOG'|'TESTSPEC_OUTPUT',
'extension': 'string',
'url': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list artifacts operation.
artifacts (list) --
Information about the artifacts.
(dict) --
Represents the output of a test. Examples of artifacts include logs and screenshots.
arn (string) --
The artifact's ARN.
name (string) --
The artifact's name.
type (string) --
The artifact's type.
Allowed values include the following:
extension (string) --
The artifact's file extension.
url (string) --
The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the artifact's file.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_device_instances')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_device_instances().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'deviceInstances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
An object containing information about your device instances.
Represents the device instance.
The Amazon Resource Name (ARN) of the device instance.
The Amazon Resource Name (ARN) of the device.
An array of strings describing the device instance.
The status of the device instance. Valid values are listed below.
Unique device identifier for the device instance.
A object containing information about the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
A token to resume pagination.
paginator = client.get_paginator('list_device_pools')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_device_pools().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
type='CURATED'|'PRIVATE',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The project ARN.
The device pools' type.
Allowed values include:
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'devicePools': [
{
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'rules': [
{
'attribute': 'ARN'|'PLATFORM'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'APPIUM_VERSION'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE'|'OS_VERSION'|'MODEL'|'AVAILABILITY',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'value': 'string'
},
],
'maxDevices': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list device pools request.
devicePools (list) --
Information about the device pools.
(dict) --
Represents a collection of device types.
arn (string) --
The device pool's ARN.
name (string) --
The device pool's name.
description (string) --
The device pool's description.
type (string) --
The device pool's type.
Allowed values include:
rules (list) --
Information about the device pool's rules.
(dict) --
Represents a condition for a device pool.
attribute (string) --
The rule's stringified attribute. For example, specify the value as "\"abc\"" .
The supported operators for each attribute are provided in the following list.
APPIUM_VERSION
The Appium version for the test.
Supported operators : CONTAINS
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
AVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALS
FLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
FORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALS , IN , NOT_IN
INSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : IN , NOT_IN
INSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINS
MANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_IN
MODEL
The device model, such as "Apple iPad Air 2" or "Google Pixel".
Supported operators : CONTAINS , EQUALS , IN , NOT_IN
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
PLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
operator (string) --
Specifies how Device Farm compares the rule's attribute to the value. For the operators that are supported by each attribute, see the attribute descriptions.
value (string) --
The rule's value.
maxDevices (integer) --
The number of devices that Device Farm can add to your device pool. Device Farm adds devices that are available and that meet the criteria that you assign for the rules parameter. Depending on how many devices meet these constraints, your device pool might contain fewer devices than the value for this parameter.
By specifying the maximum number of devices, you can control the costs that you incur by running tests.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_devices')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_devices().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
filters=[
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
Used to select a set of devices. A filter is made up of an attribute, an operator, and one or more values.
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 .
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_INPLATFORM
The device platform. Valid values are "ANDROID" or "IOS".
Supported operators : EQUALSOS_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_INMODEL
The device model. For example, "iPad 5th Gen".
Supported operators : CONTAINS , EQUALS , IN , NOT_INAVAILABILITY
The current availability of the device. Valid values are "AVAILABLE", "HIGHLY_AVAILABLE", "BUSY", or "TEMPORARY_NOT_AVAILABLE".
Supported operators : EQUALSFORM_FACTOR
The device form factor. Valid values are "PHONE" or "TABLET".
Supported operators : EQUALSMANUFACTURER
The device manufacturer. For example, "Apple".
Supported operators : EQUALS , IN , NOT_INREMOTE_ACCESS_ENABLED
Whether the device is enabled for remote access. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSREMOTE_DEBUG_ENABLED
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALSINSTANCE_ARN
The Amazon Resource Name (ARN) of the device instance.
Supported operators : EQUALS , IN , NOT_ININSTANCE_LABELS
The label of the device instance.
Supported operators : CONTAINSFLEET_TYPE
The fleet type. Valid values are "PUBLIC" or "PRIVATE".
Supported operators : EQUALS
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.
An array of one or more filter values used in a device filter.
Operator Values
Attribute Values
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'devices': [
{
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list devices operation.
devices (list) --
Information about the devices.
(dict) --
Represents a device type that an app is tested against.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_instance_profiles')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_instance_profiles().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'instanceProfiles': [
{
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
},
],
'NextToken': 'string'
}
Response Structure
An object containing information about your instance profiles.
Represents the instance profile.
The Amazon Resource Name (ARN) of the instance profile.
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
The name of the instance profile.
The description of the instance profile.
A token to resume pagination.
paginator = client.get_paginator('list_jobs')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_jobs().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The run's Amazon Resource Name (ARN).
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'jobs': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'videoEndpoint': 'string',
'videoCapture': True|False
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list jobs request.
jobs (list) --
Information about the jobs.
(dict) --
Represents a device.
arn (string) --
The job's ARN.
name (string) --
The job's name.
type (string) --
The job's type.
Allowed values include the following:
created (datetime) --
When the job was created.
status (string) --
The job's status.
Allowed values include:
result (string) --
The job's result.
Allowed values include:
started (datetime) --
The job's start time.
stopped (datetime) --
The job's stop time.
counters (dict) --
The job'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 job's result.
device (dict) --
The device (phone or tablet).
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
instanceArn (string) --
The Amazon Resource Name (ARN) of the instance.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the job.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
videoEndpoint (string) --
The endpoint for streaming device video.
videoCapture (boolean) --
This value is set to true if video capture is enabled; otherwise, it is set to false.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_network_profiles')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_network_profiles().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
type='CURATED'|'PRIVATE',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list network profiles.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'networkProfiles': [
{
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
networkProfiles (list) --
A list of the available network profiles.
(dict) --
An array of settings that describes characteristics of a network profile.
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_offering_promotions')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_offering_promotions().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'offeringPromotions': [
{
'id': 'string',
'description': 'string'
},
],
'NextToken': 'string'
}
Response Structure
Information about the offering promotions.
Represents information about an offering promotion.
The ID of the offering promotion.
A string describing the offering promotion.
A token to resume pagination.
paginator = client.get_paginator('list_offering_transactions')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_offering_transactions().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'offeringTransactions': [
{
'offeringStatus': {
'type': 'PURCHASE'|'RENEW'|'SYSTEM',
'offering': {
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
'quantity': 123,
'effectiveOn': datetime(2015, 1, 1)
},
'transactionId': 'string',
'offeringPromotionId': 'string',
'createdOn': datetime(2015, 1, 1),
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
}
},
],
'NextToken': 'string'
}
Response Structure
Returns the transaction log of the specified offerings.
The audit log of subscriptions you have purchased and modified through AWS Device Farm.
Represents the metadata of an offering transaction.
The status of an offering transaction.
The type specified for the offering status.
Represents the metadata of an offering status.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
The number of available devices in the offering.
The date on which the offering is effective.
The transaction ID of the offering transaction.
The ID that corresponds to a device offering promotion.
The date on which an offering transaction was created.
The cost of an offering transaction.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
A token to resume pagination.
paginator = client.get_paginator('list_offerings')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_offerings().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'offerings': [
{
'id': 'string',
'description': 'string',
'type': 'RECURRING',
'platform': 'ANDROID'|'IOS',
'recurringCharges': [
{
'cost': {
'amount': 123.0,
'currencyCode': 'USD'
},
'frequency': 'MONTHLY'
},
]
},
],
'NextToken': 'string'
}
Response Structure
Represents the return values of the list of offerings.
A value representing the list offering results.
Represents the metadata of a device offering.
The ID that corresponds to a device offering.
A string describing the offering.
The type of offering (e.g., "RECURRING") for a device.
The platform of the device (e.g., ANDROID or IOS).
Specifies whether there are recurring charges for the offering.
Specifies whether charges for devices will be recurring.
The cost of the recurring charge.
The numerical amount of an offering or transaction.
The currency code of a monetary amount. For example, USD means "U.S. dollars."
The frequency in which charges will recur.
A token to resume pagination.
paginator = client.get_paginator('list_projects')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_projects().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'projects': [
{
'arn': 'string',
'name': 'string',
'defaultJobTimeoutMinutes': 123,
'created': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list projects request.
projects (list) --
Information about the projects.
(dict) --
Represents an operating-system neutral workspace for running and managing tests.
arn (string) --
The project's ARN.
name (string) --
The project's name.
defaultJobTimeoutMinutes (integer) --
The default number of minutes (at the project level) a test run will execute before it times out. Default value is 60 minutes.
created (datetime) --
When the project was created.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_remote_access_sessions')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_remote_access_sessions().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'remoteAccessSessions': [
{
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'instanceArn': 'string',
'remoteDebugEnabled': True|False,
'remoteRecordEnabled': True|False,
'remoteRecordAppArn': 'string',
'hostAddress': 'string',
'clientId': 'string',
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'endpoint': 'string',
'deviceUdid': 'string',
'interactionMode': 'INTERACTIVE'|'NO_VIDEO'|'VIDEO_ONLY',
'skipAppResign': True|False
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the response from the server after AWS Device Farm makes a request to return information about the remote access session.
remoteAccessSessions (list) --
A container representing the metadata from the service about each remote access session you are requesting.
(dict) --
Represents information about the remote access session.
arn (string) --
The Amazon Resource Name (ARN) of the remote access session.
name (string) --
The name of the remote access session.
created (datetime) --
The date and time the remote access session was created.
status (string) --
The status of the remote access session. Can be any of the following:
result (string) --
The result of the remote access session. Can be any of the following:
message (string) --
A message about the remote access session.
started (datetime) --
The date and time the remote access session was started.
stopped (datetime) --
The date and time the remote access session was stopped.
device (dict) --
The device (phone or tablet) used in the remote access session.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
instanceArn (string) --
The Amazon Resource Name (ARN) of the instance.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the remote access session.
remoteRecordEnabled (boolean) --
This flag is set to true if remote recording is enabled for the remote access session.
remoteRecordAppArn (string) --
The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.
hostAddress (string) --
IP address of the EC2 host where you need to connect to remotely debug devices. Only returned if remote debugging is enabled for the remote access session.
clientId (string) --
Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.
billingMethod (string) --
The billing method of the remote access session. Possible values include METERED or UNMETERED . For more information about metered devices, see AWS Device Farm terminology ."
deviceMinutes (dict) --
The number of minutes a device is used in a remote access sesssion (including setup and teardown minutes).
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
endpoint (string) --
The endpoint for the remote access sesssion.
deviceUdid (string) --
Unique device identifier for the remote device. Only returned if remote debugging is enabled for the remote access session.
interactionMode (string) --
The interaction mode of the remote access session. Valid values are:
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 .
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_runs')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_runs().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list runs.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'runs': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'platform': 'ANDROID'|'IOS',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'totalJobs': 123,
'completedJobs': 123,
'billingMethod': 'METERED'|'UNMETERED',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
},
'networkProfile': {
'arn': 'string',
'name': 'string',
'description': 'string',
'type': 'CURATED'|'PRIVATE',
'uplinkBandwidthBits': 123,
'downlinkBandwidthBits': 123,
'uplinkDelayMs': 123,
'downlinkDelayMs': 123,
'uplinkJitterMs': 123,
'downlinkJitterMs': 123,
'uplinkLossPercent': 123,
'downlinkLossPercent': 123
},
'parsingResultUrl': 'string',
'resultCode': 'PARSING_FAILED'|'VPC_ENDPOINT_SETUP_FAILED',
'seed': 123,
'appUpload': 'string',
'eventCount': 123,
'jobTimeoutMinutes': 123,
'devicePoolArn': 'string',
'locale': 'string',
'radios': {
'wifi': True|False,
'bluetooth': True|False,
'nfc': True|False,
'gps': True|False
},
'location': {
'latitude': 123.0,
'longitude': 123.0
},
'customerArtifactPaths': {
'iosPaths': [
'string',
],
'androidPaths': [
'string',
],
'deviceHostPaths': [
'string',
]
},
'webUrl': 'string',
'skipAppResign': True|False,
'testSpecArn': 'string',
'deviceSelectionResult': {
'filters': [
{
'attribute': 'ARN'|'PLATFORM'|'OS_VERSION'|'MODEL'|'AVAILABILITY'|'FORM_FACTOR'|'MANUFACTURER'|'REMOTE_ACCESS_ENABLED'|'REMOTE_DEBUG_ENABLED'|'INSTANCE_ARN'|'INSTANCE_LABELS'|'FLEET_TYPE',
'operator': 'EQUALS'|'LESS_THAN'|'LESS_THAN_OR_EQUALS'|'GREATER_THAN'|'GREATER_THAN_OR_EQUALS'|'IN'|'NOT_IN'|'CONTAINS',
'values': [
'string',
]
},
],
'matchedDevicesCount': 123,
'maxDevices': 123
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list runs request.
runs (list) --
Information about the runs.
(dict) --
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:
platform (string) --
The run's platform.
Allowed values include:
created (datetime) --
When the run was created.
status (string) --
The run's status.
Allowed values include:
result (string) --
The run's result.
Allowed values include:
started (datetime) --
The run's start time.
stopped (datetime) --
The run's stop time.
counters (dict) --
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 (dict) --
Represents the total (metered or unmetered) minutes used by the test run.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
networkProfile (dict) --
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 (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
downlinkBandwidthBits (integer) --
The data throughput rate in bits per second, as an integer from 0 to 104857600.
uplinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
downlinkDelayMs (integer) --
Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.
uplinkJitterMs (integer) --
Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.
downlinkJitterMs (integer) --
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 (dict) --
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 (dict) --
Information about the location that is used for the run.
latitude (float) --
The latitude.
longitude (float) --
The longitude.
customerArtifactPaths (dict) --
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.
androidPaths (list) --
Comma-separated list of paths on the Android device where the artifacts generated by the customer's tests will be pulled from.
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.
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 (dict) --
The results of a device filter used to select the devices for a test run.
filters (list) --
The filters in a device selection result.
(dict) --
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
Whether the device is enabled for remote debugging. Valid values are "TRUE" or "FALSE".
Supported operators : EQUALS
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
Attribute Values
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) --
A token to resume pagination.
paginator = client.get_paginator('list_samples')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_samples().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the job used to list samples.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'samples': [
{
'arn': 'string',
'type': 'CPU'|'MEMORY'|'THREADS'|'RX_RATE'|'TX_RATE'|'RX'|'TX'|'NATIVE_FRAMES'|'NATIVE_FPS'|'NATIVE_MIN_DRAWTIME'|'NATIVE_AVG_DRAWTIME'|'NATIVE_MAX_DRAWTIME'|'OPENGL_FRAMES'|'OPENGL_FPS'|'OPENGL_MIN_DRAWTIME'|'OPENGL_AVG_DRAWTIME'|'OPENGL_MAX_DRAWTIME',
'url': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list samples request.
samples (list) --
Information about the samples.
(dict) --
Represents a sample of performance data.
arn (string) --
The sample's ARN.
type (string) --
The sample's type.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download the sample's file.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_suites')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_suites().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The job's Amazon Resource Name (ARN).
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'suites': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list suites request.
suites (list) --
Information about the suites.
(dict) --
Represents a collection of one or more tests.
arn (string) --
The suite's ARN.
name (string) --
The suite's name.
type (string) --
The suite's type.
Must be one of the following values:
created (datetime) --
When the suite was created.
status (string) --
The suite's status.
Allowed values include:
result (string) --
The suite's result.
Allowed values include:
started (datetime) --
The suite's start time.
stopped (datetime) --
The suite's stop time.
counters (dict) --
The suite'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 suite's result.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the test suite.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_tests')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_tests().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The test suite's Amazon Resource Name (ARN).
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'tests': [
{
'arn': 'string',
'name': 'string',
'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'WEB_PERFORMANCE_PROFILE'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_NODE'|'APPIUM_RUBY'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'APPIUM_WEB_NODE'|'APPIUM_WEB_RUBY'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI'|'REMOTE_ACCESS_RECORD'|'REMOTE_ACCESS_REPLAY',
'created': datetime(2015, 1, 1),
'status': 'PENDING'|'PENDING_CONCURRENCY'|'PENDING_DEVICE'|'PROCESSING'|'SCHEDULING'|'PREPARING'|'RUNNING'|'COMPLETED'|'STOPPING',
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'started': datetime(2015, 1, 1),
'stopped': datetime(2015, 1, 1),
'counters': {
'total': 123,
'passed': 123,
'failed': 123,
'warned': 123,
'errored': 123,
'stopped': 123,
'skipped': 123
},
'message': 'string',
'deviceMinutes': {
'total': 123.0,
'metered': 123.0,
'unmetered': 123.0
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list tests request.
tests (list) --
Information about the tests.
(dict) --
Represents a condition that is evaluated.
arn (string) --
The test's ARN.
name (string) --
The test's name.
type (string) --
The test's type.
Must be one of the following values:
created (datetime) --
When the test was created.
status (string) --
The test's status.
Allowed values include:
result (string) --
The test's result.
Allowed values include:
started (datetime) --
The test's start time.
stopped (datetime) --
The test's stop time.
counters (dict) --
The test'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 test's result.
deviceMinutes (dict) --
Represents the total (metered or unmetered) minutes used by the test.
total (float) --
When specified, represents the total minutes used by the resource to run tests.
metered (float) --
When specified, represents only the sum of metered minutes used by the resource to run tests.
unmetered (float) --
When specified, represents only the sum of unmetered minutes used by the resource to run tests.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_unique_problems')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_unique_problems().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The unique problems' ARNs.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'uniqueProblems': {
'string': [
{
'message': 'string',
'problems': [
{
'run': {
'arn': 'string',
'name': 'string'
},
'job': {
'arn': 'string',
'name': 'string'
},
'suite': {
'arn': 'string',
'name': 'string'
},
'test': {
'arn': 'string',
'name': 'string'
},
'device': {
'arn': 'string',
'name': 'string',
'manufacturer': 'string',
'model': 'string',
'modelId': 'string',
'formFactor': 'PHONE'|'TABLET',
'platform': 'ANDROID'|'IOS',
'os': 'string',
'cpu': {
'frequency': 'string',
'architecture': 'string',
'clock': 123.0
},
'resolution': {
'width': 123,
'height': 123
},
'heapSize': 123,
'memory': 123,
'image': 'string',
'carrier': 'string',
'radio': 'string',
'remoteAccessEnabled': True|False,
'remoteDebugEnabled': True|False,
'fleetType': 'string',
'fleetName': 'string',
'instances': [
{
'arn': 'string',
'deviceArn': 'string',
'labels': [
'string',
],
'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
'udid': 'string',
'instanceProfile': {
'arn': 'string',
'packageCleanup': True|False,
'excludeAppPackagesFromCleanup': [
'string',
],
'rebootAfterUse': True|False,
'name': 'string',
'description': 'string'
}
},
],
'availability': 'TEMPORARY_NOT_AVAILABLE'|'BUSY'|'AVAILABLE'|'HIGHLY_AVAILABLE'
},
'result': 'PENDING'|'PASSED'|'WARNED'|'FAILED'|'SKIPPED'|'ERRORED'|'STOPPED',
'message': 'string'
},
]
},
]
},
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list unique problems request.
uniqueProblems (dict) --
Information about the unique problems.
Allowed values include:
(string) --
(list) --
(dict) --
A collection of one or more problems, grouped by their result.
message (string) --
A message about the unique problems' result.
problems (list) --
Information about the problems.
(dict) --
Represents a specific warning or failure.
run (dict) --
Information about the associated run.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
job (dict) --
Information about the associated job.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
suite (dict) --
Information about the associated suite.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
test (dict) --
Information about the associated test.
arn (string) --
The problem detail's ARN.
name (string) --
The problem detail's name.
device (dict) --
Information about the associated device.
arn (string) --
The device's ARN.
name (string) --
The device's display name.
manufacturer (string) --
The device's manufacturer name.
model (string) --
The device's model name.
modelId (string) --
The device's model ID.
formFactor (string) --
The device's form factor.
Allowed values include:
platform (string) --
The device's platform.
Allowed values include:
os (string) --
The device's operating system type.
cpu (dict) --
Information about the device's CPU.
frequency (string) --
The CPU's frequency.
architecture (string) --
The CPU's architecture, for example x86 or ARM.
clock (float) --
The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU is expressed as 1200000000.
resolution (dict) --
The resolution of the device.
width (integer) --
The screen resolution's width, expressed in pixels.
height (integer) --
The screen resolution's height, expressed in pixels.
heapSize (integer) --
The device's heap size, expressed in bytes.
memory (integer) --
The device's total memory size, expressed in bytes.
image (string) --
The device's image name.
carrier (string) --
The device's carrier.
radio (string) --
The device's radio.
remoteAccessEnabled (boolean) --
Specifies whether remote access has been enabled for the specified device.
remoteDebugEnabled (boolean) --
This flag is set to true if remote debugging is enabled for the device.
fleetType (string) --
The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE and PUBLIC.
fleetName (string) --
The name of the fleet to which this device belongs.
instances (list) --
The instances belonging to this device.
(dict) --
Represents the device instance.
arn (string) --
The Amazon Resource Name (ARN) of the device instance.
deviceArn (string) --
The Amazon Resource Name (ARN) of the device.
labels (list) --
An array of strings describing the device instance.
status (string) --
The status of the device instance. Valid values are listed below.
udid (string) --
Unique device identifier for the device instance.
instanceProfile (dict) --
A object containing information about the instance profile.
arn (string) --
The Amazon Resource Name (ARN) of the instance profile.
packageCleanup (boolean) --
When set to true , Device Farm will remove app packages after a test run. The default value is false for private devices.
excludeAppPackagesFromCleanup (list) --
An array of strings specifying the list of app packages that should not be cleaned up from the device after a test run is over.
The list of packages is only considered if you set packageCleanup to true .
rebootAfterUse (boolean) --
When set to true , Device Farm will reboot the instance after a test run. The default value is true .
name (string) --
The name of the instance profile.
description (string) --
The description of the instance profile.
availability (string) --
Reflects how likely a device will be available for a test run. It is currently available in the ListDevices and GetDevice API methods.
result (string) --
The problem's result.
Allowed values include:
message (string) --
A message about the problem's result.
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_uploads')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_uploads().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
arn='string',
type='ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
[REQUIRED]
The Amazon Resource Name (ARN) of the project for which you want to list uploads.
The type of upload.
Must be one of the following values:
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'uploads': [
{
'arn': 'string',
'name': 'string',
'created': datetime(2015, 1, 1),
'type': 'ANDROID_APP'|'IOS_APP'|'WEB_APP'|'EXTERNAL_DATA'|'APPIUM_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_PYTHON_TEST_PACKAGE'|'APPIUM_NODE_TEST_PACKAGE'|'APPIUM_RUBY_TEST_PACKAGE'|'APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE'|'APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE'|'APPIUM_WEB_PYTHON_TEST_PACKAGE'|'APPIUM_WEB_NODE_TEST_PACKAGE'|'APPIUM_WEB_RUBY_TEST_PACKAGE'|'CALABASH_TEST_PACKAGE'|'INSTRUMENTATION_TEST_PACKAGE'|'UIAUTOMATION_TEST_PACKAGE'|'UIAUTOMATOR_TEST_PACKAGE'|'XCTEST_TEST_PACKAGE'|'XCTEST_UI_TEST_PACKAGE'|'APPIUM_JAVA_JUNIT_TEST_SPEC'|'APPIUM_JAVA_TESTNG_TEST_SPEC'|'APPIUM_PYTHON_TEST_SPEC'|'APPIUM_NODE_TEST_SPEC'|'APPIUM_RUBY_TEST_SPEC'|'APPIUM_WEB_JAVA_JUNIT_TEST_SPEC'|'APPIUM_WEB_JAVA_TESTNG_TEST_SPEC'|'APPIUM_WEB_PYTHON_TEST_SPEC'|'APPIUM_WEB_NODE_TEST_SPEC'|'APPIUM_WEB_RUBY_TEST_SPEC'|'INSTRUMENTATION_TEST_SPEC'|'XCTEST_UI_TEST_SPEC',
'status': 'INITIALIZED'|'PROCESSING'|'SUCCEEDED'|'FAILED',
'url': 'string',
'metadata': 'string',
'contentType': 'string',
'message': 'string',
'category': 'CURATED'|'PRIVATE'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Represents the result of a list uploads request.
uploads (list) --
Information about the uploads.
(dict) --
An app or a set of one or more tests to upload or that have been uploaded.
arn (string) --
The upload's ARN.
name (string) --
The upload's file name.
created (datetime) --
When the upload was created.
type (string) --
The upload's type.
Must be one of the following values:
status (string) --
The upload's status.
Must be one of the following values:
url (string) --
The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.
metadata (string) --
The upload's metadata. For example, for Android, this contains information that is parsed from the manifest and is displayed in the AWS Device Farm console after the associated app is uploaded.
contentType (string) --
The upload's content type (for example, "application/octet-stream").
message (string) --
A message about the upload's result.
category (string) --
The upload's category. Allowed values include:
NextToken (string) --
A token to resume pagination.
paginator = client.get_paginator('list_vpce_configurations')
Creates an iterator that will paginate through responses from DeviceFarm.Client.list_vpce_configurations().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'vpceConfigurations': [
{
'arn': 'string',
'vpceConfigurationName': 'string',
'vpceServiceName': 'string',
'serviceDnsName': 'string',
'vpceConfigurationDescription': 'string'
},
],
'NextToken': 'string'
}
Response Structure
An array of VPCEConfiguration objects containing information about your VPC endpoint configuration.
Represents an Amazon Virtual Private Cloud (VPC) endpoint configuration.
The Amazon Resource Name (ARN) of the VPC endpoint configuration.
The friendly name you give to your VPC endpoint configuration, to manage your configurations more easily.
The name of the VPC endpoint service running inside your AWS account that you want Device Farm to test.
The DNS name that maps to the private IP address of the service you want to access.
An optional description, providing more details about your VPC endpoint configuration.
A token to resume pagination.