This document describes how to edit an existing Google Distributed Cloud (GDC) air-gapped
project. There are a subset of configurations for your project that can be
updated after creation, such as project name, billing account, and data
exfiltration protection. You can update these configurations as your usage of
the project evolves.

This document is for audiences such as IT administrators, security engineers, and
network administrators within the platform administrator group, who are
responsible for managing resources within their organization. For more information,
see [Audiences for GDC air-gapped documentation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/audiences.md.txt).

## Before you begin

To perform the tasks in this document, you must complete the following
requirements:

- To get the permissions that you need to edit an existing project, ask your
  IAM Org Admin to grant you the Project Editor role (`project-editor`).

- To use the gdcloud CLI, ensure you have it installed. For more
  information, see
  [Install the gdcloud CLI](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/gdcloud-install.md.txt).

## Edit the configuration of a project

Projects offer a subset of configurations you can update after creation.
Complete the following steps to find and change the configurable settings of
your project:

### Console

1. Open the navigation menu and select **Projects**.

2. Click the project you want to edit.

3. Click edit **Edit** next
   to the field you want to update.

4. Provide the updated project configuration and click **Save**.

### gdcloud

1. List the available configurations you can change for a project:

   ```bash
   gdcloud projects update --help
   ```

   The output provides flags you can set in the `gdcloud projects update`
   command to update configurations of the project. For example, the `--name`
   flag updates the project name.
2. Run the `gdcloud projects update` command with the flag corresponding to
   the configuration to update. For example, to update the project name,
   run:

   ```bash
   gdcloud projects update PROJECT_ID --name=PROJECT_NAME
   ```

   Replace the following variables:
   - `PROJECT_ID`: the unique identifier for your project.
   - `PROJECT_NAME`: the new name for the project.

## What's next

- [Design access boundaries between resources](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/access-boundaries.md.txt)
- [Configure organization policies](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform/pa-user/org-policy.md.txt)
- [Create and link billing accounts](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform/pa-user/billing/manage-billing-accounts.md.txt)