Legacy | Recover device

  • Command: device

  • Subcommand: recover

  • Supported Platforms: Native (legacy), UFT (legacy), Selenium, Appium

    All commands must be executed using the same framework. Sharing the execution ID between different frameworks is not possible. This means that if you work with a Selenium/Appium driver, you need to call the commands using the Selenium/Appium driver (or, in the case of Reporting commands, through the Reporting SDK that works with the driver) and not as part of a UFT test or another framework.

  • Supported OS: Android, iOS

Recovers a connected device that is unresponsive. For example, a device with an interrupted video, black screen or touch failure.

Description

The device will not be rebooted; it will be disconnected and reconnected to the Perfecto data center, and returned unlocked. To reboot the device, use the Reboot device function.

Recovery will take a few minutes to complete. Use this function at the end of your script instance of the device in error. This is useful for your next run.

Important: Devices continuously in error state should be checked. In such cases, contact your Perfecto system administrator for support.
Restriction: When using this command in Automation scripts, the execution report video may not be available.

Parameters

Name Value Default Description
deviceID*     The device for this command.

* Mandatory parameter

Request & Response

Copy

Reqest

https://mycloud.perfectomobile.com/services/executions/john@perfectomobile.com_controller_16-11-02_12_21_16_829?operation=command&securityToken=<your_token>&command=device&subcommand=recover&param.deviceId=6370E775
Copy

JSON response

{
    "executionId":"john@perfectomobile.com_controller_16-11-06_07_08_05_338",
    "reason":"Success",
    "timer.elapsed":"7188",
    "testGridReportUrl":"https://mycloud.reporting-stg.perfectomobile.com?externalId[0]=john@perfectomobile.com_controller_16-11-06_07_08_05_338",
    "timer.ux":"0",
    "singleTestReportUrl":"https://mycloud.perfectomobile.com/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/161106/controller_16-11-06_07_08_05_338.xml&ownerId=john@perfectomobile.com&sharingCode=f528fdd2-5d98-4a0a-9e3e-ffb7219235e0",
    "description":"Success",
    "timer.system":"7188",
    "reportKey":"PRIVATE:controller/161106/controller_16-11-06_07_08_05_338.xml",
    "completed":"true",
    "flowEndCode":"SUCCEEDED",
    "timer.device":"0"}