--- title: "NAS-HA - Gestão das partições por API" description: "Aprenda a gerir as partições NAS-HA graças à API OVHcloud" url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/ha-nas/nas-partitions-api lang: pt lastUpdated: 2022-07-20 --- # NAS-HA - Gestão das partições por 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 manual explica-lhe como gerir as partições 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) ### Lista de todas as partições Utilize a seguinte rota para recuperar as partições de um serviço: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition) | Parameter | Required | Description | | ------------- | -------- | ------------------------------- | | `serviceName` | Yes | Nome interno do seu serviço NAS | ### Obter as propriedades de uma partição Para visualizar os detalhes de uma partição, utilize a seguinte rota: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-) | Parameter | Required | Description | | --------------- | -------- | ------------------------------ | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | ### Recuperação das estatísticas de uma partição Utilize a seguinte rota para recuperar as informações de utilização de uma partição: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/use](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/use) | Parameter | Required | Description | | --------------- | -------- | ---------------------------------------------------------------------- | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `type` | Yes | O tipo de estatística a recuperar: _size_, _used_ ou _usedbysnapshots_ | ### 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 protocol e um tamanho de `10` Gigabytes, por exemplo. ### Modificar as propriedades de uma partição Para alterar uma partição, utilize a seguinte rota: 🇪🇺EU▾ [PUT/dedicated/nasha/{serviceName}/partition/{partitionName}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#put-/dedicated/nasha/-serviceName-/partition/-partitionName-) | Parameter | Required | Description | | ---------------------- | -------- | ------------------------------- | | `serviceName` | Yes | Nome interno do seu serviço NAS | | `partitionName` | Yes | Nome da partição | | `partitionDescription` | | A nova descrição | | `size` | | O novo tamanho da partição | ### Obter os parâmetros ZFS de uma partição Utilize a seguinte rota para recuperar os parâmetros ZFS: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/options](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/options) | Parameter | Required | Description | | --------------- | -------- | ------------------------------- | | `serviceName` | Yes | Nome interno do seu serviço NAS | | `partitionName` | Yes | Nome da partição | ### Modificação dos parâmetros ZFS de uma partição :::warning Todos os parâmetros ZFS predefinidos são otimizados. Não é aconselhável alterar estes parâmetros. ::: Para alterar os parâmetros ZFS, utilize a seguinte rota: 🇪🇺EU▾ [POST/dedicated/nasha/{serviceName}/partition/{partitionName}/options](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#post-/dedicated/nasha/-serviceName-/partition/-partitionName-/options) | Parameter | Required | Description | | --------------- | -------- | ---------------------------------------------------------------------------------------------- | | `serviceName` | Yes | Nome interno do seu serviço NAS | | `partitionName` | Yes | Nome da partição | | `atime` | | Parâmetro de atualização do tempo de acesso: _on_ (default) ou _off_ | | `recordsize` | | Tamanho máximo do bloco: _131072_ (por defeito), _16384_, _32768_, _4096_, _65536_ ou _8129_ | | `sync` | | Parâmetro de sincronização do ficheiro: _always_, _disabled_ ou _standard_ (valor predefinido) | ### 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/).