Skip to main content
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.

Información general sobre la instalación de API de REST

Colaboradores
PDF

StorageGRID proporciona dos API REST para realizar tareas de instalación: La API de instalación de StorageGRID y la API del instalador de dispositivos de StorageGRID.

Ambas API utilizan la plataforma API de código abierto de Swagger para proporcionar la documentación de API. Swagger permite que tanto desarrolladores como no desarrolladores interactúen con la API en una interfaz de usuario que ilustra cómo responde la API a los parámetros y las opciones. En esta documentación se asume que está familiarizado con las tecnologías web estándar y el formato de datos JSON.

Precaución Cualquier operación de API que realice mediante la página web de documentos de API es una operación en directo. Tenga cuidado de no crear, actualizar o eliminar datos de configuración u otros datos por error.

Cada comando de API REST incluye la URL de la API, una acción HTTP, los parámetros de URL necesarios o opcionales y una respuesta de API esperada.

API de instalación de StorageGRID

La API de instalación de StorageGRID solo está disponible cuando está configurando inicialmente el sistema StorageGRID y si necesita realizar una recuperación de nodo de administración principal. Se puede acceder a la API de instalación a través de HTTPS desde Grid Manager.

Para acceder a la documentación de la API, vaya a la página web de instalación en el nodo de administración principal y seleccione Ayuda > Documentación de la API en la barra de menús.

La API de instalación de StorageGRID incluye las siguientes secciones:

  • Config: Operaciones relacionadas con el lanzamiento del producto y versiones de la API. Puede mostrar la versión de la versión del producto y las versiones principales de la API que admite esa versión.

  • Grid: Operaciones de configuración a nivel de red. Puede obtener y actualizar la configuración de la cuadrícula, incluidos los detalles de la cuadrícula, las subredes de la red de cuadrícula, las contraseñas de la cuadrícula y las direcciones IP del servidor NTP y DNS.

  • Nodos: Operaciones de configuración a nivel de nodo. Puede recuperar una lista de nodos de cuadrícula, eliminar un nodo de cuadrícula, configurar un nodo de cuadrícula, ver un nodo de cuadrícula y restablecer la configuración de un nodo de cuadrícula.

  • Provisión: Operaciones de aprovisionamiento. Puede iniciar la operación de aprovisionamiento y ver el estado de la operación de aprovisionamiento.

  • RECOVERY: Operaciones de recuperación de nodo de administración principal. Puede restablecer la información, cargar el paquete de recuperación, iniciar la recuperación y ver el estado de la operación de recuperación.

  • Recovery-package: Operaciones para descargar el paquete de recuperación.

  • SITIOS: Operaciones de configuración a nivel de sitio. Puede crear, ver, eliminar y modificar un sitio.

API del instalador de dispositivos de StorageGRID

Se puede acceder a la API del instalador de dispositivos de StorageGRID a través de HTTPS desde Controller_IP:8443.

Para acceder a la documentación de la API, vaya al instalador del dispositivo StorageGRID en el dispositivo y seleccione Ayuda > Documentación de la API en la barra de menús.

La API del instalador de dispositivos de StorageGRID incluye las siguientes secciones:

  • Clone: Operaciones para configurar y controlar la clonación de nodos.

  • Drive-encryption (StorageGRID 11,8 y posterior): Operaciones para administrar el cifrado de la unidad y ver el estado de cifrado de la unidad.

  • Encriptación: Operaciones para administrar el cifrado de nodos y ver el estado de cifrado de nodos.

  • CONFIG DE HARDWARE: Operaciones para configurar los ajustes del sistema en el hardware conectado.

  • INSTALACIÓN: Operaciones para iniciar la instalación del aparato y para monitorear el estado de la instalación.

  • Networking: Operaciones relacionadas con la configuración de red de red, administración y red de cliente para un dispositivo StorageGRID y la configuración de puerto del dispositivo.

  • Setup: Operaciones para ayudar con la configuración inicial de la instalación del dispositivo, incluidas las solicitudes para obtener información sobre el sistema y actualizar la IP del nodo de administración principal.

  • SOPORTE: Operaciones para reiniciar el controlador y obtener registros.

  • Update-config: Operaciones para actualizar la configuración del dispositivo StorageGRID.

  • UPGRADE: Operaciones relacionadas con la actualización del firmware del dispositivo.

  • Uploadsg: Operaciones para cargar archivos de instalación de StorageGRID.