Gestisci ONTAP in modalità ONTAP

Questa pagina descrive come gestire ONTAP in modalità ONTAP.

Per motivi di sicurezza e logging, NetApp Volumes non consente connessioni dirette alla LIF di gestione ONTAP. Pertanto, 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 un'API proxy Google per le chiamate API REST ONTAP.

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

Utilizzare un'API proxy di Google per le chiamate all'API REST ONTAP

NetApp Volumes fornisce un endpoint API Google per ogni pool di archiviazione Flex in modalità ONTAP Unified, che 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/v1beta1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL

Questo URL è composto dai seguenti elementi:

  • URL di base: https://netapp.googleapis.com/v1beta1/projects

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

    Sostituisci le seguenti informazioni:

    • PROJECT: il tuo project ID o numero.

    • 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 saperne di più, consulta il riferimento all'API REST ONTAP.

Elenca tutti i volumi di un pool di archiviazione

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

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

Come tutte le chiamate API di Google, questa chiamata deve essere autenticata. Il seguente esempio di CLI 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/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' 

   --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 Flex Unified in modalità ONTAP 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 Archiviazione, quindi espandi Gestisci volumi di archiviazione. Questa sezione fornisce diversi esempi.

Utilizza le seguenti 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/v1beta1/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 un SVM e un aggregato di archiviazione. Queste informazioni possono essere recuperate eseguendo 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 NetApp Volumes ONTAP-mode, 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: il seguente esempio utilizza lo strumento open source jq per estrarre name (nome SVM) e aggregates dalla risposta JSON, il che è utile per l'elaborazione negli script shell.

      TOKEN=$(gcloud auth print-access-token)
curl --location
'https://netapp.googleapis.com/v1beta1/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 per la creazione del volume.

    Con il nome dell'aggregato (aggr1) e il nome della SVM (gcnv-7cf6ee41c1a94f0-svm-01), crea il payload finale per la creazione del volume e invia la chiamata API. Tieni presente che il payload dell'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/v1beta1/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 di volumi supporta molti parametri facoltativi, come size. Ad esempio, il payload specifica una dimensione di 2 GB. La pagina di documentazione della risorsa elenca tutti i parametri disponibili, inclusi quelli obbligatori e facoltativi. Fornisce inoltre esempi dettagliati di payload e corpi delle risposte.

  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/v1beta1/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 uuid restituito:

    curl --location
'https://netapp.googleapis.com/v1beta1/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. Mostra anche come creare il formato del payload richiesto e inviarlo al pool di archiviazione utilizzando un'API Google. Infine, mostra come monitorare un job ONTAP fino alla creazione della risorsa. Con questo approccio, puoi controllare la maggior parte delle impostazioni ONTAP per il pool di archiviazione.

Azioni ONTAP consentite

Quando accedi a un pool tramite il proxy API o CLI, hai autorizzazioni limitate e non puoi eseguire tutti i comandi ONTAP. In questo modo, l'integrità dell'impianto è protetta. Per alcune API, il sistema filtra i payload di richiesta e risposta 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.

Elimina un pool in modalità ONTAP

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