We announced the upcoming end-of-support for AWS SDK for JavaScript v2.
We recommend that you migrate to AWS SDK for JavaScript v3. For dates, additional details, and information on how to migrate, please refer to the linked announcement.

Class: AWS.DeviceFarm

Inherits:
AWS.Service show all
Identifier:
devicefarm
API Version:
2015-06-23
Defined in:
(unknown)

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

Welcome to the AWS Device Farm API documentation, which contains APIs for:

  • Testing on desktop browsers

    Device Farm makes it possible for you to test your web applications on desktop browsers using Selenium. The APIs for desktop browser testing contain TestGrid in their names. For more information, see Testing Web Applications on Selenium with Device Farm.

  • Testing on real mobile devices

    Device Farm makes it possible for you to test apps on physical phones, tablets, and other devices in the cloud. For more information, see the Device Farm Developer Guide.

Sending a Request Using DeviceFarm

var devicefarm = new AWS.DeviceFarm();
devicefarm.createDevicePool(params, function (err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Locking the API Version

In order to ensure that the DeviceFarm object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var devicefarm = new AWS.DeviceFarm({apiVersion: '2015-06-23'});

You can also set the API version globally in AWS.config.apiVersions using the devicefarm service identifier:

AWS.config.apiVersions = {
  devicefarm: '2015-06-23',
  // other service API versions
};

var devicefarm = new AWS.DeviceFarm();

Version:

  • 2015-06-23

Constructor Summary collapse

Property Summary collapse

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService

Constructor Details

new AWS.DeviceFarm(options = {}) ⇒ Object

Constructs a service object. This object has one method for each API operation.

Examples:

Constructing a DeviceFarm object

var devicefarm = new AWS.DeviceFarm({apiVersion: '2015-06-23'});

Options Hash (options):

  • params (map)

    An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.

  • endpoint (String|AWS.Endpoint)

    The endpoint URI to send requests to. The default endpoint is built from the configured region. The endpoint should be a string like 'https://{service}.{region}.amazonaws.com' or an Endpoint object.

  • accessKeyId (String)

    your AWS access key ID.

  • secretAccessKey (String)

    your AWS secret access key.

  • sessionToken (AWS.Credentials)

    the optional AWS session token to sign requests with.

  • credentials (AWS.Credentials)

    the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.

  • credentialProvider (AWS.CredentialProviderChain)

    the provider chain used to resolve credentials if no static credentials property is set.

  • region (String)

    the region to send service requests to. See AWS.DeviceFarm.region for more information.

  • maxRetries (Integer)

    the maximum amount of retries to attempt with a request. See AWS.DeviceFarm.maxRetries for more information.

  • maxRedirects (Integer)

    the maximum amount of redirects to follow with a request. See AWS.DeviceFarm.maxRedirects for more information.

  • sslEnabled (Boolean)

    whether to enable SSL for requests.

  • paramValidation (Boolean|map)

    whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:

    • min [Boolean] — Validates that a value meets the min constraint. This is enabled by default when paramValidation is set to true.
    • max [Boolean] — Validates that a value meets the max constraint.
    • pattern [Boolean] — Validates that a string value matches a regular expression.
    • enum [Boolean] — Validates that a string value matches one of the allowable enum values.
  • computeChecksums (Boolean)

    whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)

  • convertResponseTypes (Boolean)

    whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to true.

  • correctClockSkew (Boolean)

    whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to false.

  • s3ForcePathStyle (Boolean)

    whether to force path style URLs for S3 objects.

  • s3BucketEndpoint (Boolean)

    whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an endpoint to be provided explicitly to the service constructor.

  • s3DisableBodySigning (Boolean)

    whether S3 body signing should be disabled when using signature version v4. Body signing can only be disabled when using https. Defaults to true.

  • s3UsEast1RegionalEndpoint ('legacy'|'regional')

    when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to legacy

  • s3UseArnRegion (Boolean)

    whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to true

  • retryDelayOptions (map)

    A set of options to configure the retry delay on retryable errors. Currently supported options are:

    • base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
    • customBackoff [function] — A custom function that accepts a retry count and error and returns the amount of time to delay in milliseconds. If the result is a non-zero negative value, no further retry attempts will be made. The base option will be ignored if this option is supplied. The function is only called for retryable errors.
  • httpOptions (map)

    A set of options to pass to the low-level HTTP request. Currently supported options are:

    • proxy [String] — the URL to proxy requests through
    • agent [http.Agent, https.Agent] — the Agent object to perform HTTP requests with. Used for connection pooling. Defaults to the global agent (http.globalAgent) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment.
    • connectTimeout [Integer] — Sets the socket to timeout after failing to establish a connection with the server after connectTimeout milliseconds. This timeout has no effect once a socket connection has been established.
    • timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
    • xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
    • xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
  • apiVersion (String, Date)

    a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by apiVersions). Specify 'latest' to use the latest possible version.

  • apiVersions (map<String, String|Date>)

    a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.

  • logger (#write, #log)

    an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests

  • systemClockOffset (Number)

    an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global AWS.config object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds.

  • signatureVersion (String)

    the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.

  • signatureCache (Boolean)

    whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to true.

  • dynamoDbCrc32 (Boolean)

    whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default: true.

  • useAccelerateEndpoint (Boolean)

    Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default: false.

  • clientSideMonitoring (Boolean)

    whether to collect and publish this client's performance metrics of all its API requests.

  • endpointDiscoveryEnabled (Boolean|undefined)

    whether to call operations with endpoints given by service dynamically. Setting this

  • endpointCacheSize (Number)

    the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000

  • hostPrefixEnabled (Boolean)

    whether to marshal request parameters to the prefix of hostname. Defaults to true.

  • stsRegionalEndpoints ('legacy'|'regional')

    whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.

  • useFipsEndpoint (Boolean)

    Enables FIPS compatible endpoints. Defaults to false.

  • useDualstackEndpoint (Boolean)

    Enables IPv6 dualstack endpoint. Defaults to false.

Property Details

endpointAWS.Endpoint (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

  • (AWS.Endpoint)

    an Endpoint object representing the endpoint URL for service requests.

Method Details

createDevicePool(params = {}, callback) ⇒ AWS.Request

Creates a device pool.

Service Reference:

Examples:

To create a new device pool


/* The following example creates a new device pool named MyDevicePool inside an existing project. */

 var params = {
  name: "MyDevicePool", // A device pool contains related devices, such as devices that run only on Android or that run only on iOS.
  description: "My Android devices", 
  projectArn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the project ARN by using the list-projects CLI command.
  rules: [
  ]
 };
 devicefarm.createDevicePool(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    devicePool: {
    }
   }
   */
 });

Calling the createDevicePool operation

var params = {
  name: 'STRING_VALUE', /* required */
  projectArn: 'STRING_VALUE', /* required */
  rules: [ /* required */
    {
      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_VALUE'
    },
    /* more items */
  ],
  description: 'STRING_VALUE',
  maxDevices: 'NUMBER_VALUE'
};
devicefarm.createDevicePool(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      The ARN of the project for the device pool.

    • name — (String)

      The device pool's name.

    • description — (String)

      The device pool's description.

    • rules — (Array<map>)

      The device pool's rules.

      • 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

        Because remote debugging is no longer supported, this filter is ignored.

        Possible values include:
        • "ARN"
        • "PLATFORM"
        • "FORM_FACTOR"
        • "MANUFACTURER"
        • "REMOTE_ACCESS_ENABLED"
        • "REMOTE_DEBUG_ENABLED"
        • "APPIUM_VERSION"
        • "INSTANCE_ARN"
        • "INSTANCE_LABELS"
        • "FLEET_TYPE"
        • "OS_VERSION"
        • "MODEL"
        • "AVAILABILITY"
      • 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.

        Possible values include:
        • "EQUALS"
        • "LESS_THAN"
        • "LESS_THAN_OR_EQUALS"
        • "GREATER_THAN"
        • "GREATER_THAN_OR_EQUALS"
        • "IN"
        • "NOT_IN"
        • "CONTAINS"
      • 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 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • devicePool — (map)

        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:

          • CURATED: A device pool that is created and managed by AWS Device Farm.

          • PRIVATE: A device pool that is created and managed by the device pool developer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • rules — (Array<map>)

          Information about the device pool's rules.

          • 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

            Because remote debugging is no longer supported, this filter is ignored.

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"
          • 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.

            Possible values include:
            • "EQUALS"
            • "LESS_THAN"
            • "LESS_THAN_OR_EQUALS"
            • "GREATER_THAN"
            • "GREATER_THAN_OR_EQUALS"
            • "IN"
            • "NOT_IN"
            • "CONTAINS"
          • 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 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createInstanceProfile(params = {}, callback) ⇒ AWS.Request

Creates a profile that can be applied to one or more private fleet device instances.

Service Reference:

Examples:

Calling the createInstanceProfile operation

var params = {
  name: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  excludeAppPackagesFromCleanup: [
    'STRING_VALUE',
    /* more items */
  ],
  packageCleanup: true || false,
  rebootAfterUse: true || false
};
devicefarm.createInstanceProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      The name of your instance profile.

    • description — (String)

      The description of your instance profile.

    • packageCleanup — (Boolean)

      When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

    • excludeAppPackagesFromCleanup — (Array<String>)

      An array of strings that specifies the list of app packages that should not be cleaned up from the device after a test run.

      The list of packages is considered only if you set packageCleanup to true.

    • rebootAfterUse — (Boolean)

      When set to true, Device Farm reboots the instance after a test run. The default value is true.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • instanceProfile — (map)

        An object that contains information about your instance profile.

        • arn — (String)

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

        • packageCleanup — (Boolean)

          When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

        • excludeAppPackagesFromCleanup — (Array<String>)

          An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

          The list of packages is considered only if you set packageCleanup to true.

        • rebootAfterUse — (Boolean)

          When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createNetworkProfile(params = {}, callback) ⇒ AWS.Request

Creates a network profile.

Service Reference:

Examples:

Calling the createNetworkProfile operation

var params = {
  name: 'STRING_VALUE', /* required */
  projectArn: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  downlinkBandwidthBits: 'NUMBER_VALUE',
  downlinkDelayMs: 'NUMBER_VALUE',
  downlinkJitterMs: 'NUMBER_VALUE',
  downlinkLossPercent: 'NUMBER_VALUE',
  type: CURATED | PRIVATE,
  uplinkBandwidthBits: 'NUMBER_VALUE',
  uplinkDelayMs: 'NUMBER_VALUE',
  uplinkJitterMs: 'NUMBER_VALUE',
  uplinkLossPercent: 'NUMBER_VALUE'
};
devicefarm.createNetworkProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      The Amazon Resource Name (ARN) of the project for which you want to create a network profile.

    • name — (String)

      The name for the new network profile.

    • description — (String)

      The description of the network profile.

    • type — (String)

      The type of network profile to create. Valid values are listed here.

      Possible values include:
      • "CURATED"
      • "PRIVATE"
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • networkProfile — (map)

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

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createProject(params = {}, callback) ⇒ AWS.Request

Creates a project.

Service Reference:

Examples:

To create a new project


/* The following example creates a new project named MyProject. */

 var params = {
  name: "MyProject"// 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.
 };
 devicefarm.createProject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    project: {
     name: "MyProject", 
     arn: "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE", 
     created: <Date Representation>
    }
   }
   */
 });

Calling the createProject operation

var params = {
  name: 'STRING_VALUE', /* required */
  defaultJobTimeoutMinutes: 'NUMBER_VALUE',
  vpcConfig: {
    securityGroupIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    subnetIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    vpcId: 'STRING_VALUE' /* required */
  }
};
devicefarm.createProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      The project's name.

    • defaultJobTimeoutMinutes — (Integer)

      Sets the execution timeout value (in minutes) for a project. All test runs in this project use the specified execution timeout value unless overridden when scheduling a run.

    • vpcConfig — (map)

      The VPC security groups and subnets that are attached to a project.

      • securityGroupIdsrequired — (Array<String>)

        An array of one or more security groups IDs in your Amazon VPC.

      • subnetIdsrequired — (Array<String>)

        An array of one or more subnet IDs in your Amazon VPC.

      • vpcIdrequired — (String)

        The ID of the Amazon VPC.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • project — (map)

        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 executes before it times out. The default value is 150 minutes.

        • created — (Date)

          When the project was created.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createRemoteAccessSession(params = {}, callback) ⇒ AWS.Request

Specifies and starts a remote access session.

Service Reference:

Examples:

To create a remote access session


/* The following example creates a remote access session named MySession. */

 var params = {
  name: "MySession", 
  configuration: {
   billingMethod: "METERED"
  }, 
  deviceArn: "arn:aws:devicefarm:us-west-2::device:123EXAMPLE", // You can get the device ARN by using the list-devices CLI command.
  projectArn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.createRemoteAccessSession(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    remoteAccessSession: {
    }
   }
   */
 });

Calling the createRemoteAccessSession operation

