How to change timeout for operations with VMs?

A timeout is set for operations with virtual machines (VMs) in the platform. After this time, VMmanager stops the task. Default timeout values:

for operations of creating, reinstalling and restoring VMs from a backup — 3600 sec (1 hour);
to execute a script on a VM or cluster node — 10800 sec (3 hours).

How to check the current timeout

To check the current timeout:

Get an authorization token:
```
curl -k -X POST -H "accept: application/json" -H "Content-Type: application/json" 'https://domain.com/auth/v4/public/token' -d '{"email": "admin_email", "password": "admin_pass"}'
```
Comments to the command

domain.com — domain name or IP address of the server with the platform
admin_email — platform administrator's email
admin_pass — platform administrator's password

In response, you will get the message in the form:
Example of response in JSON
```
{
  "confirmed": true,
  "expires_at": null,
  "id": "6",
  "token": "4-e9726dd9-61d9-2940-add3-914851d2cb8a"
}
```
Save the received token value.
Execute the request:
```
curl -k -X GET -H "X-XSRF-Token: <token>" "https://example.com/vm/v3/settings/task/<task_name>/timeout"
```
Comments to commands
- <token> — authorization token
- <task_name> — task name:
  - host_migrate — migrate VM
  - disk_migrate — migrate VM disk
  - disk_backup — VM backup
  - host_create — create VM
  - host_reinstall — reinstall VM
  - disk_restore — restore VM from backup
  - host_run_recipe — run script on VM
  - host_guest_agent_repair — install QEMU Guest Agent
  - host_image_create — create VM image
  - node_run_script — run script on cluster node
  - disk_resize — edit VM disk size
  - os_copy — upload OS template
  - disk_backup_relocate — relocate backups
  - host_clone — VM cloning

How to edit the timeout value

To edit the timeout value:

Get an authorization token:
```
curl -k -X POST -H "accept: application/json" -H "Content-Type: application/json" 'https://domain.com/auth/v4/public/token' -d '{"email": "admin_email", "password": "admin_pass"}'
```
Comments to the command

domain.com — domain name or IP address of the server with the platform
admin_email — platform administrator's email
admin_pass — platform administrator's password

In response, you will get the message in the form:
Example of response in JSON
```
{
  "confirmed": true,
  "expires_at": null,
  "id": "6",
  "token": "4-e9726dd9-61d9-2940-add3-914851d2cb8a"
}
```
Save the received token value.
Execute the request:
```
curl -H "x-xsrf-token: <token>" "https://example.com/vm/v3/settings/task/<task_name>/timeout" -d '{"timeout_seconds": <seconds>}'
```
Comments to commands
- <token> — authorization token
- <task_name> — task name:
  - host_migrate — migrate VM
  - disk_migrate — migrate VM disk
  - disk_backup — VM backup
  - host_create — create VM
  - host_reinstall — reinstall VM
  - disk_restore — restore VM from backup
  - host_run_recipe — run script on VM
  - host_guest_agent_repair — install QEMU Guest Agent
  - host_image_create — create VM image
  - node_run_script — run script on cluster node
  - disk_resize — edit VM disk size
  - os_copy — upload OS template
  - disk_backup_relocate — relocate backups
  - host_clone — VM cloning
- <seconds> — timeout in seconds
Sample command to increase the migration timeout to 24 hours (86,400 seconds):
```
curl -H "x-xsrf-token: <token>" "https://example.com/vm/v3/settings/task/host_migrate/timeout" -d '{"timeout_seconds": 86400}'
```
Comments to commands
<token> — authorization token

Useful tips