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/v1URN do Google para o pool de armazenamento: /projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAMESubstitua 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.
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.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
namepara 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:
Use
ontap_fieldspara seleção de campos: em pools do modo ONTAP do NetApp Volumes, use o parâmetro de consultaontap_fields=em vez do parâmetro padrãofields=do ONTAP para especificar os campos solicitados.Opcional: use
jqpara extrair campos: o exemplo a seguir usa a ferramenta de código aberto jq para extrair oname(nome da SVM) eaggregatesda 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" }
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 envelopebody: {}para o NetApp Volumes.O exemplo a seguir cria um volume chamado
myvolumecom 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
tieringno 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
Monitore o job do ONTAP.
A maioria das chamadas de API do ONTAP, como as operações
POSTouPATCHque 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
uuidretornado: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
stateforsuccess, 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 totalcluster 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 leituraevent 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 totalqos policy-group show: somente leituravolume 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 |
|
| Segurança | Mostrar a configuração de auditoria, ativar o recurso antiransomware e criar e instalar certificados | security audit: somente leiturasecurity 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 totalstatistics 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 totalvserver 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.