var params = {
  deviceArn: 'STRING_VALUE', /* required */
  projectArn: 'STRING_VALUE', /* required */
  clientId: 'STRING_VALUE',
  configuration: {
    billingMethod: METERED | UNMETERED,
    vpceConfigurationArns: [
      'STRING_VALUE',
      /* more items */
    ]
  },
  instanceArn: 'STRING_VALUE',
  interactionMode: INTERACTIVE | NO_VIDEO | VIDEO_ONLY,
  name: 'STRING_VALUE',
  remoteDebugEnabled: true || false,
  remoteRecordAppArn: 'STRING_VALUE',
  remoteRecordEnabled: true || false,
  skipAppResign: true || false,
  sshPublicKey: 'STRING_VALUE'
};
devicefarm.createRemoteAccessSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      The Amazon Resource Name (ARN) of the project for which you want to create a remote access session.

    • deviceArn — (String)

      The ARN of the device for which you want to create a remote access session.

    • instanceArn — (String)

      The Amazon Resource Name (ARN) of the device instance for which you want to create a remote access session.

    • sshPublicKey — (String)

      Ignored. The public key of the ssh key pair you want to use for connecting to remote devices in your remote debugging session. This key is required only if remoteDebugEnabled is set to true.

      Remote debugging is no longer supported.

    • remoteDebugEnabled — (Boolean)

      Set to true if you want to access devices remotely for debugging in your remote access session.

      Remote debugging is no longer supported.

    • remoteRecordEnabled — (Boolean)

      Set to true to enable remote recording for the remote access session.

    • remoteRecordAppArn — (String)

      The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.

    • name — (String)

      The name of the remote access session to create.

    • clientId — (String)

      Unique identifier for the client. If you want access to multiple devices on the same client, you should pass the same clientId value in each call to CreateRemoteAccessSession. This identifier is required only if remoteDebugEnabled is set to true.

      Remote debugging is no longer supported.

    • configuration — (map)

      The configuration information for the remote access session request.

      • billingMethod — (String)

        The billing method for the remote access session.

        Possible values include:
        • "METERED"
        • "UNMETERED"
      • vpceConfigurationArns — (Array<String>)

        An array of ARNs included in the VPC endpoint configuration.

    • interactionMode — (String)

      The interaction mode of the remote access session. Valid values are:

      • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

      • NO_VIDEO: You are connected to the device, but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

      • VIDEO_ONLY: You can view the screen, but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

      Possible values include:
      • "INTERACTIVE"
      • "NO_VIDEO"
      • "VIDEO_ONLY"
    • skipAppResign — (Boolean)

      When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

      For more information on how Device Farm modifies your uploads during tests, see Do you modify my app?

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • remoteAccessSession — (map)

        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 — (Date)

          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:

          • PENDING.

          • PENDING_CONCURRENCY.

          • PENDING_DEVICE.

          • PROCESSING.

          • SCHEDULING.

          • PREPARING.

          • RUNNING.

          • COMPLETED.

          • STOPPING.

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The result of the remote access session. Can be any of the following:

          • PENDING.

          • PASSED.

          • WARNED.

          • FAILED.

          • SKIPPED.

          • ERRORED.

          • STOPPED.

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • message — (String)

          A message about the remote access session.

        • started — (Date)

          The date and time the remote access session was started.

        • stopped — (Date)

          The date and time the remote access session was stopped.

        • device — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • remoteDebugEnabled — (Boolean)

          This flag is set to true if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

        • remoteRecordEnabled — (Boolean)

          This flag is set to true if remote recording is enabled for the remote access session.

        • remoteRecordAppArn — (String)

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

          Remote debugging is no longer supported.

        • clientId — (String)

          Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

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

          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          The number of minutes a device is used in a remote access session (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.

          Remote debugging is no longer supported.

        • interactionMode — (String)

          The interaction mode of the remote access session. Valid values are:

          • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

          • NO_VIDEO: You are connected to the device, but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

          • VIDEO_ONLY: You can view the screen, but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

          Possible values include:
          • "INTERACTIVE"
          • "NO_VIDEO"
          • "VIDEO_ONLY"
        • skipAppResign — (Boolean)

          When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createTestGridProject(params = {}, callback) ⇒ AWS.Request

Creates a Selenium testing project. Projects are used to track TestGridSession instances.

Service Reference:

Examples:

Calling the createTestGridProject operation

var params = {
  name: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  vpcConfig: {
    securityGroupIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    subnetIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    vpcId: 'STRING_VALUE' /* required */
  }
};
devicefarm.createTestGridProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      Human-readable name of the Selenium testing project.

    • description — (String)

      Human-readable description of the project.

    • vpcConfig — (map)

      The VPC security groups and subnets that are attached to a project.

      • securityGroupIdsrequired — (Array<String>)

        A list of VPC security group IDs in your Amazon VPC.

      • subnetIdsrequired — (Array<String>)

        A list of VPC subnet IDs in your Amazon VPC.

      • vpcIdrequired — (String)

        The ID of the Amazon VPC.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridProject — (map)

        ARN of the Selenium testing project that was created.

        • arn — (String)

          The ARN for the project.

        • name — (String)

          A human-readable name for the project.

        • description — (String)

          A human-readable description for the project.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            A list of VPC security group IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            A list of VPC subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

        • created — (Date)

          When the project was created.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createTestGridUrl(params = {}, callback) ⇒ AWS.Request

Creates a signed, short-term URL that can be passed to a Selenium RemoteWebDriver constructor.

Service Reference:

Examples:

Calling the createTestGridUrl operation

var params = {
  expiresInSeconds: 'NUMBER_VALUE', /* required */
  projectArn: 'STRING_VALUE' /* required */
};
devicefarm.createTestGridUrl(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createUpload(params = {}, callback) ⇒ AWS.Request

Uploads an app or test scripts.

Service Reference:

Examples:

To create a new test package upload


/* The following example creates a new Appium Python test package upload inside an existing project. */

 var params = {
  name: "MyAppiumPythonUpload", 
  type: "APPIUM_PYTHON_TEST_PACKAGE", 
  projectArn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.createUpload(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    upload: {
     name: "MyAppiumPythonUpload", 
     type: "APPIUM_PYTHON_TEST_PACKAGE", 
     arn: "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE", 
     created: <Date Representation>, 
     status: "INITIALIZED", 
     url: "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789101%3Aproject%3A5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789101%3Aupload%3A5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/b5340a65-3da7-4da6-a26e-12345EXAMPLE/MyAppiumPythonUpload?AWSAccessKeyId=1234567891011EXAMPLE&Expires=1472747804&Signature=1234567891011EXAMPLE"
    }
   }
   */
 });

Calling the createUpload operation

var params = {
  name: 'STRING_VALUE', /* required */
  projectArn: 'STRING_VALUE', /* required */
  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, /* required */
  contentType: 'STRING_VALUE'
};
devicefarm.createUpload(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      The ARN of the project for the upload.

    • name — (String)

      The upload's file name. The name should not contain any forward slashes (/). If you are uploading an iOS app, the file name must end with the .ipa extension. If you are uploading an Android app, the file name must end with the .apk extension. For all others, the file name must end with the .zip file extension.

    • type — (String)

      The upload's upload type.

      Must be one of the following values:

      • 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

      If you call CreateUpload with WEB_APP specified, AWS Device Farm throws an ArgumentException error.

      Possible values include:
      • "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)

      The upload's content type (for example, application/octet-stream).

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • upload — (map)

        The newly created upload.

        • arn — (String)

          The upload's ARN.

        • name — (String)

          The upload's file name.

        • created — (Date)

          When the upload was created.

        • type — (String)

          The upload's type.

          Must be one of the following values:

          • 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

          Possible values include:
          • "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 — (String)

          The upload's status.

          Must be one of the following values:

          • FAILED

          • INITIALIZED

          • PROCESSING

          • SUCCEEDED

          Possible values include:
          • "INITIALIZED"
          • "PROCESSING"
          • "SUCCEEDED"
          • "FAILED"
        • url — (String)

          The presigned Amazon S3 URL that was used to store a file using a 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:

          • CURATED: An upload managed by AWS Device Farm.

          • PRIVATE: An upload managed by the AWS Device Farm customer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createVPCEConfiguration(params = {}, callback) ⇒ AWS.Request

Creates a configuration record in Device Farm for your Amazon Virtual Private Cloud (VPC) endpoint.

Service Reference:

Examples:

Calling the createVPCEConfiguration operation

var params = {
  serviceDnsName: 'STRING_VALUE', /* required */
  vpceConfigurationName: 'STRING_VALUE', /* required */
  vpceServiceName: 'STRING_VALUE', /* required */
  vpceConfigurationDescription: 'STRING_VALUE'
};
devicefarm.createVPCEConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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 in your AWS account that you want Device Farm to test.

    • serviceDnsName — (String)

      The DNS name of the service running in your VPC that you want Device Farm to test.

    • vpceConfigurationDescription — (String)

      An optional description that provides details about your VPC endpoint configuration.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • vpceConfiguration — (map)

        An object that contains 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 in 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 that provides details about your VPC endpoint configuration.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteDevicePool(params = {}, callback) ⇒ AWS.Request

Deletes a device pool given the pool ARN. Does not allow deletion of curated pools owned by the system.

Service Reference:

Examples:

To delete a device pool


/* The following example deletes a specific device pool. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID"// You can get the device pool ARN by using the list-device-pools CLI command.
 };
 devicefarm.deleteDevicePool(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the deleteDevicePool operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteDevicePool(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      Represents the Amazon Resource Name (ARN) of the Device Farm device pool to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteInstanceProfile(params = {}, callback) ⇒ AWS.Request

Deletes a profile that can be applied to one or more private device instances.

Service Reference:

Examples:

Calling the deleteInstanceProfile operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteInstanceProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the instance profile you are requesting to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteNetworkProfile(params = {}, callback) ⇒ AWS.Request

Deletes a network profile.

Service Reference:

Examples:

Calling the deleteNetworkProfile operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteNetworkProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The ARN of the network profile to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteProject(params = {}, callback) ⇒ AWS.Request

Deletes an AWS Device Farm project, given the project ARN.

Deleting this resource does not stop an in-progress run.

Service Reference:

Examples:

To delete a project


/* The following example deletes a specific project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.deleteProject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the deleteProject operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      Represents the Amazon Resource Name (ARN) of the Device Farm project to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteRemoteAccessSession(params = {}, callback) ⇒ AWS.Request

Deletes a completed remote access session and its results.

Service Reference:

Examples:

To delete a specific remote access session


/* The following example deletes a specific remote access session. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456"// You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
 };
 devicefarm.deleteRemoteAccessSession(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the deleteRemoteAccessSession operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteRemoteAccessSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the session for which you want to delete remote access.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteRun(params = {}, callback) ⇒ AWS.Request

Deletes the run, given the run ARN.

Deleting this resource does not stop an in-progress run.

Service Reference:

Examples:

To delete a run


/* The following example deletes a specific test run. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456"// You can get the run ARN by using the list-runs CLI command.
 };
 devicefarm.deleteRun(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the deleteRun operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) for the run to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTestGridProject(params = {}, callback) ⇒ AWS.Request

Deletes a Selenium testing project and all content generated under it.

You cannot undo this operation.

Note: You cannot delete a project if it has active sessions.

Service Reference:

Examples:

Calling the deleteTestGridProject operation

var params = {
  projectArn: 'STRING_VALUE' /* required */
};
devicefarm.deleteTestGridProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteUpload(params = {}, callback) ⇒ AWS.Request

Deletes an upload given the upload ARN.

Service Reference:

Examples:

To delete a specific upload


/* The following example deletes a specific upload. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456"// You can get the upload ARN by using the list-uploads CLI command.
 };
 devicefarm.deleteUpload(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the deleteUpload operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteUpload(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      Represents the Amazon Resource Name (ARN) of the Device Farm upload to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteVPCEConfiguration(params = {}, callback) ⇒ AWS.Request

Deletes a configuration for your Amazon Virtual Private Cloud (VPC) endpoint.

Service Reference:

Examples:

Calling the deleteVPCEConfiguration operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.deleteVPCEConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to delete.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getAccountSettings(params = {}, callback) ⇒ AWS.Request

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

Service Reference:

Examples:

To get information about account settings


/* The following example returns information about your Device Farm account settings. */

 var params = {
 };
 devicefarm.getAccountSettings(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    accountSettings: {
     awsAccountNumber: "123456789101", 
     unmeteredDevices: {
      "ANDROID": 1, 
      "IOS": 2
     }
    }
   }
   */
 });

Calling the getAccountSettings operation

var params = {
};
devicefarm.getAccountSettings(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • accountSettings — (map)

        The account settings.

        • awsAccountNumber — (String)

          The AWS account number specified in the AccountSettings container.

        • unmeteredDevices — (map<Integer>)

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

        • unmeteredRemoteAccessDevices — (map<Integer>)

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

        • maxJobTimeoutMinutes — (Integer)

          The maximum number of minutes a test run executes before it times out.

        • trialMinutes — (map)

          Information about an AWS account's usage of free trial device minutes.

          • total — (Float)

            The total number of free trial minutes that the account started with.

          • remaining — (Float)

            The number of free trial minutes remaining in the account.

        • maxSlots — (map<Integer>)

          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.

        • defaultJobTimeoutMinutes — (Integer)

          The default number of minutes (at the account level) a test run executes before it times out. The default value is 150 minutes.

        • skipAppResign — (Boolean)

          When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getDevice(params = {}, callback) ⇒ AWS.Request

Gets information about a unique device type.

Service Reference:

Examples:

To get information about a device


/* The following example returns information about a specific device. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2::device:123EXAMPLE"
 };
 devicefarm.getDevice(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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
     }
    }
   }
   */
 });

Calling the getDevice operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getDevice(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The device type's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • device — (map)

        An object that contains information about the requested 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:

          • PHONE

          • TABLET

          Possible values include:
          • "PHONE"
          • "TABLET"
        • platform — (String)

          The device's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • os — (String)

          The device's operating system type.

        • cpu — (map)

          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 — (map)

          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.

          Remote debugging is no longer supported.

        • fleetType — (String)

          The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

        • fleetName — (String)

          The name of the fleet to which this device belongs.

        • instances — (Array<map>)

          The instances that belong to this device.

          • arn — (String)

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

          • deviceArn — (String)

            The ARN of the device.

          • labels — (Array<String>)

            An array of strings that describe the device instance.

          • status — (String)

            The status of the device instance. Valid values are listed here.

            Possible values include:
            • "IN_USE"
            • "PREPARING"
            • "AVAILABLE"
            • "NOT_AVAILABLE"
          • udid — (String)

            Unique device identifier for the device instance.

          • instanceProfile — (map)

            A object that contains information about the instance profile.

            • arn — (String)

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

            • packageCleanup — (Boolean)

              When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

            • excludeAppPackagesFromCleanup — (Array<String>)

              An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

              The list of packages is considered only if you set packageCleanup to true.

            • rebootAfterUse — (Boolean)

              When set to true, Device Farm reboots 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)

          Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

          Possible values include:
          • "TEMPORARY_NOT_AVAILABLE"
          • "BUSY"
          • "AVAILABLE"
          • "HIGHLY_AVAILABLE"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getDeviceInstance(params = {}, callback) ⇒ AWS.Request

Returns information about a device instance that belongs to a private device fleet.

Service Reference:

Examples:

Calling the getDeviceInstance operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getDeviceInstance(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the instance you're requesting information about.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • deviceInstance — (map)

        An object that contains information about your device instance.

        • arn — (String)

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

        • deviceArn — (String)

          The ARN of the device.

        • labels — (Array<String>)

          An array of strings that describe the device instance.

        • status — (String)

          The status of the device instance. Valid values are listed here.

          Possible values include:
          • "IN_USE"
          • "PREPARING"
          • "AVAILABLE"
          • "NOT_AVAILABLE"
        • udid — (String)

          Unique device identifier for the device instance.

        • instanceProfile — (map)

          A object that contains information about the instance profile.

          • arn — (String)

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

          • packageCleanup — (Boolean)

            When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

          • excludeAppPackagesFromCleanup — (Array<String>)

            An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

            The list of packages is considered only if you set packageCleanup to true.

          • rebootAfterUse — (Boolean)

            When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getDevicePool(params = {}, callback) ⇒ AWS.Request

Gets information about a device pool.

Service Reference:

Examples:

To get information about a device pool


/* The following example returns information about a specific device pool, given a project ARN. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can obtain the project ARN by using the list-projects CLI command.
 };
 devicefarm.getDevicePool(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    devicePool: {
    }
   }
   */
 });

Calling the getDevicePool operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getDevicePool(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The device pool's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • devicePool — (map)

        An object that contains information about the requested 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:

          • CURATED: A device pool that is created and managed by AWS Device Farm.

          • PRIVATE: A device pool that is created and managed by the device pool developer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • rules — (Array<map>)

          Information about the device pool's rules.

          • 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

            Because remote debugging is no longer supported, this filter is ignored.

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"
          • 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.

            Possible values include:
            • "EQUALS"
            • "LESS_THAN"
            • "LESS_THAN_OR_EQUALS"
            • "GREATER_THAN"
            • "GREATER_THAN_OR_EQUALS"
            • "IN"
            • "NOT_IN"
            • "CONTAINS"
          • 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 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getDevicePoolCompatibility(params = {}, callback) ⇒ AWS.Request

Gets information about compatibility with a device pool.

Service Reference:

Examples:

To get information about the compatibility of a device pool


/* The following example returns information about the compatibility of a specific device pool, given its ARN. */

 var params = {
  appArn: "arn:aws:devicefarm:us-west-2::app:123-456-EXAMPLE-GUID", 
  devicePoolArn: "arn:aws:devicefarm:us-west-2::devicepool:123-456-EXAMPLE-GUID", // You can get the device pool ARN by using the list-device-pools CLI command.
  testType: "APPIUM_PYTHON"
 };
 devicefarm.getDevicePoolCompatibility(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    compatibleDevices: [
    ], 
    incompatibleDevices: [
    ]
   }
   */
 });

Calling the getDevicePoolCompatibility operation

