--- title: "NAS-HA - Gestão das snapshots através da API" description: "Saiba como gerir as snapshots NAS-HA através da API OVHcloud" url: https://docs.ovhcloud.com/pt/guides/storage-and-backup/file-storage/ha-nas/nas-snapshots-api lang: pt lastUpdated: 2022-07-20 --- # NAS-HA - Gestão das snapshots 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 As NAS-HA da OVHcloud permitem-lhe criar e gerir volumes de ficheiros acessíveis a partir de uma rede. **Este manual explica-lhe como gerir as snapshots 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 :::info Não hesite em aceder [à página FAQ NAS-HA](/pt/guides/storage-and-backup/file-storage/ha-nas/nas-faq.md) para encontrar todas as informações relativas à função snapshot. ::: 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) Por predefinição, realiza-se uma snapshot dos seus dados a cada hora e é guardado no seu NAS-HA. Pode ativar outras estratégias de snapshot que irão criar snapshots com frequências predefinidas. ### Recuperar o planeamento automático das snapshots Para apresentar o planeamento de snapshot automático ativo, utilize a seguinte rota: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot) | Parameter | Required | Description | | --------------- | -------- | ------------------------------ | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | ### Adicionar um intervalo de snapshot automático Para criar snapshots automáticas adicionais a uma frequência selecionada, utilize a seguinte rota: 🇪🇺EU▾ [POST/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#post-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot) | Parameter | Required | Description | | --------------- | -------- | -------------------------------------------------------------------------------------- | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `snapshotType` | Yes | Uma frequência para o snapshot: _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, _hour-6_ | ### Recuperação das informações das snapshots automáticas Para obter os detalhes de uma snapshot automática, utilize a seguinte rota: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot/{snapshotType}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot/-snapshotType-) | Parameter | Required | Description | | --------------- | -------- | ----------------------------------------------------------------------------------------- | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `snapshotType` | Yes | A frequência da snapshot em causa: _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, _hour-6_ | ### Eliminação de um intervalo de snapshot automático Utilize a seguinte rota para eliminar uma frequência de snapshot automática: 🇪🇺EU▾ [DELETE/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot/{snapshotType}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#delete-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot/-snapshotType-) | Parameter | Required | Description | | --------------- | -------- | ----------------------------------------------------------------------------------------- | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `snapshotType` | Yes | A frequência da snapshot em causa: _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, _hour-6_ | Também pode utilizar snapshots instantâneas com o NAS-HA (snapshots personalizadas) através dos seguintes endpoints. ### Listing das snapshots personalizadas Utilize a seguinte rota para recuperar snapshots personalizadas existentes: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot) | Parameter | Required | Description | | --------------- | -------- | ------------------------------ | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | ### 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 | ### Recuperação das informações de uma snapshot personalizada Para apresentar os detalhes de uma snapshot personalizada, utilize a seguinte rota: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot/{name}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot/-name-) | Parameter | Required | Description | | --------------- | -------- | ------------------------------ | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `name` | Yes | O nome da snapshot | ### Eliminação de uma snapshot personalizada Utilize a seguinte rota para eliminar uma snapshot personalizada: 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot/{name}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot/-name-) | Parameter | Required | Description | | --------------- | -------- | ------------------------------ | | `serviceName` | Yes | Nome interno do serviço NAS-HA | | `partitionName` | Yes | Nome da partição | | `name` | Yes | O nome da snapshot | ##### **Restauro das snapshots** A API não permite restaurar as snapshots efetuadas. As snapshots são armazenadas em modo de leitura apenas na partição. Para aceder às snapshots a partir do seu ponto de montagem, deve aceder ao diretório `.zfs/snapshot` da sua partição. Por exemplo, num serviço cujo ID é `zpool-123456`, contendo uma partição designada por `partition1` e cujo qual criou uma snapshot chamada `snapshot01`. Pode encontrar a snapshot com este comando: ```bash ls -al /zpool-123456/partition1/.zfs/snapshot/snap-snapshot01/ ``` Para restaurar a sua snapshot, copie-a a partir do caminho de acesso do ficheiro `.zfs` para o novo diretório onde pretende restaurar a snapshot. Pode utilizar uma ferramenta como rsync que lhe permite efetuar restauros. Para mais informações, aceda à secção [Quer saber mais](#gofurther). ## 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/).