Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# SupportInfo Estructura XML
<a name="dnf-supportinfo-xml-structure"></a>

En esta página se documenta el esquema XML de la versión 1.0 que se utiliza para definir los ciclos de vida, los plazos y las clasificaciones de soporte de los paquetes en las distribuciones de Linux. El esquema es independiente del DNF y no es específico de ninguna distribución individual. Puedes consumirlo directamente desde cualquier herramienta. El `dnf supportinfo` plugin es uno de esos consumidores.
+ **Definición del esquema (XSD): ** `https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd`
+ **Datos de soporte (XML): ** `https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml`

Para analizar este XML directamente, utilice la [amazon-linux-supportinfo](https://github.com/amazonlinux/amazon-linux-supportinfo) biblioteca de código abierto, que implementa el esquema descrito en esta página, en lugar de escribir un analizador personalizado.

**Topics**
+ [Cómo usa el complemento este archivo](#dnf-supportinfo-xml-how-plugin-uses)
+ [Ejemplo mínimo completo](#dnf-supportinfo-xml-minimal-example)
+ [Referencia del elemento](#dnf-supportinfo-xml-element-reference)
+ [Integridad referencial](#dnf-supportinfo-xml-referential-integrity)

## Cómo usa el complemento este archivo
<a name="dnf-supportinfo-xml-how-plugin-uses"></a>

Desde este archivo, el complemento informa:
+ En qué nivel de soporte se encuentra un paquete (estos valores completan las opciones de `--show` filtro)
+ Cuando cambian las fases del ciclo de vida (se muestran en el `--pkg` resultado y en el cronograma)
+ Cobertura de prioridad y gravedad de los parches para cada nivel de soporte
+ De dónde proviene el paquete (origen y clasificación)

## Ejemplo mínimo completo
<a name="dnf-supportinfo-xml-minimal-example"></a>

Este ejemplo muestra la estructura mínima con todas las secciones necesarias y un paquete:

```
<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">
  <lifecycles>
    <lifecycle name="default_lc"
               display_name="AL2023 Standard Lifecycle"
               description="Standard support lifecycle for Amazon Linux 2023 packages">
      <phase name="full_support"
             support_level="default"
             start_milestone="AL2023_GA"
             display_name="Full Support"/>
      <phase name="end_of_support"
             support_level="eos"
             start_milestone="AL2023_EOS"
             display_name="End of Support"/>
    </lifecycle>
  </lifecycles>

  <support_milestones>
    <milestone name="AL2023_GA" date="2023-03-15"
               display_name="AL2023 General Availability"
               description="Amazon Linux 2023 general availability date"/>
    <milestone name="AL2023_EOS" date="2029-06-30"
               display_name="AL2023 End of Support"
               description="End of all support for Amazon Linux 2023"/>
  </support_milestones>

  <support_levels>
    <support_level name="default"
                   severities="Low,Medium,Important,Critical"
                   description="Full security and bug fix support for all severities"
                   display_name="Default Support" />
    <support_level name="eos"
                   severities=""
                   description="End of support - no further updates"
                   display_name="End of Support" />
  </support_levels>

  <packages>
    <package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
  </packages>

  <package_classes>
    <package_class name="default">
      <summary>Default class for Amazon Linux packages</summary>
      <text></text>
    </package_class>
  </package_classes>

  <package_origins>
    <package_origin name="al2023_core"
                    repo_id="amazonlinux"
                    dist="amzn2023"
                    vendor="amazonlinux"
                    display_name="Amazon Linux 2023 Core"
                    description="Core Amazon Linux 2023 repository" />
  </package_origins>

  <notes>
    <note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>
  </notes>
</package_support>
```

## Referencia del elemento
<a name="dnf-supportinfo-xml-element-reference"></a>

### `package_support` (elemento raíz)
<a name="dnf-supportinfo-xml-package-support"></a>

El elemento raíz que contiene todos los metadatos de soporte.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| schema\_version | Sí | Versión en formato de esquema (actualmente1.0) | 
| current\_as | Sí | Marca de tiempo ISO de la última vez que se generaron los datos de soporte | 

```
<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">
```

La `current_as` marca de tiempo aparece en la salida para indicar la actualidad de los datos.

### `ciclo de vida`
<a name="dnf-supportinfo-xml-lifecycle"></a>

Define una secuencia de fases por las que pasa un paquete a lo largo del tiempo.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador único al que hace referencia package@lifecycle | 
| note | No | Hace referencia a a note@name para obtener un contexto adicional | 
| display\_name | No | Customer-facing etiqueta | 
| description | No | Human-readable descripción | 

```
<lifecycle name="redis6_lc" note="eol_redis6"
           display_name="Redis 6 Lifecycle"
           description="Support lifecycle for Redis 6 packages">
  <phase .../>
</lifecycle>
```

El complemento recorre las fases en orden, encuentra la fase actualmente activa e informa del nivel de soporte de esa fase en los resultados.

### `fase`
<a name="dnf-supportinfo-xml-phase"></a>

Define una etapa dentro de un ciclo de vida. Cada fase continúa hasta que comience la siguiente fase (o indefinidamente si es la última fase).


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador de fase (único en su ciclo de vida) | 
| support\_level | Sí | Hace referencia a support\_level@name | 
| start\_date | Condicional | Fecha ISO fija (YYYY-MM-DD). Usa esto  o  start\_milestone | 
| start\_milestone | Condicional | Referencias amilestone@name. Usa esto  o  start\_date | 
| display\_name | No | Customer-facing etiqueta | 

**nota**  
Especifique exactamente uno de `start_date` o`start_milestone`, no ambos.

```
<phase name="limited_support"
       support_level="limited"
       start_milestone="AL2023_6months"
       display_name="Limited Support"/>
```

Cada fase está activa desde su fecha de inicio hasta que comience la siguiente fase. La última fase de un ciclo de vida permanece activa indefinidamente.

### `hito`
<a name="dnf-supportinfo-xml-milestone"></a>

Define un marcador de fecha reutilizable al que hacen referencia las fases del ciclo de vida.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador único al que hace referencia phase@start\_milestone | 
| date | Sí | Fecha ISO (YYYY-MM-DD) | 
| display\_name | No | Customer-facing etiqueta | 
| description | No | Human-readable descripción | 

```
<milestone name="AL2023_GA" date="2023-03-15"
           display_name="AL2023 General Availability"
           description="Amazon Linux 2023 general availability date"/>
```

Los hitos permiten que las fases compartan fechas. Cuando la fecha de un hito cambia, cada fase que hace referencia a ella se actualiza automáticamente.

### `support_level`
<a name="dnf-supportinfo-xml-support-level"></a>

Define un nivel de soporte y los niveles de severidad que cubre. Cada uno `name` se convierte en un valor `--show` de filtro válido.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador único. Se utiliza como valor --show de filtro | 
| severities | Sí | Comma-separated niveles de gravedad cubiertos (cadena vacía = sin parches) | 
| description | Sí | Human-readable la descripción se muestra en la --list-filters salida | 
| display\_name | No | Customer-facing etiqueta | 

```
<support_level name="limited"
               severities="Important,Critical"
               description="Security fixes for Important and Critical severities only"
               display_name="Limited Support" />
```

En ejecución se `dnf supportinfo --show limited` enumeran todos los paquetes que se encuentran actualmente en este nivel de soporte. El `--list-filters` comando muestra las `name` y de cada nivel`description`.

### `paquete`
<a name="dnf-supportinfo-xml-package"></a>

Asigna el nombre de un paquete RPM a su ciclo de vida, origen y clase.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Nombre del paquete RPM | 
| lifecycle | Sí | Hace referencia a lifecycle@name | 
| origin | Sí | Referencias a package\_origin@name | 
| package\_class | No | Referencias a package\_class@name | 

```
<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
```

**nota**  
Un paquete puede aparecer varias veces con `origin` valores diferentes (por ejemplo, el mismo paquete en los repositorios principales y SPAL). La combinación de `name` \+ `origin` debe ser única.

Cada RPM instalado se compara con esta lista para determinar su ciclo de vida y su estado actual de soporte.

### `package_class`
<a name="dnf-supportinfo-xml-package-class"></a>

Clasifica los paquetes según su función en el sistema. El nombre y el resumen de la clase aparecen en la salida del plugin.


| Attribute/Element | Obligatorio | Descripción | 
| --- | --- | --- | 
| @name | Sí | Identificador único al que hace referencia package@package\_class | 
| summary(niño) | Sí | Breve descripción de la categoría | 
| text(niño) | Sí | Descripción ampliada. El elemento debe estar presente, pero puede estar vacío | 

```
<package_class name="os_dependency">
  <summary>Packages supported only as dependencies of the operating system</summary>
  <text></text>
</package_class>
```

El nombre de la clase aparece en la salida para indicar la función de un paquete en el sistema.

### `package_origin`
<a name="dnf-supportinfo-xml-package-origin"></a>

Identifica la fuente del repositorio de un paquete. El `origin` valor aparece en la `dnf supportinfo --pkg` salida.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador único al que hace referencia package@origin | 
| repo\_id | Sí | ID del repositorio DNF | 
| dist | Sí | Identificador de distribución | 
| vendor | Sí | Vendedor de paquetes | 
| signing\_key | No | Identificador de clave de firma GPG | 
| display\_name | No | Customer-facing etiqueta | 
| description | No | Human-readable descripción | 

```
<package_origin name="al2023_core"
                repo_id="amazonlinux"
                dist="amzn2023"
                vendor="amazonlinux"
                display_name="Amazon Linux 2023 Core"
                description="Core Amazon Linux 2023 repository" />
```

`display_name`Aparece como el campo «Origen» en la `--pkg` salida.

### `note`
<a name="dnf-supportinfo-xml-note"></a>

Proporciona texto de formato libre al que puede hacer referencia un ciclo de vida para obtener un contexto adicional.


| Atributo | Obligatorio | Descripción | 
| --- | --- | --- | 
| name | Sí | Identificador único al que hace referencia lifecycle@note | 

El contenido de texto del elemento contiene el mensaje de la nota.

```
<note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>
```

Cuando el ciclo de vida de un paquete hace referencia a una nota, el texto de la nota aparece como «Nota del paquete» en la `--pkg` salida.

## Integridad referencial
<a name="dnf-supportinfo-xml-referential-integrity"></a>

El esquema vincula los elementos mediante `name` referencias. Cada atributo de origen debe coincidir con el `name` de un elemento de destino existente:


| Atributo de origen | Referencias | 
| --- | --- | 
| package@lifecycle | lifecycle@name | 
| package@origin | package\_origin@name | 
| package@package\_class | package\_class@name | 
| phase@support\_level | support\_level@name | 
| phase@start\_milestone | milestone@name | 
| lifecycle@note | note@name | 

Además, la combinación de todos `package@name` los elementos `package@origin` debe ser única en todos los `package` elementos.