gcloud-projects

gcloud projects command [options]

gcloud projects provides commands for managing Google Cloud projects, which serve as the fundamental organizational unit in GCP. Every resource in Google Cloud belongs to exactly one project, and projects provide the basis for billing, access control, and resource isolation.The command group supports the full project lifecycle including creation, deletion, and restoration of soft-deleted projects. It also handles IAM policy management at the project level, controlling which principals have access to project resources.Projects contain settings like project ID (immutable), project name (changeable), and project number (assigned by Google). Understanding project management is essential for organizing resources and managing costs in Google Cloud, as billing is tracked per project.

list

List projects the active account has permission to view.

Create a new project. ID must be 6–30 characters, lowercase letters, digits, or hyphens.

Show metadata (name, number, lifecycle state, labels) for a project.

Mark a project for deletion (it is soft-deleted for 30 days before permanent removal).

Print the IAM policy attached to the project.

Replace the IAM policy with the one defined in the JSON or YAML file.

Add a single member/role binding to the project's IAM policy.

Remove a member/role binding from the project's IAM policy.

Update project metadata such as display name or labels.

Move a project to a different organization or folder.

Restore a soft-deleted project within the 30-day grace period.

gcloud(1), gcloud-config(1)