Gerenciar o ONTAP no modo ONTAP

Com o Google Cloud NetApp Volumes, é possível gerenciar recursos do ONTAP em um pool de armazenamento do modo ONTAP enviando operações por meio de proxies do Google Cloud .

Por motivos de segurança e geração de registros, o NetApp Volumes não permite conexões diretas com o LIF de gerenciamento do ONTAP. Portanto, não é possível usar ferramentas como o SystemManager ou o SSH diretamente. Em vez disso, envie operações do ONTAP para o pool de armazenamento no modo ONTAP usando os seguintes métodos:

As ferramentas de gestão, como o Terraform, usam o proxy de API do Google para gerenciar recursos do ONTAP.

Antes de começar

A versão da CLI do Google Cloud precisa ser pelo menos 559.0.0 para gerenciar as operações do ONTAP no pool de armazenamento do modo ONTAP. Se a versão for mais antiga, a Google Cloud CLI vai retornar um erro informando que o comando ou a flag não está definido.

Usar o proxy da CLI do ONTAP da CLI do Google Cloud

Embora o acesso SSH direto à CLI do ONTAP não esteja disponível, é possível enviar comandos da CLI do ONTAP para o pool de armazenamento usando a Google Cloud CLI.

gcloud

Execute um comando do ONTAP:

gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \
  --location=LOCATION

Substitua as seguintes informações:

  • POOL-NAME: o nome do pool de armazenamento do modo ONTAP unificado do Flex.

  • ONTAP-COMMAND: o comando ONTAP que você quer executar no cluster ou no pool de armazenamento.

  • PROJECT: o ID do projeto.

  • LOCATION: o local do pool de armazenamento.

Usar uma API de proxy do Google para chamadas da API REST do ONTAP

O NetApp Volumes fornece um endpoint de API do Google para cada pool de armazenamento do modo ONTAP unificado Flex, que permite enviar chamadas de API REST do ONTAP para o cluster do ONTAP subjacente. Isso permite controlar os recursos do ONTAP usando APIs.

As chamadas para o proxy do ONTAP precisam usar o seguinte formato de URL:

  https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
 

Esse URL consiste nos seguintes elementos:

  • URL de referência: https://netapp.googleapis.com/v1

  • URN do Google para o pool de armazenamento: /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    Substitua as seguintes informações:

    • PROJECT: ID do projeto.

    • LOCATION: o nome da zona para pools zonais ou a região para pools regionais.

    • POOL_NAME: o nome do pool.

  • Caminho da API REST do ONTAP: /ontap/ONTAP_REST_URL. Para mais informações, consulte a referência da API REST do ONTAP.

Listar todos os volumes de um pool de armazenamento

O exemplo a seguir mostra o URL completo para listar todos os volumes do pool de armazenamento mypool em us-central1-a no projeto myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes

Como todas as chamadas de API do Google, essa chamada precisa ser autenticada. O exemplo de CLI a seguir busca um token de API e, em seguida, chama o URL usando curl para listar todos os volumes no pool:

   TOKEN=$(gcloud auth print-access-token)
   curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \
   --header "Authorization: Bearer $TOKEN" \
   --header "Content-Type: application/json"
  

Listar todos os snapshots de um volume

O exemplo a seguir mostra o URL completo para listar todos os snapshots do pool de armazenamento mypool e do volume volume-uuid em us-central1-a no projeto myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots

Como todas as chamadas de API do Google, essa chamada precisa ser autenticada. O exemplo de CLI a seguir busca um token de API e, em seguida, chama o URL usando curl para listar todos os snapshots do volume:

   TOKEN=$(gcloud auth print-access-token)
   curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots' \
   --header "Authorization: Bearer $TOKEN" \
   --header "Content-Type: application/json"
  

Criar um volume

Nesta seção, mostramos como criar um volume chamado myvolume em um pool de armazenamento no modo ONTAP unificado do Flex, identificado pelo URN: /projects/myproject/locations/us-central1-a/storagePools/mypool, usando a API REST do ONTAP.

Para criar um volume, consulte a documentação on-line da API REST do ONTAP. Na documentação, acesse a seção Armazenamento e expanda Gerenciar volumes de armazenamento. Esta seção fornece vários exemplos.

