> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage volume data

> View files, active workspaces, and manage data with the CLI.

## Files

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/uQ7CXJK8tcoJv2tB/images/storage_volumelist.png?fit=max&auto=format&n=uQ7CXJK8tcoJv2tB&q=85&s=c7955c97972285fb8b5c1434c55c3b08" alt="Volume file list with name, size, and last-modified columns" width="3024" height="1610" data-path="images/storage_volumelist.png" />
  </Frame>

  <small>Example: Files in a volume</small>
</div>

See files stored in the volume.

* Name: file name
* Size: file size
* Last modified: last modification timestamp

## Details

View volume metadata and status information.

* **Cluster availability**: Clusters where this volume can be mounted.
* **Size**: Total provisioned storage capacity.
* **Teams**: Teams that have access to this volume.
* **Last attached**: Last time the volume was attached to a workspace.

## Active workspaces

View workspaces currently attached to this volume. Active workspaces can read/write files. Data is automatically synchronized across sessions at the configured mount paths.

## Data management (CLI)

Use short-lived credentials to manage data on Object storage volumes with the AWS CLI.

<div>
  <Frame>
    <img src="https://mintcdn.com/dora/vPFagCAoutrvcxVV/images/newdatacli.png?fit=max&auto=format&n=vPFagCAoutrvcxVV&q=85&s=e0a3d488b77cce897f66833aef091f42" alt="Volume detail page with the Guide button that opens the AWS CLI guide modal" width="1920" height="1266" data-path="images/newdatacli.png" />
  </Frame>

  <small>Example: Volume detail page</small>
</div>

### Access guide

On the **Volume detail** page, click the **Guide** button (book icon) to open the CLI guide modal. The modal includes:

* **AWS Credentials**: Temporary credentials are automatically generated (expire after 36 hours). Click **Copy All** to copy all credentials at once. Use the **Regenerate** button to create new credentials if needed.
* **AWS S3 Commands**: Common commands for managing files. Each command has a copy button for easy use.

### CLI operations

<Steps>
  <Step title="List files">
    ```bash theme={null}
    aws s3 ls s3://dora-managed-storage-prod/<storage-id>/<volume-id>/
    ```
  </Step>

  <Step title="Upload files">
    ```bash theme={null}
    aws s3 cp my_file.txt s3://dora-managed-storage-prod/<storage-id>/<volume-id>/my_directory/my_file.txt
    ```
  </Step>

  <Step title="Download files">
    ```bash theme={null}
    aws s3 cp s3://dora-managed-storage-prod/<storage-id>/<volume-id>/my_directory/my_file.txt .
    ```
  </Step>

  <Step title="Delete files">
    ```bash theme={null}
    aws s3 rm s3://dora-managed-storage-prod/<storage-id>/<volume-id>/my_directory/my_file.txt
    ```
  </Step>
</Steps>

<Info>
  Replace `<storage-id>` and `<volume-id>` with the actual values shown in the Guide modal. Refer to [AWS S3 CLI docs](https://docs.aws.amazon.com/cli/latest/reference/s3/) for advanced operations.
</Info>

## Permissions

Volume access is controlled by team membership.

* **View and use**: You can view and use volumes that are assigned to teams you belong to.
* **Update**: You can update volumes (name, description, team assignments) if you belong to at least one team assigned to the volume. When modifying team assignments, you can only add or remove teams you belong to.
* **Delete**: You can delete volumes if you belong to at least one team assigned to the volume.

Organization admins can view, update, and delete all volumes regardless of team membership.

## Delete volume

<Warning>
  Deleting a volume permanently removes all data. This action cannot be undone.
</Warning>

<Info>
  **Deletion restrictions:**

  * You cannot delete a volume while it is attached to active workspaces. Before deleting, you must stop or terminate all workspaces using this volume.
  * You must belong to at least one team assigned to the volume, or be an organization admin.
  * This applies to both Object storage and Cluster storage volumes.
</Info>

<Tip>Watch the demo below to see the delete flow.</Tip>

<div style={{ position: 'relative', paddingBottom: 'calc(53.2407% + 41px)', height: 0, width: '100%' }}>
  <iframe src="https://demo.arcade.software/AwuZwOfX6ymjcH9twWNm?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=true" title="Delete a Storage Volume in VESSL Cloud" frameBorder="0" loading="lazy" webkitAllowFullScreen="" mozAllowFullScreen="" allowFullScreen allow="clipboard-write" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', colorScheme: 'light' }} />
</div>

To delete a volume:

1. Go to the **Volume detail** page.
2. Click the **Delete** button.
3. Confirm the deletion by typing the volume name.
