> [!CAUTION]
> You are currently viewing version 1.3 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.3 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/manage-environments.md.txt)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/manage-environments.md.txt)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/manage-environments.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/manage-environments.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/manage-environments.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/manage-environments.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/manage-environments.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/manage-environments.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/manage-environments.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/manage-environments.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/manage-environments.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/manage-environments.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/manage-environments.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/manage-environments.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/manage-environments.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/manage-environments.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/manage-environments.md.txt)

> [!NOTE]
> **More Information**   
>
> For more information, see:
>
> - [About environments and environment groups](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-overview.md.txt)

You can manage your environments with a combination of the [Google Cloud console](https://console.cloud.google.com) and the hybrid
runtime configuration file. This section describes how to create a new environment, edit an
environment's details, and delete an existing environment with Google Cloud. You must then update
your `overrides.yaml` on the runtime plane to complete the creation or deletion of an environment.

> [!NOTE]
> **Note:** Do not create any new environments until you have installed the hybrid runtime on your cluster as described in [Part 2: Runtime quickstart](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/install-before-begin.md.txt).

## Create a new environment in the UI

To create a new environment, you must do the following (in this order):

1. Create a new environment in the Google Cloud console. **AND**

2. Provision the new environment in your overrides file.

> [!NOTE]
> **Note:** After you create a new environment in the UI, there can be a several minute delay before you can provision it in the runtime.

You can create up to 75 environments per organization.

**To create a new environment:**

1. Create the new environment as described in [Creating environments](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-working-with.md.txt#create).

   There can be a several minute delay before the new environment is provisioned.

   Even when provisioning is done, you have one more step to perform. You must still add the
   environment to the runtime's `overrides.yaml` file.
2. On the Kubernetes administration machine, add the new environment to the runtime's overrides file, as described in [Creating environments](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/environment-create.md.txt#how-to-add-multiple-environments).

## Edit an existing environment in the UI

You can change the following properties of an existing environment in the UI:

- Display name
- Description

To edit an existing environment, see
[Editing environments](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-working-with.md.txt#edit).

## Delete an existing environment

To delete an existing environment, you must do the following (in this order):

1. Delete the environment in the UI, as described in this section **AND**

2. Delete the environment from the runtime, as described in [Deleting environments](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/environment-delete.md.txt).

**To delete an existing environment:**

1. Delete the environment in the Apigee UI using the instructions in [Deleting environments](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/environments-working-with.md.txt#delete).

   The environment's card in the UI displays a "Pending Deletion" label while Apigee deletes the
   environment.

   There can be a several minute delay before the deletion is completed.

   > [!NOTE]
   > **NOTE:** You're not quite done. You must still delete the environment from the runtime's `overrides.yaml` file.

2. Delete the environment from the runtime's `overrides.yaml` file, as described in [Deleting environments](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/environment-delete.md.txt).