> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/es/automation-api/api-tables-description.md). # Descripción de las tablas de la API La siguiente es una breve descripción de cada una de las tablas de la API. Para obtener más detalles, añada **/#swagger** al final de la URL de VergeUI (o navegue a **Sistema->Documentación de la API**). Swagger proporciona información detallada sobre cada tabla y le permite probar cada método con una acción Get/Post/Put/Delete. Para obtener más instrucciones sobre cómo integrarse con la API, consulte la página de [Documentación de la API](/knowledge-base/es/automation-api/verge-api-guide.md) . ## Tablas de la API ### auth\_source\_states Proporciona una lista de estados de origen de autenticación. ### auth\_sources Tabla de orígenes de autorización para gestionar orígenes de autorización como OpenID o AzureAD. ### billing Se utiliza para obtener información de facturación del entorno actual. Esto se almacena como datos de facturación con una fecha de inicio y fin. ### billing\_actions Se utiliza para enviar acciones de facturación. La acción principal es "generate", que crea una nueva factura. * **Campos:** * **action** : Consulte la lista de acciones a continuación. * **Acciones:** * **generate** : Generar factura * **Ejemplo:** ```plaintext URL: '/v4/billing_actions' POST(JSON): {"action": "generate"} ``` ### catalog\_logs Registros específicos de los catálogos. ### catalog\_repositories Repositorios de catálogos y sublistas para catálogos, registros, permisos, etc. ### catalog\_repository\_actions Se utiliza para enviar acciones de repositorio de catálogo. * **Campos:** * **repository** : ID de fila del repositorio que desea actualizar. * **action** : La acción predeterminada es refresh. Consulte la lista de acciones a continuación. * **Acciones:** * **refresh** : Actualizar el repositorio de catálogo. * **Ejemplo:** ```plaintext URL: '/v4/catalog_repository_actions' POST(JSON): {"repository": 1, "action": "refresh"} ``` ### catalog\_repository\_logs Ver y publicar registros del repositorio de catálogo. ### catalog\_repository\_status Se utiliza para almacenar y actualizar los estados del repositorio de catálogo. Estos determinan el estado y la situación de un repositorio de catálogo. ### catalogs Tabla de catálogos que le permite actualizar/publicar/eliminar catálogos. ### certificates Certificados SSL para su sitio. ### clone\_iso Almacena información y estado del programa Verge.io Clone ISO. ### clone\_iso\_actions Acciones para la función Clone ISO. * **Campos:** * **action** : El valor predeterminado es "update". Consulte la lista de acciones a continuación. * **Acciones:** * **update** : Actualizar la imagen ISO. * **delete** : Eliminar la imagen ISO. * **cancel** : Cancelar la compilación actual. * **Ejemplo:** ```plaintext URL: '/v4/clone_iso_actions' POST(JSON): {"action": "update"} ``` ### cloud\_restore Almacena información cuando se realiza una restauración en la nube. ### cloud\_snapshot\_actions Acciones para la función Instantánea del sistema. ### cloud\_snapshot\_tenant\_actions Acciones para la función Instantánea del sistema para un inquilino. ### cloud\_snapshot\_tenants Instantáneas del sistema para un inquilino. ### cloud\_snapshot\_vm\_actions Acciones para una VM e instantáneas del sistema. ### cloud\_snapshot\_vms Se utiliza para almacenar información cuando se descarga una instantánea del sistema a una VM. ### cloud\_snapshots La tabla de instantáneas del sistema incluye información sobre la instantánea del sistema, así como una lista de VMs, inquilinos y colas de sincronización. Esto puede utilizarse para ver qué VMs están incluidas en una instantánea del sistema. ### cloudinit\_files Operaciones para la función de archivos Cloudinit. ### cluster\_actions Cluster Actions se utiliza para enviar acciones para clústeres. * **Campos:** * **cluster** : ID de fila del clúster (obligatorio). * **action** : Consulte la lista de acciones a continuación. * **params** : Parámetros proporcionados en forma JSON (opcional). * **Acciones:** * **shutdown** : Apagar el clúster. * **cancel\_shutdown** : Cancelar la solicitud de apagado actual. * **Ejemplo:** ```plaintext URL: '/v4/cluster_actions' POST(JSON): {"cluster": 1, "action": "shutdown", "params": "{}"} ``` ### cluster\_stats\_history\_long La tabla cluster\_stats\_history\_long contiene el historial de estadísticas del clúster durante períodos prolongados. ### cluster\_stats\_history\_short La tabla cluster\_stats\_history\_short contiene estadísticas del clúster durante un período corto, almacenando las estadísticas más recientes para un acceso rápido. ### cluster\_status Gestiona el estado de todos los clústeres. ### cluster\_tier\_stats Gestiona las estadísticas de los niveles vSAN de un clúster. ### cluster\_tier\_stats\_history\_long Contiene estadísticas históricas de los niveles de clúster durante períodos prolongados. ### cluster\_tier\_stats\_history\_short Contiene estadísticas históricas de los niveles de clúster durante períodos cortos, almacenando las estadísticas más recientes para un acceso rápido. ### cluster\_tier\_status Se utiliza para los estados de los niveles de clúster. ### cluster\_tiers Contiene una lista de niveles para el clúster. ### clusters La tabla principal para los datos de los clústeres. ### file\_actions La tabla file\_actions envía acciones sobre archivos. * **Campos:** * **file** : ID de archivo de la tabla files (obligatorio). * **action** : Consulte la lista de acciones a continuación. * **params** : Parámetros proporcionados en forma JSON (opcional). * **Acciones:** * **overwrite** : Sobrescribir el archivo. * **add\_link** : Añadir un enlace al archivo. * **delete\_link** : Eliminar un enlace al archivo. * **delete\_reference** : Eliminar referencias de archivo. * **Ejemplo:** ```plaintext URL: '/v4/file_actions' POST(JSON): {"file": 1, "action": "add_link", "params": "{}"} ``` ### files Información relacionada con los archivos almacenados. ### files\_public\_links Gestiona enlaces públicos para archivos. ### group\_logs Registros relacionados con grupos. ### groups Tabla de gestión de grupos. ### help\_actions Gestiona acciones relacionadas con la ayuda. ### help\_search Tabla de búsqueda para la documentación de ayuda. ### licenses Gestiona las licencias de VergeOS. ### logs Gestiona los registros del sistema. ### machine\_console Gestiona las interacciones de la consola de la máquina. ### machine\_console\_active Rastrea sesiones activas de la consola de la máquina. ### machine\_console\_active\_chat Rastrea interacciones de chat en consolas de máquina activas. ### machine\_device\_gpu\_stats\_history\_long Contiene estadísticas históricas de GPU durante períodos prolongados. ### machine\_device\_gpu\_stats\_history\_short Contiene estadísticas históricas de GPU durante períodos cortos. ### machine\_device\_settings\_nvidia\_vgpu Gestiona la configuración de dispositivos Nvidia vGPU. ### machine\_device\_settings\_tpm Gestiona la configuración de dispositivos TPM. ### machine\_device\_stats Rastrea estadísticas de dispositivos. ### machine\_device\_status Rastrea el estado de los dispositivos. ### machine\_devices Tabla para información de dispositivos de máquina. ### machine\_drive\_phys Datos de unidades físicas para máquinas. ### machine\_drive\_stats Estadísticas de unidades para máquinas. ### machine\_drive\_stats\_history\_long Contiene estadísticas históricas de unidades durante períodos prolongados. ### machine\_drive\_stats\_history\_short Contiene estadísticas históricas de unidades durante períodos cortos. ### machine\_drive\_status Rastrea el estado de las unidades para máquinas. ### machine\_drives Tabla para unidades de máquina. ### machine\_logs Rastrea los registros de la máquina. ### machine\_nic\_stats Estadísticas de NIC para máquinas. ### machine\_nic\_stats\_history\_long Estadísticas históricas de NIC durante períodos largos. ### machine\_nic\_stats\_history\_short Estadísticas históricas de NIC durante períodos cortos. ### machine\_nic\_status Estado de NIC para máquinas. ### machine\_nics Tabla para NICs en máquinas. ### machine\_snapshots Rastrea instantáneas para máquinas. ### machine\_stats Estadísticas generales para máquinas. ### machine\_stats\_history\_long Estadísticas históricas para máquinas durante períodos prolongados. ### machine\_stats\_history\_short Estadísticas históricas para máquinas durante períodos cortos. ### machine\_status Rastrea el estado de las máquinas. ### machines Tabla principal para los datos de la máquina. *** {% hint style="info" %} **Información del documento** * Última actualización: 2024-08-29 * Versión de vergeOS: 4.12.6 {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/knowledge-base/es/automation-api/api-tables-description.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.