Solucionar problemas de volúmenes ONTAP mediante API de puerta de enlace
Sugerir cambios
PDF
Las API de puerta de enlace actúan como una puerta de enlace para invocar las API de ONTAP para consultar información sobre sus objetos de almacenamiento de ONTAP y tomar medidas correctivas para abordar los problemas informados.
Este flujo de trabajo retoma un caso de uso de muestra en el que se genera un evento cuando un volumen ONTAP casi alcanza su capacidad. El flujo de trabajo también demuestra cómo abordar este problema invocando una combinación de Active IQ Unified Manager y las API REST de ONTAP .
|
Antes de ejecutar los pasos del flujo de trabajo, asegúrese de lo siguiente:
|
El siguiente diagrama ilustra cada paso del flujo de trabajo para solucionar el problema del uso de la capacidad del volumen de ONTAP .
El flujo de trabajo cubre los puntos de invocación de las API REST de Unified Manager y ONTAP .
-
Anote el nombre del volumen del evento que notifica la utilización de la capacidad del volumen.
-
Al utilizar el nombre del volumen como valor en el parámetro de nombre, consulte el volumen ejecutando la siguiente API de Unified Manager.
Categoría verbo HTTP Camino centro de datos
CONSEGUIR
/datacenter/storage/volumes -
Recupere el UUID del clúster y el UUID del volumen de la salida.
-
En la interfaz de usuario web de Unified Manager, navegue a General > Configuración de funciones > API Gateway para verificar si la función API Gateway está habilitada. A menos que esté habilitado, las API bajo la categoría de puerta de enlace no estarán disponibles para su invocación. Habilite la función si está deshabilitada.
-
Utilice el UUID del clúster para ejecutar la API de ONTAP/
storage/volumes/{uuid}a través de la puerta de enlace API. La consulta devuelve los detalles del volumen cuando el UUID del volumen se pasa como parámetro API.Para ejecutar las API de ONTAP a través de la puerta de enlace API, las credenciales de Unified Manager se pasan internamente para la autenticación y no es necesario ejecutar un paso de autenticación adicional para el acceso a cada clúster.
Categoría verbo HTTP Camino Administrador unificado: puerta de enlace
ONTAP: almacenamiento
CONSEGUIR
API de puerta de enlace:
/gateways/{uuid}/{path}API de ONTAP :
/storage/volumes/{uuid}
En /gateways/{uuid}/{path}, el valor de {uuid} debe reemplazarse con el UUID del clúster en el que se realizará la operación REST. {path} debe reemplazarse por la URL 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>"
-
A partir del resultado, determine el tamaño, el uso y las medidas correctivas a tomar. En este flujo de trabajo, la medida correctiva adoptada es cambiar el tamaño del volumen.
-
Utilice el UUID del clúster y ejecute la siguiente API de ONTAP a través de la puerta de enlace de API para cambiar el tamaño del volumen. Para obtener información sobre los parámetros de entrada para la puerta de enlace y las API de ONTAP , consulte el paso 5.
Categoría verbo HTTP Camino Administrador unificado: puerta de enlace
ONTAP: almacenamiento
PARCHE
API de puerta de enlace:
/gateways/{uuid}/{path}API de ONTAP :
/storage/volumes/{uuid}
Junto con el UUID del clúster y el UUID del volumen, debe ingresar un valor para el parámetro de tamaño para cambiar el tamaño del volumen. Asegúrese de introducir el valor en bytes. Por ejemplo, si desea aumentar el tamaño de un volumen de 100 GB a 120 GB, ingrese el valor del parámetro tamaño 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.
-
Verifique si el trabajo se ejecutó correctamente utilizando el UUID del trabajo. Utilice el UUID del clúster y el UUID del trabajo para ejecutar la siguiente API de ONTAP a través de la puerta de enlace de API. Para obtener información sobre los parámetros de entrada para la puerta de enlace y las API de ONTAP , consulte el paso 5.
Categoría verbo HTTP Camino Administrador unificado: puerta de enlace
ONTAP: clúster
CONSEGUIR
API de puerta de enlace:
/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 REST de ONTAP .
-
Ejecute la siguiente API de ONTAP para consultar los detalles del volumen redimensionado. Para obtener información sobre los parámetros de entrada para la puerta de enlace y las API de ONTAP , consulte el paso 5.
Categoría verbo HTTP Camino Administrador unificado: puerta de enlace
ONTAP: almacenamiento
CONSEGUIR
API de puerta de enlace:
/gateways/{uuid}/{path}API de ONTAP :
/storage/volumes/{uuid}La salida muestra un tamaño de volumen aumentado de 120 GB.