--- title: "Enterprise File Storage - Primeiros passos com as API" description: "Iniciar a sua oferta Enterprise File Storage com recurso às API OVHcloud" url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/enterprise-file-storage/netapp-quick-start lang: pt lastUpdated: 2021-10-27 --- # Enterprise File Storage - Primeiros passos com as 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 Neste guia de arranque rápido, saiba como começar na oferta Enterprise File Storage. **Aprenderá a recuperar as informações da sua oferta e a criar o seu primeiro volume através das API OVHcloud.** ## Requisitos - Ter uma oferta OVHcloud Enterprise File Storage - Ter acesso à página das [API OVHcloud](https://eu.api.ovh.com/) - Saber [montar um NAS através de NFS](/pt/guides/storage-and-backup/file-storage/ha-nas/nas-nfs.md) ## O essencial A oferta OVHcloud Enterprise File Storage permite-lhe criar volumes e gerir assim partilhas de ficheiros acessíveis numa rede. Pode escolher o tamanho dos seus volumes, gerir os acessos através de ACL ou ainda criar snapshots (cópia instantânea do volume). ## Instruções Todas as 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 Aquando da utilização das API, todos os campos marcados com um asterisco (\*) são obrigatórios. ::: ### Obter as informações do seu serviço Todos os seus serviços ativos podem ser recuperados utilizando a seguinte rota API: 🇪🇺EU▾ [GET/storage/netapp](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp) ### Criar um novo volume Um volume é uma unidade de armazenamento com um tamanho e um protocolo. Para criar um volume, utilize a seguinte rota API: 🇪🇺EU▾ [POST/storage/netapp/{serviceName}/share](https://eu.api.ovh.com/console/?section=/storage&branch=v1#post-/storage/netapp/-serviceName-/share) | Parameter | Required | Description | | ------------------------- | -------- | ------------------------------- | | `serviceName` | Yes | ID do serviço | | `NetAppShare.description` | | Descrição do volume | | `NetAppShare.name` | | Nome do volume | | `NetAppShare.protocol` | Yes | Protocolo utilizado pelo volume | | `NetAppShare.size` | | Tamanho em gigabytes do volume | Selecione o protocolo `NFS` e um tamanho de `10` gigabytes, por exemplo. ### Adicionar um ACL ao volume Os ACL permitem autorizar ou recusar o acesso a um volume. :::warning O comportamento predefinido consiste em recusar todo o acesso a um novo volume. ::: Depois de criar um volume, deve criar um novo ACL para aceder ao mesmo. Para criar um novo ACL que lhe permitirá ligar-se ao seu volume, 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. | :::info Ao utilizar a notação CIDR, pode autorizar o acesso ao volume a partir do intervalo de endereços IP X.X.X.X/X. Por exemplo: 192.0.2.0/24 ::: ### Montar o volume Verifique o estado de criação do ACL através da seguinte rota API: 🇪🇺EU▾ [GET/storage/netapp/{serviceName}/share/{shareId}/acl/{aclRuleId}](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/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 `aclRuleId` pelo ID da ACL criada para o seu volume. :::info O estado ACL deve estar `active`. ::: Uma vez ativa a ACL, recupere os caminhos de acesso ao volume através da seguinte API: 🇪🇺EU▾ [GET/storage/netapp/{serviceName}/share/{shareId}/accessPath](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share/-shareId-/accessPath) | Parameter | Required | Description | | ------------- | -------- | ------------- | | `serviceName` | Yes | ID do serviço | | `shareId` | Yes | ID do volume | Receberá uma ou mais opções de acesso para o seu volume. Agora pode aumentar o volume com o seguinte comando: ```sh mount-nfs accessPath ``` :::info Se utilizar Linux, o pacote `nfs-utils` deve estar instalado. ::: Uma vez montado, o seu volume pode ser utilizado para armazenar os seus ficheiros. ### Eliminação do volume Pode eliminar o seu volume através da seguinte rota API: 🇪🇺EU▾ [DELETE/storage/netapp/{serviceName}/share/{shareId}](https://eu.api.ovh.com/console/?section=/storage&branch=v1#delete-/storage/netapp/-serviceName-/share/-shareId-) | Parameter | Required | Description | | ------------- | -------- | ------------- | | `serviceName` | Yes | ID do serviço | | `shareId` | Yes | ID do volume | ## Quer saber 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/).