Apache CloudStack 4.21.0.0 Root Admin API Reference

updateBackupSchedule

Updates a user-defined VM backup schedule

Request parameters

Parameter NameDescriptionRequired
intervaltypevalid values are HOURLY, DAILY, WEEKLY, and MONTHLYtrue
schedulecustom backup schedule, the format is:for HOURLY MM*, for DAILY MM:HH*, for WEEKLY MM:HH:DD (1-7)*, for MONTHLY MM:HH:DD (1-28)true
timezoneSpecifies a timezone for this command. For more information on the timezone parameter, see TimeZone Format.true
virtualmachineidID of the VM for which schedule is to be definedtrue
maxbackupsThe maximum number of backups to keep for a VM. If "0", no retention policy will be applied and, thus, no backups from the schedule will be automatically deleted. This parameter is only supported for the Dummy, NAS and EMC Networker backup provider.false
quiescevmQuiesce the instance before checkpointing the disks for backup. Applicable only to NAS backup provider. The filesystem is frozen before the backup starts and thawed immediately after. Requires the instance to have the QEMU Guest Agent installed and running.false

Response Tags

Response NameDescription
idID of the VM backup
accountaccount name
accountidaccount id
backupofferingidbackup offering id
backupofferingnamebackup offering name
createdbackup date
descriptiondescription for the backup
domaindomain name
domainiddomain id
externalidexternal backup id
intervaltypeInterval type of the backup
namename of the backup
sizebackup size in bytes
statusbackup status
typebackup type
virtualmachineidID of the VM
virtualmachinenamename of the VM
virtualsizebackup protected (virtual) size in bytes
vmbackupofferingremovedThe backup offering corresponding to this backup was removed from the VM
vmdetailsLists the vm specific details for the backup
volumesbacked up volumes
zonezone name
zoneidzone id