var params = {
  devicePoolArn: 'STRING_VALUE', /* required */
  appArn: 'STRING_VALUE',
  configuration: {
    auxiliaryApps: [
      'STRING_VALUE',
      /* more items */
    ],
    billingMethod: METERED | UNMETERED,
    customerArtifactPaths: {
      androidPaths: [
        'STRING_VALUE',
        /* more items */
      ],
      deviceHostPaths: [
        'STRING_VALUE',
        /* more items */
      ],
      iosPaths: [
        'STRING_VALUE',
        /* more items */
      ]
    },
    extraDataPackageArn: 'STRING_VALUE',
    locale: 'STRING_VALUE',
    location: {
      latitude: 'NUMBER_VALUE', /* required */
      longitude: 'NUMBER_VALUE' /* required */
    },
    networkProfileArn: 'STRING_VALUE',
    radios: {
      bluetooth: true || false,
      gps: true || false,
      nfc: true || false,
      wifi: true || false
    },
    vpceConfigurationArns: [
      'STRING_VALUE',
      /* more items */
    ]
  },
  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, /* required */
    filter: 'STRING_VALUE',
    parameters: {
      '<String>': 'STRING_VALUE',
      /* '<String>': ... */
    },
    testPackageArn: 'STRING_VALUE',
    testSpecArn: 'STRING_VALUE'
  },
  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
};
devicefarm.getDevicePoolCompatibility(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • devicePoolArn — (String)

      The device pool's ARN.

    • appArn — (String)

      The ARN of the app that is associated with the specified device pool.

    • testType — (String)

      The test type for the specified device pool.

      Allowed values include the following:

      • BUILTIN_FUZZ.

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

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

      Possible values include:
      • "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 — (map)

      Information about the uploaded test to be run against the device pool.

      • typerequired — (String)

        The test's type.

        Must be one of the following values:

        • BUILTIN_FUZZ

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

        • 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

        Possible values include:
        • "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)

        The ARN of the uploaded test to be run.

      • testSpecArn — (String)

        The ARN of the YAML-formatted test specification.

      • filter — (String)

        The test's filter.

      • parameters — (map<String>)

        The test's parameters, such as test framework parameters and fixture settings. Parameters are represented by name-value pairs of strings.

        For all tests:

        • app_performance_monitoring: Performance monitoring is enabled by default. Set this parameter to false to disable it.

        For Calabash tests:

        • profile: A cucumber profile (for example, my_profile_name).

        • tags: You can limit execution to features or scenarios that have (or don't have) certain tags (for example, @smoke or @smoke,~@wip).

        For Appium tests (all types):

        • appium_version: The Appium version. Currently supported values are 1.6.5 (and later), latest, and default.

          • latest runs the latest Appium version supported by Device Farm (1.9.1).

          • For default, Device Farm selects a compatible version of Appium for the device. The current behavior is to run 1.7.2 on Android devices and iOS 9 and earlier and 1.7.2 for iOS 10 and later.

          • This behavior is subject to change.

        For fuzz tests (Android only):

        • event_count: The number of events, between 1 and 10000, that the UI fuzz test should perform.

        • throttle: The time, in ms, between 0 and 1000, that the UI fuzz test should wait between events.

        • seed: A seed to use for randomizing the UI fuzz test. Using the same seed value between tests ensures identical event sequences.

        For Explorer tests:

        • username: A user name to use if the Explorer encounters a login form. If not supplied, no user name is inserted.

        • password: A password to use if the Explorer encounters a login form. If not supplied, no password is inserted.

        For Instrumentation:

        • filter: A test filter string. Examples:

          • Running a single test case: com.android.abc.Test1

          • Running a single test: com.android.abc.Test1#smoke

          • Running multiple tests: com.android.abc.Test1,com.android.abc.Test2

        For XCTest and XCTestUI:

        • filter: A test filter string. Examples:

          • Running a single test class: LoginTests

          • Running a multiple test classes: LoginTests,SmokeTests

          • Running a single test: LoginTests/testValid

          • Running multiple tests: LoginTests/testValid,LoginTests/testInvalid

        For UIAutomator:

        • filter: A test filter string. Examples:

          • Running a single test case: com.android.abc.Test1

          • Running a single test: com.android.abc.Test1#smoke

          • Running multiple tests: com.android.abc.Test1,com.android.abc.Test2

    • configuration — (map)

      An object that contains information about the settings for a run.

      • extraDataPackageArn — (String)

        The ARN of the extra data for the run. The extra data is a .zip file that AWS Device Farm extracts 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 — (map)

        Information about the location that is used for the run.

        • latituderequired — (Float)

          The latitude.

        • longituderequired — (Float)

          The longitude.

      • vpceConfigurationArns — (Array<String>)

        An array of ARNs for your VPC endpoint configurations.

      • customerArtifactPaths — (map)

        Input CustomerArtifactPaths object for the scheduled run configuration.

        • iosPaths — (Array<String>)

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

        • androidPaths — (Array<String>)

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

        • deviceHostPaths — (Array<String>)

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

      • radios — (map)

        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 — (Array<String>)

        A list of upload ARNs for app packages to be installed with your app.

      • billingMethod — (String)

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

        Note: If you have purchased unmetered device slots, you must set this parameter to unmetered to make use of them. Otherwise, your run counts against your metered time.
        Possible values include:
        • "METERED"
        • "UNMETERED"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • compatibleDevices — (Array<map>)

        Information about compatible devices.

        • device — (map)

          The device (phone or tablet) 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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • compatible — (Boolean)

          Whether the result was compatible with the device pool.

        • incompatibilityMessages — (Array<map>)

          Information about the compatibility.

          • message — (String)

            A message about the incompatibility.

          • type — (String)

            The type of incompatibility.

            Allowed values include:

            • ARN

            • FORM_FACTOR (for example, phone or tablet)

            • MANUFACTURER

            • PLATFORM (for example, Android or iOS)

            • REMOTE_ACCESS_ENABLED

            • APPIUM_VERSION

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"
      • incompatibleDevices — (Array<map>)

        Information about incompatible devices.

        • device — (map)

          The device (phone or tablet) 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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • compatible — (Boolean)

          Whether the result was compatible with the device pool.

        • incompatibilityMessages — (Array<map>)

          Information about the compatibility.

          • message — (String)

            A message about the incompatibility.

          • type — (String)

            The type of incompatibility.

            Allowed values include:

            • ARN

            • FORM_FACTOR (for example, phone or tablet)

            • MANUFACTURER

            • PLATFORM (for example, Android or iOS)

            • REMOTE_ACCESS_ENABLED

            • APPIUM_VERSION

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getInstanceProfile(params = {}, callback) ⇒ AWS.Request

Returns information about the specified instance profile.

Service Reference:

Examples:

Calling the getInstanceProfile operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getInstanceProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of an instance profile.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • instanceProfile — (map)

        An object that contains information about an instance profile.

        • arn — (String)

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

        • packageCleanup — (Boolean)

          When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

        • excludeAppPackagesFromCleanup — (Array<String>)

          An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

          The list of packages is considered only if you set packageCleanup to true.

        • rebootAfterUse — (Boolean)

          When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getJob(params = {}, callback) ⇒ AWS.Request

Gets information about a job.

Service Reference:

Examples:

To get information about a job


/* The following example returns information about a specific job. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2::job:123-456-EXAMPLE-GUID"// You can get the job ARN by using the list-jobs CLI command.
 };
 devicefarm.getJob(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    job: {
    }
   }
   */
 });

Calling the getJob operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The job's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • job — (map)

        An object that contains information about the requested job.

        • 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

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

          • 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

          Possible values include:
          • "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 — (Date)

          When the job was created.

        • status — (String)

          The job's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The job's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The job's start time.

        • stopped — (Date)

          The job's stop time.

        • counters — (map)

          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 — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • deviceMinutes — (map)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getNetworkProfile(params = {}, callback) ⇒ AWS.Request

Returns information about a network profile.

Service Reference:

Examples:

Calling the getNetworkProfile operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getNetworkProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The ARN of the network profile to return information about.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • networkProfile — (map)

        The 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 here.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getOfferingStatus(params = {}, callback) ⇒ AWS.Request

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. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

Service Reference:

Examples:

To get status information about device offerings


/* The following example returns information about Device Farm offerings available to your account. */

 var params = {
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE="// A dynamically generated value, used for paginating results.
 };
 devicefarm.getOfferingStatus(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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: <Date Representation>, 
       offering: {
        type: "RECURRING", 
        description: "Android Remote Access Unmetered Device Slot", 
        id: "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", 
        platform: "ANDROID"
       }, 
       quantity: 1
      }
    }
   }
   */
 });

Calling the getOfferingStatus operation

var params = {
  nextToken: 'STRING_VALUE'
};
devicefarm.getOfferingStatus(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • current — (map<map>)

        When specified, gets the offering status for the current period.

        • type — (String)

          The type specified for the offering status.

          Possible values include:
          • "PURCHASE"
          • "RENEW"
          • "SYSTEM"
        • offering — (map)

          Represents the metadata of an offering status.

          • id — (String)

            The ID that corresponds to a device offering.

          • description — (String)

            A string that describes the offering.

          • type — (String)

            The type of offering (for example, RECURRING) for a device.

            Possible values include:
            • "RECURRING"
          • platform — (String)

            The platform of the device (for example, ANDROID or IOS).

            Possible values include:
            • "ANDROID"
            • "IOS"
          • recurringCharges — (Array<map>)

            Specifies whether there are recurring charges for the offering.

            • cost — (map)

              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.

                Possible values include:
                • "USD"
            • frequency — (String)

              The frequency in which charges recur.

              Possible values include:
              • "MONTHLY"
        • quantity — (Integer)

          The number of available devices in the offering.

        • effectiveOn — (Date)

          The date on which the offering is effective.

      • nextPeriod — (map<map>)

        When specified, gets the offering status for the next period.

        • type — (String)

          The type specified for the offering status.

          Possible values include:
          • "PURCHASE"
          • "RENEW"
          • "SYSTEM"
        • offering — (map)

          Represents the metadata of an offering status.

          • id — (String)

            The ID that corresponds to a device offering.

          • description — (String)

            A string that describes the offering.

          • type — (String)

            The type of offering (for example, RECURRING) for a device.

            Possible values include:
            • "RECURRING"
          • platform — (String)

            The platform of the device (for example, ANDROID or IOS).

            Possible values include:
            • "ANDROID"
            • "IOS"
          • recurringCharges — (Array<map>)

            Specifies whether there are recurring charges for the offering.

            • cost — (map)

              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.

                Possible values include:
                • "USD"
            • frequency — (String)

              The frequency in which charges recur.

              Possible values include:
              • "MONTHLY"
        • quantity — (Integer)

          The number of available devices in the offering.

        • effectiveOn — (Date)

          The date on which the offering is effective.

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

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getProject(params = {}, callback) ⇒ AWS.Request

Gets information about a project.

Service Reference:

Examples:

To get information about a project


/* The following example gets information about a specific project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.getProject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    project: {
     name: "My Project", 
     arn: "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE", 
     created: <Date Representation>
    }
   }
   */
 });

Calling the getProject operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The project's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • project — (map)

        The project to get information about.

        • 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 executes before it times out. The default value is 150 minutes.

        • created — (Date)

          When the project was created.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getRemoteAccessSession(params = {}, callback) ⇒ AWS.Request

Returns a link to a currently running remote access session.

Service Reference:

Examples:

To get a remote access session


/* The following example gets a specific remote access session. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456"// You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
 };
 devicefarm.getRemoteAccessSession(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    remoteAccessSession: {
    }
   }
   */
 });

Calling the getRemoteAccessSession operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getRemoteAccessSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the remote access session about which you want to get session information.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • remoteAccessSession — (map)

        A container that lists detailed 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 — (Date)

          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:

          • PENDING.

          • PENDING_CONCURRENCY.

          • PENDING_DEVICE.

          • PROCESSING.

          • SCHEDULING.

          • PREPARING.

          • RUNNING.

          • COMPLETED.

          • STOPPING.

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The result of the remote access session. Can be any of the following:

          • PENDING.

          • PASSED.

          • WARNED.

          • FAILED.

          • SKIPPED.

          • ERRORED.

          • STOPPED.

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • message — (String)

          A message about the remote access session.

        • started — (Date)

          The date and time the remote access session was started.

        • stopped — (Date)

          The date and time the remote access session was stopped.

        • device — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • remoteDebugEnabled — (Boolean)

          This flag is set to true if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

        • remoteRecordEnabled — (Boolean)

          This flag is set to true if remote recording is enabled for the remote access session.

        • remoteRecordAppArn — (String)

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

          Remote debugging is no longer supported.

        • clientId — (String)

          Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

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

          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          The number of minutes a device is used in a remote access session (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.

          Remote debugging is no longer supported.

        • interactionMode — (String)

          The interaction mode of the remote access session. Valid values are:

          • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

          • NO_VIDEO: You are connected to the device, but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

          • VIDEO_ONLY: You can view the screen, but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

          Possible values include:
          • "INTERACTIVE"
          • "NO_VIDEO"
          • "VIDEO_ONLY"
        • skipAppResign — (Boolean)

          When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getRun(params = {}, callback) ⇒ AWS.Request

Gets information about a run.

Service Reference:

Examples:

To get information about a test run


/* The following example gets information about a specific test run. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE"// You can get the run ARN by using the list-runs CLI command.
 };
 devicefarm.getRun(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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: <Date Representation>, 
     deviceMinutes: {
      metered: 0.0, 
      total: 0.0, 
      unmetered: 0.0
     }, 
     platform: "ANDROID", 
     result: "PENDING", 
     status: "RUNNING", 
     totalJobs: 3
    }
   }
   */
 });

Calling the getRun operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The run's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • run — (map)

        The run to get results from.

        • 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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (String)

          The run's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • created — (Date)

          When the run was created.

        • status — (String)

          The run's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The run's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The run's start time.

        • stopped — (Date)

          The run's stop time.

        • counters — (map)

          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.

          Note: If you have unmetered device slots, you must set this to unmetered to use them. Otherwise, the run is counted toward metered device minutes.
          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          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 — (map)

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

            Possible values include:
            • "CURATED"
            • "PRIVATE"
          • 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 an 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.

          Possible values include:
          • "PARSING_FAILED"
          • "VPC_ENDPOINT_SETUP_FAILED"
        • 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 executes 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 — (map)

          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 — (map)

          Information about the location that is used for the run.

          • latituderequired — (Float)

            The latitude.

          • longituderequired — (Float)

            The longitude.

        • customerArtifactPaths — (map)

          Output CustomerArtifactPaths object for the test run.

          • iosPaths — (Array<String>)

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

          • androidPaths — (Array<String>)

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

          • deviceHostPaths — (Array<String>)

            Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests are 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 does not sign your app again. For public devices, Device Farm always signs your apps again.

          For more information about how Device Farm re-signs your apps, 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 — (map)

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

          • filters — (Array<map>)

            The filters in a device selection result.

            • attributerequired — (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

              Because remote debugging is no longer supported, this filter is ignored.

              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

              Possible values include:
              • "ARN"
              • "PLATFORM"
              • "OS_VERSION"
              • "MODEL"
              • "AVAILABILITY"
              • "FORM_FACTOR"
              • "MANUFACTURER"
              • "REMOTE_ACCESS_ENABLED"
              • "REMOTE_DEBUG_ENABLED"
              • "INSTANCE_ARN"
              • "INSTANCE_LABELS"
              • "FLEET_TYPE"
            • operatorrequired — (String)

              Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

              Possible values include:
              • "EQUALS"
              • "LESS_THAN"
              • "LESS_THAN_OR_EQUALS"
              • "GREATER_THAN"
              • "GREATER_THAN_OR_EQUALS"
              • "IN"
              • "NOT_IN"
              • "CONTAINS"
            • valuesrequired — (Array<String>)

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

              Operator Values

              • The IN and NOT_IN operators can take a values array that has more than one element.

              • The other operators require an array with a single element.

              Attribute Values

              • The PLATFORM attribute can be set to ANDROID or IOS.

              • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getSuite(params = {}, callback) ⇒ AWS.Request

Gets information about a suite.

Service Reference:

Examples:

To get information about a test suite


/* The following example gets information about a specific test suite. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:suite:EXAMPLE-GUID-123-456"// You can get the suite ARN by using the list-suites CLI command.
 };
 devicefarm.getSuite(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    suite: {
    }
   }
   */
 });

Calling the getSuite operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getSuite(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The suite's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • suite — (map)

        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

          • BUILTIN_EXPLORER

            Note: Only available for Android; an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (Date)

          When the suite was created.

        • status — (String)

          The suite's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The suite's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The suite's start time.

        • stopped — (Date)

          The suite's stop time.

        • counters — (map)

          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 — (map)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTest(params = {}, callback) ⇒ AWS.Request

Gets information about a test.

Service Reference:

Examples:

To get information about a specific test


/* The following example gets information about a specific test. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456"// You can get the test ARN by using the list-tests CLI command.
 };
 devicefarm.getTest(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    test: {
    }
   }
   */
 });

