---
title: "Enterprise File Storage - Managing volumes"
description: "Manage Enterprise File Storage volumes using the OVHcloud API"
url: https://docs.ovhcloud.com/en/guides/storage-and-backup/file-storage/enterprise-file-storage/netapp-volumes
lang: en
lastUpdated: 2021-10-27
---
# Enterprise File Storage - Managing volumes

## Objective

In this tutorial, we will provide an overview of how to manage the volumes of your OVHcloud Enterprise File Storage offer.

**Learn how to list volumes and their mount points, create a new volume and remove a volume using the OVHcloud API.**

## Requirements

- An OVHcloud Enterprise File Storage service
- You should be logged into the [OVHcloud API](https://api.ovh.com)

## Basics

A volume is a persistent, readable and writable file system volume. It uses a protocol and has a size.

It can also optionally have a name and a description.

:::warning
By default, all access to a newly created volume is restricted. An ACL has to be created in order to allow access.
:::

## Instructions

All API routes used for this tutorial are available under the _/storage_ section here: [https://api.ovh.com/console/#/storage](https://api.ovh.com/console/#/storage).

:::info
While using the API, all fields marked with an asterisk (\*) are required.
:::

### Listing existing volumes

All existing volumes can be retrieved using the following route:


🇪🇺EU▾

[GET/storage/netapp/{serviceName}/share](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share)

| Parameter     | Required | Description |
| ------------- | -------- | ----------- |
| `serviceName` | Yes      | Service ID  |

Replace `serviceName` with the ID of your service.

### Retrieving information about a volume

To retrieve the information about a volume, use the following route:


🇪🇺EU▾

[GET/storage/netapp/{serviceName}/share/{shareId}](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share/-shareId-)

| Parameter     | Required | Description |
| ------------- | -------- | ----------- |
| `serviceName` | Yes      | Service ID  |
| `shareId`     | Yes      | Volume ID   |

Replace `serviceName` with the ID of your service and `shareId` with your volume ID.

### Creating a volume

To create a new volume, use the following route:


🇪🇺EU▾

[POST/storage/netapp/{serviceName}/share](https://eu.api.ovh.com/console/?section=/storage&branch=v1#post-/storage/netapp/-serviceName-/share)

| Parameter     | Required | Description |
| ------------- | -------- | ----------- |
| `serviceName` | Yes      | Service ID  |

Replace `serviceName` with the ID of your service.

Choose `NFS` protocol for your new volume (`protocol` property) and its `size`.
You can also specify `name` and `description` properties (optional).

### Viewing mount points for a volume

To determine the mount path of a volume, use the following route:


🇪🇺EU▾

[GET/storage/netapp/{serviceName}/share/{shareId}/accessPath](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share/-shareId-/accessPath)

| Parameter     | Required | Description |
| ------------- | -------- | ----------- |
| `serviceName` | Yes      | Service ID  |
| `shareId`     | Yes      | Volume ID   |

Replace `serviceName` with the ID of your service and `shareId` with your volume ID.

Returned mount paths can be used to mount your volume.

The mount command will be different, depending on the protocol chosen for the volume.

:::info
For NFS, you can refer to [this guide](/en/guides/storage-and-backup/file-storage/ha-nas/nas-nfs.md).

Note that the retrieved mount path replaces IP\_NAS/NFS\_PATH in that documentation.
:::

### Deleting a volume

To remove a volume, use the following route:


🇪🇺EU▾

[DELETE/storage/netapp/{serviceName}/share/{shareId}](https://eu.api.ovh.com/console/?section=/storage&branch=v1#delete-/storage/netapp/-serviceName-/share/-shareId-)

| Parameter     | Required | Description |
| ------------- | -------- | ----------- |
| `serviceName` | Yes      | Service ID  |
| `shareId`     | Yes      | Volume ID   |

Replace `serviceName` with the ID of your service and `shareId` with your volume ID.

## Go further

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/en-gb/professional-services/) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project.

Join our [community of users](https://community.ovhcloud.com/).