Gestisci ONTAP in modalità ONTAP

Questa pagina descrive come gestire ONTAP in modalità ONTAP.

Per motivi di sicurezza e di logging, NetApp Volumes non consente connessioni dirette al LIF di gestione ONTAP. Di conseguenza, non puoi utilizzare strumenti come SystemManager o SSH per gestire direttamente il sistema ONTAP. In alternativa, puoi inviare operazioni ONTAP al pool di archiviazione in modalità ONTAP utilizzando i seguenti metodi:

Gli strumenti di gestione, come Terraform, utilizzano il proxy API di Google per gestire le risorse ONTAP.

Prima di iniziare

La versione di Google Cloud CLI deve essere almeno la 559.0.0 per gestire le operazioni ONTAP per il pool di archiviazione in modalità ONTAP. Se la versione è precedente, Google Cloud CLI restituisce un errore che indica che il comando o il flag non è definito.

Utilizza il proxy ONTAP CLI di Google Cloud CLI

Sebbene l'accesso SSH diretto alla CLI ONTAP non sia disponibile, puoi inviare comandi CLI ONTAP al pool di archiviazione utilizzando Google Cloud CLI.

gcloud

Esegui un comando ONTAP:

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

Sostituisci le seguenti informazioni:

  • POOL-NAME: il nome del pool di archiviazione in modalità ONTAP Flex Unified.

  • ONTAP-COMMAND: il comando ONTAP che vuoi eseguire sul cluster o sul pool di archiviazione.

  • PROJECT: il tuo ID progetto.

  • LOCATION: la località del pool di archiviazione.

Utilizza un'API proxy di Google per le chiamate API REST ONTAP

NetApp Volumes fornisce un endpoint API di Google per ogni pool di archiviazione in modalità ONTAP Flex Unified, che ti consente di inviare chiamate API REST ONTAP al cluster ONTAP sottostante. In questo modo puoi controllare le funzionalità ONTAP utilizzando le API.

Le chiamate al proxy ONTAP devono utilizzare il seguente formato URL:

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

Questo URL è composto dai seguenti elementi:

  • URL di base: https://netapp.googleapis.com/v1

  • URN di Google per il pool di archiviazione: /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    Sostituisci le seguenti informazioni:

    • PROJECT: il tuo ID progetto.

    • LOCATION: il nome della zona per i pool zonali o la regione per i pool regionali.

    • POOL_NAME: il nome del pool.

  • Percorso API REST ONTAP: /ontap/ONTAP_REST_URL. Per ulteriori informazioni, consulta il riferimento API REST ONTAP.

Elenca tutti i volumi di un pool di archiviazione

L'esempio seguente mostra l'URL completo per elencare tutti i volumi del pool di archiviazione mypool in us-central1-a nel progetto myproject.

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

Come tutte le chiamate API di Google, questa chiamata deve essere autenticata. L'esempio CLI seguente recupera un token API, quindi chiama l'URL utilizzando curl per elencare tutti i volumi nel 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"

Elenca tutti gli snapshot di un volume

L'esempio seguente mostra l'URL completo per elencare tutti gli snapshot del pool di archiviazione mypool e del volume volume-uuid in us-central1-a nel progetto myproject.

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

Come tutte le chiamate API di Google, questa chiamata deve essere autenticata. L'esempio CLI seguente recupera un token API, quindi chiama l'URL utilizzando curl per elencare tutti gli snapshot del 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"

Crea un volume

Questa sezione mostra come creare un volume denominato myvolume in un pool di archiviazione in modalità ONTAP Flex Unified esistente, identificato dall'URN: /projects/myproject/locations/us-central1-a/storagePools/mypool, utilizzando l'API REST ONTAP.

Per creare un volume, consulta la documentazione online dell'API REST ONTAP. Nella documentazione, vai alla sezione Storage, quindi espandi Gestisci volumi di archiviazione. Questa sezione fornisce diversi esempi.

