Backup

Entity

Backup

Backup resource:

Field

Explanation

id

backup identifier

disk_id

disk identifier

date_created

date when the backup was created

status

backup status

operating_system

operation system

operating_system_distro

operating system distribution

template_id

template’s id from disk was provisioned to

backup_size

backup’s size

locked

whether backup is locked or not

backup_type

can be gigas (regular backup) or gigas-automatic (automatic backup)

Backup resource list:

Operations

Delete backup

Method

DELETE

Url

/account/<account_id>/backup/<id>

Success Code

202

Returned Data

No data returned

Has Token

Yes

Remove a backup.

Curl example

curl -i -X DELETE https://api.gigas.com/account/ACCOUNT_ID/backup/BACKUP_ID -H "Authorization: $TOKEN" -H "Content-Type: application/json"

Get backup

Method

GET

Url

/account/<account_id>/backup/<id>

Success Code

200

Returned Data

Backup resource

Has Token

No

Get a backup resource.

List backup

Method

GET

Url

/account/<account_id>/backups

Success Code

200

Returned Data

Backup resource list

Has Token

No

Get all the user backups.

Filters:

  • min_disk_size

  • disk_id

  • operating_system

  • operating_system_distro

  • locked

Restore backup

Method

POST

Url

/account/<account_id>/backup/<backup_id>/restore

Success Code

202

Returned Data

Backup resource

Has Token

Yes

Restore a backup to the disk it originated from.

Curl example

curl -i -X POST https://api.gigas.com/account/ACCOUNT_ID/backup/BACKUP_ID/restore -H "Authorization: $TOKEN" -H "Content-Type: application/json"

Create template from backup

Method

POST

Url

/account/<account_id>/backup/<backup_id>/template

Success Code

202

Returned Data

Template resource

Has Token

Yes

Create a virtual template from a backup. This will allow to clone a virtual machine state into new virtual machines

Mandatory parameters:

  • label backup description