Skip to main content
ONTAP automation
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Considerações de migração para a API REST do ONTAP

Colaboradores dmp-netapp

A API ONTAPI (ZAPI) é o conjunto original de chamadas proprietárias incluído no software NetApp ONTAP . A API é fornecida pelo Network Manageability SDK e oferece suporte à automação de tarefas de administração e gerenciamento de armazenamento de dados. Se estiver usando o ONTAPI, você deve planejar sua migração para a API REST do ONTAP para aproveitar o conjunto de recursos expandidos do ONTAP disponível com a API REST.

Diferenças gerais de design

A API REST do ONTAP e a interface de linha de comando têm designs fundamentalmente diferentes. Os comandos e parâmetros da CLI não mapeiam diretamente para as chamadas da API REST. E mesmo onde pode haver uma semelhança, os detalhes dos parâmetros de entrada podem ser diferentes. Por exemplo, unidades numéricas podem ser especificadas em bytes ou usando um sufixo (como KB). "Variáveis de entrada que controlam uma solicitação de API"Consulte e "Referência da API" para obter mais informações.

SVMs de dados expostos por meio da API REST

O ONTAP oferece suporte a vários tipos de máquinas virtuais de storage (SVMs). No entanto, apenas as SVMs de dados são expostas diretamente pela API REST do ONTAP. As informações de configuração que descrevem o cluster e os nós estão disponíveis por meio da API REST, no entanto, o cluster e os nós não são tratados como SVMs separadas.

Acesse a CLI do ONTAP por meio da API REST

Para auxiliar os usuários da API ONTAPI e da CLI na transição para a API REST do ONTAP, o ONTAP fornece um ponto de extremidade REST para acessar a CLI do ONTAP. Você pode usar esse recurso de passagem para executar qualquer comando CLI. O uso do endpoint REST é retornado nos dados do AutoSupport para que o NetApp possa identificar lacunas na API REST e fazer melhorias em futuras versões do ONTAP.

Para emitir um comando CLI, você deve fazer uma chamada de API REST que seja formada corretamente com base em regras relacionadas ao seguinte:

  • Caminhos de recursos

  • Nomes de campos

  • Métodos HTTP

O caminho do recurso base para o acesso CLI é /private/cli. Consulte a página de documentação on-line da API do ONTAP para obter detalhes sobre como acessar a CLI por meio da API REST. O NetApp também mantém um repositório do GitHub contendo amostras de código e outras informações úteis. Consulte "ONTAP REST Python repositório GitHub - exemplos de passagem de CLI" para obter mais informações.

Alterações na disponibilidade SnapDiff no ONTAPI

SnapDiff v1 e v2 são baseadas na estrutura de gerenciamento ONTAPI (ZAPI) e há algumas limitações de usabilidade com certas versões do ONTAP. A API SnapDiff v3 não utiliza ONTAPI e é compatível com o ONTAP 9.8 e versões posteriores. A disponibilidade da API SnapDiff nas versões do ONTAP é definida da seguinte forma:

  • ONTAP 9.7 e versões anteriores: V1 e v2 (apenas ONTAPI)

  • ONTAP 9.8 e versões posteriores: v1, v2 e v3. Algumas limitações se aplicam; consulte a "Perguntas frequentes: SnapDiff suporte no ONTAP" para obter mais detalhes sobre o suporte ao SnapDiff com base na versão do ONTAP.

Você deve verificar se seus aplicativos de backup oferecem suporte ao SnapDiff e estar ciente de quaisquer limitações de interoperabilidade com base na versão do ONTAP que você está usando. Veja também o "Notas de versão do ONTAP" para mais informações.