Manage environment labels and break down environment costs

Console

1. Go to the Environments page in the Google Cloud console:

   Go to Environments

2. Select your environment.

3. Go to the Labels tab.

4. Click Edit, then click Add label.

5. Add a key-value pair for the label, then click Save.

6. Wait until the environment updates.

gcloud

When you update an environment using the gcloud composer command, the following arguments specify labels for the environment:

• --clear-labels removes all labels.

• --update-labels updates specified labels; creates new labels if they don't already exist.

• --remove-labels removes specified labels; specified label that do not exist are ignored.

If you use several of these arguments, they are applied in the following order: --clear-labels, --update-labels, --remove-labels.

Update or create labels

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

Remove specified labels

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

Remove all labels

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

Replace:

• ENVIRONMENT_NAME with the name of the environment.
• LOCATION with the region where the environment is located.
• LABEL_KEY with the environment label key that you want to create, update, or remove.
• LABEL_VALUE with the environment label value.

Example

The following example updates the owner label, creates the new env label, and removes the misc label:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

When you update an environment, in the Environment resource, specify new labels of your environment.

Replace all labels

To replace all labels, include labels in the updateMask query parameter and provide a replacement in the request body.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Replace:

• LABEL_KEY with a key of the environment label.
• LABEL_VALUE with a new value for the environment label.

Example:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Remove all labels

To remove all labels, include labels in the updateMask query parameter and do not provide the replacement value.

Update individual labels

To update a label or add a new label to existing labels, include labels.LABEL_KEY in the updateMask query parameter and provide a replacement in the request body.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Replace:

• LABEL_KEY with a key of the environment label.
• LABEL_VALUE with a new value for the environment label.

Example:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Remove individual labels

To remove labels, include labels.LABEL_KEY in the updateMask query parameter and do not provide the replacement value.

Terraform

To create an environment with default parameters is a specified location, edit the labels block in your Terraform configuration and run terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Replace:

• LABEL_KEY with the environment label key that you want to create or update. To remove labels, delete their fields.
• LABEL_VALUE with the environment label value.

Example:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}