Use as instruções a seguir para criar um volume.

  1. Determine o endpoint de API REST do ONTAP.

    Usando o exemplo básico no NetApp Volumes, o endpoint de API ONTAP necessário é /api/storage/volumes. Esse endpoint cria o URL: https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.

  2. Crie o payload da solicitação.

    Use o payload de exemplo da documentação do ONTAP para corresponder ao seu ambiente específico. Exemplo:

    {
      "name": "vol1",
      "aggregates": [
        {
          "name": "aggr1"
        }
      ],
      "svm": {
        "name": "vs1"
      }
    }
    

    Ao criar um volume, use o campo name para atribuir o nome do volume. O payload de criação de volume requer os nomes do agregado e da máquina virtual de armazenamento (SVM, na sigla em inglês) atribuídos pelo NetApp Volumes durante a criação do pool do modo ONTAP. No modo ONTAP, cada pool de armazenamento tem uma SVM e um agregado de armazenamento. Para recuperar essas informações, consulte o ONTAP para todas as SVMs.

    Para recuperar a SVM e os nomes agregados:

    1. Use ontap_fields para seleção de campos: em pools do modo ONTAP do NetApp Volumes, use o parâmetro de consulta ontap_fields= em vez do parâmetro padrão fields= do ONTAP para especificar os campos solicitados.

    2. Opcional: usejq para extrair campos: o exemplo a seguir usa a ferramenta de código aberto jq para extrair o name (nome da SVM) e aggregates da resposta JSON, o que é útil para processamento em scripts de shell.

      TOKEN=$(gcloud auth print-access-token)
      curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/svm/svms?ontap_fields=name,aggregates' \
      --header "Authorization: Bearer $TOKEN" \
      --header "Content-Type: application/json" | jq '.rawResponse.records[] | {name: .name, aggregates: .aggregates[].name}'
      

      Exemplo de resposta:

      {
       "name": "gcnv-7cf6ee41c1a94f0-svm-01",
       "aggregates": "aggr1"
      }
      
  3. Execute a chamada de API de criação de volume.

    Com o nome do agregado (aggr1) e o nome da SVM (gcnv-7cf6ee41c1a94f0-svm-01), crie o payload final de criação de volume e envie a chamada de API. O payload da API ONTAP precisa estar dentro de um envelope body: {} para o NetApp Volumes.

    O exemplo a seguir cria um volume chamado myvolume com um tamanho de 2 GB:

    curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \
    --header "Authorization: Bearer $TOKEN" \
    --header "Content-Type: application/json" \
    --data '{
      "body": {
        "name": "myvolume",
        "aggregates": [
          {
            "name": "aggr1"
          }
        ],
        "svm": {
          "name": "gcnv-7cf6ee41c1a94f0-svm-01"
        },
        "size": "2GB"
      }
    }'
    

    A criação de volumes é compatível com muitos parâmetros opcionais, como size. Por exemplo, o payload especifica um tamanho de 2 GB. A página de documentação do recurso lista todos os parâmetros disponíveis, incluindo os obrigatórios e os opcionais. Ele também fornece exemplos detalhados de payloads e corpos de resposta.

    Para configurar os níveis automáticos na API REST do ONTAP, inclua o objeto JSON tiering no corpo da solicitação:

    • Para definir a política de nível do volume como all, use "tiering": {"policy": "all"}.

    • Opcional: para configurar os dias de resfriamento, use "tiering": {"policy": "auto", "min_cooling_days": 31}.

      É possível especificar um limite de resfriamento entre 2 e 183 dias no campo min_cooling_days. O valor padrão do limite de resfriamento é de 31 dias.

    Para ignorar o nível de acesso frequente e gravar dados diretamente no nível de nuvem em volumes de leitura e gravação (RW), use o proxy da CLI do ONTAP da CLI do Google Cloud com privilégios avançados:

    set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
  4. Monitore o job do ONTAP.

    A maioria das chamadas de API do ONTAP, como as operações POST ou PATCH que criam ou atualizam recursos, não é executada de forma síncrona. Em vez disso, essas chamadas retornam um recurso de job do ONTAP, conforme mostrado no exemplo de criação de volume.

    Exemplo de resposta do job:

    {
      "body": {
        "job": {
          "_links": {
            "self": {
              "href": "curl --location
    'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \
    --header "Authorization: Bearer $TOKEN" \
    --header "Content-Type: application/json""
            }
          },
          "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c"
        }
      }
    }
    

    Para verificar o status do job, consulte o recurso dele usando o uuid retornado:

    curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \
    --header "Authorization: Bearer $TOKEN" \
    --header "Content-Type: application/json"
    

    Exemplo de resposta:

    {
      "rawResponse": {
        "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c",
        "description": "POST
    /api/storage/volumes/15be0ad9-fd2c-11f0-b3c2-7f15697be61c",
        "state": "success",
        "message": "success",
        "code": 0,
        "start_time": "2026-01-29T16:03:43+00:00",
        "end_time": "2026-01-29T16:03:44+00:00",
        "svm": {
          "name": "gcnv-7cf6ee41c1a94f0-svm-01",
          "uuid": "8a29c15d-fb31-11f0-ab03-03e1bb49206d"
       }
      }
    }
    

    Se o state for success, o volume será criado.

    Este exemplo de fluxo de trabalho orienta você na pesquisa rápida de ações do ONTAP na documentação da API REST do ONTAP. Ele também mostra como criar o formato de payload necessário e enviá-lo ao pool de armazenamento usando uma API do Google. Por fim, demonstra como monitorar um job do ONTAP até que o recurso seja criado. Com essa abordagem, é possível controlar a maioria das configurações do ONTAP para seu pool de armazenamento.

