# list

View a list of Backup VM for your project. This command provides details such as schedule name, cron time, snapshot configuration, storage location, retention period, associated virtual machine, creation time, last backup execution, and current status.  

## Usage

```
cldkctl backup-vm list [flags]
```

## Aliases

```
list, ls
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl backup-vm list 
```

2. The terminal displays the command output.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FwXmLi4ZpLSHkXx1Tx05F%2Fimage.png?alt=media&#x26;token=8ad678f8-194e-4472-8d5b-b489b49bf13b" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="183.77777099609375">Column</th><th>Description</th></tr></thead><tbody><tr><td>Schedule Name</td><td>The name of the backup schedule.</td></tr><tr><td>Cron Time</td><td>The cron expression that defines when the backup runs.</td></tr><tr><td>Snapshot Move Data</td><td>Indicates whether snapshot data is moved to the storage location.</td></tr><tr><td>Storage Location</td><td>The repository or storage where the backup is stored.</td></tr><tr><td>Retention TTL</td><td>The duration for which the backup is retained.</td></tr><tr><td>VM Name</td><td>The name of the virtual machine being backed up.</td></tr><tr><td>Age</td><td>The elapsed time since the backup schedule was created.</td></tr><tr><td>Created</td><td>The date and time when the backup schedule was created.</td></tr><tr><td>Last Backup</td><td>The date and time of the most recent backup execution.</td></tr><tr><td>Status</td><td>The current status of the backup schedule.</td></tr></tbody></table>

## Flags

{% hint style="info" %}
This command supports [global flags](https://docs.cloudeka.ai/cloudeka-api-list/global-flags). Refer to the Global Flags section for details
{% endhint %}

| Flag                 | Description                |
| -------------------- | -------------------------- |
| -h, --help           | Help for the list command. |
| -p, --project string | Project ID                 |