AWS Device Farm

2016/04/18 - AWS Device Farm - 12 updated api methods

GetAccountSettings (updated) Link ¶
Changes (response)
{'accountSettings': {'unmeteredRemoteAccessDevices': {'ANDROID | IOS': 'integer'}}}

Returns the number of unmetered iOS and/or unmetered Android devices that have been purchased by the account.

Request Syntax

client.get_account_settings()
rtype

dict

returns

Response Syntax

{
    'accountSettings': {
        'awsAccountNumber': 'string',
        'unmeteredDevices': {
            'string': 123
        },
        'unmeteredRemoteAccessDevices': {
            'string': 123
        }
    }
}

Response Structure

  • (dict) --

    Represents the account settings return values from the GetAccountSettings request.

    • accountSettings (dict) --

      A container for account-level settings within AWS Device Farm.

      • awsAccountNumber (string) --

        The AWS account number specified in the AccountSettings container.

      • unmeteredDevices (dict) --

        Returns the unmetered devices you have purchased or want to purchase.

        • (string) --

          • (integer) --

      • unmeteredRemoteAccessDevices (dict) --

        Returns the unmetered remote access devices you have purchased or want to purchase.

        • (string) --

          • (integer) --

GetJob (updated) Link ¶
Changes (response)
{'job': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about a job.

Request Syntax

client.get_job(
    arn='string'
)
type arn

string

param arn

[REQUIRED]

The job's ARN.

rtype

dict

returns

Response Syntax

{
    'job': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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',
            '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'
        },
        'deviceMinutes': {
            'total': 123.0,
            'metered': 123.0,
            'unmetered': 123.0
        }
    }
}

Response Structure

  • (dict) --

    Represents the result of a get job request.

    • job (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:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • created (datetime) --

        When the job was created.

      • status (string) --

        The job's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The job's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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) --

        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.

        • formFactor (string) --

          The device's form factor.

          Allowed values include:

          • PHONE: The phone form factor.

          • TABLET: The tablet form factor.

        • platform (string) --

          The device's platform.

          Allowed values include:

          • ANDROID: The Android platform.

          • IOS: The iOS platform.

        • 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) --

          Represents the screen resolution of a device in height and width, expressed in pixels.

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

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

GetRun (updated) Link ¶
Changes (response)
{'run': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about a run.

Request Syntax

client.get_run(
    arn='string'
)
type arn

string

param arn

[REQUIRED]

The run's ARN.

rtype

dict

returns

Response Syntax

{
    'run': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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
        }
    }
}

Response Structure

  • (dict) --

    Represents the result of a get run request.

    • run (dict) --

      Represents an app on a set of devices with a specific test and configuration.

      • arn (string) --

        The run's ARN.

      • name (string) --

        The run's name.

      • type (string) --

        The run's type.

        Must be one of the following values:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • platform (string) --

        The run's platform.

        Allowed values include:

        • ANDROID: The Android platform.

        • IOS: The iOS platform.

      • created (datetime) --

        When the run was created.

      • status (string) --

        The run's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The run's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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 unmetered .

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

