Administra instancias

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Una instancia es una máquina virtual en la que se almacenan tu proyecto de API y los servicios relacionados. Las instancias corresponden a las regiones. Por lo general, comienzas con una sola instancia y agregas nuevas a medida que tu organización se expande a más regiones. Esta sección explica cómo:

Cree una instancia nueva

Para crear una instancia nueva, puedes usar la API de instancias o la IU de Apigee. Cada instancia requiere lo siguiente:

  • su propia clave de encriptación de disco para la red. Google recomienda que también crees un llavero de claves por separado para la instancia nueva. Para obtener más información, consulta Acerca de las claves de encriptación de Apigee.
  • sus propios rangos de /22 y /28 CIDR no superpuestos para el intercambio de tráfico entre redes. Los rangos no se pueden compartir entre instancias.

Apigee en la consola de Cloud

Para crear una instancia nueva en Apigee en la consola de Cloud, sigue estos pasos:

  1. Abre la IU de Apigee en la consola de Cloud en tu navegador.

  2. Selecciona Administración > Instancias. En el panel Instancias, se muestra una lista de instancias existentes.

  3. Haz clic en + Crear. Puede haber un retraso mientras la IU determina si tu organización tiene las autorizaciones adecuadas para crear una instancia nueva.

    En la página Crear instancia nueva, se muestra lo siguiente.

  4. Ingresa los detalles de la instancia nueva en los campos:
    Campo Obligatorio Descripción
    Runtime hosting location Obligatorio Selecciona la región en la que deseas crear tu instancia nueva. No puedes crear una instancia nueva en una región que ya tiene una. Si deseas obtener más información para trabajar con varias regiones, consulta Usa varias regiones.
    Name Obligatorio

    Ingresa el ID de la instancia nueva.

    El valor predeterminado es el nombre de la región de hosting del entorno de ejecución que seleccionaste, pero puedes cambiarla a cualquier nombre significativo que quieras, siempre que sigas las reglas de denominación:

    • Longitud mínima de 2
    • La longitud máxima es de 32 caracteres.
    • Usa solo letras minúsculas, números y guiones (según el patrón /^[a-z0-9\-]+$/).
    • Debe comenzar con una letra, no debe contener dígitos ni guiones.
    • Debe terminar con un número o una letra, no debe contener guiones finales.
    • Debe ser único en toda la organización.
    IP range allocation Obligatorio

    Especifica cómo deseas asignar un rango de IP. Elige entre estas opciones:

    • Automático (recomendado): Apigee selecciona un rango de CIDR disponible con un tamaño de prefijo de /22. No se requiere ninguna otra acción de tu parte.
    • Personalizado: En casos de uso avanzados, es posible que debas especificar con exactitud qué rango de IP deseas que use Apigee. Para estos casos, debes especificar un rango de IP personalizado, y debe tener un tamaño de prefijo de /22. El rango debe estar disponible como parte de una conexión privada entre tu proyecto y Apigee.
    Disk encryption key Obligatorio

    En Clave de encriptación de disco, elige una clave de encriptación administrada por el cliente. Si ya existe una clave, puedes elegirla. El asistente enumera todas las claves en la misma ubicación que la región de hosting del entorno de ejecución en todos los llaveros de claves. Si no existe una clave o no quieres usar una existente, puedes crear una nueva en el asistente. Para crear una clave, sigue estos pasos:

    1. Haz clic en Crear clave.
    2. Selecciona un llavero de claves o, si no existe uno, habilita Crear un llavero de claves e ingresa un nombre de llavero de claves y elige una ubicación de llavero de claves. Los nombres de los llaveros de claves pueden contener letras, números, guiones bajos (_) y guiones (-). No es posible cambiar ni borrar el nombre de los llaveros de claves.
    3. Haga clic en Continuar.
    4. Crea una clave. Ingresa un nombre y un nivel de protección. Ten en cuenta que los nombres de las claves pueden contener letras, números, guiones bajos (_) y guiones (-). No se puede cambiar el nombre de las claves ni borrarlas. Para el nivel de protección, el Software es una buena opción. Este es el mismo valor predeterminado que usa Cloud KMS. Sin embargo, puedes cambiarlo si lo deseas.
    5. Haz clic en Continuar y revisa tus selecciones.
    6. Haz clic en Crear.
    7. Haz clic en Otorgar para otorgar permiso a la cuenta de servicio para encriptar y desencriptar con la clave seleccionada.
    Environments Opcional

    Selecciona los entornos que deseas conectar a esta instancia. Para ello, haz clic en la lista desplegable Entornos y selecciona las casillas de verificación junto a los entornos que deseas conectar. Puedes hacer esto en todos los entornos que desees. Luego, haz clic en Aceptar.

    Ten en cuenta que los entornos de todas las instancias se suman a la cantidad total de entornos que puedes asignar. Para obtener más información, consulta Información acerca de los entornos y grupos de entornos.

    Es opcional agregar entornos cuando creas una instancia nueva. Si no las agregas ahora, puedes usar la API de creación de adjuntos de instancias o la IU para agregarlas y quitarlas más adelante. Consulta Adjunta o quita un entorno.
    Accepted projects Opcional Haz clic en Agregar proyecto aceptado para seleccionar uno o más proyectos de Cloud. Los proyectos seleccionados pueden conectarse de forma privada al adjunto de servicio de tu instancia. De forma predeterminada, el proyecto asociado con tu organización de Apigee se incluye en esta lista.
    Enable logging Opcional Haz clic en el botón de activación Habilitar registro para habilitar los registros de acceso de entrada de Cloud Logging para la instancia. Esta función te permite ver los registros que generan las puertas de enlace de entrada en la infraestructura de Apigee, como un balanceador de cargas de aplicaciones externo o una puerta de enlace de Anthos, para ayudar a solucionar problemas de llamadas a la API de Apigee.

    Para obtener más información, consulta Registra los registros de acceso de Apigee.
    Filter Opcional Selecciona un código de respuesta HTTP del cuadro código de respuesta para que actúe como filtro para los registros de acceso.

    Si deseas incluir todos los registros, sin importar el código de respuesta HTTP, selecciona None (all HTTP responses).

    Para crear un filtro personalizado, selecciona Custom y, luego, ingresa el filtro en el siguiente formato:

    status_code > XX && status code <= YY

    Por ejemplo:

    status_code >= 500 && status_code < 504

    Si tu organización no puede crear una instancia nueva, comunícate con Ventas de Apigee.

  5. Haz clic en Crear.

    Apigee inicia una operación de larga duración que puede tardar 20 minutos o más en completarse. Cuando finalice, la instancia nueva aparecerá en la lista de instancias en la IU de Instancias.

