Administrar objetos de almacenamiento en un centro de datos mediante API
Las API REST bajo el datacenter La categoría le permite administrar los objetos de almacenamiento en su centro de datos, como clústeres, nodos, agregados, máquinas virtuales 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 le permiten realizar operaciones de agregar, eliminar o modificar estos objetos.
La mayoría de estas API son llamadas GET que brindan agregación entre clústeres con soporte de filtrado, clasificación y paginación. Al ejecutar estas API, devuelven datos de la base de datos. Por lo tanto, los objetos recién creados deben ser descubiertos por el siguiente ciclo de adquisición para que aparezcan en la respuesta.
Si desea consultar los detalles de un objeto específico, debe ingresar el ID único de ese objeto para ver sus detalles. Por ejemplo, para obtener información sobre métricas y análisis de los objetos de almacenamiento, consulte"Visualización de 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>"
|
|
Los comandos CURL, ejemplos, solicitudes y respuestas a las API están disponibles en la interfaz API de Swagger. Puede filtrar y ordenar los resultados por parámetros específicos como se indica en Swagger. Estas API le permiten filtrar los resultados para objetos de almacenamiento específicos, como clúster, volumen o VM de almacenamiento. |
API para objetos de almacenamiento en su centro de datos
| verbo HTTP | Camino | Descripción |
|---|---|---|
|
|
Puede utilizar 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, 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 una matriz All SAN. |
|
|
Devuelve los detalles de las licencias instaladas en los clústeres de su centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelve información como la clave de licencia, la clave de clúster, la fecha de vencimiento y el alcance de la licencia. Puede ingresar una clave de licencia para recuperar los detalles de una licencia específica. |
|
|
Puede utilizar este método para ver los detalles de los nodos en el centro de datos. Puede ver información sobre el clúster, el estado del nodo, la capacidad de rendimiento y el par de alta disponibilidad (HA) del nodo. |
|
|
Puede utilizar este método para ver los detalles de los recursos compartidos CIFS en el centro de datos. Además de los detalles del clúster, SVM y volumen, también se devuelve información sobre la lista de control de acceso (ACL). |
|
|
Puede utilizar este método para ver los detalles de las políticas de exportación de los servicios NFS compatibles. Puede 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 la asignación y reutilización de políticas de exportación en cargas de trabajo, consulte “Aprovisionamiento de recursos compartidos de archivos CIFS y NFS”. |
|
|
Puede 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 monitorearlos. Se devuelve información como detalles del clúster y del nodo, capacidad de rendimiento utilizada, espacio disponible y utilizado y eficiencia de almacenamiento. |
|
|
Puede utilizar este método para ver la colección de LUN en todo el centro de datos. Puede ver información sobre el LUN, como detalles del clúster y de SVM, políticas de QoS y igroups. |
|
|
Puede utilizar este método para ver los detalles de todas las políticas de QoS aplicables a los objetos de almacenamiento en el centro de datos. Se devuelve información como los detalles del clúster y de SVM, los detalles de la política fija o adaptativa y la cantidad de objetos aplicables para esa política. |
|
|
Puede utilizar este método para ver los detalles del qtree en todo el centro de datos para todos los volúmenes FlexVol o FlexGroup . Se devuelve información como los detalles del clúster y de SVM, el FlexVol volume y la política de exportación. |
|
|
Puede utilizar este método para ver la colección de volúmenes en el centro de datos. Se devuelve información sobre los volúmenes, como detalles de SVM y del clúster, QoS y políticas de exportación, y si el volumen es de tipo lectura-escritura, protección de datos o uso compartido de carga. Para los volúmenes FlexVol y FlexClone , puede ver la información sobre los agregados respectivos. Para un volumen FlexGroup , la consulta devuelve la lista de agregados constituyentes. |
|
|
Puede asignar grupos de iniciadores (igroups) autorizados para acceder a objetivos LUN específicos. Si existe un igroup, puedes asignarlo. También puede crear igroups y asignarlos a los LUN. Puede utilizar estos métodos para consultar, crear, eliminar y modificar igroups respectivamente. Puntos a tener en cuenta:
|
|
|
Puede utilizar estos métodos para ver, crear, eliminar y modificar máquinas virtuales de almacenamiento (VM de almacenamiento).
|
|
|
Puntos a tener en cuenta: |
Si ha habilitado el aprovisionamiento de carga de trabajo basado en SLO en su entorno, al crear la VM de almacenamiento, asegúrese de que admita todos los protocolos necesarios para aprovisionar LUN y recursos compartidos de archivos en ellas, por ejemplo, CIFS o SMB, NFS, FCP e iSCSI. Los flujos de trabajo de aprovisionamiento pueden fallar si la máquina virtual de almacenamiento no admite los servicios requeridos. Se recomienda que los servicios para los respectivos tipos de cargas de trabajo también estén habilitados en la máquina virtual de almacenamiento.
Si ha habilitado el aprovisionamiento de carga de trabajo basado en SLO en su entorno, no podrá eliminar la máquina virtual de almacenamiento en la que se han aprovisionado cargas de trabajo de almacenamiento. Cuando elimina 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 continúa estando en la configuración de Active Directory y debes eliminarlo manualmente del servidor de Active Directory.
API para elementos de red en su centro de datos
Las siguientes API en la categoría de centro de datos recuperan información sobre los puertos y las interfaces de red en su entorno, específicamente los puertos FC, las interfaces FC, los puertos Ethernet y las interfaces IP.
| verbo HTTP | Camino | Descripción |
|---|---|---|
|
|
Recupera información sobre todos los puertos Ethernet en su entorno de centro de datos. Con una clave de puerto como parámetro de entrada, puede ver la información de ese puerto específico. Se recupera información, como detalles del clúster, dominio de transmisión, detalles del puerto, como estado, velocidad y tipo, y si el puerto está habilitado. |
|
|
Puede utilizar este método para ver los detalles de las interfaces FC en su entorno de centro de datos. Con una clave de interfaz como parámetro de entrada, puede ver la información de esa interfaz específica. Se recupera información, como detalles del clúster, detalles del nodo local y detalles del puerto local. |
|
|
Recupera información sobre todos los puertos FC utilizados en los nodos de su entorno de centro de datos. Con una clave de puerto como parámetro de entrada, puede ver la información de ese puerto específico. Se recupera información como detalles del clúster, descripción del puerto, protocolo compatible y el estado del puerto. |
|
|
Puede utilizar este método para ver los detalles de las interfaces IP en el entorno de su centro de datos. Con una clave de interfaz como parámetro de entrada, puede ver la información de esa interfaz específica. Se recupera información como detalles del clúster, detalles del espacio IP, detalles del nodo local y si la conmutación por error está habilitada. |