Usar o Terraform para gerenciar o modo ONTAP

É possível gerenciar recursos do modo ONTAP usando o proxy da CLI. O proxy da CLI é eficaz para uso interativo, mas a automação pode ser mais complexa. O Terraform gerencia de forma consistente o ciclo de vida dos recursos de nuvem e pode ser usado para gerenciar os recursos do NetApp Volumes e do ONTAP.

Use a tabela Visão geral do gerenciamento de recursos para ajudar a determinar qual provedor usar.

  • O provedor do Google gerencia recursos usando a API NetApp Volumes.

  • O provedor NetApp-ONTAP gerencia recursos usando APIs REST do ONTAP.

Por exemplo, você cria um pool de armazenamento no modo ONTAP usando o provedor do Google, versão 7.27.0 ou mais recente. Em seguida, para criar um volume nesse pool no modo ONTAP, use o provedor NetApp-ONTAP, versão 2.6.0 ou posterior.

Para mais informações sobre configuração e exemplos, consulte a documentação do provedor NetApp-ONTAP.

Ações permitidas do ONTAP

Ao acessar um pool do modo ONTAP pela API ou pelo proxy da CLI, você não tem permissões completas e não pode executar todos os comandos do ONTAP. Essa restrição ajuda a proteger a integridade do sistema e evitar alterações nos recursos físicos subjacentes gerenciados pelo serviço.

Para algumas APIs, o sistema filtra os payloads de solicitação de API e resposta. Por exemplo, como o NetApp Volumes cobra pela capacidade lógica, o sistema bloqueia parâmetros para configurar a capacidade física. Se você enviar um parâmetro que não é permitido, a API vai retornar um erro.

Para mais informações sobre como faturamos, consulte Faturamento: capacidade lógica versus física.

Comandos do ONTAP compatíveis

É possível gerenciar o modo ONTAP enviando comandos ONTAP usando o proxy da CLI do ONTAP da CLI do Google Cloud. O NetApp Volumes é compatível com a maioria dos comandos para gerenciar SVMs, LUNs, volumes e recursos do ONTAP. Alguns comandos são bloqueados para proteger a integridade do sistema ou porque gerenciam recursos físicos que não são relevantes em um serviço gerenciado, como o NetApp Volumes.

Você executa comandos no nível de privilégio de administrador do ONTAP. Para mudar o nível de privilégio para avançado, adicione set advanced; ou set -privilege advanced; ao início do comando. Um conjunto limitado de comandos também é compatível com o nível de privilégio de diagnóstico (diag), que pode ser acessado adicionando set diag; ao início do comando. Essas mudanças de privilégio não são permanentes.

Como o proxy não é um shell interativo, só é possível executar um comando por vez. Essa limitação significa que o proxy não é compatível com comandos interativos que solicitam mais informações. Por exemplo, não é possível criar um vserver (SVM) CIFS ou SMB que exija credenciais de administrador do Active Directory. O proxy da CLI também não é compatível com o peering de cluster porque é um comando interativo. Para realizar essas operações, use a API REST do ONTAP.

A tabela a seguir lista as famílias de comandos, os comandos e as limitações compatíveis com o proxy da CLI do ONTAP:

Família de comandos Finalidade Comandos aceitos Observações
Cluster Clusters de peering para SnapMirror, FlexCache e exibição de informações selecionadas sobre o cluster cluster peer: acesso total

cluster show, identity show, date show, ha show, statistics show e time-service ntp server show: somente leitura
O proxy da CLI não é compatível com o comando interativo cluster peer create. Use a API REST. É possível usar outros comandos cluster peer, como show.
Depuração Suporte ao rastreamento de pacotes (tcpdump), LUN e solução de problemas de bloqueio debug network tcpdump, debug san lun e debug lock persistence: acesso total Todos os comandos de depuração permitidos exigem o nível de privilégio diag. Estes são comandos de depuração comuns.
Evento Criar filtros para enviar eventos do ONTAP de interesse para destinos SMTP ou syslog event catalog show e event log show: somente leitura

