DeviceFarm / Client / update_device_instance

update_device_instance

DeviceFarm.Client.update_device_instance(**kwargs)

Updates information about a private device instance.

See also: AWS API Documentation

Request Syntax

response = client.update_device_instance(
    arn='string',
    profileArn='string',
    labels=[
        'string',
    ]
)

Parameters:

• arn (string) –

  [REQUIRED]

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

  An array of strings that you want to associate with the device instance.

  • (string) –

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