---
title: "POST /#X-Amz-Target=DeviceFarm_20150623.UpdateDeviceInstance"
method: POST
path: "/#X-Amz-Target=DeviceFarm_20150623.UpdateDeviceInstance"
---

# POST /#X-Amz-Target=DeviceFarm_20150623.UpdateDeviceInstance

`POST /#X-Amz-Target=DeviceFarm_20150623.UpdateDeviceInstance`

Updates information about a private device instance.

## Headers

- `X-Amz-Target` 'DeviceFarm_20150623.UpdateDeviceInstance', required

## Request body

- UpdateDeviceInstanceRequest
  - `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` String[] — An array of strings that you want to associate with the device instance.

## Response `200`

Success

- UpdateDeviceInstanceResult
  - `deviceInstance` object — 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` String[] — An array of strings that describe the device instance.
    - `status` 'IN_USE' | 'PREPARING' | 'AVAILABLE' | 'NOT_AVAILABLE' — The status of the device instance. Valid values are listed here.
    - `udid` string — Unique device identifier for the device instance.
    - `instanceProfile` object — 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 <code>true</code>, Device Farm removes app packages after a test run. The default value is <code>false</code> for private devices.
      - `excludeAppPackagesFromCleanup` String[] — <p>An array of strings containing the list of app packages that should not be cleaned up from the device after a test run completes.</p> <p>The list of packages is considered only if you set <code>packageCleanup</code> to <code>true</code>.</p>
      - `rebootAfterUse` boolean — When set to <code>true</code>, Device Farm reboots the instance after a test run. The default value is <code>true</code>.
      - `name` string — The name of the instance profile.
      - `description` string — The description of the instance profile.

## Other responses

- `480` — ArgumentException
- `481` — NotFoundException
- `482` — LimitExceededException
- `483` — ServiceAccountException

---

[API](https://skmtc.net/aws/apis/devicefarm.md) · [All operations](https://skmtc.net/aws/apis/devicefarm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devicefarm/versions/a20834382f29/schema)