DeviceFarm / Client / get_device_instance

get_device_instance#

DeviceFarm.Client.get_device_instance(**kwargs)#

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

See also: AWS API Documentation

Request Syntax

response = client.get_device_instance(
    arn='string'
)
Parameters:

arn (string) –

[REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

{
    'deviceInstance': {
        'arn': 'string',
        'deviceArn': 'string',
        'labels': [
            'string',
        ],
        'status': 'IN_USE'|'PREPARING'|'AVAILABLE'|'NOT_AVAILABLE',
        'udid': 'string',
        'instanceProfile': {
            'arn': 'string',
            'packageCleanup': True|False,
            'excludeAppPackagesFromCleanup': [
                'string',
            ],
            'rebootAfterUse': True|False,
            'name': 'string',
            'description': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • deviceInstance (dict) –

      An object 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 (list) –

        An array of strings that describe the device instance.

        • (string) –

      • status (string) –

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

      • udid (string) –

        Unique device identifier for the device instance.

      • instanceProfile (dict) –

        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 (list) –

          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.

          • (string) –

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

Exceptions

  • DeviceFarm.Client.exceptions.ArgumentException

  • DeviceFarm.Client.exceptions.NotFoundException

  • DeviceFarm.Client.exceptions.LimitExceededException

  • DeviceFarm.Client.exceptions.ServiceAccountException