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:

    El cuadro de diálogo de instancia nueva

  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. Haga 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. Haz clic en CONTINUE.
    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 CONTINUE y revisa tus selecciones.
    6. Haz clic en CREAR.
    7. Haz clic en OTORGAR a fin de 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.

    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.

Apigee clásico

Para crear una instancia nueva en la IU clásica de Apigee, siga estos pasos:

  1. Abre la IU de Apigee en un navegador.

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

  3. Haga clic en CREAR INSTANCIA. 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:

    El cuadro de diálogo de instancia nueva

  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 una clave no existe o no quieres usar una existente, puedes crear una nueva en el asistente. Para crear una clave, sigue estos pasos:

    1. Haga 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 el nombre de los llaveros ni borrarlos.
    3. Haga clic en CONTINUE.
    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 CONTINUE y revisa tus selecciones.
    6. Haga clic en CREAR.
    7. Haz clic en OTORGAR a fin de 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.

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

  5. Haga 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 del entorno de ejecución en los pasos de aprovisionamiento sin intercambio de tráfico de VPC.

Si Apigee se aprovisionó con el intercambio de tráfico entre VPC, consulta Crea una instancia del 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 asignar el entorno 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 del entorno o deseas 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.

Apigee en la consola de Cloud

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. En la vista Instancias, haz clic en la instancia que deseas editar.
  4. En la vista Detalles de la instancia, haz clic en Editar.
  5. En la vista 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 OK.
  7. Haz clic en Guardar para guardar los cambios.

Apigee clásico

Para adjuntar o quitar un entorno de una instancia con la IU clásica de Apigee, haz lo siguiente:

  1. Abre la IU de Apigee en un navegador.

  2. Selecciona Administrador > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. Haz clic en EDITAR.
  5. En el menú Entornos, selecciona el entorno que deseas conectar a la instancia. Si quieres desconectar cualquier entorno que ya esté conectado, desmárcalo de la lista.

    Selecciona Editar.

  6. 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 un navegador.

  2. Selecciona Administrador > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. Haz clic en EDITAR.
  5. En la sección Proyectos aceptados, haz clic en el ícono de borrar junto a un proyecto para quitarlo. Para agregar un proyecto, haz clic en AGREGAR PROYECTO necesitando y, luego, ingresa el ID del proyecto que deseas agregar.
  6. Haz clic en GUARDAR para guardar los cambios.

Borra una instancia

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

Solo una instancia de Apigee puede estar en una región de Google Cloud determinada. 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é.

Apigee en la consola de Cloud

Para borrar una instancia en 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 vista Detalles de la instancia, haz clic en Borrar.

Apigee clásico

Para borrar una instancia en la versión clásica de Apigee, sigue estos pasos:

  1. Abre la IU de Apigee en un navegador.

  2. Selecciona Administrador > Instancias.

  3. Selecciona la instancia que deseas borrar.

  4. Haz clic en BORRAR.

  5. Apigee te solicita que confirmes que deseas borrar esta instancia.

  6. Escribe el nombre de la instancia en el campo Nombre de la instancia y haz clic en Borrar.

    Apigee comienza el proceso de borrar la instancia. Este proceso puede tardar entre 10 y 15 minutos en completarse.