¿Cómo puedo utilizar FSx para las API de REST de ONTAP?

Resolución

Requisitos previos

El solicitante de la API debe poder establecer conexiones HTTPS al sistema de archivos FSx para ONTAP y a los puntos de conexión de la máquina virtual de almacenamiento (SVM). Para obtener más información, consulte Uso de la API de REST de NetApp ONTAP.

Ejecute Hello World en el sistema de archivos FSx para ONTAP con curl

En la interfaz de línea de comandos de una instancia de Linux de su Amazon Virtual Private Cloud (Amazon VPC) que ejecuta el sistema de archivos FSx para ONTAP, haga lo siguiente:

1.    Introduzca su contraseña fsxadmin y el nombre DNS del punto de conexión. En el siguiente comando de ejemplo, sustituya Contraseña y fs-XXXXXXXX.fsx.region.amazonaws.com por los valores correctos para su caso de uso:

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

2.    Ejecute el siguiente comando para recuperar la versión 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"
    }
  }
}

Ejemplo de API de REST: obtener volúmenes

El siguiente es un ejemplo del comando GET utilizado para recuperar volúmenes:

$ 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: Algunas API no se ejecutan en FSx para ONTAP.

Utilice la interfaz de Swagger de la API BlueXP de NetApp

Puede acceder a algunas API de NetApp ONTAP mediante la interfaz de Swagger en el conector BlueXP. Para obtener más información, consulte Más información sobre BlueXP y Cómo iniciar sesión en la interfaz de Swagger de la API BlueXP (anteriormente Cloud Manager) en el sitio web de NetApp.

Los siguientes pasos son un ejemplo de cómo acceder a la interfaz de Swagger mediante BlueXP y publicar credenciales.

1.    En el conector BlueXP, seleccione el menú Ayuda, representado por un signo de interrogación y, a continuación, API.

O bien, vaya directamente a la interfaz de Swagger (URL de ejemplo: http://connectorip/occm/api-doc/).

2.    Seleccione Operaciones de administración de usuarios.

3.    Seleccione auth : Operaciones de autenticación.

4.    Seleccione POST /auth/login y Expandir operaciones.

5.    Seleccione Esquema de modelo.

6.    Seleccione Haga clic para establecer como valor de parámetro en el esquema del modelo que muestra lo siguiente:

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

7.    En el campo Valor donde se rellena el esquema del modelo, edite la cadena para proporcionar el correo electrónico y la contraseña correctos:

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

Nota: El identificador de correo electrónico no esfsxadmin. El correo electrónico es el identificador de correo electrónico de Cloud Central Auth0 que se utiliza para iniciar sesión en el conector BlueXP. La contraseña se establece en texto sin formato.

8.    Seleccione Probar.

9.    Compruebe que el inicio de sesión se ha realizado correctamente desde el Código de respuesta.

Ejemplo: Obtenga la API de volúmenes mediante la interfaz de Swagger en BlueXP

1.    En la interfaz de Swagger, seleccione las operaciones del entorno de trabajo de FSx (clúster de datos ONTAP).

2.    Seleccione fsx/volumes.

3.    Seleccione GET /fsx/volumes y Expandir operaciones.

4.    En el campo Valor, ingrese el ID del sistema de archivos del que desea recuperar la lista de volúmenes.

5.    Seleccione Probar.

6.    Compruebe que el inicio de sesión se ha realizado correctamente desde el Código de respuesta y el Cuerpo de la respuesta.

---

Información relacionada

Los scripts de ejemplo de Python de la API de REST de ONTAP ya están disponibles en GitHub