GetSuite (updated) Link ¶
Changes (response)
{'suite': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about a suite.

Request Syntax

client.get_suite(
    arn='string'
)
type arn

string

param arn

[REQUIRED]

The suite's ARN.

rtype

dict

returns

Response Syntax

{
    'suite': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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

  • (dict) --

    Represents the result of a get suite request.

    • suite (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:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • created (datetime) --

        When the suite was created.

      • status (string) --

        The suite's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The suite's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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.

GetTest (updated) Link ¶
Changes (response)
{'test': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about a test.

Request Syntax

client.get_test(
    arn='string'
)
type arn

string

param arn

[REQUIRED]

The test's ARN.

rtype

dict

returns

Response Syntax

{
    'test': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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

  • (dict) --

    Represents the result of a get test request.

    • test (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:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • created (datetime) --

        When the test was created.

      • status (string) --

        The test's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The test's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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.

ListArtifacts (updated) Link ¶
Changes (response)
{'artifacts': {'type': {'VIDEO'}}}

Gets information about artifacts.

Request Syntax

client.list_artifacts(
    arn='string',
    type='SCREENSHOT'|'FILE'|'LOG',
    nextToken='string'
)
type arn

string

param arn

[REQUIRED]

The Run, Job, Suite, or Test ARN.

type type

string

param type

[REQUIRED]

The artifacts' type.

Allowed values include:

  • FILE: The artifacts are files.

  • LOG: The artifacts are logs.

  • SCREENSHOT: The artifacts are screenshots.

type nextToken

string

param nextToken

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.

rtype

dict

returns

Response Syntax

{
    'artifacts': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'UNKNOWN'|'SCREENSHOT'|'DEVICE_LOG'|'MESSAGE_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',
            '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:

          • UNKNOWN: An unknown type.

          • SCREENSHOT: The screenshot type.

          • DEVICE_LOG: The device log type.

          • MESSAGE_LOG: The message log type.

          • RESULT_LOG: The result log type.

          • SERVICE_LOG: The service log type.

          • WEBKIT_LOG: The web kit log type.

          • INSTRUMENTATION_OUTPUT: The instrumentation type.

          • EXERCISER_MONKEY_OUTPUT: For Android, the artifact (log) generated by an Android fuzz test.

          • CALABASH_JSON_OUTPUT: The Calabash JSON output type.

          • CALABASH_PRETTY_OUTPUT: The Calabash pretty output type.

          • CALABASH_STANDARD_OUTPUT: The Calabash standard output type.

          • CALABASH_JAVA_XML_OUTPUT: The Calabash Java XML output type.

          • AUTOMATION_OUTPUT: The automation output type.

          • APPIUM_SERVER_OUTPUT: The Appium server output type.

          • APPIUM_JAVA_OUTPUT: The Appium Java output type.

          • APPIUM_JAVA_XML_OUTPUT: The Appium Java XML output type.

          • APPIUM_PYTHON_OUTPUT: The Appium Python output type.

          • APPIUM_PYTHON_XML_OUTPUT: The Appium Python XML output type.

          • EXPLORER_EVENT_LOG: The Explorer event log output type.

          • EXPLORER_SUMMARY_LOG: The Explorer summary log output type.

          • APPLICATION_CRASH_REPORT: The application crash report output type.

          • XCTEST_LOG: The XCode test output type.

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

ListJobs (updated) Link ¶
Changes (response)
{'jobs': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about jobs.

Request Syntax

client.list_jobs(
    arn='string',
    nextToken='string'
)
type arn

string

param arn

[REQUIRED]

The jobs' ARNs.

type nextToken

string

param nextToken

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.

rtype

dict

returns

Response Syntax

{
    'jobs': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
            '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',
                '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'
            },
            'deviceMinutes': {
                'total': 123.0,
                'metered': 123.0,
                'unmetered': 123.0
            }
        },
    ],
    '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:

          • BUILTIN_FUZZ: The built-in fuzz type.

          • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

          • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

          • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

          • APPIUM_PYTHON: The Appium Python type.

          • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

          • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

          • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

          • CALABASH: The Calabash type.

          • INSTRUMENTATION: The Instrumentation type.

          • UIAUTOMATION: The uiautomation type.

          • UIAUTOMATOR: The uiautomator type.

          • XCTEST: The XCode test type.

          • XCTEST_UI: The XCode UI test type.

        • created (datetime) --

          When the job was created.

        • status (string) --

          The job's status.

          Allowed values include:

          • PENDING: A pending status.

          • PENDING_CONCURRENCY: A pending concurrency status.

          • PENDING_DEVICE: A pending device status.

          • PROCESSING: A processing status.

          • SCHEDULING: A scheduling status.

          • PREPARING: A preparing status.

          • RUNNING: A running status.

          • COMPLETED: A completed status.

          • STOPPING: A stopping status.

        • result (string) --

          The job's result.

          Allowed values include:

          • PENDING: A pending condition.

          • PASSED: A passing condition.

          • WARNED: A warning condition.

          • FAILED: A failed condition.

          • SKIPPED: A skipped condition.

          • ERRORED: An error condition.

          • STOPPED: A stopped condition.

        • started (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) --

          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.

          • formFactor (string) --

            The device's form factor.

            Allowed values include:

            • PHONE: The phone form factor.

            • TABLET: The tablet form factor.

          • platform (string) --

            The device's platform.

            Allowed values include:

            • ANDROID: The Android platform.

            • IOS: The iOS platform.

          • 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) --

            Represents the screen resolution of a device in height and width, expressed in pixels.

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

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

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

ListRuns (updated) Link ¶
Changes (response)
{'runs': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about runs.

Request Syntax

client.list_runs(
    arn='string',
    nextToken='string'
)
type arn

string

param arn

[REQUIRED]

The runs' ARNs.

type nextToken

string

param nextToken

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.

rtype

dict

returns

Response Syntax

{
    'runs': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
            '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
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    Represents the result of a list runs request.

    • runs (list) --

      Information about the runs.

      • (dict) --

        Represents an app on a set of devices with a specific test and configuration.

        • arn (string) --

          The run's ARN.

        • name (string) --

          The run's name.

        • type (string) --

          The run's type.

          Must be one of the following values:

          • BUILTIN_FUZZ: The built-in fuzz type.

          • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

          • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

          • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

          • APPIUM_PYTHON: The Appium Python type.

          • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

          • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

          • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

          • CALABASH: The Calabash type.

          • INSTRUMENTATION: The Instrumentation type.

          • UIAUTOMATION: The uiautomation type.

          • UIAUTOMATOR: The uiautomator type.

          • XCTEST: The XCode test type.

          • XCTEST_UI: The XCode UI test type.

        • platform (string) --

          The run's platform.

          Allowed values include:

          • ANDROID: The Android platform.

          • IOS: The iOS platform.

        • created (datetime) --

          When the run was created.

        • status (string) --

          The run's status.

          Allowed values include:

          • PENDING: A pending status.

          • PENDING_CONCURRENCY: A pending concurrency status.

          • PENDING_DEVICE: A pending device status.

          • PROCESSING: A processing status.

          • SCHEDULING: A scheduling status.

          • PREPARING: A preparing status.

          • RUNNING: A running status.

          • COMPLETED: A completed status.

          • STOPPING: A stopping status.

        • result (string) --

          The run's result.

          Allowed values include:

          • PENDING: A pending condition.

          • PASSED: A passing condition.

          • WARNED: A warning condition.

          • FAILED: A failed condition.

          • SKIPPED: A skipped condition.

          • ERRORED: An error condition.

          • STOPPED: A stopped condition.

        • started (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 unmetered .

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

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

ListSuites (updated) Link ¶
Changes (response)
{'suites': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about suites.

Request Syntax

client.list_suites(
    arn='string',
    nextToken='string'
)
type arn

string

param arn

[REQUIRED]

The suites' ARNs.

type nextToken

string

param nextToken

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.

rtype

dict

returns

Response Syntax

{
    'suites': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
            '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:

          • BUILTIN_FUZZ: The built-in fuzz type.

          • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

          • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

          • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

          • APPIUM_PYTHON: The Appium Python type.

          • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

          • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

          • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

          • CALABASH: The Calabash type.

          • INSTRUMENTATION: The Instrumentation type.

          • UIAUTOMATION: The uiautomation type.

          • UIAUTOMATOR: The uiautomator type.

          • XCTEST: The XCode test type.

          • XCTEST_UI: The XCode UI test type.

        • created (datetime) --

          When the suite was created.

        • status (string) --

          The suite's status.

          Allowed values include:

          • PENDING: A pending status.

          • PENDING_CONCURRENCY: A pending concurrency status.

          • PENDING_DEVICE: A pending device status.

          • PROCESSING: A processing status.

          • SCHEDULING: A scheduling status.

          • PREPARING: A preparing status.

          • RUNNING: A running status.

          • COMPLETED: A completed status.

          • STOPPING: A stopping status.

        • result (string) --

          The suite's result.

          Allowed values include:

          • PENDING: A pending condition.

          • PASSED: A passing condition.

          • WARNED: A warning condition.

          • FAILED: A failed condition.

          • SKIPPED: A skipped condition.

          • ERRORED: An error condition.

          • STOPPED: A stopped condition.

        • started (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.

ListTests (updated) Link ¶
Changes (response)
{'tests': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Gets information about tests.

Request Syntax

client.list_tests(
    arn='string',
    nextToken='string'
)
type arn

string

param arn

[REQUIRED]

The tests' ARNs.

type nextToken

string

param nextToken

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.

rtype

dict

returns

Response Syntax

{
    'tests': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
            '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:

          • BUILTIN_FUZZ: The built-in fuzz type.

          • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

          • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

          • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

          • APPIUM_PYTHON: The Appium Python type.

          • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

          • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

          • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

          • CALABASH: The Calabash type.

          • INSTRUMENTATION: The Instrumentation type.

          • UIAUTOMATION: The uiautomation type.

          • UIAUTOMATOR: The uiautomator type.

          • XCTEST: The XCode test type.

          • XCTEST_UI: The XCode UI test type.

        • created (datetime) --

          When the test was created.

        • status (string) --

          The test's status.

          Allowed values include:

          • PENDING: A pending status.

          • PENDING_CONCURRENCY: A pending concurrency status.

          • PENDING_DEVICE: A pending device status.

          • PROCESSING: A processing status.

          • SCHEDULING: A scheduling status.

          • PREPARING: A preparing status.

          • RUNNING: A running status.

          • COMPLETED: A completed status.

          • STOPPING: A stopping status.

        • result (string) --

          The test's result.

          Allowed values include:

          • PENDING: A pending condition.

          • PASSED: A passing condition.

          • WARNED: A warning condition.

          • FAILED: A failed condition.

          • SKIPPED: A skipped condition.

          • ERRORED: An error condition.

          • STOPPED: A stopped condition.

        • started (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.

ScheduleRun (updated) Link ¶
Changes (response)
{'run': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

Schedules a run.

Request Syntax

client.schedule_run(
    projectArn='string',
    appArn='string',
    devicePoolArn='string',
    name='string',
    test={
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        'testPackageArn': 'string',
        'filter': 'string',
        'parameters': {
            'string': 'string'
        }
    },
    configuration={
        'extraDataPackageArn': 'string',
        'networkProfileArn': 'string',
        'locale': 'string',
        'location': {
            'latitude': 123.0,
            'longitude': 123.0
        },
        'radios': {
            'wifi': True|False,
            'bluetooth': True|False,
            'nfc': True|False,
            'gps': True|False
        },
        'auxiliaryApps': [
            'string',
        ],
        'billingMethod': 'METERED'|'UNMETERED'
    }
)
type projectArn

string

param projectArn

[REQUIRED]

The ARN of the project for the run to be scheduled.

type appArn

string

param appArn

The ARN of the app to schedule a run.

type devicePoolArn

string

param devicePoolArn

[REQUIRED]

The ARN of the device pool for the run to be scheduled.

type name

string

param name

The name for the run to be scheduled.

type test

dict

param test

[REQUIRED]

Information about the test for the run to be scheduled.

  • type (string) -- [REQUIRED]

    The test's type.

    Must be one of the following values:

    • BUILTIN_FUZZ: The built-in fuzz type.

    • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

    • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

    • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

    • APPIUM_PYTHON: The Appium Python type.

    • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

    • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

    • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

    • CALABASH: The Calabash type.

    • INSTRUMENTATION: The Instrumentation type.

    • UIAUTOMATION: The uiautomation type.

    • UIAUTOMATOR: The uiautomator type.

    • XCTEST: The XCode test type.

    • XCTEST_UI: The XCode UI test type.

  • testPackageArn (string) --

    The ARN of the uploaded test that will be run.

  • filter (string) --

    The test's filter.

  • parameters (dict) --

    The test's parameters, such as test framework parameters and fixture settings.

    • (string) --

      • (string) --

type configuration

dict

param configuration

Information about the settings for the run to be scheduled.

  • extraDataPackageArn (string) --

    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.

  • networkProfileArn (string) --

    Reserved for internal use.

  • locale (string) --

    Information about the locale that is used for the run.

  • location (dict) --

    Information about the location that is used for the run.

    • latitude (float) -- [REQUIRED]

      The latitude.

    • longitude (float) -- [REQUIRED]

      The longitude.

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

  • auxiliaryApps (list) --

    A list of auxiliary apps for the run.

    • (string) --

  • billingMethod (string) --

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

rtype

dict

returns

Response Syntax

{
    'run': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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
        }
    }
}

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:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • platform (string) --

        The run's platform.

        Allowed values include:

        • ANDROID: The Android platform.

        • IOS: The iOS platform.

      • created (datetime) --

        When the run was created.

      • status (string) --

        The run's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The run's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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 unmetered .

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

StopRun (updated) Link ¶
Changes (response)
{'run': {'status': {'PENDING_DEVICE', 'PENDING_CONCURRENCY', 'PREPARING'}}}

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.

Request Syntax

client.stop_run(
    arn='string'
)
type arn

string

param arn

[REQUIRED]

Represents the Amazon Resource Name (ARN) of the Device Farm run you wish to stop.

rtype

dict

returns

Response Syntax

{
    'run': {
        'arn': 'string',
        'name': 'string',
        'type': 'BUILTIN_FUZZ'|'BUILTIN_EXPLORER'|'APPIUM_JAVA_JUNIT'|'APPIUM_JAVA_TESTNG'|'APPIUM_PYTHON'|'APPIUM_WEB_JAVA_JUNIT'|'APPIUM_WEB_JAVA_TESTNG'|'APPIUM_WEB_PYTHON'|'CALABASH'|'INSTRUMENTATION'|'UIAUTOMATION'|'UIAUTOMATOR'|'XCTEST'|'XCTEST_UI',
        '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
        }
    }
}

Response Structure

  • (dict) --

    Represents the results of your stop run attempt.

    • run (dict) --

      Represents an app on a set of devices with a specific test and configuration.

      • arn (string) --

        The run's ARN.

      • name (string) --

        The run's name.

      • type (string) --

        The run's type.

        Must be one of the following values:

        • BUILTIN_FUZZ: The built-in fuzz type.

        • BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting with it and capturing screenshots at the same time.

        • APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

        • APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

        • APPIUM_PYTHON: The Appium Python type.

        • APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

        • APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

        • APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

        • CALABASH: The Calabash type.

        • INSTRUMENTATION: The Instrumentation type.

        • UIAUTOMATION: The uiautomation type.

        • UIAUTOMATOR: The uiautomator type.

        • XCTEST: The XCode test type.

        • XCTEST_UI: The XCode UI test type.

      • platform (string) --

        The run's platform.

        Allowed values include:

        • ANDROID: The Android platform.

        • IOS: The iOS platform.

      • created (datetime) --

        When the run was created.

      • status (string) --

        The run's status.

        Allowed values include:

        • PENDING: A pending status.

        • PENDING_CONCURRENCY: A pending concurrency status.

        • PENDING_DEVICE: A pending device status.

        • PROCESSING: A processing status.

        • SCHEDULING: A scheduling status.

        • PREPARING: A preparing status.

        • RUNNING: A running status.

        • COMPLETED: A completed status.

        • STOPPING: A stopping status.

      • result (string) --

        The run's result.

        Allowed values include:

        • PENDING: A pending condition.

        • PASSED: A passing condition.

        • WARNED: A warning condition.

        • FAILED: A failed condition.

        • SKIPPED: A skipped condition.

        • ERRORED: An error condition.

        • STOPPED: A stopped condition.

      • started (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 unmetered .

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