Cosmic User API Reference

listSnapshots

Lists all available snapshots for the account.

Request parameters

Parameter Name	Description	Required
account	list resources by account. Must be used with the domainId parameter.	false
domainid	list only resources belonging to the domain specified	false
id	lists snapshot by snapshot ID	false
intervaltype	valid values are HOURLY, DAILY, WEEKLY, and MONTHLY.	false
isrecursive	defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.	false
keyword	List by keyword	false
listall	If set to false, list only resources belonging to the command's caller; if set to true - list resources that the caller is authorized to see. Default value is false	false
name	lists snapshot by snapshot name	false
page		false
pagesize		false
projectid	list objects by project	false
snapshottype	valid values are MANUAL or RECURRING.	false
tags	List resources by tags (key/value pairs)	false
volumeid	the ID of the disk volume	false
zoneid	list snapshots by zone id	false

Response Tags

Response Name	Description
id	ID of the snapshot
account	the account associated with the snapshot
created	the date the snapshot was created
domain	the domain name of the snapshot's account
domainid	the domain ID of the snapshot's account
intervaltype	valid types are hourly, daily, weekly, monthy, template, and none.
name	name of the snapshot
physicalsize	physical size of backedup snapshot on image store
project	the project name of the snapshot
projectid	the project id of the snapshot
revertable	indicates whether the underlying storage supports reverting the volume to this snapshot
snapshottype	the type of the snapshot
state	the state of the snapshot. BackedUp means that snapshot is ready to be used; Creating - the snapshot is being allocated on the primary storage; BackingUp - the snapshot is being backed up on secondary storage
volumeid	ID of the disk volume
volumename	name of the disk volume
volumetype	type of the disk volume
zoneid	id of the availability zone
*tags()**	the list of resource tags associated with snapshot
account	the account associated with the tag
customer	customer associated with the tag
domain	the domain associated with the tag
domainid	the ID of the domain associated with the tag
key	tag key name
project	the project name where tag belongs to
projectid	the project id the tag belongs to
resourceid	id of the resource
resourcetype	resource type
value	tag value
jobid	the ID of the latest async job acting on this object
jobstatus	the current status of the latest async job acting on this object