> 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/run-the-platform/es/administracion-del-sistema/tags.md).

# Etiquetas

## Descripción general

El sistema de etiquetado de VergeOS es un motor de etiquetado flexible que permite a los administradores categorizar objetos del sistema utilizando etiquetas personalizadas. Estas etiquetas, organizadas en categorías definidas por el usuario, permiten una indexación, identificación y selección eficientes de los activos durante las actividades de administración.

Las organizaciones pueden adaptar el etiquetado para satisfacer sus necesidades operativas específicas. Las categorías de etiquetas y las etiquetas individuales pueden variar ampliamente entre entornos.

### Casos de uso de ejemplo

* Etiquetar máquinas virtuales (VM) por sistema operativo instalado
* Etiquetar VMs por aplicaciones instaladas
* Etiquetar VMs por entorno (por ejemplo, producción frente a pruebas)
* Etiquetar inquilinos por nivel de soporte
* Etiquetar inquilinos por zona horaria

***

## Categorías

A **categoría** define una clase o tipo de etiqueta. Los administradores configuran categorías para especificar:

* A qué tipos de objetos se pueden asignar las etiquetas
* Si la categoría admite selecciones de una o varias etiquetas por objeto

### Categorías de ejemplo

| Categoría         | Asignable a                    | Tipo de selección | Etiquetas de ejemplo                 |
| ----------------- | ------------------------------ | ----------------- | ------------------------------------ |
| Sistema operativo | Máquinas virtuales             | Individual        | `Windows 11`, `Debian`               |
| Aplicación        | Máquinas virtuales             | Múltiple          | `SQL Server`, `Apache`, `Salesforce` |
| Zona horaria      | Inquilinos, nodos de inquilino | Individual        | `UTC-5`, `UTC+1`, `Asia/Tokio`       |

Los administradores pueden crear cualquier cantidad de categorías para adaptarse a su estructura organizativa y a sus flujos de trabajo.

***

## Crear una nueva categoría de etiquetas

1. Navegue a **Sistema** > **Etiquetas**.
2. Haga clic en **Nuevo** en el menú de la izquierda.
3. Introduzca un **Nombre** para la categoría.
4. Opcionalmente, agregue una **Descripción**.
5. Configurar **Selección de una sola etiqueta**: Si está habilitada, solo se puede asignar a un objeto una etiqueta de esta categoría. Por ejemplo, es posible que desee que una VM tenga solo una etiqueta "Sistema operativo".
6. Interruptor **Tipos admitidos** para habilitar el etiquetado de tipos de objetos específicos.

{% hint style="success" %}
**Todos los tipos están deshabilitados de forma predeterminada. Haga clic para alternar entre deshabilitado/habilitado (habilitado = botón hacia la derecha).**
{% endhint %}

7. Haga clic en **Enviar** para guardar la categoría.

## Crear una nueva etiqueta

{% hint style="success" %}
**Las etiquetas deben pertenecer a una categoría existente.**
{% endhint %}

1. Navegue a **Sistema** > **Etiquetas**.
2. **Haga doble clic en la categoría deseada** de la lista.
3. Haga clic en **Nuevo** en el menú de la izquierda.
4. Introduzca un **Nombre** para la etiqueta.
5. Opcionalmente, agregue una **Descripción**.
6. Haga clic en **Enviar** para guardar la etiqueta.

## Asignación de etiquetas a objetos

Las etiquetas se pueden asignar desde vistas de lista, paneles de objetos o el menú del sistema.

Para asignar etiquetas desde una vista de lista:

1. Vaya al listado de objetos (por ejemplo, *Máquinas virtuales* > *Lista*, *NAS* > *Volúmenes*, etc.)
2. **Seleccione** el deseado **objeto(s)**.
3. Haga clic en **Asignar etiquetas** en el menú de la izquierda.
4. **Seleccione las etiquetas deseadas** de la lista disponible.

{% hint style="success" %}
**Use la&#x20;*****Buscar*****&#x20;opción para localizar rápidamente etiquetas en conjuntos grandes.**
{% endhint %}

5. Haga clic en **Asignar**.

## Ver, agregar o eliminar etiquetas de un objeto

Para administrar etiquetas desde el panel de un objeto:

1. Vaya al panel del objeto (por ejemplo, para seleccionar una VM específica: *Máquinas virtuales* > *Lista*, luego haga doble clic en la VM).
2. Desplácese hasta **Etiquetas** sección.

### Acciones:

* **Eliminar una etiqueta:** Haga clic en el **“x”** a la derecha, junto a la etiqueta.
* **Agregar una etiqueta:** Haga clic en el **“+ Assign Tags”** botón.

***

## Mejores prácticas

* Use **nombres descriptivos** tanto para las categorías como para las etiquetas, para garantizar claridad y coherencia.
* Alinee las estructuras de etiquetas con los flujos de trabajo operativos y las necesidades de informes.
* Revise periódicamente el uso de etiquetas para mantener su relevancia y evitar el desorden.


---

# 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/run-the-platform/es/administracion-del-sistema/tags.md?ask=<question>&goal=<endgoal>
```

`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.
