---
title: "NAS-HA - Premiers pas avec les API"
description: "Découvrez comment bien débuter avec un service NAS-HA en utilisant l'API OVHcloud"
url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/file-storage/ha-nas/nas-quick-api
lang: fr
lastUpdated: 2022-07-20
---
# NAS-HA - Premiers pas avec les API

## Objectif

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

**Ce guide vous donne un aperçu de l'utilisation 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)

### 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.

### Ajout d'une entrée ACL pour accéder à la partition

:::warning
L'accès est refusé par défaut sauf s'il est accordé via l'ACL. Seules les adresses IP attachées à vos services OVHcloud peuvent être ajoutées.
:::

Vous pouvez vérifier les adresses IP éligibles à un accès via les appels API suivants :


🇪🇺EU▾

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

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

Pour créer une nouvelle entrée ACL vous permettant de vous connecter à votre partition, utilisez la route suivante :


🇪🇺EU▾

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

| Parameter       | Required | Description                                                    |
| --------------- | -------- | -------------------------------------------------------------- |
| `serviceName`   | Yes      | Le nom interne de votre service NAS-HA                         |
| `partitionName` | Yes      | Nom de la partition                                            |
| `ip`            | Yes      | L'adresse IP ou la plage à laquelle l'accès doit être accordé  |
| `type`          | Yes      | Type d'accès ACL pour cette entrée : _readonly_ ou _readwrite_ |

:::info
Utilisez la notation CIDR pour les plages IP, par exemple : 192.0.2.0/24.
:::

### Créer un snapshot manuel

Pour ajouter un snapshot manuel, utilisez la route suivante :


🇪🇺EU▾

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

| Parameter       | Required | Description                                                            |
| --------------- | -------- | ---------------------------------------------------------------------- |
| `serviceName`   | Yes      | Le nom interne de votre service NAS-HA                                 |
| `partitionName` | Yes      | Nom de la partition                                                    |
| `expiration`    |          | Une date d'expiration facultative, par exemple : 2022-06-24 (ISO 8601) |
| `name`          | Yes      | Nom du snapshot.                                                       |

### 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/).