API de Apigee

Si Apigee se aprovisionó sin intercambio de tráfico entre VPC, consulta Crea una instancia de entorno de ejecución en los pasos de aprovisionamiento sin intercambio de tráfico entre VPC.

Si Apigee se aprovisionó con el intercambio de tráfico de VPC, consulta Crea una instancia de entorno de ejecución en los pasos de aprovisionamiento de intercambio de tráfico de VPC.

Adjunta o quita entornos de una instancia

Cuando creas un entorno con la IU de Apigee en la consola de Google Cloud, tienes la opción de asignarlo a una instancia existente. Para obtener más información, consulta Crea un entorno nuevo en la IU.

Si no adjuntaste tu entorno a una instancia durante la creación o quieres quitar un entorno de una instancia, puedes seguir estos pasos. Para obtener más información sobre las instancias y los entornos, consulta Entornos e instancias.

Para adjuntar o quitar un entorno de una instancia mediante Apigee en la consola de Cloud, haz lo siguiente:

  1. Abre la IU de Apigee en la consola de Cloud en tu navegador.
  2. Selecciona Administración > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. En la página Detalles de la instancia, haz clic en Editar.
  5. En la página Editar instancia, haz clic en el campo Entornos (opcional) y selecciona el entorno que deseas conectar a la instancia, o bien anula la selección del entorno que deseas quitar.
  6. Haz clic en Aceptar.
  7. Haz clic en Guardar para guardar los cambios.

Además de usar la IU, también puedes conectar entornos a una instancia mediante la API de creación de adjuntos de instancias. Para ver un ejemplo, consulta Crea un entorno en la documentación de aprovisionamiento de la línea de comandos.

Edita la lista de proyectos aceptados

Puedes agregar o quitar proyectos de la lista Proyectos aceptados.

  1. Abre la IU de Apigee en la consola de Cloud en tu navegador.
  2. Selecciona Administración > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. En la página Detalles de la instancia, haz clic en Editar.
  5. En la sección Proyectos aceptados de la página Editar instancia, haz clic en el ícono de borrar junto a un proyecto para quitarlo. Para agregar un proyecto, haz clic en Agregar proyecto aceptado y, luego, ingresa el ID del proyecto que deseas agregar.
  6. Haz clic en Guardar para guardar los cambios.

Habilita o inhabilita los registros de acceso de entrada para una instancia

Después de crear una instancia, puedes habilitar y deshabilitar los registros de acceso de entrada de Cloud Logging para la instancia:

  1. Abre la IU de Apigee en la consola de Cloud en tu navegador.
  2. Selecciona Administración > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. En la página Detalles de la instancia, haz clic en Editar.
  5. la página Editar instancia, haz clic en el botón de activación Habilitar registro para inhabilitar la función.
  6. Haz clic en Guardar para guardar los cambios.

Borrar una instancia

Puedes usar la IU de Apigee en la consola de Cloud para borrar una instancia existente, como se describe en esta sección. También puedes borrar una instancia mediante la API de instancias.

Solo se puede ubicar una instancia de Apigee en una región determinada de Google Cloud. Cuando borras una instancia, se quita por completo de su región. Consulta también la instalación multirregional.

Advertencia: Cuando borras una instancia, se pierden todos los datos asociados con ella. Este paso no se puede deshacer. Sin embargo, ten en cuenta que si tienes varias instancias, como en una instalación multirregión, tus datos se perderán solo si borras todas las instancias. Antes de borrar la última instancia, asegúrate de extraer y hacer una copia de seguridad de los datos que no desees perder.

Los siguientes datos se almacenan en una instancia de Apigee y se borrarán si borras la instancia:

Tipo de datos Descripción
Sistema de administración de claves (KMS) Los datos de KMS incluyen productos de API, desarrolladores, aplicaciones de desarrollador, tokens de OAuth (incluidos tokens de acceso, tokens de actualización y códigos de autorización), y claves de API. Usa la política AccessEntity o la API de Apigee relacionada para recuperar los datos que deseas guardar.
Mapa de clave-valor (KVM) Cualquier dato que se pueda crear o administrar con políticas de KVM Consulta Recupera KVM.
Cuota Definiciones de cuotas, buckets y contadores.
Caché de entorno Todos los datos almacenados en caché.

Para borrar una instancia de Apigee con la IU de Apigee en la consola de Cloud, sigue estos pasos:

  1. Abre la IU de Apigee en la consola de Cloud en tu navegador.

  2. Selecciona Administración > Instancias.

  3. Selecciona la instancia que deseas borrar.
  4. En la página Detalles de la instancia, haz clic en Borrar.