Calling the getTest operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getTest(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The test's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • test — (map)

        A test 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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (Date)

          When the test was created.

        • status — (String)

          The test's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The test's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The test's start time.

        • stopped — (Date)

          The test's stop time.

        • counters — (map)

          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 — (map)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestGridProject(params = {}, callback) ⇒ AWS.Request

Retrieves information about a Selenium testing project.

Service Reference:

Examples:

Calling the getTestGridProject operation

var params = {
  projectArn: 'STRING_VALUE' /* required */
};
devicefarm.getTestGridProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridProject — (map)

        A TestGridProject.

        • arn — (String)

          The ARN for the project.

        • name — (String)

          A human-readable name for the project.

        • description — (String)

          A human-readable description for the project.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            A list of VPC security group IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            A list of VPC subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

        • created — (Date)

          When the project was created.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestGridSession(params = {}, callback) ⇒ AWS.Request

A session is an instance of a browser created through a RemoteWebDriver with the URL from CreateTestGridUrlResult$url. You can use the following to look up sessions:

Service Reference:

Examples:

Calling the getTestGridSession operation

var params = {
  projectArn: 'STRING_VALUE',
  sessionArn: 'STRING_VALUE',
  sessionId: 'STRING_VALUE'
};
devicefarm.getTestGridSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridSession — (map)

        The TestGridSession that was requested.

        • arn — (String)

          The ARN of the session.

        • status — (String)

          The state of the session.

          Possible values include:
          • "ACTIVE"
          • "CLOSED"
          • "ERRORED"
        • created — (Date)

          The time that the session was started.

        • ended — (Date)

          The time the session ended.

        • billingMinutes — (Float)

          The number of billed minutes that were used for this session.

        • seleniumProperties — (String)

          A JSON object of options and parameters passed to the Selenium WebDriver.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getUpload(params = {}, callback) ⇒ AWS.Request

Gets information about an upload.

Service Reference:

Examples:

To get information about a specific upload


/* The following example gets information about a specific upload. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:upload:EXAMPLE-GUID-123-456"// You can get the test ARN by using the list-uploads CLI command.
 };
 devicefarm.getUpload(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    upload: {
    }
   }
   */
 });

Calling the getUpload operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getUpload(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The upload's ARN.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • upload — (map)

        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 — (Date)

          When the upload was created.

        • type — (String)

          The upload's type.

          Must be one of the following values:

          • 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

          Possible values include:
          • "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 — (String)

          The upload's status.

          Must be one of the following values:

          • FAILED

          • INITIALIZED

          • PROCESSING

          • SUCCEEDED

          Possible values include:
          • "INITIALIZED"
          • "PROCESSING"
          • "SUCCEEDED"
          • "FAILED"
        • url — (String)

          The presigned Amazon S3 URL that was used to store a file using a 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:

          • CURATED: An upload managed by AWS Device Farm.

          • PRIVATE: An upload managed by the AWS Device Farm customer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getVPCEConfiguration(params = {}, callback) ⇒ AWS.Request

Returns information about the configuration settings for your Amazon Virtual Private Cloud (VPC) endpoint.

Service Reference:

Examples:

Calling the getVPCEConfiguration operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.getVPCEConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to describe.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • vpceConfiguration — (map)

        An object that contains 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 in 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 that provides details about your VPC endpoint configuration.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

installToRemoteAccessSession(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

To install to a remote access session


/* The following example installs a specific app to a device in a specific remote access session. */

 var params = {
  appArn: "arn:aws:devicefarm:us-west-2:123456789101:app:EXAMPLE-GUID-123-456", 
  remoteAccessSessionArn: "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456"// You can get the remote access session ARN by using the list-remote-access-sessions CLI command.
 };
 devicefarm.installToRemoteAccessSession(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    appUpload: {
    }
   }
   */
 });

Calling the installToRemoteAccessSession operation

var params = {
  appArn: 'STRING_VALUE', /* required */
  remoteAccessSessionArn: 'STRING_VALUE' /* required */
};
devicefarm.installToRemoteAccessSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • remoteAccessSessionArn — (String)

      The Amazon Resource Name (ARN) of the remote access session about which you are requesting information.

    • appArn — (String)

      The ARN of the app about which you are requesting information.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • appUpload — (map)

        An app to upload or that has been uploaded.

        • arn — (String)

          The upload's ARN.

        • name — (String)

          The upload's file name.

        • created — (Date)

          When the upload was created.

        • type — (String)

          The upload's type.

          Must be one of the following values:

          • 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

          Possible values include:
          • "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 — (String)

          The upload's status.

          Must be one of the following values:

          • FAILED

          • INITIALIZED

          • PROCESSING

          • SUCCEEDED

          Possible values include:
          • "INITIALIZED"
          • "PROCESSING"
          • "SUCCEEDED"
          • "FAILED"
        • url — (String)

          The presigned Amazon S3 URL that was used to store a file using a 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:

          • CURATED: An upload managed by AWS Device Farm.

          • PRIVATE: An upload managed by the AWS Device Farm customer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listArtifacts(params = {}, callback) ⇒ AWS.Request

Gets information about artifacts.

Service Reference:

Examples:

To list artifacts for a resource


/* The following example lists screenshot artifacts for a specific run. */

 var params = {
  type: "SCREENSHOT", 
  arn: "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456"// Can also be used to list artifacts for a Job, Suite, or Test ARN.
 };
 devicefarm.listArtifacts(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the listArtifacts operation

var params = {
  arn: 'STRING_VALUE', /* required */
  type: SCREENSHOT | FILE | LOG, /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listArtifacts(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The run, job, suite, or test ARN.

    • type — (String)

      The artifacts' type.

      Allowed values include:

      • FILE

      • LOG

      • SCREENSHOT

      Possible values include:
      • "SCREENSHOT"
      • "FILE"
      • "LOG"
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • artifacts — (Array<map>)

        Information about the artifacts.

        • arn — (String)

          The artifact's ARN.

        • name — (String)

          The artifact's name.

        • type — (String)

          The artifact's type.

          Allowed values include the following:

          • UNKNOWN

          • SCREENSHOT

          • DEVICE_LOG

          • MESSAGE_LOG

          • VIDEO_LOG

          • RESULT_LOG

          • SERVICE_LOG

          • WEBKIT_LOG

          • INSTRUMENTATION_OUTPUT

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

          • 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

          Possible values include:
          • "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)

          The artifact's file extension.

        • url — (String)

          The presigned Amazon S3 URL that can be used with a 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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listDeviceInstances(params = {}, callback) ⇒ AWS.Request

Returns information about the private device instances associated with one or more AWS accounts.

Service Reference:

Examples:

Calling the listDeviceInstances operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listDeviceInstances(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • maxResults — (Integer)

      An integer that specifies the maximum number of items you want to return in the API response.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • deviceInstances — (Array<map>)

        An object that contains information about your device instances.

        • arn — (String)

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

        • deviceArn — (String)

          The ARN of the device.

        • labels — (Array<String>)

          An array of strings that describe the device instance.

        • status — (String)

          The status of the device instance. Valid values are listed here.

          Possible values include:
          • "IN_USE"
          • "PREPARING"
          • "AVAILABLE"
          • "NOT_AVAILABLE"
        • udid — (String)

          Unique device identifier for the device instance.

        • instanceProfile — (map)

          A object that contains information about the instance profile.

          • arn — (String)

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

          • packageCleanup — (Boolean)

            When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

          • excludeAppPackagesFromCleanup — (Array<String>)

            An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

            The list of packages is considered only if you set packageCleanup to true.

          • rebootAfterUse — (Boolean)

            When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listDevicePools(params = {}, callback) ⇒ AWS.Request

Gets information about device pools.

Service Reference:

Examples:

To get information about device pools


/* The following example returns information about the private device pools in a specific project. */

 var params = {
  type: "PRIVATE", 
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.listDevicePools(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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"
       }
      ]
     }
    ]
   }
   */
 });

Calling the listDevicePools operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE',
  type: CURATED | PRIVATE
};
devicefarm.listDevicePools(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The project ARN.

    • type — (String)

      The device pools' type.

      Allowed values include:

      • CURATED: A device pool that is created and managed by AWS Device Farm.

      • PRIVATE: A device pool that is created and managed by the device pool developer.

      Possible values include:
      • "CURATED"
      • "PRIVATE"
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • devicePools — (Array<map>)

        Information about the device pools.

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

          • CURATED: A device pool that is created and managed by AWS Device Farm.

          • PRIVATE: A device pool that is created and managed by the device pool developer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • rules — (Array<map>)

          Information about the device pool's rules.

          • 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

            Because remote debugging is no longer supported, this filter is ignored.

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"
          • 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.

            Possible values include:
            • "EQUALS"
            • "LESS_THAN"
            • "LESS_THAN_OR_EQUALS"
            • "GREATER_THAN"
            • "GREATER_THAN_OR_EQUALS"
            • "IN"
            • "NOT_IN"
            • "CONTAINS"
          • 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 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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listDevices(params = {}, callback) ⇒ AWS.Request

Gets information about unique device types.

Service Reference:

Examples:

To get information about devices


/* The following example returns information about the available devices in a specific project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-projects CLI command.
 };
 devicefarm.listDevices(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the listDevices operation

var params = {
  arn: 'STRING_VALUE',
  filters: [
    {
      attribute: ARN | PLATFORM | OS_VERSION | MODEL | AVAILABILITY | FORM_FACTOR | MANUFACTURER | REMOTE_ACCESS_ENABLED | REMOTE_DEBUG_ENABLED | INSTANCE_ARN | INSTANCE_LABELS | FLEET_TYPE, /* required */
      operator: EQUALS | LESS_THAN | LESS_THAN_OR_EQUALS | GREATER_THAN | GREATER_THAN_OR_EQUALS | IN | NOT_IN | CONTAINS, /* required */
      values: [ /* required */
        'STRING_VALUE',
        /* more items */
      ]
    },
    /* more items */
  ],
  nextToken: 'STRING_VALUE'
};
devicefarm.listDevices(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the project.

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

    • filters — (Array<map>)

      Used to select a set of devices. A filter is made up of an attribute, an operator, and one or more values.

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

        Allowed values include:

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

        • PLATFORM: The device platform. Valid values are ANDROID or IOS.

        • OS_VERSION: The operating system version (for example, 10.3.2).

        • MODEL: The device model (for example, iPad 5th Gen).

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

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

        • MANUFACTURER: The device manufacturer (for example, Apple).

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

        • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are TRUE or FALSE. Because remote debugging is no longer supported, this attribute is ignored.

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

        • INSTANCE_LABELS: The label of the device instance.

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

      • Operator: The filter operator.

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

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

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

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

      • Values: An array of one or more filter values.

        • The IN and NOT_IN operators take a values array that has one or more elements.

        • The other operators require an array with a single element.

        • In a request, the AVAILABILITY attribute takes the following values: AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

      • attributerequired — (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

        Because remote debugging is no longer supported, this filter is ignored.

        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

        Possible values include:
        • "ARN"
        • "PLATFORM"
        • "OS_VERSION"
        • "MODEL"
        • "AVAILABILITY"
        • "FORM_FACTOR"
        • "MANUFACTURER"
        • "REMOTE_ACCESS_ENABLED"
        • "REMOTE_DEBUG_ENABLED"
        • "INSTANCE_ARN"
        • "INSTANCE_LABELS"
        • "FLEET_TYPE"
      • operatorrequired — (String)

        Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

        Possible values include:
        • "EQUALS"
        • "LESS_THAN"
        • "LESS_THAN_OR_EQUALS"
        • "GREATER_THAN"
        • "GREATER_THAN_OR_EQUALS"
        • "IN"
        • "NOT_IN"
        • "CONTAINS"
      • valuesrequired — (Array<String>)

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

        Operator Values

        • The IN and NOT_IN operators can take a values array that has more than one element.

        • The other operators require an array with a single element.

        Attribute Values

        • The PLATFORM attribute can be set to ANDROID or IOS.

        • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • devices — (Array<map>)

        Information about the devices.

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

          • PHONE

          • TABLET

          Possible values include:
          • "PHONE"
          • "TABLET"
        • platform — (String)

          The device's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • os — (String)

          The device's operating system type.

        • cpu — (map)

          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 — (map)

          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.

          Remote debugging is no longer supported.

        • fleetType — (String)

          The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

        • fleetName — (String)

          The name of the fleet to which this device belongs.

        • instances — (Array<map>)

          The instances that belong to this device.

          • arn — (String)

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

          • deviceArn — (String)

            The ARN of the device.

          • labels — (Array<String>)

            An array of strings that describe the device instance.

          • status — (String)

            The status of the device instance. Valid values are listed here.

            Possible values include:
            • "IN_USE"
            • "PREPARING"
            • "AVAILABLE"
            • "NOT_AVAILABLE"
          • udid — (String)

            Unique device identifier for the device instance.

          • instanceProfile — (map)

            A object that contains information about the instance profile.

            • arn — (String)

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

            • packageCleanup — (Boolean)

              When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

            • excludeAppPackagesFromCleanup — (Array<String>)

              An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

              The list of packages is considered only if you set packageCleanup to true.

            • rebootAfterUse — (Boolean)

              When set to true, Device Farm reboots 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)

          Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

          Possible values include:
          • "TEMPORARY_NOT_AVAILABLE"
          • "BUSY"
          • "AVAILABLE"
          • "HIGHLY_AVAILABLE"
      • nextToken — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listInstanceProfiles(params = {}, callback) ⇒ AWS.Request

Returns information about all the instance profiles in an AWS account.

Service Reference:

Examples:

Calling the listInstanceProfiles operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listInstanceProfiles(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • maxResults — (Integer)

      An integer that specifies the maximum number of items you want to return in the API response.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • instanceProfiles — (Array<map>)

        An object that contains information about your instance profiles.

        • arn — (String)

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

        • packageCleanup — (Boolean)

          When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

        • excludeAppPackagesFromCleanup — (Array<String>)

          An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

          The list of packages is considered only if you set packageCleanup to true.

        • rebootAfterUse — (Boolean)

          When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listJobs(params = {}, callback) ⇒ AWS.Request

Gets information about jobs for a given test run.

Service Reference:

Examples:

To get information about jobs


/* The following example returns information about jobs in a specific project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456"// You can get the project ARN by using the list-jobs CLI command.
 };
 devicefarm.listJobs(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
   }
   */
 });

Calling the listJobs operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listJobs(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The run's Amazon Resource Name (ARN).

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • jobs — (Array<map>)

        Information about the jobs.

        • 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

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

          • 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

          Possible values include:
          • "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 — (Date)

          When the job was created.

        • status — (String)

          The job's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The job's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The job's start time.

        • stopped — (Date)

          The job's stop time.

        • counters — (map)

          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 — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • deviceMinutes — (map)

          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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listNetworkProfiles(params = {}, callback) ⇒ AWS.Request

Returns the list of available network profiles.

Service Reference:

Examples:

Calling the listNetworkProfiles operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE',
  type: CURATED | PRIVATE
};
devicefarm.listNetworkProfiles(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

    • type — (String)

      The type of network profile to return information about. Valid values are listed here.

      Possible values include:
      • "CURATED"
      • "PRIVATE"
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • networkProfiles — (Array<map>)

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

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • 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:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listOfferingPromotions(params = {}, callback) ⇒ AWS.Request

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 must be able to invoke this operation.

Service Reference:

Examples:

Calling the listOfferingPromotions operation

var params = {
  nextToken: 'STRING_VALUE'
};
devicefarm.listOfferingPromotions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • offeringPromotions — (Array<map>)

        Information about the offering promotions.

        • id — (String)

          The ID of the offering promotion.

        • description — (String)

          A string that describes the offering promotion.

      • nextToken — (String)

        An identifier to be used in the next call to this operation, to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listOfferings(params = {}, callback) ⇒ AWS.Request

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. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

Service Reference:

Examples:

To get information about device offerings


/* The following example returns information about available device offerings. */

 var params = {
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE="// A dynamically generated value, used for paginating results.
 };
 devicefarm.listOfferings(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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"
       }
      ]
     }
    ]
   }
   */
 });

