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.

Gestiona objetos de almacenamiento en un centro de datos usando las API en Active IQ Unified Manager

Las API de REST de la categoría datacenter te permiten gestionar los objetos de almacenamiento de tu centro de datos, como clústeres, nodos, agregados, VM de almacenamiento, volúmenes, LUN, recursos compartidos de archivos y espacios de nombres. Estas API están disponibles para consultar la configuración de los objetos, mientras que algunas de ellas te permiten realizar operaciones de añadir, eliminar o modificar estos objetos.

La mayoría de estas API son llamadas GET que permiten la agregación entre clústeres y admiten filtrado, ordenación y paginación. Al ejecutar estas API, devuelven datos de la base de datos. Por lo tanto, para que los objetos recién creados aparezcan en la respuesta, es necesario que se detecten en el siguiente ciclo de adquisición.

Si quieres consultar los detalles de un objeto concreto, debes introducir el ID único de ese objeto para ver sus detalles. Por ejemplo, para consultar la información sobre métricas y análisis de los objetos de almacenamiento, consulta "Ver las métricas de rendimiento".

curl -X GET "https://<hostname>/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
Nota

Los comandos CURL, los ejemplos, las solicitudes y las respuestas a las API están disponibles en tu interfaz de API de Swagger. Puedes filtrar y ordenar los resultados según parámetros específicos, tal como se indica en Swagger. Estas API te permiten filtrar los resultados para objetos de almacenamiento específicos, como clúster, volumen o máquina virtual de almacenamiento.

API para objetos de almacenamiento en tu centro de datos

Verbo HTTP Ruta Descripción

GET

/datacenter/cluster/clusters

/datacenter/cluster/clusters/{key}

Puedes usar este método para ver los detalles de los clústeres ONTAP en todo el centro de datos. La API devuelve información, como la dirección IPv4 o IPv6 del clúster e información sobre el nodo, como el estado del nodo, la capacidad de rendimiento y el par de alta disponibilidad (HA), e indica si el clúster es All SAN Array.

GET

/datacenter/cluster/licensing/licenses /datacenter/cluster/licensing/licenses/{key}

Muestra los detalles de las licencias instaladas en los clústeres de tu centro de datos. Puedes filtrar los resultados según los criterios que quieras. Devuelve información como la clave de licencia, la clave de clúster, la fecha de caducidad y el ámbito de la licencia. Puedes introducir una clave de licencia para consultar los detalles de una licencia concreta.

GET

/datacenter/cluster/nodes

/datacenter/cluster/nodes/{key}

Puedes usar este método para consultar los detalles de los nodos del centro de datos. Puedes consultar información sobre el clúster, el estado de los nodos, la capacidad de rendimiento y el par de alta disponibilidad (HA) del nodo.

GET

/datacenter/protocols/cifs/shares

/datacenter/protocols/cifs/shares/{key}

Puedes utilizar este método para consultar los detalles de los recursos compartidos CIFS del centro de datos. Además de los detalles del clúster, la SVM y el volumen, también se devuelve información sobre la lista de control de acceso (ACL).

GET

/datacenter/protocols/nfs/export-policies

/datacenter/protocols/nfs/export-policies/{key}

Puedes utilizar este método para consultar los detalles de las políticas de exportación de los servicios de NFS compatibles.

Puedes consultar las políticas de exportación de un clúster o una máquina virtual de almacenamiento y reutilizar la clave de la política de exportación para aprovisionar recursos compartidos de archivos NFS. Para obtener más información sobre cómo asignar y reutilizar políticas de exportación en cargas de trabajo, consulta “Aprovisionamiento de recursos compartidos de archivos CIFS y NFS”.

GET

/datacenter/storage/aggregates

/datacenter/storage/aggregates/{key}

Puedes utilizar este método para ver la colección de agregados en el centro de datos o un agregado específico para aprovisionar cargas de trabajo en ellos o supervisarlos. Devuelve información, como detalles del clúster y del nodo, la capacidad de rendimiento utilizada, el espacio disponible y usado, y la eficiencia del almacenamiento.

GET

/datacenter/storage/luns

/datacenter/storage/luns/{key}

Puedes usar este método para ver la colección de LUN de todo el centro de datos. Puedes ver información sobre el LUN, como los detalles del clúster y de la SVM, las políticas de QoS y los igroups.

GET

/datacenter/storage/qos/policies

/datacenter/storage/qos/policies/{key}

Puedes utilizar este método para consultar los detalles de todas las políticas de calidad de servicio (QoS) aplicables a los objetos de almacenamiento del centro de datos. Se devuelve información como los detalles del clúster y de la SVM, los detalles de las políticas fijas o adaptativas y el número de objetos a los que se aplica esa política.

GET

/datacenter/storage/qtrees

/datacenter/storage/qtrees/{key}

Puedes usar este método para ver los detalles del qtree en todo el centro de datos para todos los volúmenes FlexVol o los volúmenes FlexGroup. Se devuelve información, como los detalles del clúster y de la SVM, el volumen FlexVol y la política de exportación.

GET

/datacenter/storage/volumes

/datacenter/storage/volumes/{key}

