Apache CloudStack v4.1.0 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 |
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 |
| project | the project name of the snapshot |
| projectid | the project id of the 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 |
| 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 |