Calling the listOfferings operation

var params = {
  nextToken: 'STRING_VALUE'
};
devicefarm.listOfferings(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • offerings — (Array<map>)

        A value that represents the list offering results.

        • id — (String)

          The ID that corresponds to a device offering.

        • description — (String)

          A string that describes the offering.

        • type — (String)

          The type of offering (for example, RECURRING) for a device.

          Possible values include:
          • "RECURRING"
        • platform — (String)

          The platform of the device (for example, ANDROID or IOS).

          Possible values include:
          • "ANDROID"
          • "IOS"
        • recurringCharges — (Array<map>)

          Specifies whether there are recurring charges for the offering.

          • cost — (map)

            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.

              Possible values include:
              • "USD"
          • frequency — (String)

            The frequency in which charges recur.

            Possible values include:
            • "MONTHLY"
      • 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:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listOfferingTransactions(params = {}, callback) ⇒ AWS.Request

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. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

Service Reference:

Examples:

To get information about device offering transactions


/* The following example returns information about Device Farm offering transactions. */

 var params = {
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE="// A dynamically generated value, used for paginating results.
 };
 devicefarm.listOfferingTransactions(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    offeringTransactions: [
       {
      cost: {
       amount: 0, 
       currencyCode: "USD"
      }, 
      createdOn: <Date Representation>, 
      offeringStatus: {
       type: "RENEW", 
       effectiveOn: <Date Representation>, 
       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: <Date Representation>, 
      offeringStatus: {
       type: "PURCHASE", 
       effectiveOn: <Date Representation>, 
       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: <Date Representation>, 
      offeringStatus: {
       type: "PURCHASE", 
       effectiveOn: <Date Representation>, 
       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: <Date Representation>, 
      offeringStatus: {
       type: "PURCHASE", 
       effectiveOn: <Date Representation>, 
       offering: {
        type: "RECURRING", 
        description: "iOS Unmetered Device Slot", 
        id: "A53D4D73-A6F6-4B82-A0B0-12345EXAMPLE", 
        platform: "IOS"
       }, 
       quantity: 1
      }, 
      transactionId: "2baf9021-ae3e-47f5-ab52-12345EXAMPLE"
     }
    ]
   }
   */
 });

Calling the listOfferingTransactions operation

var params = {
  nextToken: 'STRING_VALUE'
};
devicefarm.listOfferingTransactions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • offeringTransactions — (Array<map>)

        The audit log of subscriptions you have purchased and modified through AWS Device Farm.

        • offeringStatus — (map)

          The status of an offering transaction.

          • type — (String)

            The type specified for the offering status.

            Possible values include:
            • "PURCHASE"
            • "RENEW"
            • "SYSTEM"
          • offering — (map)

            Represents the metadata of an offering status.

            • id — (String)

              The ID that corresponds to a device offering.

            • description — (String)

              A string that describes the offering.

            • type — (String)

              The type of offering (for example, RECURRING) for a device.

              Possible values include:
              • "RECURRING"
            • platform — (String)

              The platform of the device (for example, ANDROID or IOS).

              Possible values include:
              • "ANDROID"
              • "IOS"
            • recurringCharges — (Array<map>)

              Specifies whether there are recurring charges for the offering.

              • cost — (map)

                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.

                  Possible values include:
                  • "USD"
              • frequency — (String)

                The frequency in which charges recur.

                Possible values include:
                • "MONTHLY"
          • quantity — (Integer)

            The number of available devices in the offering.

          • effectiveOn — (Date)

            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 — (Date)

          The date on which an offering transaction was created.

        • cost — (map)

          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.

            Possible values include:
            • "USD"
      • 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:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listProjects(params = {}, callback) ⇒ AWS.Request

Gets information about projects.

Service Reference:

Examples:

To get information about a Device Farm project


/* The following example returns information about the specified project in Device Farm. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE", 
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listProjects(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    projects: [
       {
      name: "My Test Project", 
      arn: "arn:aws:devicefarm:us-west-2:123456789101:project:7ad300ed-8183-41a7-bf94-12345EXAMPLE", 
      created: <Date Representation>
     }, 
       {
      name: "Hello World", 
      arn: "arn:aws:devicefarm:us-west-2:123456789101:project:d6b087d9-56db-4e44-b9ec-12345EXAMPLE", 
      created: <Date Representation>
     }
    ]
   }
   */
 });

Calling the listProjects operation

var params = {
  arn: 'STRING_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listProjects(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      Optional. If no Amazon Resource Name (ARN) is specified, then AWS Device Farm returns a list of all projects for the AWS account. You can also specify a project ARN.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • projects — (Array<map>)

        Information about the projects.

        • 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 executes before it times out. The default value is 150 minutes.

        • created — (Date)

          When the project was created.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

      • nextToken — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listRemoteAccessSessions(params = {}, callback) ⇒ AWS.Request

Returns a list of all currently running remote access sessions.

Service Reference:

Examples:

To get information about a remote access session


/* The following example returns information about a specific Device Farm remote access session. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:session:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the session by using the list-sessions CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE="// A dynamically generated value, used for paginating results.
 };
 devicefarm.listRemoteAccessSessions(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    remoteAccessSessions: [
    ]
   }
   */
 });

Calling the listRemoteAccessSessions operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listRemoteAccessSessions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the project about which you are requesting information.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • remoteAccessSessions — (Array<map>)

        A container that represents the metadata from the service about each remote access session you are requesting.

        • arn — (String)

          The Amazon Resource Name (ARN) of the remote access session.

        • name — (String)

          The name of the remote access session.

        • created — (Date)

          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:

          • PENDING.

          • PENDING_CONCURRENCY.

          • PENDING_DEVICE.

          • PROCESSING.

          • SCHEDULING.

          • PREPARING.

          • RUNNING.

          • COMPLETED.

          • STOPPING.

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The result of the remote access session. Can be any of the following:

          • PENDING.

          • PASSED.

          • WARNED.

          • FAILED.

          • SKIPPED.

          • ERRORED.

          • STOPPED.

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • message — (String)

          A message about the remote access session.

        • started — (Date)

          The date and time the remote access session was started.

        • stopped — (Date)

          The date and time the remote access session was stopped.

        • device — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • remoteDebugEnabled — (Boolean)

          This flag is set to true if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

        • remoteRecordEnabled — (Boolean)

          This flag is set to true if remote recording is enabled for the remote access session.

        • remoteRecordAppArn — (String)

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

          Remote debugging is no longer supported.

        • clientId — (String)

          Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

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

          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          The number of minutes a device is used in a remote access session (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.

          Remote debugging is no longer supported.

        • interactionMode — (String)

          The interaction mode of the remote access session. Valid values are:

          • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

          • NO_VIDEO: You are connected to the device, but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

          • VIDEO_ONLY: You can view the screen, but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

          Possible values include:
          • "INTERACTIVE"
          • "NO_VIDEO"
          • "VIDEO_ONLY"
        • skipAppResign — (Boolean)

          When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

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

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listRuns(params = {}, callback) ⇒ AWS.Request

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

Service Reference:

Examples:

To get information about a test run


/* The following example returns information about a specific test run. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-5ec6e6c6dd23/0fcac17b-6122-44d7-ae5a-12345EXAMPLE", // You can get the Amazon Resource Name (ARN) of the run by using the list-runs CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listRuns(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    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: <Date Representation>, 
      deviceMinutes: {
       metered: 0.0, 
       total: 0.0, 
       unmetered: 0.0
      }, 
      platform: "ANDROID", 
      result: "PENDING", 
      status: "RUNNING", 
      totalJobs: 3
     }
    ]
   }
   */
 });

Calling the listRuns operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listRuns(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • runs — (Array<map>)

        Information about the runs.

        • 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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (String)

          The run's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • created — (Date)

          When the run was created.

        • status — (String)

          The run's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The run's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The run's start time.

        • stopped — (Date)

          The run's stop time.

        • counters — (map)

          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.

          Note: If you have unmetered device slots, you must set this to unmetered to use them. Otherwise, the run is counted toward metered device minutes.
          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          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 — (map)

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

            Possible values include:
            • "CURATED"
            • "PRIVATE"
          • 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 an 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.

          Possible values include:
          • "PARSING_FAILED"
          • "VPC_ENDPOINT_SETUP_FAILED"
        • 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 executes 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 — (map)

          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 — (map)

          Information about the location that is used for the run.

          • latituderequired — (Float)

            The latitude.

          • longituderequired — (Float)

            The longitude.

        • customerArtifactPaths — (map)

          Output CustomerArtifactPaths object for the test run.

          • iosPaths — (Array<String>)

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

          • androidPaths — (Array<String>)

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

          • deviceHostPaths — (Array<String>)

            Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests are 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 does not sign your app again. For public devices, Device Farm always signs your apps again.

          For more information about how Device Farm re-signs your apps, 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 — (map)

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

          • filters — (Array<map>)

            The filters in a device selection result.

            • attributerequired — (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

              Because remote debugging is no longer supported, this filter is ignored.

              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

              Possible values include:
              • "ARN"
              • "PLATFORM"
              • "OS_VERSION"
              • "MODEL"
              • "AVAILABILITY"
              • "FORM_FACTOR"
              • "MANUFACTURER"
              • "REMOTE_ACCESS_ENABLED"
              • "REMOTE_DEBUG_ENABLED"
              • "INSTANCE_ARN"
              • "INSTANCE_LABELS"
              • "FLEET_TYPE"
            • operatorrequired — (String)

              Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

              Possible values include:
              • "EQUALS"
              • "LESS_THAN"
              • "LESS_THAN_OR_EQUALS"
              • "GREATER_THAN"
              • "GREATER_THAN_OR_EQUALS"
              • "IN"
              • "NOT_IN"
              • "CONTAINS"
            • valuesrequired — (Array<String>)

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

              Operator Values

              • The IN and NOT_IN operators can take a values array that has more than one element.

              • The other operators require an array with a single element.

              Attribute Values

              • The PLATFORM attribute can be set to ANDROID or IOS.

              • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

      • nextToken — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listSamples(params = {}, callback) ⇒ AWS.Request

Gets information about samples, given an AWS Device Farm job ARN.

Service Reference:

Examples:

To get information about samples


/* The following example returns information about samples, given a specific Device Farm project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listSamples(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    samples: [
    ]
   }
   */
 });

Calling the listSamples operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listSamples(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the job used to list samples.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • samples — (Array<map>)

        Information about the samples.

        • arn — (String)

          The sample's ARN.

        • type — (String)

          The sample's type.

          Must be one of the following values:

          • CPU: A CPU sample type. This is expressed as the app processing CPU time (including child processes) as reported by process, as a percentage.

          • MEMORY: A memory usage sample type. This is expressed as the total proportional set size of an app process, in kilobytes.

          • NATIVE_AVG_DRAWTIME

          • NATIVE_FPS

          • NATIVE_FRAMES

          • NATIVE_MAX_DRAWTIME

          • NATIVE_MIN_DRAWTIME

          • OPENGL_AVG_DRAWTIME

          • OPENGL_FPS

          • OPENGL_FRAMES

          • OPENGL_MAX_DRAWTIME

          • OPENGL_MIN_DRAWTIME

          • RX

          • RX_RATE: The total number of bytes per second (TCP and UDP) that are sent, by app process.

          • THREADS: A threads sample type. This is expressed as the total number of threads per app process.

          • TX

          • TX_RATE: The total number of bytes per second (TCP and UDP) that are received, by app process.

          Possible values include:
          • "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)

          The presigned Amazon S3 URL that can be used with a 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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listSuites(params = {}, callback) ⇒ AWS.Request

Gets information about test suites for a given job.

Service Reference:

Examples:

To get information about suites


/* The following example returns information about suites, given a specific Device Farm job. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:job:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the job by using the list-jobs CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listSuites(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    suites: [
    ]
   }
   */
 });