Puedes utilizar este método para ver la colección de volúmenes del centro de datos. Devuelve información sobre los volúmenes, como los detalles de SVM y del clúster, las políticas de QoS y de exportación, y si el volumen es de tipo lectura y escritura, protección de datos o uso compartido de carga.

Para los volúmenes FlexVol y FlexClone, puedes ver la información sobre los agregados correspondientes. Para un volumen FlexGroup, la consulta devuelve la lista de agregados que lo componen.

GET

POST

DELETE

PATCH

/datacenter/protocols/san/igroups

/datacenter/protocols/san/igroups/{key}

Puedes asignar grupos de iniciadores (igroups) autorizados para acceder a determinados destinos de LUN. Si ya existe un igroup, puedes asignarlo. También puedes crear igroups y asignarlos a las LUN.

Puedes usar estos métodos para consultar, crear, eliminar y modificar igroups, respectivamente.

Aspectos a tener en cuenta:

  • POST: Al crear un igroup, puedes designar la máquina virtual de almacenamiento a la que deseas asignar acceso.

  • DELETE: Para eliminar un igroup concreto, debes proporcionar la clave del igroup como parámetro de entrada. Si ya has asignado un igroup a un LUN, no podrás eliminar ese igroup.

  • PATCH: Para modificar un igroup concreto, debes indicar la clave del igroup como parámetro de entrada. También debes introducir la propiedad que deseas actualizar, junto con su valor.

GET

POST

DELETE

PATCH

/datacenter/svm/svms

/datacenter/svm/svms/{key}

Puedes utilizar estos métodos para ver, crear, eliminar y modificar máquinas virtuales de almacenamiento (VM de almacenamiento).

  • POST: Debes introducir el objeto de máquina virtual de almacenamiento que deseas crear como parámetro de entrada. Puedes crear una máquina virtual de almacenamiento personalizada y, a continuación, asignarle las propiedades necesarias.

  • DELETE: Debes proporcionar la clave de la VM de almacenamiento para eliminar una VM de almacenamiento concreta.

  • PATCH: Para modificar una máquina virtual de almacenamiento concreta, debes proporcionar la clave de dicha máquina virtual. Además, debes introducir las propiedades que deseas actualizar, junto con sus valores.

Nota Aspectos a tener en cuenta:

Si has habilitado el aprovisionamiento de carga de trabajo basado en SLO en tu entorno, al crear la VM de almacenamiento, asegúrate de que admita todos los protocolos necesarios para aprovisionar LUN y recursos compartidos de archivos en ella; por ejemplo, CIFS o SMB, NFS, FCP e iSCSI. Los flujos de trabajo de aprovisionamiento de almacenamiento podrían fallar si la VM de almacenamiento no admite los servicios necesarios. Se recomienda que también habilites en la VM de almacenamiento los servicios correspondientes a los respectivos tipos de cargas de trabajo.

Si has habilitado el aprovisionamiento de cargas de trabajo basado en SLO en tu entorno, no puedes eliminar la máquina virtual de almacenamiento en la que se han aprovisionado cargas de trabajo de almacenamiento. Al eliminar una máquina virtual de almacenamiento en la que se ha configurado un servidor CIFS o SMB, esta API también elimina el servidor CIFS o SMB, junto con la configuración local de Active Directory. Sin embargo, el nombre del servidor CIFS o SMB sigue figurando en la configuración de Active Directory, por lo que debes eliminarlo manualmente del servidor de Active Directory.

API para los elementos de red de tu centro de datos

Las siguientes API de la categoría «centro de datos» obtienen información sobre los puertos y las interfaces de red de tu entorno, concretamente los puertos FC, las interfaces FC, los puertos Ethernet y las interfaces IP.

Verbo HTTP Ruta Descripción

GET

/datacenter/network/ethernet/ports

/datacenter/network/ethernet/ports/{key}

Recupera información sobre todos los puertos Ethernet de tu entorno de centro de datos. Con una clave de puerto como parámetro de entrada, puedes ver la información de ese puerto específico. Recupera información como los detalles del clúster, el dominio de difusión, los detalles del puerto, como el estado, la velocidad y el tipo, y si el puerto está habilitado.

GET

/datacenter/network/fc/interfaces

/datacenter/network/fc/interfaces/{key}

Puedes usar este método para ver los detalles de las interfaces FC en el entorno de tu centro de datos. Con una clave de interfaz como parámetro de entrada, puedes ver la información de esa interfaz específica. Se recupera información, como los detalles del clúster, los detalles del nodo de inicio y los detalles del puerto de inicio.

GET

/datacenter/network/fc/ports

/datacenter/network/fc/ports/{key}

Recupera información sobre todos los puertos FC usados en los nodos de tu entorno de centro de datos. Con una clave de puerto como parámetro de entrada, puedes ver la información de ese puerto específico. Recupera información como los detalles del clúster, la descripción del puerto, el protocolo admitido y el estado del puerto.

GET

/datacenter/network/ip/interfaces

/datacenter/network/ip/interfaces/{key}

Puedes usar este método para ver los detalles de las interfaces IP en el entorno de tu centro de datos. Con una clave de interfaz como parámetro de entrada, puedes ver la información de esa interfaz específica. Se obtiene información como los detalles del clúster, los detalles de IPspace, los detalles del nodo principal y si la conmutación por error está habilitada.