--- title: "NAS-HA - Primeiros passos com as API" description: "Saiba como começar a usar e a gerir um serviço NAS-HA através da API OVHcloud" url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/ha-nas/nas-quick-api lang: pt lastUpdated: 2022-07-20 --- # NAS-HA - 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 O serviço NAS-HA da OVHcloud permite-lhe gerir ficheiros acessíveis a partir de uma rede. **Este guia dá-lhe uma ideia da utilização do seu serviç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) ### Criação de uma partição Utilize a seguinte rota para criar uma nova partição: 🇪🇺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 | Nome interno do seu serviço NAS | | `partitionDescription` | | Descrição facultativa | | `partitionName` | Yes | Um nome para a partição | | `protocol` | Yes | _NFS_, _CIFS_ ou _NFS\_CIFS_ para ambos | | `size` | Yes | O tamanho da partição | Escolha `NFS` como protocolo e um tamanho de `10` Gigabytes, por exemplo. ### Adicionar uma entrada ACL para aceder à partição :::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. ::: 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 | | `partitionName` | Yes | Nome da partição | 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. ::: ### Criar uma snapshot manual Para adicionar uma snapshot manual, utilize a seguinte rota: 🇪🇺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 | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `expiration` | | Uma data de expiração facultativa, por exemplo: 2022-06-24 (ISO 8601) | | `name` | Yes | Nome da snapshot | ### Eliminação de uma partição Utilize a seguinte rota para eliminar uma partição: 🇪🇺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 | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | ## 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/).