Resumen

  • La revisión 13 separa filtrado, ordenación, configuración regional, dirección, posición y límites, y permite declarar capacidades por nodo para listas operativas restringidas.
  • Esas señales explican cómo se obtuvo una página; no prueban por sí solas un orden total, una vista NACM invariable, un instante común entre almacenes ni la integridad de las sublistas.

El problema no aparece dentro de una página. Aparece en el espacio entre dos páginas correctas. La primera puede responder exactamente al filtro y al orden solicitados. La segunda también. Sin embargo, si una ruta cambió de métrica, una interfaz desapareció, una regla NACM alteró la población visible o dos almacenes avanzaron a ritmos distintos, la suma puede no representar ningún estado real que haya existido completo.

draft-ietf-netconf-list-pagination-13 ofrece una gramática rigurosa para evitar confusiones básicas. Primero se aplica where; después sort-by, acompañado en su caso por locale; a continuación llegan direction y una de dos formas excluyentes de posicionamiento, offset o cursor; al final, limit reduce la lista objetivo. sublist-limit no es otro tamaño de página general: limita las colecciones descendientes de cada objeto devuelto.

La revisión 13 se presentó el 6 de julio de 2026. El Datatracker de IETF la muestra como Internet-Draft activo del grupo NETCONF, destinado a Standards Track, con estado de grupo In WG Last Call, etiqueta Revised I-D Needed - Issue raised by WGLC y estado IESG I-D Exists. El panel actual de validación YANG agrega tres errores. Las salidas visibles de pyang y yanglint señalan el mismo entorno de escape y salto de línea. Eso describe el estado del documento y de sus comprobadores, no una avería probada en código, despliegue o datos de un operador.

Una pregunta reproducible no es una población congelada

La inicialización del cursor utiliza el valor first. Allí se fijan where, sort-by y locale. Los enlaces siguiente y anterior incorporan ese contexto inicial, y las llamadas posteriores sólo pueden cambiar limit y sublist-limit. El mecanismo impide que una aplicación mezcle dos preguntas distintas bajo una misma secuencia de cursores.

La protección termina ahí. No hay en el borrador un identificador de instantánea, un tiempo de lectura compartido, un número de transacción ni un vector de revisiones para fuentes federadas. Repetir la misma pregunta de manera fiel puede producir una respuesta distinta porque la realidad operativa cambió.

El offset hace visible el problema: saltar cincuenta entradas sólo funciona de manera estable si las primeras cincuenta permanecen en el mismo lugar. Una inserción o eliminación anterior mueve la frontera. El cursor mejora la posición al hacerla opaca y relacionarla con una clave o índice del sistema subyacente. Pero no inmoviliza todas las demás claves.

El compañero RESTCONF añade una precisión decisiva: el servidor no conserva estado sobre el cursor o la página siguiente o anterior. Por tanto, el enlace no es un identificador oculto de un resultado reservado. Es una instrucción de continuación que se ejecuta de nuevo.

La configuración regional no especifica toda la colación

Si no hay sort-by, manda el orden natural de la lista YANG. Cuando lo hay, los objetos sin valor para el hijo seleccionado se colocan después de los que sí lo tienen. locale sólo es válida con sort-by. Si el cliente la omite, el servidor decide y comunica la elegida mediante metadatos YANG.

Guardar esa locale es mejor que suponerla. Aun así, una etiqueta BCP 47 no contiene la versión de Unicode, la biblioteca de colación, las reglas de normalización ni el criterio de desempate. Dos nodos pueden aceptar la misma etiqueta y diferir en la ubicación de acentos, mayúsculas o formas equivalentes.

El borrador tampoco define órdenes secundarios. Cuando varios objetos comparten la clave principal, no existe en la consulta un segundo campo que garantice el orden total. Si el corte de página atraviesa un grupo empatado, el resultado depende de una decisión del servidor que puede no ser observable. Una prueba seria conserva el discriminador real, o declara que el orden solicitado no basta para reproducir la frontera.

El mapa de capacidades describe una promesa

Las listas config false pueden ser demasiado grandes o dinámicas para evaluar cualquier XPath. Mediante RFC 9196, el servidor puede marcar un nodo como constrained, declarar hijos indexed y anunciar cursor-supported. En una lista restringida, filtro y orden se limitan a nodos indexados y no descienden por sublistas.

Eso permite al cliente negociar una consulta viable. No prueba que el índice anunciado se usó en esa llamada, que contenía el último dato o que todos los sistemas de origen estaban sincronizados. Las capacidades pueden cambiar con el hardware, la licencia o el estado de ejecución. Cada página necesita la identidad del conjunto de capacidades que estaba vigente.

La identidad content-id de la biblioteca YANG definida por RFC 8525 tiene otra función: identifica el contenido de módulos y esquemas. Ayuda a interpretar la respuesta con el contrato correcto. No es una versión de las rutas, interfaces o contadores presentes en el almacén. Es identidad del lenguaje, no del momento de los hechos.

La autorización también pagina

NACM, definido en RFC 8341, restringe operaciones y contenido por principal. Así, where no se aplica a un universo abstracto, sino a la vista permitida para quien pregunta. Si cambia una regla entre páginas, la membresía de esa vista cambia aunque el filtro textual y el cursor permanezcan iguales.

