---
title: "NAS-HA - Gestão dos ACL através da API"
description: "Saiba como gerir os acessos ao NAS-HA através da API OVHcloud"
url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/ha-nas/nas-manage-acls
lang: pt
lastUpdated: 2022-07-20
---
# NAS-HA - Gestão dos ACL através da API

:::info
Esta tradução foi automaticamente gerada pelo nosso parceiro SYSTRAN. Em certos casos, poderão ocorrer formulações imprecisas, como por exemplo nomes de botões ou detalhes técnicos. Recomendamos que consulte a versão inglesa ou francesa do manual, caso tenha alguma dúvida. Se nos quiser ajudar a melhorar esta tradução, clique em "Contribuir" nesta página.
:::

## Objetivo

O serviço NAS-HA da OVHcloud permite-lhe gerir um armazenamento de ficheiros acessível a partir de uma rede.

**Este guia explica como gerir o ACL de uma partição NAS-HA através da API OVHcloud.**

## Requisitos

- Um serviço [NAS-HA OVHcloud](https://www.ovhcloud.com/pt/storage-solutions/nas-ha/)
- Consulte o nosso guia dos [primeiros passos com a API OVHcloud](/pt/guides/manage-and-operate/api/first-steps.md) para se familiarizar com a APIv6 OVHcloud

## Instruções

Todas as rotas API deste guia estão disponíveis na secção _/dedicated/nasha_: [https://api.ovh.com/console/#/dedicated/nasha](https://api.ovh.com/console/#/dedicated/nasha).

:::info
Ao utilizar a API, todos os campos assinalados com um asterisco (\*) são obrigatórios.
:::

### Obter informações sobre o seu serviço

Todos os seus serviços ativos podem ser recuperados utilizando a seguinte rota:


🇪🇺EU▾

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

:::warning
O acesso é recusado por predefinição, exceto se for concedido através do ACL. Apenas os endereços IP ligados aos seus serviços OVHcloud podem ser adicionados.
:::

### Obter o ACL de uma partição

Para obter os endereços IP que podem aceder à partição, utilize a seguinte rota:


🇪🇺EU▾

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

| Parameter       | Required | Description                    |
| --------------- | -------- | ------------------------------ |
| `serviceName`   | Yes      | Nome interno do serviço NAS-HA |
| `partitionName` | Yes      | Nome da partição               |

### Recuperação de todos os endereços IP elegíveis

Pode verificar os endereços IP elegíveis para um acesso através das chamadas API seguintes:


🇪🇺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      | Nome interno do seu serviço NAS-HA |
| `partitionName` | Yes      | Nome da partição                   |

### Adicionar uma entrada ACL

Para criar uma nova entrada ACL que lhe permita ligar-se à sua partição, utilize a seguinte rota:


🇪🇺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      | Nome interno do serviço NAS-HA                                  |
| `partitionName` | Yes      | Nome da partição                                                |
| `ip`            | Yes      | O endereço IP ou a gama de acesso                               |
| `type`          | Yes      | Tipo de acesso ACL para esta entrada: _readonly_ ou _readwrite_ |

:::info
Utilize a notação CIDR para as gamas IP, por exemplo: 192.0.2.0/24.
:::

### Eliminação de uma entrada ACL

Para eliminar um endereço IP ou um intervalo de endereços do ACL, utilize a seguinte rota:


🇪🇺EU▾

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

| Parameter       | Required | Description                       |
| --------------- | -------- | --------------------------------- |
| `serviceName`   | Yes      | Nome interno do serviço NAS-HA    |
| `partitionName` | Yes      | Nome da partição                  |
| `ip`            | Yes      | O endereço IP ou a gama a recusar |

## Quer saber mais?

[Montar um NAS através de NFS](/pt/guides/storage-and-backup/file-storage/ha-nas/nas-nfs.md)

[Configure o seu NAS no Windows Server através do CIFS](/pt/guides/storage-and-backup/file-storage/ha-nas/nas-cifs.md)

Se precisar de formação ou de assistência técnica para implementar as nossas soluções, contacte o seu representante comercial ou clique em [esta ligação](https://www.ovhcloud.com/pt/professional-services/) para obter um orçamento e solicitar uma análise personalizada do seu projecto aos nossos especialistas da equipa de Serviços Profissionais.

Fale com nossa [comunidade de utilizadores](https://community.ovhcloud.com/).