Segui queste istruzioni per creare un volume.

  1. Determina l'endpoint API REST ONTAP.

    Utilizzando l'esempio di base in NetApp Volumes, l'endpoint API ONTAP richiesto è /api/storage/volumes. Questo endpoint crea l'URL: https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.

  2. Crea il payload della richiesta.

    Utilizza il payload di esempio della documentazione ONTAP per adattarlo al tuo ambiente specifico. Ad esempio:

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

    Quando crei un volume, utilizza il campo name per assegnare il nome del volume. Il payload di creazione del volume richiede i nomi dell'aggregato e della macchina virtuale di archiviazione (SVM) assegnati da NetApp Volumes durante la creazione del pool in modalità ONTAP. In modalità ONTAP, ogni pool di archiviazione ha una SVM e un aggregato di archiviazione. Queste informazioni possono essere recuperate eseguendo una query su ONTAP per tutte le SVM.

    Per recuperare i nomi della SVM e dell'aggregato:

    1. Utilizza ontap_fields per la selezione dei campi: nei pool in modalità ONTAP di NetApp Volumes, utilizza il parametro di query ontap_fields= anziché il parametro ONTAP standard fields= per specificare i campi richiesti.

    2. (Facoltativo) Utilizzajq per estrarre i campi: l'esempio seguente utilizza lo strumento open source jq per estrarre name (nome SVM) e aggregates dalla risposta JSON, utile per l'elaborazione negli script della 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}'

      Esempio di risposta:

      {
 "name": "gcnv-7cf6ee41c1a94f0-svm-01",
 "aggregates": "aggr1"
}

  3. Esegui la chiamata API di creazione del volume.

    Con il nome dell'aggregato (aggr1) e il nome della SVM (gcnv-7cf6ee41c1a94f0-svm-01), crea il payload finale di creazione del volume e invia la chiamata API. Tieni presente che il payload API ONTAP deve essere racchiuso in un envelope body: {} per NetApp Volumes.

    L'esempio seguente crea un volume denominato myvolume con una dimensione di 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"
  }
}'

    La creazione del volume supporta molti parametri facoltativi, come size. Ad esempio, il payload specifica una dimensione di 2 GB. La pagina della documentazione della risorsa elenca tutti i parametri disponibili, inclusi quelli obbligatori e facoltativi. Fornisce anche esempi dettagliati di payload e corpi di risposta.

  4. Monitora il job ONTAP.

    La maggior parte delle chiamate API ONTAP, come le operazioni POST o PATCH che creano o aggiornano le risorse, non vengono eseguite in modo sincrono. Queste chiamate restituiscono invece una risorsa job ONTAP, come mostrato nell'esempio di creazione del volume.

    Esempio di risposta del 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"
    }
  }
}

    Per controllare lo stato del job, esegui una query sulla risorsa job utilizzando l'elemento uuid restituito:

    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"

    Esempio di risposta:

    {
  "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 state è success, il volume viene creato.

    Questo flusso di lavoro di esempio ti guida nella ricerca delle azioni ONTAP nella documentazione dell'API REST ONTAP. Ti mostra anche come creare il formato del payload richiesto e inviarlo al pool di archiviazione utilizzando un'API di Google. Infine, mostra come monitorare un job ONTAP finché la risorsa non viene creata. Con questo approccio, puoi controllare la maggior parte delle impostazioni ONTAP per il pool di archiviazione.

Utilizza Terraform per gestire la modalità ONTAP

Puoi gestire le risorse in modalità ONTAP utilizzando il proxy CLI. Il proxy CLI è efficace per l'utilizzo interattivo, ma l'automazione può essere più complessa. Terraform gestisce in modo coerente il ciclo di vita delle risorse cloud e puoi utilizzarlo per gestire sia le risorse NetApp Volumes sia quelle ONTAP.

Utilizza la Panoramica della gestione delle funzionalità tabella per determinare quale provider utilizzare.

  • Il provider Google gestisce le risorse tramite l'API NetApp Volumes.

  • Il provider NetApp-ONTAP gestisce le risorse tramite le API REST ONTAP.

Ad esempio, puoi creare un pool di archiviazione in modalità ONTAP utilizzando il provider Google, versione 7.27.0 o successive. Poi, per creare un volume in quel pool in modalità ONTAP, utilizza il provider NetApp-ONTAP, versione 2.6.0 o successive.

Per ulteriori informazioni sulla configurazione ed esempi, consulta la documentazione del provider NetApp-ONTAP.

Azioni ONTAP consentite

Quando accedi a un pool in modalità ONTAP tramite l'API o il proxy CLI, non hai le autorizzazioni complete e non puoi eseguire tutti i comandi ONTAP. Questa limitazione contribuisce a proteggere l'integrità del sistema e a impedire modifiche alle risorse fisiche sottostanti gestite dal servizio.

Per alcune API, il sistema filtra i payload delle richieste e delle risposte API. Ad esempio, poiché NetApp Volumes fattura la capacità logica, il sistema blocca i parametri per la configurazione della capacità fisica. Se invii un parametro non consentito, l'API restituisce un errore.

Comandi ONTAP supportati

Puoi gestire la modalità ONTAP inviando comandi ONTAP utilizzando il proxy ONTAP CLI di Google Cloud CLI. NetApp Volumes supporta la maggior parte dei comandi per gestire SVM, LUN, volumi e funzionalità ONTAP. Alcuni comandi sono bloccati per proteggere l'integrità del sistema o perché gestiscono risorse fisiche non pertinenti in un servizio gestito come NetApp Volumes.

Esegui i comandi a livello di privilegi di amministratore ONTAP. Per passare al livello di privilegi avanzato, aggiungi set advanced; o set -privilege advanced; all'inizio del comando. Un insieme limitato di comandi supporta anche il livello di privilegi di diagnostica (diag), a cui puoi accedere aggiungendo set diag; all'inizio del comando. Questi spostamenti di privilegi non sono persistenti.

Poiché il proxy non è una shell interattiva, puoi eseguire un solo comando alla volta. Questa limitazione significa che il proxy non supporta i comandi interattivi che richiedono informazioni aggiuntive. Ad esempio, non puoi creare un vserver CIFS o SMB (SVM) che richieda le credenziali di amministratore di Active Directory. Il proxy CLI non supporta nemmeno il peering del cluster perché è un comando interattivo. Per eseguire queste operazioni, devi utilizzare l'API REST ONTAP.

La tabella seguente elenca le famiglie di comandi, i comandi e le limitazioni supportati del proxy CLI ONTAP:

Famiglia di comandi Finalità Comandi supportati Note
Cluster Esegui il peering dei cluster per SnapMirror, FlexCache e visualizza informazioni selezionate sul cluster cluster peer - accesso completo

cluster show, identity show, date show, ha show, statistics show e time-service ntp server show - di sola lettura		 Il proxy CLI non supporta il comando interattivo cluster peer create; utilizza invece l'API REST. Puoi utilizzare altri comandi cluster peer, come show.
Debug Supporta la risoluzione dei problemi di tracciamento dei pacchetti (tcpdump), LUN e blocco debug network tcpdump, debug san lun e debug lock persistence - accesso completo Tutti i comandi di debug consentiti richiedono il livello di privilegi diag. Questi sono comandi di debug comuni.
Evento Crea filtri per inviare gli eventi ONTAP di interesse alle destinazioni SMTP o syslog event catalog show e event log show - di sola lettura

event config, event filter e event notification - accesso completo		 Ti consente di registrare gli eventi in destinazioni personalizzate. Puoi utilizzare event log show per visualizzare gli eventi di log per ora o tipo.
Job Gestisci i job ONTAP a livello di nodo e cluster job show, job schedule, job private, job stop e job resume - accesso completo
LUN Crea e gestisci LUN e gruppi di iniziatori e importa LUN esterni lun create, lun bind e igroup - accesso completo Sebbene l'importazione di LUN sia consentita, non è possibile collegare dischi esterni a un sistema in modalità ONTAP.
Rete Mostra le configurazioni di porta di rete, interfaccia, route e ipspace, esegui ping e traceroute agli indirizzi IP esterni e mostra le connessioni client per protocollo network ping, network traceroute, network port interface, network ipspace e network connections - di sola lettura
QoS Crea e gestisci i gruppi di policy QoS e visualizzane il rendimento Tutti i comandi QoS - di sola lettura Le impostazioni QoS sono di sola visualizzazione.
Sicurezza Mostra la configurazione di audit, abilita la funzionalità anti-ransomware e crea e installa i certificati security audit - di sola lettura

security anti-ransomware volume e security certificate - accesso completo		 I parametri anti-ransomware possono essere impostati durante la creazione del volume. Puoi creare solo certificati server e client.
SnapLock Gestisci l'orologio e i log di SnapLock e controlla le operazioni di conservazione basate su eventi e di archiviazione a fini legali di SnapLock snaplock compliance-clock e snaplock log - accesso completo Utilizza il comando volume snaplock modify per configurare SnapLock sui singoli volumi. Puoi gestire i comandi SnapLock snaplock event-retention e snaplock legal-hold solo utilizzando l'API REST ONTAP.
SnapMirror Crea e gestisci le relazioni SnapMirror snapmirror create, snapmirror initialize, snapmirror break e snapmirror resync - accesso completo
Statistiche Mostra le statistiche di sistema periodiche o crea campioni di statistiche specifiche statistics samples, statistics start, statistics stop e statistics show-periodic - accesso completo

statistics volume, statistics lun, statistics aggregate, statistics qtree e statistics SVM - di sola lettura		 Molti comandi richiedono la modalità avanzata per specificare i parametri.
Sistema I comandi di sistema non sono generalmente supportati, ma è possibile richiamare la trasmissione di AutoSupport e dell'archivio del rendimento system node autosupport invoke e system node autosupport invoke-performance-archive - accesso completo I file AutoSupport sono disponibili per l'assistenza NetApp.
Volume Crea e gestisci i volumi volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock, snapshot - accesso completo Alcune funzionalità del volume, come la generazione di report/l'applicazione dello spazio logico e la garanzia di spazio (nessuna), vengono gestite automaticamente dal sistema. Imposta la policy di tiering del volume in modo da utilizzare il tiering automatico impostato a livello di pool.
Vserver Gestisci la SVM (vserver) per l'accesso a file (SMB, NFS), blocchi (iSCSI, NVMe) e oggetti (S3) ai volumi.

Gestisci le policy utilizzate per i volumi, ad esempio le policy di esportazione per NFS.

Abilita le funzionalità SVM come la registrazione di audit (accesso ai file), i gruppi di coerenza, le policy, i servizi di nomi (DNS, LDAP) e l'antivirus (vscan).

Esegui il peering delle SVM per SnapMirror e FlexCache.		 vserver cifs create (unisci a un dominio Active Directory), vserver nfs create, vserver iscsi create e vserver nvme create - accesso completo

vserver object-store-server - accesso completo		 Utilizza il comando vserver modify per impostare la lingua predefinita, lo stile di sicurezza e le policy di snapshot e quota per tutti i volumi.

vserver create non è supportato al momento.
I comandi di modifica della password non possono essere eseguiti in modo interattivo e devono essere specificati utilizzando i parametri del comando o l'API REST.
Comandi legacy timezone e version - accesso completo

Elimina un pool in modalità ONTAP

Per eliminare un pool in modalità ONTAP, devi prima eliminare tutti i volumi nel pool.