RevertVm

Restores a specific machine in an environment to the state of that machine in the default snapshot. Any other machines in the environment are not affected.

Request URL

GET https://use.cloudshare.com/API/v2/Env/RevertVm?envId=<env>&vmId=<id>&UserApiId=<id>&token=<token>×tamp=<time>&HMAC=<signature>

Parameters

envId Id of the environment containing the machine.
vmId The unique id for the machine within the environment. This would be obtained, for example, using the ListEnvironments resource.
Example: PVSV2TWQQ2BA

Response example

{
    "data": {
        "vmId": "YWRFJAGBJ1SB"
    }, 
    "remaining_api_calls": 89, 
    "status_additional_data": null, 
    "status_code": "0x20000", 
    "status_text": "Success"
}

The machine id is returned.

The response is the id of the environment that was reverted.

Note that a successful (HTTP Status 200 – OK) response indicates that the request was valid and the reverted activity has commenced. This response is returned immediately. It does not mean that the reverted activity has completed and that the environment – with all of its machines – is now active. This could take some time (seconds, perhaps) to complete. To determine the progress of the reverted activity, the application should poll with the GetEnvironmentState resource, using the environment’s unique id.