Administrar las implementaciones

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.

Una API puede tener varias implementaciones. Por ejemplo: 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 se puede indicar como la implementación recomendada.

La pestaña Implementaciones muestra todas las implementaciones de la API que configuró un usuario con permisos de edición. Las implementaciones se enumeran alfabéticamente por entorno.

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.

Cómo agregar una implementación

Para agregar una implementación, haz 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 Deployments.
4. Haz clic en Add deployment.
5. Ingresa o selecciona lo siguiente:
   • ID: Es un identificador para un recurso de API. El ID solo puede contener letras en minúscula, números y guiones. El ID debe ser único en el proyecto. Los ID deben tener entre 4 y 63 caracteres. Los ID no se pueden cambiar una vez que se crea una implementación.
   • Entorno: La ubicación en la que está disponible una instancia de una API. Por ejemplo: producción, etapa de pruebas, prueba, etcétera.
   • Puerta de enlace: El tipo de puerta de enlace. El proxy que se usa para entregar y proteger la API. Se define como una taxonomía del sistema.

   • Versión de la API: La versión de la API que proporciona esta implementación. Si una versión no tiene revisiones, se marca como tal en la lista y no se puede seleccionar.

     
   • Nombre y URL del canal externo: una etiqueta y una URL de un vínculo a un canal externo para la API, como un Portal para desarrolladores
   • Información de acceso
     • Guía de uso: orientación que especifica el público de la implementación. Por ejemplo, consumo público, pruebas internas, etcétera.
     • Extremo del servidor: Es el extremo del servidor para la API.
     • Guía de acceso: Contenido de Markdown de formato libre en el que se describe cómo los consumidores de API pueden obtener acceso a la implementación.
6. Haz clic en Guardar (o Cancelar).

Edita la implementación

Para editar una implementación, haz 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 Deployments.
4. Haz clic en Más > Editar junto a la implementación deseada.
5. Realiza las modificaciones necesarias.

6. Actualizar revisión: esta casilla de verificación se muestra cuando la versión seleccionada actualmente tiene una revisión de especificaciones que es más nueva que la que ya está asignada a la implementación. Selecciona esta casilla para actualizar la revisión de la especificación implementada.

   
7. Haz clic en Guardar (o Cancelar).

Borrar implementación

Para borrar una implementación, haz 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 Deployments.
4. Haz clic en Más > Borrar junto a la implementación deseada.
5. Haz clic en Borrar (o Cancelar) en el mensaje de confirmación.

Especifica la implementación recomendada

Para configurar o borrar una implementación recomendada, sigue estos pasos:

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 Deployments.
4. En la fila de implementación deseada, haz clic en Más > Set as recommended. No puedes borrar una implementación recomendada. Solo puedes especificar una implementación diferente como implementación recomendada.

Obtén acceso

Nota: La información de acceso se especifica como parte de la implementación. Para obtener más información, consulta Cómo agregar una implementación.

Para ver información sobre cómo obtener acceso a una API, sigue estos pasos:

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. En el panel General o la pestaña Implementaciones, haz clic en Obtener acceso para abrir el panel de la API Acceso. Si no aparece el botón Obtener acceso, no se proporcionó información. Consulta Agrega implementación para obtener instrucciones sobre cómo agregar información de acceso.

4. Selecciona una Implementación de la lista. Si una implementación no tiene información de acceso, se marca como tal en la lista y no se puede seleccionar.

   

Cómo ir a un canal externo

Nota: Un canal externo se define cuando creas una implementación. Para obtener más información, consulta Agrega implementación.

Sigue estos pasos para navegar a un canal externo:

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

4. Haz clic en un vínculo de canal externo para navegar a un canal externo, como un portal, si se definió uno.