Calling the listSuites operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listSuites(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The job's Amazon Resource Name (ARN).

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • suites — (Array<map>)

        Information about the suites.

        • 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

          • BUILTIN_EXPLORER

            Note: Only available for Android; an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (Date)

          When the suite was created.

        • status — (String)

          The suite's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The suite's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The suite's start time.

        • stopped — (Date)

          The suite's stop time.

        • counters — (map)

          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 — (map)

          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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTagsForResource(params = {}, callback) ⇒ AWS.Request

List the tags for an AWS Device Farm resource.

Service Reference:

Examples:

Calling the listTagsForResource operation

var params = {
  ResourceARN: 'STRING_VALUE' /* required */
};
devicefarm.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (String)

      The Amazon Resource Name (ARN) of the resource or resources 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • Tags — (Array<map>)

        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. Tag values can have a maximum length of 256 characters.

        • Keyrequired — (String)

          One part of a key-value pair that makes up a tag. A key is a general label that acts like a category for more specific tag values.

        • Valuerequired — (String)

          The optional part of a key-value pair that makes up a tag. A value acts as a descriptor in a tag category (key).

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestGridProjects(params = {}, callback) ⇒ AWS.Request

Gets a list of all Selenium testing projects in your account.

Service Reference:

Examples:

Calling the listTestGridProjects operation

var params = {
  maxResult: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listTestGridProjects(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • maxResult — (Integer)

      Return no more than this number of results.

    • nextToken — (String)

      From a response, used to continue a paginated listing.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridProjects — (Array<map>)

        The list of TestGridProjects, based on a ListTestGridProjectsRequest.

        • arn — (String)

          The ARN for the project.

        • name — (String)

          A human-readable name for the project.

        • description — (String)

          A human-readable description for the project.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            A list of VPC security group IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            A list of VPC subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

        • created — (Date)

          When the project was created.

      • nextToken — (String)

        Used for pagination. Pass into ListTestGridProjects to get more results in a paginated request.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestGridSessionActions(params = {}, callback) ⇒ AWS.Request

Returns a list of the actions taken in a TestGridSession.

Service Reference:

Examples:

Calling the listTestGridSessionActions operation

var params = {
  sessionArn: 'STRING_VALUE', /* required */
  maxResult: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listTestGridSessionActions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • sessionArn — (String)

      The ARN of the session to retrieve.

    • maxResult — (Integer)

      The maximum number of sessions to return per response.

    • nextToken — (String)

      Pagination token.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • actions — (Array<map>)

        The action taken by the session.

        • action — (String)

          The action taken by the session.

        • started — (Date)

          The time that the session invoked the action.

        • duration — (Integer)

          The time, in milliseconds, that the action took to complete in the browser.

        • statusCode — (String)

          HTTP status code returned to the browser when the action was taken.

        • requestMethod — (String)

          HTTP method that the browser used to make the request.

      • nextToken — (String)

        Pagination token.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestGridSessionArtifacts(params = {}, callback) ⇒ AWS.Request

Retrieves a list of artifacts created during the session.

Service Reference:

Examples:

Calling the listTestGridSessionArtifacts operation

var params = {
  sessionArn: 'STRING_VALUE', /* required */
  maxResult: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  type: VIDEO | LOG
};
devicefarm.listTestGridSessionArtifacts(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • sessionArn — (String)

      The ARN of a TestGridSession.

    • type — (String)

      Limit results to a specified type of artifact.

      Possible values include:
      • "VIDEO"
      • "LOG"
    • maxResult — (Integer)

      The maximum number of results to be returned by a request.

    • nextToken — (String)

      Pagination token.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • artifacts — (Array<map>)

        A list of test grid session artifacts for a TestGridSession.

        • filename — (String)

          The file name of the artifact.

        • type — (String)

          The kind of artifact.

          Possible values include:
          • "UNKNOWN"
          • "VIDEO"
          • "SELENIUM_LOG"
        • url — (String)

          A semi-stable URL to the content of the object.

      • nextToken — (String)

        Pagination token.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestGridSessions(params = {}, callback) ⇒ AWS.Request

Retrieves a list of sessions for a TestGridProject.

Service Reference:

Examples:

Calling the listTestGridSessions operation

var params = {
  projectArn: 'STRING_VALUE', /* required */
  creationTimeAfter: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  creationTimeBefore: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  endTimeAfter: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  endTimeBefore: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  maxResult: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  status: ACTIVE | CLOSED | ERRORED
};
devicefarm.listTestGridSessions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      ARN of a TestGridProject.

    • status — (String)

      Return only sessions in this state.

      Possible values include:
      • "ACTIVE"
      • "CLOSED"
      • "ERRORED"
    • creationTimeAfter — (Date)

      Return only sessions created after this time.

    • creationTimeBefore — (Date)

      Return only sessions created before this time.

    • endTimeAfter — (Date)

      Return only sessions that ended after this time.

    • endTimeBefore — (Date)

      Return only sessions that ended before this time.

    • maxResult — (Integer)

      Return only this many results at a time.

    • nextToken — (String)

      Pagination token.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridSessions — (Array<map>)

        The sessions that match the criteria in a ListTestGridSessionsRequest.

        • arn — (String)

          The ARN of the session.

        • status — (String)

          The state of the session.

          Possible values include:
          • "ACTIVE"
          • "CLOSED"
          • "ERRORED"
        • created — (Date)

          The time that the session was started.

        • ended — (Date)

          The time the session ended.

        • billingMinutes — (Float)

          The number of billed minutes that were used for this session.

        • seleniumProperties — (String)

          A JSON object of options and parameters passed to the Selenium WebDriver.

      • nextToken — (String)

        Pagination token.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTests(params = {}, callback) ⇒ AWS.Request

Gets information about tests in a given test suite.

Service Reference:

Examples:

To get information about tests


/* The following example returns information about tests, given a specific Device Farm project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listTests(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    tests: [
    ]
   }
   */
 });

Calling the listTests operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listTests(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The test suite's Amazon Resource Name (ARN).

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • tests — (Array<map>)

        Information about the tests.

        • 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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (Date)

          When the test was created.

        • status — (String)

          The test's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The test's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The test's start time.

        • stopped — (Date)

          The test's stop time.

        • counters — (map)

          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 — (map)

          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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listUniqueProblems(params = {}, callback) ⇒ AWS.Request

Gets information about unique problems, such as exceptions or crashes.

Unique problems are defined as a single instance of an error across a run, job, or suite. For example, if a call in your application consistently raises an exception (OutOfBoundsException in MyActivity.java:386), ListUniqueProblems returns a single entry instead of many individual entries for that exception.

Service Reference:

Examples:

To get information about unique problems


/* The following example returns information about unique problems, given a specific Device Farm project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listUniqueProblems(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    uniqueProblems: {
    }
   }
   */
 });

Calling the listUniqueProblems operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
devicefarm.listUniqueProblems(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The unique problems' ARNs.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • uniqueProblems — (map<Array<map>>)

        Information about the unique problems.

        Allowed values include:

        • PENDING

        • PASSED

        • WARNED

        • FAILED

        • SKIPPED

        • ERRORED

        • STOPPED

        • message — (String)

          A message about the unique problems' result.

        • problems — (Array<map>)

          Information about the problems.

          • run — (map)

            Information about the associated run.

            • arn — (String)

              The problem detail's ARN.

            • name — (String)

              The problem detail's name.

          • job — (map)

            Information about the associated job.

            • arn — (String)

              The problem detail's ARN.

            • name — (String)

              The problem detail's name.

          • suite — (map)

            Information about the associated suite.

            • arn — (String)

              The problem detail's ARN.

            • name — (String)

              The problem detail's name.

          • test — (map)

            Information about the associated test.

            • arn — (String)

              The problem detail's ARN.

            • name — (String)

              The problem detail's name.

          • device — (map)

            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:

              • PHONE

              • TABLET

              Possible values include:
              • "PHONE"
              • "TABLET"
            • platform — (String)

              The device's platform.

              Allowed values include:

              • ANDROID

              • IOS

              Possible values include:
              • "ANDROID"
              • "IOS"
            • os — (String)

              The device's operating system type.

            • cpu — (map)

              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 — (map)

              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.

              Remote debugging is no longer supported.

            • fleetType — (String)

              The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

            • fleetName — (String)

              The name of the fleet to which this device belongs.

            • instances — (Array<map>)

              The instances that belong to this device.

              • arn — (String)

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

              • deviceArn — (String)

                The ARN of the device.

              • labels — (Array<String>)

                An array of strings that describe the device instance.

              • status — (String)

                The status of the device instance. Valid values are listed here.

                Possible values include:
                • "IN_USE"
                • "PREPARING"
                • "AVAILABLE"
                • "NOT_AVAILABLE"
              • udid — (String)

                Unique device identifier for the device instance.

              • instanceProfile — (map)

                A object that contains information about the instance profile.

                • arn — (String)

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

                • packageCleanup — (Boolean)

                  When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

                • excludeAppPackagesFromCleanup — (Array<String>)

                  An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                  The list of packages is considered only if you set packageCleanup to true.

                • rebootAfterUse — (Boolean)

                  When set to true, Device Farm reboots 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)

              Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

              Possible values include:
              • "TEMPORARY_NOT_AVAILABLE"
              • "BUSY"
              • "AVAILABLE"
              • "HIGHLY_AVAILABLE"
          • result — (String)

            The problem's result.

            Allowed values include:

            • PENDING

            • PASSED

            • WARNED

            • FAILED

            • SKIPPED

            • ERRORED

            • STOPPED

            Possible values include:
            • "PENDING"
            • "PASSED"
            • "WARNED"
            • "FAILED"
            • "SKIPPED"
            • "ERRORED"
            • "STOPPED"
          • 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. It can be used in a subsequent call to this operation to return the next set of items in the list.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listUploads(params = {}, callback) ⇒ AWS.Request

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

Service Reference:

Examples:

To get information about uploads


/* The following example returns information about uploads, given a specific Device Farm project. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
  nextToken: "RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE"// A dynamically generated value, used for paginating results.
 };
 devicefarm.listUploads(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    uploads: [
    ]
   }
   */
 });

Calling the listUploads operation

var params = {
  arn: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE',
  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
};
devicefarm.listUploads(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

    • type — (String)

      The type of upload.

      Must be one of the following values:

      • 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

      Possible values include:
      • "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)

      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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • uploads — (Array<map>)

        Information about the uploads.

        • arn — (String)

          The upload's ARN.

        • name — (String)

          The upload's file name.

        • created — (Date)

          When the upload was created.

        • type — (String)

          The upload's type.

          Must be one of the following values:

          • 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

          Possible values include:
          • "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 — (String)

          The upload's status.

          Must be one of the following values:

          • FAILED

          • INITIALIZED

          • PROCESSING

          • SUCCEEDED

          Possible values include:
          • "INITIALIZED"
          • "PROCESSING"
          • "SUCCEEDED"
          • "FAILED"
        • url — (String)

          The presigned Amazon S3 URL that was used to store a file using a 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:

          • CURATED: An upload managed by AWS Device Farm.

          • PRIVATE: An upload managed by the AWS Device Farm customer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
      • nextToken — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listVPCEConfigurations(params = {}, callback) ⇒ AWS.Request

Returns information about all Amazon Virtual Private Cloud (VPC) endpoint configurations in the AWS account.

Service Reference:

Examples:

Calling the listVPCEConfigurations operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
devicefarm.listVPCEConfigurations(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • maxResults — (Integer)

      An integer that specifies the maximum number of items you want to return in the API response.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • vpceConfigurations — (Array<map>)

        An array of VPCEConfiguration objects that contain 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 in 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 that provides 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

purchaseOffering(params = {}, callback) ⇒ AWS.Request

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. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

Service Reference:

Examples:

To purchase a device slot offering


/* The following example purchases a specific device slot offering. */

 var params = {
  offeringId: "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", // You can get the offering ID by using the list-offerings CLI command.
  quantity: 1
 };
 devicefarm.purchaseOffering(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    offeringTransaction: {
     cost: {
      amount: 8.07, 
      currencyCode: "USD"
     }, 
     createdOn: <Date Representation>, 
     offeringStatus: {
      type: "PURCHASE", 
      effectiveOn: <Date Representation>, 
      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"
    }
   }
   */
 });

Calling the purchaseOffering operation

var params = {
  offeringId: 'STRING_VALUE', /* required */
  quantity: 'NUMBER_VALUE', /* required */
  offeringPromotionId: 'STRING_VALUE'
};
devicefarm.purchaseOffering(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • offeringId — (String)

      The ID of the offering.

    • quantity — (Integer)

      The number of device slots to purchase in an offering request.

    • offeringPromotionId — (String)

      The ID of the offering promotion to be applied to the purchase.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • offeringTransaction — (map)

        Represents the offering transaction for the purchase result.

        • offeringStatus — (map)

          The status of an offering transaction.

          • type — (String)

            The type specified for the offering status.

            Possible values include:
            • "PURCHASE"
            • "RENEW"
            • "SYSTEM"
          • offering — (map)

            Represents the metadata of an offering status.

            • id — (String)

              The ID that corresponds to a device offering.

            • description — (String)

              A string that describes the offering.

            • type — (String)

              The type of offering (for example, RECURRING) for a device.

              Possible values include:
              • "RECURRING"
            • platform — (String)

              The platform of the device (for example, ANDROID or IOS).

              Possible values include:
              • "ANDROID"
              • "IOS"
            • recurringCharges — (Array<map>)

              Specifies whether there are recurring charges for the offering.

              • cost — (map)

                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.

                  Possible values include:
                  • "USD"
              • frequency — (String)

                The frequency in which charges recur.

                Possible values include:
                • "MONTHLY"
          • quantity — (Integer)

            The number of available devices in the offering.

          • effectiveOn — (Date)

            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 — (Date)

          The date on which an offering transaction was created.

        • cost — (map)

          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.

            Possible values include:
            • "USD"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

renewOffering(params = {}, callback) ⇒ AWS.Request

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. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

Service Reference:

Examples:

To renew a device slot offering


/* The following example renews a specific device slot offering. */

 var params = {
  offeringId: "D68B3C05-1BA6-4360-BC69-12345EXAMPLE", // You can get the offering ID by using the list-offerings CLI command.
  quantity: 1
 };
 devicefarm.renewOffering(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    offeringTransaction: {
     cost: {
      amount: 250, 
      currencyCode: "USD"
     }, 
     createdOn: <Date Representation>, 
     offeringStatus: {
      type: "RENEW", 
      effectiveOn: <Date Representation>, 
      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"
    }
   }
   */
 });

Calling the renewOffering operation

var params = {
  offeringId: 'STRING_VALUE', /* required */
  quantity: 'NUMBER_VALUE' /* required */
};
devicefarm.renewOffering(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • offeringId — (String)

      The ID of a request to renew an offering.

    • quantity — (Integer)

      The quantity requested in an offering renewal.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • offeringTransaction — (map)

        Represents the status of the offering transaction for the renewal.

        • offeringStatus — (map)

          The status of an offering transaction.

          • type — (String)

            The type specified for the offering status.

            Possible values include:
            • "PURCHASE"
            • "RENEW"
            • "SYSTEM"
          • offering — (map)

            Represents the metadata of an offering status.

            • id — (String)

              The ID that corresponds to a device offering.

            • description — (String)

              A string that describes the offering.

            • type — (String)

              The type of offering (for example, RECURRING) for a device.

              Possible values include:
              • "RECURRING"
            • platform — (String)

              The platform of the device (for example, ANDROID or IOS).

              Possible values include:
              • "ANDROID"
              • "IOS"
            • recurringCharges — (Array<map>)

              Specifies whether there are recurring charges for the offering.

              • cost — (map)

                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.

                  Possible values include:
                  • "USD"
              • frequency — (String)

                The frequency in which charges recur.

                Possible values include:
                • "MONTHLY"
          • quantity — (Integer)

            The number of available devices in the offering.

          • effectiveOn — (Date)

            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 — (Date)

          The date on which an offering transaction was created.

        • cost — (map)

          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.

            Possible values include:
            • "USD"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

scheduleRun(params = {}, callback) ⇒ AWS.Request

Schedules a run.

Service Reference:

Examples:

To schedule a test run


/* The following example schedules a test run named MyRun. */

 var params = {
  name: "MyRun", 
  devicePoolArn: "arn:aws:devicefarm:us-west-2:123456789101:pool:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command.
  projectArn: "arn:aws:devicefarm:us-west-2:123456789101:project:EXAMPLE-GUID-123-456", // You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
  test: {
   type: "APPIUM_JAVA_JUNIT", 
   testPackageArn: "arn:aws:devicefarm:us-west-2:123456789101:test:EXAMPLE-GUID-123-456"
  }
 };
 devicefarm.scheduleRun(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    run: {
    }
   }
   */
 });

Calling the scheduleRun operation