La cobertura existente de BTW sobre RFC 9865 y SCIM se concentra en que tener un cursor no debe conservar permisos ya revocados. Aquí el límite es otro: incluso con autorización fresca y correcta en cada llamada, dos vistas distintas no componen necesariamente una lista coherente. El expediente debe conservar principal, versión de política y decisión por página, y hacer visible cualquier ruptura.

El almacén operacional sigue produciendo hechos

RFC 8342 distingue configuración prevista y datos operacionales. Estos últimos incorporan configuración aplicada y estado del sistema, a veces desde orígenes múltiples. Mientras el cliente pagina, las tablas de rutas convergen, los contadores avanzan y los recursos aparecen o desaparecen.

Si la primera página acaba en la clave m, un objeto puede moverse de b a z y reaparecer después. Otro puede pasar de y a a y quedar fuera de ambas páginas. El cursor puede mantener una frontera mejor que el offset, pero no evita la mutación de elementos ajenos. Tampoco sincroniza sistemas federados que responden con relojes o ciclos de actualización diferentes.

Cuando el sistema sí ofrece una revisión o instantánea común, debe vincularse a cada página. Cuando no, el resultado necesita una ventana temporal, tiempos por origen y reconciliación de claves. La descripción correcta puede ser “recorrido observado entre 10:00:00 y 10:00:37”, no “estado completo a las 10:00”.

Una lista de objetos contiene más listas

limit limita la colección objetivo. sublist-limit limita por separado las listas hijas. La anotación remaining puede ser un entero positivo o unknown. Por ello, recuperar todos los dispositivos no implica recuperar todas sus interfaces, y conocer el número de dispositivos pendientes no informa del número de rutas truncadas dentro de cada uno.

Cada colección hija limitada abre una rama de evidencia: identidad del padre, consulta, cursor, respuesta y recuento o incertidumbre. Si el consumidor descarta esas ramas y sólo marca la página superior como terminada, confunde integridad del contenedor con integridad de su contenido.

Un sobre de evidencia para cada página

El diseño operacional recomendado conserva, por página, el principal y la política NACM, almacén, content-id de YANG Library, conjunto de capacidades, parámetros exactos, hashes de solicitud y respuesta, linaje del cursor, claves y valores de orden, anotaciones de restantes, hora del servidor e identidades o revisiones de las fuentes.

Después, un registro de ensamblaje busca duplicados, huecos e inversiones de frontera; compara la última tupla ordenada con la primera de la página siguiente; señala cambios de política, capacidad o locale; y clasifica la consistencia que realmente obtuvo. Es una práctica propuesta para operadores, no un requisito atribuido al Internet-Draft.

La decisión relevante no es si la paginación es buena o mala. Es qué afirmación permite. Para inventarios que controlan borrados o cumplimiento puede ser necesario exigir instantánea común. Para telemetría puede bastar una inconsistencia acotada y visible. En ambos casos, el cursor tiene un papel exacto: recordar una posición. El momento pertenece a otra capa de prueba.

Fuentes primarias

El conjunto cerrado contiene textos y estados oficiales, diferencias, documentos compañeros, tres revisiones históricas tratadas sólo como historia y RFC de base: https://datatracker.ietf.org/doc/html/draft-ietf-netconf-list-pagination-13; https://www.ietf.org/archive/id/draft-ietf-netconf-list-pagination-13.txt; https://datatracker.ietf.org/doc/draft-ietf-netconf-list-pagination/; https://datatracker.ietf.org/doc/draft-ietf-netconf-list-pagination/history/; https://author-tools.ietf.org/iddiff?url1=draft-ietf-netconf-list-pagination-12&url2=draft-ietf-netconf-list-pagination-13; https://datatracker.ietf.org/doc/html/draft-ietf-netconf-list-pagination-nc-12; https://datatracker.ietf.org/doc/draft-ietf-netconf-list-pagination-nc/; https://datatracker.ietf.org/doc/html/draft-ietf-netconf-list-pagination-rc-11; https://datatracker.ietf.org/doc/draft-ietf-netconf-list-pagination-rc/; https://datatracker.ietf.org/doc/review-ietf-netconf-list-pagination-07-opsdir-early-linkova-2025-05-10/; https://datatracker.ietf.org/doc/review-ietf-netconf-list-pagination-07-yangdoctors-early-lhotka-2025-04-28/; https://datatracker.ietf.org/doc/review-ietf-netconf-list-pagination-03-yangdoctors-lc-lhotka-2024-05-01/; https://www.rfc-editor.org/rfc/rfc6241.html; https://www.rfc-editor.org/rfc/rfc6242.html; https://www.rfc-editor.org/rfc/rfc5646.html; https://www.rfc-editor.org/rfc/rfc7950.html; https://www.rfc-editor.org/rfc/rfc7951.html; https://www.rfc-editor.org/rfc/rfc7952.html; https://www.rfc-editor.org/rfc/rfc8040.html; https://www.rfc-editor.org/rfc/rfc8341.html; https://www.rfc-editor.org/rfc/rfc8342.html; https://www.rfc-editor.org/rfc/rfc8407.html; https://www.rfc-editor.org/rfc/rfc8525.html; https://www.rfc-editor.org/rfc/rfc9196.html; https://www.rfc-editor.org/rfc/rfc9911.html.