Administrar revisiones

Esta página se aplica a Apigee y Apigee Hybrid.

Vista previa — Apigee API hub

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Cada API en el concentrador de APIs puede tener varias versiones, y cada versión puede tener una especificación que a su vez puede tener varias revisiones. La pestaña Historial de revisión en la página de las API enumera cada revisión de especificación en todas las versiones de la API.

Visualiza el esquema del registro de API

A continuación, se muestran las relaciones entre las API de concentrador de API, las versiones, las implementaciones y las especificaciones.

Referencia	Elemento	Descripción
	Registro	Un registro es una colección de API que funciona como catálogo de API.
	Versión	Una API puede tener varias versiones. Una versión debe corresponder a una interfaz estable que los clientes pueden usar para llamar a una API. Una de estas versiones se puede designar como la versión recomendada. En la terminología de semver, se recomienda que las versiones sean versiones principales.
	Deployment	Una API puede tener varias implementaciones, p. ej., diferentes regiones o entornos de etapa de pruebas. Una implementación es una ubicación (una dirección) en la que los usuarios pueden acceder a una API. Una de estas implementaciones puede ser la implementación recomendada.
	Especificación	Se recomienda, pero no es obligatorio, que una versión de API se describa mediante especificaciones formales, a menudo con diferentes formatos de especificación de API. Uno de estos formatos de especificación puede ser el principal, lo que indica que otras especificaciones de esta versión derivan de él.
	Revisiones	Las implementaciones tienen un historial de revisión. Las revisiones de implementaciones representan instancias particulares de una implementación en el tiempo y pueden hacer referencia a una o más revisiones de especificaciones si la implementación de la API que entrega la implementación cambió. Las especificaciones tienen un historial de revisión. Las revisiones de especificaciones representan instancias posteriores de una especificación y, por lo general, representan cambios no rotundos en el contenido de la especificación. En la terminología de semver, las revisiones pueden corresponder a versiones secundarias o puntuales.

Ordena la tabla de revisión

Haz clic en el encabezado de la columna Actualizado para actualizar la tabla.

Agregar revisión

Para agregar una revisión, debes hacer lo siguiente:

1. En la consola de Google Cloud, dirígete a la página del concentrador de APIs.

   Ir al centro de APIs

   La página de lista de API se muestra de forma predeterminada.

2. En la lista de API, haz clic en una fila de API. La pestaña Descripción general se muestra de forma predeterminada.
3. Selecciona la pestaña Historial.
4. Haz clic en Agregar revisión.
5. Haz clic en Explorar y, luego, selecciona un documento de descripción o un archivo ZIP.
6. Haz clic en Abrir.
7. Especifica Detalles:
   • Selecciona una versión de API.
   • Selecciona un tipo de MIME. Si seleccionas Otro, se mostrará un campo de texto en el que podrás especificar el tipo de MIME de forma manual.
   • Escribe un mensaje de confirmación (opcional).
   • Escribe un Hash de confirmación (opcional).
8. Haz clic en Guardar (o Cancelar).

Nota: La columna ID de la tabla Historial el ID de la revisión como aparece en la API de registro.

Ver revisión

Consulta Visualiza o descarga una especificación

Borra la revisión

Para borrar una revisión, debes hacer lo siguiente:

1. En la consola de Cloud, ve a la página del concentrador de APIs.

   Ir al centro de APIs

   La página de lista de API se muestra de forma predeterminada.

2. En la lista de API, haz clic en una fila de API. La pestaña Descripción general se muestra de forma predeterminada.
3. Selecciona la pestaña Historial.
4. Haz clic en Borrar junto al tipo deseado.
5. Haz clic en Borrar (o Cancelar) en el mensaje de confirmación.