Apache CloudStack 4.17.0.0 Root Admin API Reference
createSnapshot
Creates an instant snapshot of a volume.
Request parameters
| Parameter Name | Description | Required |
| volumeid | The ID of the disk volume | true |
| account | The account of the snapshot. The account parameter must be used with the domainId parameter. | false |
| asyncbackup | asynchronous backup if true | false |
| domainid | The domain ID of the snapshot. If used with the account parameter, specifies a domain for the account associated with the disk volume. | false |
| locationtype | Currently applicable only for managed storage. Valid location types: 'primary', 'secondary'. Default = 'primary'. | false |
| name | the name of the snapshot | false |
| policyid | policy id of the snapshot, if this is null, then use MANUAL_POLICY. | false |
| quiescevm | quiesce vm if true | false |
| tags | Map of tags (key/value pairs) | 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. |
| locationtype | valid location types are primary and secondary. |
| name | name of the snapshot |
| osdisplayname | display name of the os on volume |
| ostypeid | id of the os on volume |
| 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 |
| virtualsize | virtual size of backedup snapshot on image store |
| volumeid | ID of the disk volume |
| volumename | name of the disk volume |
| volumetype | type of the disk volume |
| zoneid | id of the availability zone |
| 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 |