Edit a project

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.

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 Organization IAM 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.

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:

    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:

    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