How to revert VM to snapshot

[slavavrn]

Re: Automation script to revert and save snapshot

Thanks.

Can I be sure that all API capabilities are reflected in Swagger?

So far, I've only found one method: creating a scheduled job, which can be launched via the API.
curl -k -X POST -b 'authenticationToken=<my-token-from-user-authentication-tokens>' 'https://<xen-local>/rest/v0/schedules/<schedule-id>/actions/run'
But that's a bit of a complicated process.

[olivierlambert]

Swagger is auto generated from the API, so the doc cannot lag. That's the point of the Swagger doc/API.

[slavavrn]

@olivierlambert
But, for example, for VMS, there are the following actions:
curl -k -X GET -H "Content-Type: application/json" -b authenticationToken=<my-token-from-user-authentication-tokens> 'https://<xen-local>/rest/v0/vms/<vm_id>/actions'
[
"/rest/v0/vms/<vm_id>/actions/clean_reboot",
"/rest/v0/vms/<vm_id>/actions/clean_shutdown",
"/rest/v0/vms/<vm_id>/actions/hard_reboot",
"/rest/v0/vms/<vm_id>/actions/hard_shutdown",
"/rest/v0/vms/<vm_id>/actions/snapshot",
"/rest/v0/vms/<vm_id>/actions/start"
]
but in swagger you can see only one action - start
So, not everything available through the API is reflected in Swagger?

[olivierlambert]

Because some endpoints aren't migrated to swagger yet (it needs to be correctly typed etc.). Each month we migrate more and more endpoint to it (it's almost done).

Adding @mathieuRA in the convo

[slavavrn]

So, Swagger isn't 100% API compliant. That's what I was saying
Can I see the API endpoints myself? Is the code open source?
https://github.com/vatesfr/xen-orchestra/blob/master/packages/xo-server/src/api/vm.mjs#L1088
Did I find the correct entry point?
Maybe I should use xo-cli to perform the revert operation? Or does the cli also access the API and can't provide more functionality?

[olivierlambert]

I will let @mathieuRA to answer

[slavavrn]

@olivierlambert There is no information on this issue yet?

[MathieuRA]

Hi @slavavrn
FYI, all endpoints are now documented in Swagger.

The REST API code is available here.

The revert snapshot action is not yet accessible via the REST API, but you can use it with xo-cli.

See
xo-cli vm.revert snapshot=<snapshot-id>

[olivierlambert]

Thanks @MathieuRA !

[MathieuRA]

Hi @slavavrn,
FYI, its now possible to revert a snapshot via the REST API.
POST /vms/:id/actions/revert_snapshot
And the body of the endpoint:

{
  "snapshotId": <snapshot-id>
  "snapshotBefore": boolean (optional)
}