var params = {
  projectArn: 'STRING_VALUE', /* required */
  test: { /* required */
    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, /* required */
    filter: 'STRING_VALUE',
    parameters: {
      '<String>': 'STRING_VALUE',
      /* '<String>': ... */
    },
    testPackageArn: 'STRING_VALUE',
    testSpecArn: 'STRING_VALUE'
  },
  appArn: 'STRING_VALUE',
  configuration: {
    auxiliaryApps: [
      'STRING_VALUE',
      /* more items */
    ],
    billingMethod: METERED | UNMETERED,
    customerArtifactPaths: {
      androidPaths: [
        'STRING_VALUE',
        /* more items */
      ],
      deviceHostPaths: [
        'STRING_VALUE',
        /* more items */
      ],
      iosPaths: [
        'STRING_VALUE',
        /* more items */
      ]
    },
    extraDataPackageArn: 'STRING_VALUE',
    locale: 'STRING_VALUE',
    location: {
      latitude: 'NUMBER_VALUE', /* required */
      longitude: 'NUMBER_VALUE' /* required */
    },
    networkProfileArn: 'STRING_VALUE',
    radios: {
      bluetooth: true || false,
      gps: true || false,
      nfc: true || false,
      wifi: true || false
    },
    vpceConfigurationArns: [
      'STRING_VALUE',
      /* more items */
    ]
  },
  devicePoolArn: 'STRING_VALUE',
  deviceSelectionConfiguration: {
    filters: [ /* required */
      {
        attribute: ARN | PLATFORM | OS_VERSION | MODEL | AVAILABILITY | FORM_FACTOR | MANUFACTURER | REMOTE_ACCESS_ENABLED | REMOTE_DEBUG_ENABLED | INSTANCE_ARN | INSTANCE_LABELS | FLEET_TYPE, /* required */
        operator: EQUALS | LESS_THAN | LESS_THAN_OR_EQUALS | GREATER_THAN | GREATER_THAN_OR_EQUALS | IN | NOT_IN | CONTAINS, /* required */
        values: [ /* required */
          'STRING_VALUE',
          /* more items */
        ]
      },
      /* more items */
    ],
    maxDevices: 'NUMBER_VALUE' /* required */
  },
  executionConfiguration: {
    accountsCleanup: true || false,
    appPackagesCleanup: true || false,
    jobTimeoutMinutes: 'NUMBER_VALUE',
    skipAppResign: true || false,
    videoCapture: true || false
  },
  name: 'STRING_VALUE'
};
devicefarm.scheduleRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

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

    • appArn — (String)

      The ARN of an application package to run tests against, created with CreateUpload. See ListUploads.

    • devicePoolArn — (String)

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

    • deviceSelectionConfiguration — (map)

      The filter criteria used to dynamically select a set of devices for a test run and the maximum number of devices to be included in the run.

      Either devicePoolArn or deviceSelectionConfiguration is required in a request.

      • filtersrequired — (Array<map>)

        Used to dynamically select a set of devices for a test run. A filter is made up of an attribute, an operator, and one or more values.

        • Attribute

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

          Allowed values include:

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

          • PLATFORM: The device platform. Valid values are ANDROID or IOS.

          • OS_VERSION: The operating system version (for example, 10.3.2).

          • MODEL: The device model (for example, iPad 5th Gen).

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

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

          • MANUFACTURER: The device manufacturer (for example, Apple).

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

          • REMOTE_DEBUG_ENABLED: Whether the device is enabled for remote debugging. Valid values are TRUE or FALSE. Because remote debugging is no longer supported, this filter is ignored.

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

          • INSTANCE_LABELS: The label of the device instance.

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

        • Operator

          The filter operator.

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

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

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

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

        • Values

          An array of one or more filter values.

          Operator Values

          • The IN and NOT_IN operators can take a values array that has more than one element.

          • The other operators require an array with a single element.

          Attribute Values

          • The PLATFORM attribute can be set to ANDROID or IOS.

          • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

        • attributerequired — (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

          Because remote debugging is no longer supported, this filter is ignored.

          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

          Possible values include:
          • "ARN"
          • "PLATFORM"
          • "OS_VERSION"
          • "MODEL"
          • "AVAILABILITY"
          • "FORM_FACTOR"
          • "MANUFACTURER"
          • "REMOTE_ACCESS_ENABLED"
          • "REMOTE_DEBUG_ENABLED"
          • "INSTANCE_ARN"
          • "INSTANCE_LABELS"
          • "FLEET_TYPE"
        • operatorrequired — (String)

          Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

          Possible values include:
          • "EQUALS"
          • "LESS_THAN"
          • "LESS_THAN_OR_EQUALS"
          • "GREATER_THAN"
          • "GREATER_THAN_OR_EQUALS"
          • "IN"
          • "NOT_IN"
          • "CONTAINS"
        • valuesrequired — (Array<String>)

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

          Operator Values

          • The IN and NOT_IN operators can take a values array that has more than one element.

          • The other operators require an array with a single element.

          Attribute Values

          • The PLATFORM attribute can be set to ANDROID or IOS.

          • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

      • maxDevicesrequired — (Integer)

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

    • name — (String)

      The name for the run to be scheduled.

    • test — (map)

      Information about the test for the run to be scheduled.

      • typerequired — (String)

        The test's type.

        Must be one of the following values:

        • BUILTIN_FUZZ

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

        • 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

        Possible values include:
        • "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)

        The ARN of the uploaded test to be run.

      • testSpecArn — (String)

        The ARN of the YAML-formatted test specification.

      • filter — (String)

        The test's filter.

      • parameters — (map<String>)

        The test's parameters, such as test framework parameters and fixture settings. Parameters are represented by name-value pairs of strings.

        For all tests:

        • app_performance_monitoring: Performance monitoring is enabled by default. Set this parameter to false to disable it.

        For Calabash tests:

        • profile: A cucumber profile (for example, my_profile_name).

        • tags: You can limit execution to features or scenarios that have (or don't have) certain tags (for example, @smoke or @smoke,~@wip).

        For Appium tests (all types):

        • appium_version: The Appium version. Currently supported values are 1.6.5 (and later), latest, and default.

          • latest runs the latest Appium version supported by Device Farm (1.9.1).

          • For default, Device Farm selects a compatible version of Appium for the device. The current behavior is to run 1.7.2 on Android devices and iOS 9 and earlier and 1.7.2 for iOS 10 and later.

          • This behavior is subject to change.

        For fuzz tests (Android only):

        • event_count: The number of events, between 1 and 10000, that the UI fuzz test should perform.

        • throttle: The time, in ms, between 0 and 1000, that the UI fuzz test should wait between events.

        • seed: A seed to use for randomizing the UI fuzz test. Using the same seed value between tests ensures identical event sequences.

        For Explorer tests:

        • username: A user name to use if the Explorer encounters a login form. If not supplied, no user name is inserted.

        • password: A password to use if the Explorer encounters a login form. If not supplied, no password is inserted.

        For Instrumentation:

        • filter: A test filter string. Examples:

          • Running a single test case: com.android.abc.Test1

          • Running a single test: com.android.abc.Test1#smoke

          • Running multiple tests: com.android.abc.Test1,com.android.abc.Test2

        For XCTest and XCTestUI:

        • filter: A test filter string. Examples:

          • Running a single test class: LoginTests

          • Running a multiple test classes: LoginTests,SmokeTests

          • Running a single test: LoginTests/testValid

          • Running multiple tests: LoginTests/testValid,LoginTests/testInvalid

        For UIAutomator:

        • filter: A test filter string. Examples:

          • Running a single test case: com.android.abc.Test1

          • Running a single test: com.android.abc.Test1#smoke

          • Running multiple tests: com.android.abc.Test1,com.android.abc.Test2

    • configuration — (map)

      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 extracts 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 — (map)

        Information about the location that is used for the run.

        • latituderequired — (Float)

          The latitude.

        • longituderequired — (Float)

          The longitude.

      • vpceConfigurationArns — (Array<String>)

        An array of ARNs for your VPC endpoint configurations.

      • customerArtifactPaths — (map)

        Input CustomerArtifactPaths object for the scheduled run configuration.

        • iosPaths — (Array<String>)

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

        • androidPaths — (Array<String>)

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

        • deviceHostPaths — (Array<String>)

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

      • radios — (map)

        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 — (Array<String>)

        A list of upload ARNs for app packages to be installed with your app.

      • billingMethod — (String)

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

        Note: If you have purchased unmetered device slots, you must set this parameter to unmetered to make use of them. Otherwise, your run counts against your metered time.
        Possible values include:
        • "METERED"
        • "UNMETERED"
    • executionConfiguration — (map)

      Specifies configuration information about a test run, such as the execution timeout (in minutes).

      • jobTimeoutMinutes — (Integer)

        The number of minutes a test run executes before it times out.

      • accountsCleanup — (Boolean)

        True if account cleanup is enabled at the beginning of the test. Otherwise, false.

      • appPackagesCleanup — (Boolean)

        True if app package cleanup is enabled at the beginning of the test. Otherwise, false.

      • videoCapture — (Boolean)

        Set to true to enable video capture. Otherwise, set to false. The default is true.

      • skipAppResign — (Boolean)

        When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • run — (map)

        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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (String)

          The run's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • created — (Date)

          When the run was created.

        • status — (String)

          The run's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The run's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The run's start time.

        • stopped — (Date)

          The run's stop time.

        • counters — (map)

          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.

          Note: If you have unmetered device slots, you must set this to unmetered to use them. Otherwise, the run is counted toward metered device minutes.
          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          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 — (map)

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

            Possible values include:
            • "CURATED"
            • "PRIVATE"
          • 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 an 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.

          Possible values include:
          • "PARSING_FAILED"
          • "VPC_ENDPOINT_SETUP_FAILED"
        • 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 executes 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 — (map)

          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 — (map)

          Information about the location that is used for the run.

          • latituderequired — (Float)

            The latitude.

          • longituderequired — (Float)

            The longitude.

        • customerArtifactPaths — (map)

          Output CustomerArtifactPaths object for the test run.

          • iosPaths — (Array<String>)

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

          • androidPaths — (Array<String>)

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

          • deviceHostPaths — (Array<String>)

            Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests are 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 does not sign your app again. For public devices, Device Farm always signs your apps again.

          For more information about how Device Farm re-signs your apps, 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 — (map)

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

          • filters — (Array<map>)

            The filters in a device selection result.

            • attributerequired — (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

              Because remote debugging is no longer supported, this filter is ignored.

              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

              Possible values include:
              • "ARN"
              • "PLATFORM"
              • "OS_VERSION"
              • "MODEL"
              • "AVAILABILITY"
              • "FORM_FACTOR"
              • "MANUFACTURER"
              • "REMOTE_ACCESS_ENABLED"
              • "REMOTE_DEBUG_ENABLED"
              • "INSTANCE_ARN"
              • "INSTANCE_LABELS"
              • "FLEET_TYPE"
            • operatorrequired — (String)

              Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

              Possible values include:
              • "EQUALS"
              • "LESS_THAN"
              • "LESS_THAN_OR_EQUALS"
              • "GREATER_THAN"
              • "GREATER_THAN_OR_EQUALS"
              • "IN"
              • "NOT_IN"
              • "CONTAINS"
            • valuesrequired — (Array<String>)

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

              Operator Values

              • The IN and NOT_IN operators can take a values array that has more than one element.

              • The other operators require an array with a single element.

              Attribute Values

              • The PLATFORM attribute can be set to ANDROID or IOS.

              • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

stopJob(params = {}, callback) ⇒ AWS.Request

Initiates a stop request for the current job. AWS Device Farm immediately stops the job on the device where tests have not started. You are not billed for this device. On the device where tests have started, setup suite and teardown suite tests run to completion on the device. You are billed for setup, teardown, and any tests that were in progress or already completed.

Service Reference:

Examples:

Calling the stopJob operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.stopJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      Represents the Amazon Resource Name (ARN) of the Device Farm job to stop.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • job — (map)

        The job that was stopped.

        • 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

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

          • 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

          Possible values include:
          • "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 — (Date)

          When the job was created.

        • status — (String)

          The job's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The job's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The job's start time.

        • stopped — (Date)

          The job's stop time.

        • counters — (map)

          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 — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • deviceMinutes — (map)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

stopRemoteAccessSession(params = {}, callback) ⇒ AWS.Request

Ends a specified remote access session.

Service Reference:

Examples:

Calling the stopRemoteAccessSession operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.stopRemoteAccessSession(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the remote access session to stop.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • remoteAccessSession — (map)

        A container that represents the metadata from the service about the remote access session you are stopping.

        • arn — (String)

          The Amazon Resource Name (ARN) of the remote access session.

        • name — (String)

          The name of the remote access session.

        • created — (Date)

          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:

          • PENDING.

          • PENDING_CONCURRENCY.

          • PENDING_DEVICE.

          • PROCESSING.

          • SCHEDULING.

          • PREPARING.

          • RUNNING.

          • COMPLETED.

          • STOPPING.

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The result of the remote access session. Can be any of the following:

          • PENDING.

          • PASSED.

          • WARNED.

          • FAILED.

          • SKIPPED.

          • ERRORED.

          • STOPPED.

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • message — (String)

          A message about the remote access session.

        • started — (Date)

          The date and time the remote access session was started.

        • stopped — (Date)

          The date and time the remote access session was stopped.

        • device — (map)

          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:

            • PHONE

            • TABLET

            Possible values include:
            • "PHONE"
            • "TABLET"
          • platform — (String)

            The device's platform.

            Allowed values include:

            • ANDROID

            • IOS

            Possible values include:
            • "ANDROID"
            • "IOS"
          • os — (String)

            The device's operating system type.

          • cpu — (map)

            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 — (map)

            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.

            Remote debugging is no longer supported.

          • fleetType — (String)

            The type of fleet to which this device belongs. Possible values are PRIVATE and PUBLIC.

          • fleetName — (String)

            The name of the fleet to which this device belongs.

          • instances — (Array<map>)

            The instances that belong to this device.

            • arn — (String)

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

            • deviceArn — (String)

              The ARN of the device.

            • labels — (Array<String>)

              An array of strings that describe the device instance.

            • status — (String)

              The status of the device instance. Valid values are listed here.

              Possible values include:
              • "IN_USE"
              • "PREPARING"
              • "AVAILABLE"
              • "NOT_AVAILABLE"
            • udid — (String)

              Unique device identifier for the device instance.

            • instanceProfile — (map)

              A object that contains information about the instance profile.

              • arn — (String)

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

              • packageCleanup — (Boolean)

                When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

              • excludeAppPackagesFromCleanup — (Array<String>)

                An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

                The list of packages is considered only if you set packageCleanup to true.

              • rebootAfterUse — (Boolean)

                When set to true, Device Farm reboots 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)

            Indicates how likely a device is available for a test run. Currently available in the ListDevices and GetDevice API methods.

            Possible values include:
            • "TEMPORARY_NOT_AVAILABLE"
            • "BUSY"
            • "AVAILABLE"
            • "HIGHLY_AVAILABLE"
        • instanceArn — (String)

          The ARN of the instance.

        • remoteDebugEnabled — (Boolean)

          This flag is set to true if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

        • remoteRecordEnabled — (Boolean)

          This flag is set to true if remote recording is enabled for the remote access session.

        • remoteRecordAppArn — (String)

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

          Remote debugging is no longer supported.

        • clientId — (String)

          Unique identifier of your client for the remote access session. Only returned if remote debugging is enabled for the remote access session.

          Remote debugging is no longer supported.

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

          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          The number of minutes a device is used in a remote access session (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.

          Remote debugging is no longer supported.

        • interactionMode — (String)

          The interaction mode of the remote access session. Valid values are:

          • INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen. You cannot run XCUITest framework-based tests in this mode.

          • NO_VIDEO: You are connected to the device, but cannot interact with it or view the screen. This mode has the fastest test execution speed. You can run XCUITest framework-based tests in this mode.

          • VIDEO_ONLY: You can view the screen, but cannot touch or rotate it. You can run XCUITest framework-based tests and watch the screen in this mode.

          Possible values include:
          • "INTERACTIVE"
          • "NO_VIDEO"
          • "VIDEO_ONLY"
        • skipAppResign — (Boolean)

          When set to true, for private devices, Device Farm does not sign your app again. For public devices, Device Farm always signs your apps again.

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

stopRun(params = {}, callback) ⇒ AWS.Request

Initiates a stop request for the current test run. AWS Device Farm immediately stops the run on devices where tests have not started. You are not billed for these devices. On devices where tests have started executing, setup suite and teardown suite tests run to completion on those devices. You are billed for setup, teardown, and any tests that were in progress or already completed.

Service Reference:

Examples:

To stop a test run


/* The following example stops a specific test run. */

 var params = {
  arn: "arn:aws:devicefarm:us-west-2:123456789101:run:EXAMPLE-GUID-123-456"// You can get the Amazon Resource Name (ARN) of the test run by using the list-runs CLI command.
 };
 devicefarm.stopRun(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    run: {
    }
   }
   */
 });

Calling the stopRun operation

var params = {
  arn: 'STRING_VALUE' /* required */
};
devicefarm.stopRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • run — (map)

        The run that was stopped.

        • 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

          • BUILTIN_EXPLORER

            Note: For Android, an app explorer that traverses an Android app, interacting with it and capturing screenshots at the same time.
          • 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

          Possible values include:
          • "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 — (String)

          The run's platform.

          Allowed values include:

          • ANDROID

          • IOS

          Possible values include:
          • "ANDROID"
          • "IOS"
        • created — (Date)

          When the run was created.

        • status — (String)

          The run's status.

          Allowed values include:

          • PENDING

          • PENDING_CONCURRENCY

          • PENDING_DEVICE

          • PROCESSING

          • SCHEDULING

          • PREPARING

          • RUNNING

          • COMPLETED

          • STOPPING

          Possible values include:
          • "PENDING"
          • "PENDING_CONCURRENCY"
          • "PENDING_DEVICE"
          • "PROCESSING"
          • "SCHEDULING"
          • "PREPARING"
          • "RUNNING"
          • "COMPLETED"
          • "STOPPING"
        • result — (String)

          The run's result.

          Allowed values include:

          • PENDING

          • PASSED

          • WARNED

          • FAILED

          • SKIPPED

          • ERRORED

          • STOPPED

          Possible values include:
          • "PENDING"
          • "PASSED"
          • "WARNED"
          • "FAILED"
          • "SKIPPED"
          • "ERRORED"
          • "STOPPED"
        • started — (Date)

          The run's start time.

        • stopped — (Date)

          The run's stop time.

        • counters — (map)

          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.

          Note: If you have unmetered device slots, you must set this to unmetered to use them. Otherwise, the run is counted toward metered device minutes.
          Possible values include:
          • "METERED"
          • "UNMETERED"
        • deviceMinutes — (map)

          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 — (map)

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

            Possible values include:
            • "CURATED"
            • "PRIVATE"
          • 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 an 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.

          Possible values include:
          • "PARSING_FAILED"
          • "VPC_ENDPOINT_SETUP_FAILED"
        • 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 executes 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 — (map)

          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 — (map)

          Information about the location that is used for the run.

          • latituderequired — (Float)

            The latitude.

          • longituderequired — (Float)

            The longitude.

        • customerArtifactPaths — (map)

          Output CustomerArtifactPaths object for the test run.

          • iosPaths — (Array<String>)

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

          • androidPaths — (Array<String>)

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

          • deviceHostPaths — (Array<String>)

            Comma-separated list of paths in the test execution environment where the artifacts generated by the customer's tests are 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 does not sign your app again. For public devices, Device Farm always signs your apps again.

          For more information about how Device Farm re-signs your apps, 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 — (map)

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

          • filters — (Array<map>)

            The filters in a device selection result.

            • attributerequired — (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

              Because remote debugging is no longer supported, this filter is ignored.

              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

              Possible values include:
              • "ARN"
              • "PLATFORM"
              • "OS_VERSION"
              • "MODEL"
              • "AVAILABILITY"
              • "FORM_FACTOR"
              • "MANUFACTURER"
              • "REMOTE_ACCESS_ENABLED"
              • "REMOTE_DEBUG_ENABLED"
              • "INSTANCE_ARN"
              • "INSTANCE_LABELS"
              • "FLEET_TYPE"
            • operatorrequired — (String)

              Specifies how Device Farm compares the filter's attribute to the value. See the attribute descriptions.

              Possible values include:
              • "EQUALS"
              • "LESS_THAN"
              • "LESS_THAN_OR_EQUALS"
              • "GREATER_THAN"
              • "GREATER_THAN_OR_EQUALS"
              • "IN"
              • "NOT_IN"
              • "CONTAINS"
            • valuesrequired — (Array<String>)

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

              Operator Values

              • The IN and NOT_IN operators can take a values array that has more than one element.

              • The other operators require an array with a single element.

              Attribute Values

              • The PLATFORM attribute can be set to ANDROID or IOS.

              • The AVAILABILITY attribute can be set to AVAILABLE, HIGHLY_AVAILABLE, BUSY, or TEMPORARY_NOT_AVAILABLE.

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

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

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

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

tagResource(params = {}, callback) ⇒ AWS.Request

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 also deleted.

Service Reference:

Examples:

Calling the tagResource operation

var params = {
  ResourceARN: 'STRING_VALUE', /* required */
  Tags: [ /* required */
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
devicefarm.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (String)

      The Amazon Resource Name (ARN) of the resource or resources 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.

    • Tags — (Array<map>)

      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. Tag values can have a maximum length of 256 characters.

      • Keyrequired — (String)

        One part of a key-value pair that makes up a tag. A key is a general label that acts like a category for more specific tag values.

      • Valuerequired — (String)

        The optional part of a key-value pair that makes up a tag. A value acts as a descriptor in a tag category (key).

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

untagResource(params = {}, callback) ⇒ AWS.Request

Deletes the specified tags from a resource.

Service Reference:

Examples:

Calling the untagResource operation

var params = {
  ResourceARN: 'STRING_VALUE', /* required */
  TagKeys: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
devicefarm.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (String)

      The Amazon Resource Name (ARN) of the resource or resources 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.

    • TagKeys — (Array<String>)

      The keys of the tags to be removed.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateDeviceInstance(params = {}, callback) ⇒ AWS.Request

Updates information about a private device instance.

Service Reference:

Examples:

Calling the updateDeviceInstance operation

var params = {
  arn: 'STRING_VALUE', /* required */
  labels: [
    'STRING_VALUE',
    /* more items */
  ],
  profileArn: 'STRING_VALUE'
};
devicefarm.updateDeviceInstance(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

    • profileArn — (String)

      The ARN of the profile that you want to associate with the device instance.

    • labels — (Array<String>)

      An array of strings that you want to associate with the device instance.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • deviceInstance — (map)

        An object that contains information about your device instance.

        • arn — (String)

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

        • deviceArn — (String)

          The ARN of the device.

        • labels — (Array<String>)

          An array of strings that describe the device instance.

        • status — (String)

          The status of the device instance. Valid values are listed here.

          Possible values include:
          • "IN_USE"
          • "PREPARING"
          • "AVAILABLE"
          • "NOT_AVAILABLE"
        • udid — (String)

          Unique device identifier for the device instance.

        • instanceProfile — (map)

          A object that contains information about the instance profile.

          • arn — (String)

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

          • packageCleanup — (Boolean)

            When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

          • excludeAppPackagesFromCleanup — (Array<String>)

            An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

            The list of packages is considered only if you set packageCleanup to true.

          • rebootAfterUse — (Boolean)

            When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateDevicePool(params = {}, callback) ⇒ AWS.Request

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

Service Reference:

Examples:

To update a device pool


/* 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. */

 var params = {
  name: "NewName", 
  arn: "arn:aws:devicefarm:us-west-2::devicepool:082d10e5-d7d7-48a5-ba5c-12345EXAMPLE", // You can get the Amazon Resource Name (ARN) of the device pool by using the list-pools CLI command.
  description: "NewDescription", 
  rules: [
     {
    value: "True", 
    attribute: "REMOTE_ACCESS_ENABLED", 
    operator: "EQUALS"
   }
  ]
 };
 devicefarm.updateDevicePool(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    devicePool: {
    }// Note: you cannot update curated device pools.
   }
   */
 });

Calling the updateDevicePool operation

var params = {
  arn: 'STRING_VALUE', /* required */
  clearMaxDevices: true || false,
  description: 'STRING_VALUE',
  maxDevices: 'NUMBER_VALUE',
  name: 'STRING_VALUE',
  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_VALUE'
    },
    /* more items */
  ]
};
devicefarm.updateDevicePool(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the Device Farm device pool to update.

    • name — (String)

      A string that represents the name of the device pool to update.

    • description — (String)

      A description of the device pool to update.

    • rules — (Array<map>)

      Represents the rules to modify for the device pool. Updating rules is optional. If you update rules for your request, the update replaces the existing rules.

      • 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

        Because remote debugging is no longer supported, this filter is ignored.

        Possible values include:
        • "ARN"
        • "PLATFORM"
        • "FORM_FACTOR"
        • "MANUFACTURER"
        • "REMOTE_ACCESS_ENABLED"
        • "REMOTE_DEBUG_ENABLED"
        • "APPIUM_VERSION"
        • "INSTANCE_ARN"
        • "INSTANCE_LABELS"
        • "FLEET_TYPE"
        • "OS_VERSION"
        • "MODEL"
        • "AVAILABILITY"
      • 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.

        Possible values include:
        • "EQUALS"
        • "LESS_THAN"
        • "LESS_THAN_OR_EQUALS"
        • "GREATER_THAN"
        • "GREATER_THAN_OR_EQUALS"
        • "IN"
        • "NOT_IN"
        • "CONTAINS"
      • 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.

      If you use this parameter in your request, you cannot use the clearMaxDevices parameter in the same request.

    • clearMaxDevices — (Boolean)

      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 specified in the rules parameter.

      If you use this parameter in your request, you cannot use the maxDevices parameter in the same request.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • devicePool — (map)

        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:

          • CURATED: A device pool that is created and managed by AWS Device Farm.

          • PRIVATE: A device pool that is created and managed by the device pool developer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • rules — (Array<map>)

          Information about the device pool's rules.

          • 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

            Because remote debugging is no longer supported, this filter is ignored.

            Possible values include:
            • "ARN"
            • "PLATFORM"
            • "FORM_FACTOR"
            • "MANUFACTURER"
            • "REMOTE_ACCESS_ENABLED"
            • "REMOTE_DEBUG_ENABLED"
            • "APPIUM_VERSION"
            • "INSTANCE_ARN"
            • "INSTANCE_LABELS"
            • "FLEET_TYPE"
            • "OS_VERSION"
            • "MODEL"
            • "AVAILABILITY"
          • 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.

            Possible values include:
            • "EQUALS"
            • "LESS_THAN"
            • "LESS_THAN_OR_EQUALS"
            • "GREATER_THAN"
            • "GREATER_THAN_OR_EQUALS"
            • "IN"
            • "NOT_IN"
            • "CONTAINS"
          • 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 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateInstanceProfile(params = {}, callback) ⇒ AWS.Request

Updates information about an existing private device instance profile.

Service Reference:

Examples:

Calling the updateInstanceProfile operation

var params = {
  arn: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  excludeAppPackagesFromCleanup: [
    'STRING_VALUE',
    /* more items */
  ],
  name: 'STRING_VALUE',
  packageCleanup: true || false,
  rebootAfterUse: true || false
};
devicefarm.updateInstanceProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

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

    • name — (String)

      The updated name for your instance profile.

    • description — (String)

      The updated description for your instance profile.

    • packageCleanup — (Boolean)

      The updated choice for whether you want to specify package cleanup. The default value is false for private devices.

    • excludeAppPackagesFromCleanup — (Array<String>)

      An array of strings that specifies 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)

      The updated choice for whether you want to reboot the device after use. The default value is true.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • instanceProfile — (map)

        An object that contains information about your instance profile.

        • arn — (String)

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

        • packageCleanup — (Boolean)

          When set to true, Device Farm removes app packages after a test run. The default value is false for private devices.

        • excludeAppPackagesFromCleanup — (Array<String>)

          An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.

          The list of packages is considered only if you set packageCleanup to true.

        • rebootAfterUse — (Boolean)

          When set to true, Device Farm reboots 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateNetworkProfile(params = {}, callback) ⇒ AWS.Request

Updates the network profile.

Service Reference:

Examples:

Calling the updateNetworkProfile operation

var params = {
  arn: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  downlinkBandwidthBits: 'NUMBER_VALUE',
  downlinkDelayMs: 'NUMBER_VALUE',
  downlinkJitterMs: 'NUMBER_VALUE',
  downlinkLossPercent: 'NUMBER_VALUE',
  name: 'STRING_VALUE',
  type: CURATED | PRIVATE,
  uplinkBandwidthBits: 'NUMBER_VALUE',
  uplinkDelayMs: 'NUMBER_VALUE',
  uplinkJitterMs: 'NUMBER_VALUE',
  uplinkLossPercent: 'NUMBER_VALUE'
};
devicefarm.updateNetworkProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the project for which you want to update network profile settings.

    • name — (String)

      The name of the network profile about which you are returning information.

    • description — (String)

      The description of the network profile about which you are returning information.

    • type — (String)

      The type of network profile to return information about. Valid values are listed here.

      Possible values include:
      • "CURATED"
      • "PRIVATE"
    • 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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • networkProfile — (map)

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

          Possible values include:
          • "CURATED"
          • "PRIVATE"
        • 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateProject(params = {}, callback) ⇒ AWS.Request

Modifies the specified project name, given the project ARN and a new name.

Service Reference:

Examples:

To update a device pool


/* The following example updates the specified project with a new name. */

 var params = {
  name: "NewName", 
  arn: "arn:aws:devicefarm:us-west-2:123456789101:project:8f75187d-101e-4625-accc-12345EXAMPLE"// You can get the Amazon Resource Name (ARN) of the project by using the list-projects CLI command.
 };
 devicefarm.updateProject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    project: {
     name: "NewName", 
     arn: "arn:aws:devicefarm:us-west-2:123456789101:project:8f75187d-101e-4625-accc-12345EXAMPLE", 
     created: <Date Representation>
    }
   }
   */
 });

