---
title: "NAS-HA - Gestion des partitions par API"
description: "Apprenez à gérer les partitions NAS-HA grâce à l'API OVHcloud"
url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/file-storage/ha-nas/nas-partitions-api
lang: fr
lastUpdated: 2022-07-20
---
# NAS-HA - Gestion des partitions par API

## Objectif

Le service NAS-HA OVHcloud vous permet de gérer un stockage de fichiers accessible depuis un réseau.

**Ce guide vous explique comment gérer les partitions de votre service NAS-HA via l'API OVHcloud.**

## Prérequis

- Un service [NAS-HA OVHcloud](https://www.ovhcloud.com/fr/storage-solutions/nas-ha/)
- Consultez notre guide des [premiers pas avec l'API OVHcloud](/fr/guides/manage-and-operate/api/first-steps.md) afin de vous familiariser avec l'APIv6 OVHcloud

## En pratique

Toutes les routes API de ce guide sont disponibles dans la section _/dedicated/nasha_ : [https://api.ovh.com/console/#/dedicated/nasha](https://api.ovh.com/console/#/dedicated/nasha).

:::info
Lors de l'utilisation de l'API, tous les champs marqués d'un astérisque (\*) sont obligatoires.
:::

### Récupérer des informations sur votre service

Tous vos services actifs peuvent être récupérés en utilisant la route suivante :


🇪🇺EU▾

[GET/dedicated/nasha](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha)

### Liste de toutes les partitions

Utilisez la route suivante pour récupérer les partitions d'un service :


🇪🇺EU▾

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

| Parameter     | Required | Description                         |
| ------------- | -------- | ----------------------------------- |
| `serviceName` | Yes      | Le nom interne de votre service NAS |

### Récupérer les propriétés d'une partition

Pour visualiser les détails d'une partition, utilisez la route suivante :


🇪🇺EU▾

[GET/dedicated/nasha/{serviceName}/partition/{partitionName}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-)

| Parameter       | Required | Description                            |
| --------------- | -------- | -------------------------------------- |
| `serviceName`   | Yes      | Le nom interne de votre service NAS-HA |
| `partitionName` | Yes      | Nom de la partition                    |

### Récupération des statistiques d'une partition

Utilisez la route suivante pour récupérer les informations d'utilisation d'une partition :


🇪🇺EU▾

[GET/dedicated/nasha/{serviceName}/partition/{partitionName}/use](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/use)

| Parameter       | Required | Description                                                              |
| --------------- | -------- | ------------------------------------------------------------------------ |
| `serviceName`   | Yes      | Le nom interne de votre service NAS-HA                                   |
| `partitionName` | Yes      | Nom de la partition                                                      |
| `type`          | Yes      | Le type de statistique à récupérer : _size_, _used_ or _usedbysnapshots_ |

### Création d'une partition

Utilisez la route suivante pour créer une nouvelle partition :


🇪🇺EU▾

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

| Parameter              | Required | Description                                |
| ---------------------- | -------- | ------------------------------------------ |
| `serviceName`          | Yes      | Le nom interne de votre service NAS        |
| `partitionDescription` |          | Description facultative                    |
| `partitionName`        | Yes      | Un nom pour la partition                   |
| `protocol`             | Yes      | _NFS_, _CIFS_ ou _NFS\_CIFS_ pour les deux |
| `size`                 | Yes      | La taille de la partition                  |

Choisissez `NFS` comme protocole et une taille de `10` Gigaoctets par exemple.

### Modifier les propriétés d'une partition

Utilisez la route suivante pour modifier une partition :


🇪🇺EU▾

[PUT/dedicated/nasha/{serviceName}/partition/{partitionName}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#put-/dedicated/nasha/-serviceName-/partition/-partitionName-)

| Parameter              | Required | Description                         |
| ---------------------- | -------- | ----------------------------------- |
| `serviceName`          | Yes      | Le nom interne de votre service NAS |
| `partitionName`        | Yes      | Nom de la partition                 |
| `partitionDescription` |          | La nouvelle description             |
| `size`                 |          | La nouvelle taille de la partition  |

### Récupérer les paramètres ZFS d’une partition

Utilisez la route suivante pour récupérer les paramètres ZFS :


🇪🇺EU▾

[GET/dedicated/nasha/{serviceName}/partition/{partitionName}/options](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/options)

| Parameter       | Required | Description                         |
| --------------- | -------- | ----------------------------------- |
| `serviceName`   | Yes      | Le nom interne de votre service NAS |
| `partitionName` | Yes      | Nom de la partition                 |

### Modification des paramètres ZFS d’une partition

:::warning
Tous les paramètres ZFS par défaut sont optimisés. Il est déconseillé de modifier ces paramètres.
:::

Utilisez la route suivante pour modifier les paramètres ZFS :


🇪🇺EU▾

[POST/dedicated/nasha/{serviceName}/partition/{partitionName}/options](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#post-/dedicated/nasha/-serviceName-/partition/-partitionName-/options)

| Parameter       | Required | Description                                                                                      |
| --------------- | -------- | ------------------------------------------------------------------------------------------------ |
| `serviceName`   | Yes      | Le nom interne de votre service NAS                                                              |
| `partitionName` | Yes      | Nom de la partition                                                                              |
| `time`          |          | Paramètre de mise à jour du temps d'accès : _on_ (default) ou _off_                              |
| `recordsize`    |          | Taille de bloc maximale : _131072_ (par défaut), _16384_, _32768_, _4096_, _65536_ ou _8129_     |
| `sync`          |          | Paramètre de synchronisation de fichier : _always_, _disabled_ ou _standard_ (valeur par défaut) |

### Suppression d'une partition

Utilisez la route suivante pour supprimer une partition :


🇪🇺EU▾

[DELETE/dedicated/nasha/{serviceName}/partition/{partitionName}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#delete-/dedicated/nasha/-serviceName-/partition/-partitionName-)

| Parameter       | Required | Description                            |
| --------------- | -------- | -------------------------------------- |
| `serviceName`   | Yes      | Le nom interne de votre service NAS-HA |
| `partitionName` | Yes      | Nom de la partition                    |

## Aller plus loin

[Montez votre NAS via un partage NFS](/fr/guides/storage-and-backup/file-storage/ha-nas/nas-nfs.md)

[Montez votre NAS sur Windows Server via CIFS](/fr/guides/storage-and-backup/file-storage/ha-nas/nas-cifs.md)

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/).