HA-NAS - Managing ACLs via API
292 Views
20.07.2022 
Cloud / NAS-HA
Objective
The OVHcloud HA-NAS service allows you to manage file storage that can be accessed over a network.
This guide explains how to manage the ACL of a HA-NAS partition via the OVHcloud API.
Requirements
- An OVHcloud HA-NAS service
- Consulting the OVHcloud API first steps guide to familiarise yourself with the OVHcloud APIv6
Instructions
All API routes in this guide are available in the section /dedicated/nasha: <https://ca.api.ovh.com/console/#/dedicated/nasha.
When using the API, all fields marked with an asterisk (*) are required.
Retrieving information about your service
All your active services can be retrieved by using the following route:
Access is denied by default unless granted via the ACL. Only IP addresses attached to your OVHcloud services can be added.
Retrieving the ACL of a partition
To retrieve the IP addresses that can access the partition, use the following route:
| Parameter | Required | Description |
|---|---|---|
serviceName | Yes | The internal name of your HA-NAS service |
partitionName | Yes | Name of the partition |
Retrieving all eligible IP addresses
You can verify the IP addresses that are eligible for access via the following API calls:
| Parameter | Required | Description |
|---|---|---|
serviceName | Yes | The internal name of your HA-NAS service |
partitionName | Yes | Name of the partition |
Adding an ACL entry
To create a new ACL entry that will allow you to connect to your partition, use the following route:
| Parameter | Required | Description |
|---|---|---|
serviceName | Yes | The internal name of your HA-NAS service |
partitionName | Yes | Name of the partition |
ip | Yes | The IP address or range to be granted access |
type | Yes | ACL access type for this entry: readonly or readwrite |
Use CIDR notation for IP ranges, for example: 192.0.2.0/24.
Removing an ACL entry
To delete an IP address or address range from the ACL, use the following route:
| Parameter | Required | Description |
|---|---|---|
serviceName | Yes | The internal name of your HA-NAS service |
partitionName | Yes | Name of the partition |
ip | Yes | The IP address or range to be denied access |
Go further
Mount your NAS on Windows Server via CIFS
If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link 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 on https://community.ovh.com/en/.
Mounting HA-NAS via NFS share
822