Skip to main content
Active IQ Unified Manager
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Soluciona problemas en volúmenes ONTAP usando las API gateway de Active IQ Unified Manager

PDF

Las API de puerta de enlace actúan como una puerta de enlace para invocar las API de ONTAP con el fin de consultar información sobre tus objetos de almacenamiento ONTAP y tomar medidas correctivas para resolver los problemas detectados.

Este flujo de trabajo aborda un caso de uso de ejemplo en el que se genera un evento cuando un volumen de ONTAP está a punto de alcanzar su capacidad máxima. El flujo de trabajo también muestra cómo resolver este problema invocando una combinación de Active IQ Unified Manager y API de REST de ONTAP.

Nota

Antes de ejecutar los pasos del flujo de trabajo, asegúrate de lo siguiente:

  • Conoces las API de gateway y cómo se usan. Para obtener más información, consulta "Acceder a las API de ONTAP a través de acceso proxy".

  • Conoces el uso de las API de REST de ONTAP. Para obtener información sobre el uso de las API de REST de ONTAP, consulta "Documentación de automatización de ONTAP".

  • Eres un administrador de aplicaciones.

  • El clúster en el que quieres ejecutar las operaciones de la API de REST es compatible con ONTAP 9.5 o una versión posterior, y has añadido el clúster a Unified Manager mediante HTTPS.

El siguiente diagrama ilustra cada paso del flujo de trabajo para solucionar el problema relacionado con el uso de la capacidad de los volúmenes de ONTAP.

Un diagrama que muestra los pasos de Unified Manager y la API de ONTAP para solucionar problemas de alertas de capacidad de volúmenes

El flujo de trabajo abarca los puntos de invocación tanto de las API de REST de Unified Manager como de ONTAP.

  1. Anota el nombre del volumen que aparece en el aviso sobre el uso de la capacidad del volumen.

  2. Si usas el nombre del volumen como valor en el parámetro name, consulta el volumen ejecutando la siguiente API de Unified Manager.

    Categoría Verbo HTTP Ruta

    centro de datos

    GET

    /datacenter/storage/volumes

  3. Recupera el UUID del clúster y el UUID del volumen de la salida.

  4. En la interfaz de usuario web de Unified Manager, ve a General > Feature Settings > API Gateway para comprobar si la función API Gateway está activada. Si no está activada, no podrás invocar las API de la categoría gateway. Activa la función si está desactivada.

  5. Utiliza el UUID del clúster para ejecutar la API de ONTAP /storage/volumes/{uuid} a través del gateway de API. La consulta devuelve los detalles del volumen cuando se pasa el UUID del volumen como parámetro de la API.

    Para ejecutar las API de ONTAP a través de API gateway, Unified Manager pasa internamente las credenciales para la autenticación, por lo que no necesitas realizar ningún paso de autenticación adicional para acceder a cada clúster.

    Categoría Verbo HTTP Ruta

    Unified Manager: puerta de enlace

    ONTAP: almacenamiento

    GET

    API de Gateway: /gateways/{uuid}/{path}

    API de ONTAP: /storage/volumes/{uuid}
    Nota

    En /gateways/{uuid}/{path}, el valor de {uuid} debe sustituirse por el UUID del clúster donde vas a realizar la operación de REST. {path} debe sustituirse por la URL de REST de ONTAP /storage/volumes/{uuid}.

    La URL adjunta es: /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

    Al ejecutar la operación GET, la URL generada es: GEThttps://<hostname\>/api/gateways/<cluster_UUID\>/storage/volumes/{volume_uuid}

    Ejemplo de comando cURL

    curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7"
-H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"

  6. A partir de los resultados, determina el tamaño, el uso y la medida correctiva que debes tomar. En este flujo de trabajo, la medida correctiva que debes tomar es cambiar el tamaño del volumen.

  7. Utiliza el UUID del clúster y ejecuta la siguiente API de ONTAP a través de la pasarela de API para cambiar el tamaño del volumen. Para obtener información sobre los parámetros de entrada de la pasarela y las API de ONTAP, consulta el paso 5.

    Categoría Verbo HTTP Ruta

    Unified Manager: puerta de enlace

    ONTAP: almacenamiento

    PATCH

    API de Gateway: /gateways/{uuid}/{path}

    API de ONTAP: /storage/volumes/{uuid}
    Nota

    Además del UUID del clúster y el UUID del volumen, debes introducir un valor para el parámetro size para cambiar el tamaño del volumen. Asegúrate de introducir el valor en bytes. Por ejemplo, si quieres aumentar el tamaño de un volumen de 100 GB a 120 GB, introduce el valor del parámetro size al final de la consulta: -d {\"size\": 128849018880}"

    Ejemplo de comando cURL

    curl -X PATCH "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
    "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>" -d
    {\"size\": 128849018880}"

    La salida JSON devuelve un UUID de trabajo.

  8. Comprueba si el trabajo se ejecutó correctamente usando el UUID del trabajo. Usa el UUID del clúster y el UUID del trabajo para ejecutar la siguiente API de ONTAP a través del API gateway. Para obtener información sobre los parámetros de entrada del gateway y las API de ONTAP, consulta el paso 5.

    Categoría Verbo HTTP Ruta

    Unified Manager: puerta de enlace

    ONTAP: clúster

    GET

    API de Gateway: /gateways/{uuid}/{path}

    API de ONTAP: /cluster/jobs/{uuid}

    Los códigos HTTP devueltos son los mismos que los códigos de estado HTTP de la API de REST de ONTAP.

  9. Ejecuta la siguiente API de ONTAP para consultar los detalles del volumen redimensionado. Para obtener información sobre los parámetros de entrada de las API del gateway y de ONTAP, consulta el paso 5.

    Categoría Verbo HTTP Ruta

    Unified Manager: puerta de enlace

    ONTAP: almacenamiento

    GET

    API de Gateway: /gateways/{uuid}/{path}

    API de ONTAP: /storage/volumes/{uuid}

    El resultado muestra un tamaño del volumen aumentado a 120 GB.