Apache CloudStack 4.21.0.0 Root Admin API Reference

createSnapshotPolicy

Creates a snapshot policy for the account.

Request parameters

Parameter NameDescriptionRequired
intervaltypevalid values are HOURLY, DAILY, WEEKLY, and MONTHLYtrue
maxsnapsmaximum number of snapshots to retaintrue
scheduletime the snapshot is scheduled to be taken. Format is:* if HOURLY, MM* if DAILY, MM:HH* if WEEKLY, MM:HH:DD (1-7)* if MONTHLY, MM:HH:DD (1-28)true
timezoneSpecifies a timezone for this command. For more information on the timezone parameter, see Time Zone Format.true
volumeidthe ID of the disk volumetrue
fordisplayan optional field, whether to the display the policy to the end user or notfalse
storageidsA comma-separated list of IDs of the storage pools in other zones in which the snapshot will be made available. The snapshot will always be made available in the zone in which the volume is present.false
tagsMap of tags (key/value pairs)false
usestoragereplicationThis parameter enables the option the snapshot to be copied to supported primary storagefalse
zoneidsA list of IDs of the zones in which the snapshots will be made available.The snapshots will always be made available in the zone in which the volume is present.false

Response Tags

Response NameDescription
idthe ID of the snapshot policy
fordisplayis this policy for display to the regular user
intervaltypethe interval type of the snapshot policy
maxsnapsmaximum number of snapshots retained
scheduletime the snapshot is scheduled to be taken.
storageThe list of pools in which snapshot backup is scheduled
timezonethe time zone of the snapshot policy
volumeidthe ID of the disk volume
zoneThe list of zones in which snapshot backup is scheduled