Come posso usare FSx per le REST API ONTAP?

Risoluzione

Requisiti

Il richiedente API deve essere in grado di effettuare connessioni HTTPS al file system FSx per ONTAP e agli endpoint della macchina virtuale di storage (SVM). Per ulteriori informazioni, consulta Utilizzo della REST API NetApp ONTAP.

Esegui Hello World sul file system FSx per ONTAP con curl

Nell'interfaccia a riga di comando di un'istanza Linux sul tuo Amazon Virtual Private Cloud (Amazon VPC) che esegue il file system FSx per ONTAP, procedi come segue:

1.    Inserisci la tua password fsxadmin e il nome DNS dell'endpoint. Nel seguente comando di esempio, sostituisci Password e fs-XXXXXXXX.fsx.region.amazonaws.com con i valori corretti per il tuo caso d'uso:

$ CRED=fsxadmin:Password
$ ONTAP=management.fs-XXXXXXXX.fsx.region.amazonaws.com

2.    Esegui il seguente comando per recuperare la versione del software ONTAP:

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/cluster?fields=version"
{
  "version": {
    "full": "NetApp Release 9.10.1RC1P1: Sat Nov 27 18:08:32 UTC 2021",
    "generation": 9,
    "major": 10,
    "minor": 1
  },
  "_links": {
    "self": {
      "href": "/api/cluster"
    }
  }
}

Esempio di REST API: ottieni volumi

Di seguito è riportato un esempio del comando GET utilizzato per recuperare i volumi:

$ curl -X GET -u ${CRED} -k "https://${ONTAP}/api/storage/volumes"
{
  "records": [
    {
      "uuid": "504c8162-a435-11ec-bb13-130f21c56a08",
      "name": "svm1_root",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/504c8162-a435-11ec-bb13-130f21c56a08"
        }
      }
    },
    {
      "uuid": "956f5ce9-a435-11ec-bb13-130f21c56a08",
      "name": "vol1",
      "_links": {
        "self": {
          "href": "/api/storage/volumes/956f5ce9-a435-11ec-bb13-130f21c56a08"
        }
      }
    }
  ],
  "num_records": 2,
  "_links": {
    "self": {
      "href": "/api/storage/volumes"
    }
  }
}

Nota: alcune API non funzionano su FSx per ONTAP.

Usa l'interfaccia NetApp BlueXP API Swagger

Puoi accedere ad alcune API NetApp ONTAP utilizzando l'interfaccia BlueXP r Connector Swagger. Per ulteriori informazioni, consulta Informazioni su BlueXP e Come accedere all'interfaccia API Swagger di BlueXP (precedentemente Cloud Manager) sul sito web di NetApp.

I passaggi seguenti sono un esempio di accesso all'interfaccia Swagger utilizzando BlueXP e di pubblicazione delle credenziali.

1.    Nel Connettore BlueXP, seleziona il menu Aiuto, rappresentato da un punto interrogativo, quindi seleziona API.

Oppure, vai direttamente all'interfaccia Swagger (URL di esempio: http://connectorip/occm/api-doc/).

2.    Seleziona Operazioni di gestione utenti.

3.    Seleziona auth: operazioni di autenticazione.

4.    Seleziona POST /auth/login, Espandi operazioni.

5.    Seleziona Schema modello.

6.    Seleziona Fai clic per impostare come valore di parametro nello schema del modello che visualizza quanto segue:

{
"email": "string",
"password": "string"
}

7.    Nel campo Valore in cui è compilato lo schema del modello, modifica la stringa per fornire l'indirizzo e-mail e la password corretti:

{
"email": "user@example.com",
"password": "xxxxxxxxxx"
}

Nota: l'ID e-mail non èfsxadmin. L'e-mail è l'ID e-mail di Cloud Central Auth0 utilizzato per accedere al connettore BlueXP. La password è impostata in testo normale.

8.    Seleziona Fai una prova!

9.    Verifica che l'accesso sia stato eseguito correttamente nel Codice di risposta.

Esempio: ottieni l'API dei volumi utilizzando l'interfaccia BlueXP Swagger

1.    Nell'interfaccia Swagger, seleziona Operazioni dell'ambiente di lavoro FSx (cluster Data ONTAP).

2.    Seleziona fsx/volumi.

3.    Seleziona GET /fsx/volumes, Espandi operazioni.

4.    Nel campo Valore, inserisci l'ID del file system da cui desideri recuperare l'elenco dei volumi.

5.    Seleziona Fai una prova!

6.    Verifica che l'accesso sia riuscito dal Codice di risposta e dal Corpo della risposta.

---

Informazioni correlate

Gli script di esempio in Python di REST API di ONTAP sono ora disponibili su GitHub