---
title: "Enterprise File Storage - Gerir os ACL de um volume"
description: "Saiba como gerir os ACL de um volume Enterprise File Storage através das API OVHcloud"
url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/enterprise-file-storage/netapp-volume-acl
lang: pt
lastUpdated: 2021-10-27
---
# Enterprise File Storage - Gerir os ACL de um volume

:::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

Neste guia, saiba como gerir os ACL de um volume para a oferta OVHcloud Enterprise File Storage.

**Aprenderá a recuperar os ACL (Access Control Lists) do seu volume, criar uma nova ACL assim como eliminar uma ACL existente a partir das API OVHcloud.**

## Requisitos

- Dispor de uma oferta OVHcloud Enterprise File Storage com um volume
- Ter acesso à página das [API OVHcloud](https://eu.api.ovh.com/)

## O essencial

Os ACL permitem autorizar ou restringir o acesso a um volume.

:::warning
Por predefinição, o acesso a um volume criado é limitado. Deve ser criada uma ACL para permitir o acesso.
:::

Com a ajuda dos ACL, pode autorizar um endereço IP ou um intervalo de endereços IP (notação CIDR) a aceder ao seu volume.

## Instruções

Todas as rotas API utilizadas para este guia estão disponíveis na secção _/armazenamento_: [https://api.ovh.com/console/#/storage](https://api.ovh.com/console/#/storage).

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

### Listar os ACL

Todas as ACL existentes de um volume podem ser recuperadas através da seguinte rota API:


🇪🇺EU▾

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

| Parameter     | Required | Description   |
| ------------- | -------- | ------------- |
| `serviceName` | Yes      | ID do serviço |
| `shareId`     | Yes      | ID do volume  |

Substitua o `serviçoName` pelo ID do seu serviço e `shareId` pelo ID do volume.

Quando utilizar esta chamada API para um novo volume, nenhuma ACL deve ser devolvida por predefinição.

### Autorizar o acesso a um volume com recurso a um ACL

Para criar uma nova ACL, utilize a seguinte rota API:


🇪🇺EU▾

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

| Parameter                        | Required | Description                                                                          |
| -------------------------------- | -------- | ------------------------------------------------------------------------------------ |
| `serviceName`                    | Yes      | ID do serviço                                                                        |
| `shareId`                        | Yes      | ID do volume                                                                         |
| `NetAppShareACLRule.accessLevel` | Yes      | Nível de acesso ACL. Pode ser **rw** (leitura e escrita) ou **ro** (leitura apenas). |
| `NetAppShareACLRule.accessTo`    | Yes      | Endereço IP ou intervalo de endereços IP em notação CIDR.                            |

Substitua o `serviceName` pelo ID do seu serviço e `shareId` pelo ID do volume.

Escolha o nível de acesso que deseja autorizar: ou `ro` (apenas leitura) ou `rw` (leitura e escrita).

Por fim, substitua o `accessTo` pelo endereço IP a partir do qual deseja autorizar as ligações.

### Eliminar uma ACL

A eliminação de um ACL impede qualquer acesso posterior a partir dos endereços IP que especifica.

Para eliminar um ACL, utilize a seguinte rota API:


🇪🇺EU▾

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

| Parameter     | Required | Description   |
| ------------- | -------- | ------------- |
| `serviceName` | Yes      | ID do serviço |
| `shareId`     | Yes      | ID do volume  |
| `aclRuleId`   | Yes      | ID do ACL     |

Substitua o `serviceName` pelo ID do seu serviço e `shareId` pelo ID do volume.

Pode obter o `aclRuleId` a partir da resposta obtida aquando da criação do ACL ou listando os ACL existentes do seu volume.

## Saiba mais

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