Calling the updateProject operation

var params = {
  arn: 'STRING_VALUE', /* required */
  defaultJobTimeoutMinutes: 'NUMBER_VALUE',
  name: 'STRING_VALUE',
  vpcConfig: {
    securityGroupIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    subnetIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    vpcId: 'STRING_VALUE' /* required */
  }
};
devicefarm.updateProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the project whose name to update.

    • name — (String)

      A string that represents the new name of the project that you are updating.

    • defaultJobTimeoutMinutes — (Integer)

      The number of minutes a test run in the project executes before it times out.

    • vpcConfig — (map)

      The VPC security groups and subnets that are attached to a project.

      • securityGroupIdsrequired — (Array<String>)

        An array of one or more security groups IDs in your Amazon VPC.

      • subnetIdsrequired — (Array<String>)

        An array of one or more subnet IDs in your Amazon VPC.

      • vpcIdrequired — (String)

        The ID of the Amazon VPC.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • project — (map)

        The project 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 executes before it times out. The default value is 150 minutes.

        • created — (Date)

          When the project was created.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            An array of one or more security groups IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            An array of one or more subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateTestGridProject(params = {}, callback) ⇒ AWS.Request

Change details of a project.

Service Reference:

Examples:

Calling the updateTestGridProject operation

var params = {
  projectArn: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  name: 'STRING_VALUE',
  vpcConfig: {
    securityGroupIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    subnetIds: [ /* required */
      'STRING_VALUE',
      /* more items */
    ],
    vpcId: 'STRING_VALUE' /* required */
  }
};
devicefarm.updateTestGridProject(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • projectArn — (String)

      ARN of the project to update.

    • name — (String)

      Human-readable name for the project.

    • description — (String)

      Human-readable description for the project.

    • vpcConfig — (map)

      The VPC security groups and subnets that are attached to a project.

      • securityGroupIdsrequired — (Array<String>)

        A list of VPC security group IDs in your Amazon VPC.

      • subnetIdsrequired — (Array<String>)

        A list of VPC subnet IDs in your Amazon VPC.

      • vpcIdrequired — (String)

        The ID of the Amazon VPC.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testGridProject — (map)

        The project, including updated information.

        • arn — (String)

          The ARN for the project.

        • name — (String)

          A human-readable name for the project.

        • description — (String)

          A human-readable description for the project.

        • vpcConfig — (map)

          The VPC security groups and subnets that are attached to a project.

          • securityGroupIdsrequired — (Array<String>)

            A list of VPC security group IDs in your Amazon VPC.

          • subnetIdsrequired — (Array<String>)

            A list of VPC subnet IDs in your Amazon VPC.

          • vpcIdrequired — (String)

            The ID of the Amazon VPC.

        • created — (Date)

          When the project was created.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateUpload(params = {}, callback) ⇒ AWS.Request

Updates an uploaded test spec.

Service Reference:

Examples:

Calling the updateUpload operation

var params = {
  arn: 'STRING_VALUE', /* required */
  contentType: 'STRING_VALUE',
  editContent: true || false,
  name: 'STRING_VALUE'
};
devicefarm.updateUpload(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the uploaded test spec.

    • name — (String)

      The upload's test spec file name. The name must not contain any forward slashes (/). The test spec file name must end with the .yaml or .yml file extension.

    • contentType — (String)

      The upload's content type (for example, application/x-yaml).

    • editContent — (Boolean)

      Set to true if the YAML file has changed and must be updated. Otherwise, set to false.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • upload — (map)

        A test spec uploaded to Device Farm.

        • arn — (String)

          The upload's ARN.

        • name — (String)

          The upload's file name.

        • created — (Date)

          When the upload was created.

        • type — (String)

          The upload's type.

          Must be one of the following values:

          • 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

          Possible values include:
          • "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 — (String)

          The upload's status.

          Must be one of the following values:

          • FAILED

          • INITIALIZED

          • PROCESSING

          • SUCCEEDED

          Possible values include:
          • "INITIALIZED"
          • "PROCESSING"
          • "SUCCEEDED"
          • "FAILED"
        • url — (String)

          The presigned Amazon S3 URL that was used to store a file using a 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:

          • CURATED: An upload managed by AWS Device Farm.

          • PRIVATE: An upload managed by the AWS Device Farm customer.

          Possible values include:
          • "CURATED"
          • "PRIVATE"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateVPCEConfiguration(params = {}, callback) ⇒ AWS.Request

Updates information about an Amazon Virtual Private Cloud (VPC) endpoint configuration.

Service Reference:

Examples:

Calling the updateVPCEConfiguration operation

var params = {
  arn: 'STRING_VALUE', /* required */
  serviceDnsName: 'STRING_VALUE',
  vpceConfigurationDescription: 'STRING_VALUE',
  vpceConfigurationName: 'STRING_VALUE',
  vpceServiceName: 'STRING_VALUE'
};
devicefarm.updateVPCEConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • arn — (String)

      The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to update.

    • 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 in your AWS account that you want Device Farm to test.

    • serviceDnsName — (String)

      The DNS (domain) name used to connect to your private service in your VPC. The DNS name must not already be in use on the internet.

    • vpceConfigurationDescription — (String)

      An optional description that provides details about your VPC endpoint configuration.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • vpceConfiguration — (map)

        An object that contains 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 in 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 that provides details about your VPC endpoint configuration.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.