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:
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:
Selecciona Administración > Instancias. En el panel Instancias, se muestra una lista de instancias existentes.
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.
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:
Haz clic en Crear clave.
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.
Haga clic en Continuar.
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.
Haz clic en Continuar y revisa tus selecciones.
Haz clic en Crear.
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.
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.
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.
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:
En la página Detalles de la instancia, haz clic en Editar.
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.
Haz clic en Aceptar.
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.
En la página Detalles de la instancia, haz clic en Editar.
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.
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:
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:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis page outlines how to manage Apigee instances, which are virtual machines storing your API project and services, and it's important to note that this content does not apply to Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a new instance via the Apigee UI or Instances API, each requiring a unique disk encryption key and non-overlapping CIDR ranges for network peering.\u003c/p\u003e\n"],["\u003cp\u003eInstances can have environments attached or removed, and these associations can be managed through the Apigee UI or the Instances attachment create API.\u003c/p\u003e\n"],["\u003cp\u003eThe list of Cloud projects that can connect to an instance can be managed by adding or removing projects in the "Accepted projects" list, and this can be done through the UI.\u003c/p\u003e\n"],["\u003cp\u003eDeleting an instance will remove all associated data, including KMS, KVM, quota data, and environment cache, and it will also remove the association for any attached environments.\u003c/p\u003e\n"]]],[],null,["# Managing instances\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nAn [instance](/apigee/docs/api-platform/get-started/create-instance) is a virtual\nmachine where your API project and related services are stored. Instances correspond to regions.\nTypically, you start with a single instance and add new instances as your organization expands\ninto more regions. This section explains how to:\n\n- [Create a new instance](#create-a-new-instance).\n- [Attach or remove environments from an instance](#add-envs).\n- [Edit the accepted projects list](#accepted-projects)\n- [Enable or disable ingress access logs for an instance](#enable-logging).\n- [Delete an instance](#delete-an-instance).\n\n| **Note:** Evaluation organizations can only have one instance (region).\n| To expand beyond a single region and instance, you must have a\n| [paid organization](/apigee/docs/api-platform/fundamentals/organization-structure#org_types). Your subscription entitlements limit the number of instances (regions) you can add.\n| You can add more instances (regions) by purchasing an Org Pack. For more information,\n| see [Subscription entitlements](/apigee/docs/api-platform/reference/subscription-entitlements).\n\nCreate a new instance\n---------------------\n\nTo create a new instance, you can use the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances) or the Apigee UI. Each instance requires:\n\n- its own disk encryption key for the network. Apigee recommends that you also create a separate key ring for the new instance. For more information, see [About the Apigee encryption keys](/apigee/docs/api-platform/security/encryption-keys).\n- its own non-overlapping /22 and /28 CIDR ranges for network peering. The ranges cannot be shared between instances.\n\n**Note:** You must have a paid organization to add an instance. Evaluation accounts are limited to one region or instance and cannot be expanded to a second. Your entitlements limit the number of regions you can add. For more information, see [Apigee Pricing](https://cloud.google.com/apigee/pricing). \n\n### Apigee in Cloud console\n\n| **Important:** This topic only applies to organizations that were created with VPC peering enabled. See also [Apigee networking options](/apigee/docs/api-platform/get-started/networking-options).\n\nTo create a new instance in Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n The **Instances** pane displays a list of existing instances.\n\n \u003cbr /\u003e\n\n2. Click **+ Create**. There might be a delay while the UI determines if\n your org has the proper entitlements to create a new instance.\n\n The **Create new instance** page displays.\n3. Enter details about your new instance in the fields:\n\n If your org cannot create a new instance, contact [Apigee Sales](https://pages.apigee.com/contact-sales-reg.html).\n4. Click **Create**.\n\n Apigee begins a long-running operation that can take 20 minutes\n or more to complete. When it's done, the new instance will appear in the list of instances in\n the **Instances** UI.\n\n### Apigee API\n\nIf Apigee was provisioned without VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli-non-peered#runtime-instance) in the non-VPC peering provisioning steps.\n\nIf Apigee was provisioned with VPC-peering, see [Create a runtime instance](/apigee/docs/api-platform/get-started/install-cli#runtime-instance) in the VPC peering provisioning steps.\n\nAttach or remove environments from an instance\n----------------------------------------------\n\nWhen you create an environment using the Apigee UI in Google Cloud console, you have the option to assign the\nenvironment to an existing instance. For more information, see [Creating a new environment in the UI](/apigee/docs/api-platform/fundamentals/environments-working-with#creating-a-new-environment-in-the-ui).\n\nIf you did not attach your environment to an instance during environment creation, or you want to remove an\nenvironment from an instance, you can follow these steps. For more information on environments and instances, see [Environments and instances](/apigee/docs/api-platform/fundamentals/environments-working-with#environments-and-instances).\n\nTo attach or remove an environment from an instance using Apigee in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Edit Instance** page, click the **Environments (optional)** field and select the environment you want to attach to the instance, or deselect the environment you want to remove.\n5. Click **OK**.\n6. Click **Save** to save your changes.\n\nIn addition to using the UI, you can also attach environments to an instance using the\n[Instances attachment create API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances.attachments/create). For an example, see\n[Create\nan environment](/apigee/docs/api-platform/get-started/install-cli#create-environment) in the command-line provisioning documentation.\n\nEdit the accepted projects list\n-------------------------------\n\nYou can add or remove projects from the **Accepted projects** list:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. In the **Accepted projects** section of the **Edit Instance** page, click delete **Delete** next to a project to remove it. To add a project click **Add accepted project** and enter the ID of the project to add.\n5. Click **Save** to save your changes.\n\nEnable or disable ingress access logs for an instance\n-----------------------------------------------------\n\nAfter you create an instance, you can enable and disable Cloud Logging ingress access logs for the instance:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to edit.\n\n3. In the **Instance details** page, click **Edit**.\n4. the **Edit Instance** page, click the **Enable logging** toggle to disable the feature.\n5. Click **Save** to save your changes.\n\nDelete an instance\n------------------\n\nYou can use the Apigee UI to delete an existing instance, as described in this section.\nAlternatively, you can delete an instance using the [Instances API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.instances).\n\nOnly one Apigee instance can be in a given Google Cloud region. When you delete an instance,\nit is completely removed from its region. See also\n[multi-region installation](/apigee/docs/api-platform/system-administration/multi-region).\n**Warning:** When you delete an instance, all data associated with that instance is lost. This step cannot be undone. Note, however, that if you have multiple instances, such as in a multi-region installation, your data will be lost only if you delete all of the instances. Before deleting the last instance, be sure to extract and back up any data you do not wish to lose. **Note:** Deleting an instance removes the association for any attached environments. You may need to move any attached environments to new instances by [Attaching and removing environments from an instance](#add-envs) before deleting the instance. All environments must be attached to at least one instance for their proxies to function.\n\nThe following data is stored in an Apigee instance and will be deleted if you delete\nthe instance:\n\nTo delete an Apigee instance using the Apigee UI in Cloud console:\n\n1. In the Google Cloud console, go to the **Management \\\u003e Instances** page.\n\n [Go to Instances](https://console.cloud.google.com/apigee/instances)\n2. Click the instance that you want to delete.\n3. In the **Instance Details** page, click **Delete**."]]