event config, event filter e event notification: acesso total
Permite registrar eventos em destinos personalizados. Use event log show para exibir eventos de registro por horário ou tipo.
Job Gerenciar jobs do ONTAP no nível do nó e do cluster job show, job schedule, job private, job stop e job resume: acesso total
LUN Criar e gerenciar LUNs e grupos de iniciadores, além de importar LUNs externos lun create, lun bind e igroup: acesso total Embora lun import seja permitido, não é possível conectar discos externos a um sistema de modo ONTAP.
Rede Mostrar configurações de porta de rede, interface, rota e ipspace, executar ping e traceroute para endereços IP externo e mostrar conexões de cliente por protocolo network ping, network traceroute, network port interface, network ipspace e network connections: somente leitura
QoS Criar e gerenciar grupos de políticas de QoS (QPGs) e atribuí-los a volumes. A capacidade de processamento total e as IOPS do pool definem o limite geral. qos policy-group create, qos policy-group modify e qos policy-group delete: acesso total

qos policy-group show: somente leitura

volume create -qos-policy-group e volume modify -qos-policy-group: anexar um volume a um QPG, movê-lo para outro QPG ou desanexá-lo com none
  • qos policy-group create requer -vserver.
  • Se você omitir -is-shared, o QPG será compartilhado.
  • -vserver não é necessário para qos policy-group modify ou qos policy-group delete.
  • qos policy-group delete só funciona quando nenhum volume está anexado. Remova-os primeiro com volume modify -qos-policy-group none.
  • A política de SVM SVM-qos-policy reflete a capacidade de processamento total e as IOPS do pool. Para alterar esses totais, use gcloud netapp storage-pools update --total-throughput ou --total-iops, não a linha de comando do ONTAP.
Segurança Mostrar a configuração de auditoria, ativar o recurso antiransomware e criar e instalar certificados security audit: somente leitura

security anti-ransomware volume e security certificate: acesso total
Os parâmetros antiransomware podem ser definidos ao criar o volume. Só é possível criar certificados de servidor e de cliente.
SnapLock Gerenciar o relógio e os registros do SnapLock e controlar as operações de retenção baseada em eventos e guarda de documentos do SnapLock snaplock compliance-clock e snaplock log: acesso total Use o comando volume snaplock modify para configurar o SnapLock em volumes individuais. Só é possível gerenciar os comandos snaplock event-retention e snaplock legal-hold do SnapLock usando a API REST do ONTAP.
SnapMirror Criar e gerenciar relações do SnapMirror snapmirror create, snapmirror initialize, snapmirror break e snapmirror resync: acesso total
Estatísticas Mostrar estatísticas periódicas do sistema ou criar amostras de estatísticas específicas statistics samples, statistics start, statistics stop e statistics show-periodic: acesso total

statistics volume, statistics lun, statistics aggregate, statistics qtree e statistics SVM: somente leitura
Muitos comandos precisam do modo avançado para especificar os parâmetros.
Sistema Os comandos do sistema geralmente não são compatíveis, mas o AutoSupport e a transmissão de arquivos de desempenho podem ser invocados system node autosupport invoke e system node autosupport invoke-performance-archive: acesso total Os arquivos do AutoSupport estão disponíveis para o suporte da NetApp.
Volume Criar e gerenciar volumes volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock e snapshot: acesso total Alguns recursos de volume, como relatórios/aplicação de espaço lógico e garantia de espaço (nenhum), são gerenciados automaticamente pelo sistema. Defina a política de divisão em níveis de volume para usar a divisão em níveis automática definida no nível do pool.
Vserver Gerenciar a SVM (vserver) para acesso de arquivos (SMB, NFS), blocos (iSCSI, NVMe) e objetos (S3) aos volumes.

Gerenciar políticas usadas para volumes, como políticas de exportação para NFS.

Ativar recursos da SVM, como registro de auditoria (acesso a arquivos), grupos de consistência, políticas, serviços de nomes (DNS, LDAP) e antivírus (vscan).

Fazer peering de SVMs para SnapMirror e FlexCache.
vserver cifs create (mesclar com um domínio do Active Directory), vserver nfs create, vserver iscsi create e vserver nvme create: acesso total

vserver object-store-server: acesso total
Use o comando vserver modify para definir o idioma padrão, o estilo de segurança e as políticas de snapshot e cota para todos os volumes.

vserver create não é compatível no momento.
Os comandos de alteração de senha não podem ser executados como interativos e precisam ser especificados usando parâmetros de comando ou a API REST.
Comandos legados timezone e version: acesso total

Excluir um pool do modo ONTAP

Para excluir um pool do modo ONTAP, primeiro é necessário excluir todos os volumes dele.