Console

1. In the Google Cloud console, go to the Cloud RunServices page:

   Go to Cloud Run

2. Check the checkbox at the left of the service you are setting the labelon.

3. Make sure theInfo Panel at the far right is toggled on(Show Info Panel).

4. ClickLabels to display the labels pane.

   

5. To edit an existing label key value, locate the label and change theValue.

6. To set a new label on the service, clickAdd Label and supply the keyand the value.

7. ClickSave

gcloud

You can update labels for a service using the command:

gcloudrunservicesupdateSERVICE--update-labelsKEY=VALUE

To update more than one label, supply a comma delimited list of key-value pairs. Note that theupdate-labels command sets a new value for the label key if the label already exists, otherwise it creates a new label.

Replace the following:

• SERVICE: the name of your Cloud Run service
• KEY: the name of your label key
• VALUE: the value for the key

You can also set labels duringdeployment:

gcloudrundeploySERVICE--imageIMAGE--labelsKEY=VALUE

To create more than one label during deployment, supply a comma delimitedlist of key-value pairs.

YAML

1. If you are creating a new service, skip this step.If you are updating an existing service, download itsYAML configuration:

   gcloudrunservicesdescribeSERVICE--formatexport>service.yaml

2. Update thelabels attributes in two places:

   apiVersion:serving.knative.dev/v1kind:Servicemetadata:name:SERVICElabels:LABEL:VALUEspec:template:metadata:labels:LABEL:VALUEname:REVISION

   Replace the following:

   • SERVICE: the name of your Cloud Run service
   • LABEL: the name of the label
   • VALUE: the required value
   • REVISION with a new revision name or delete it (if present). If you supply a new revision name, itmust meet the following criteria:
     • Starts withSERVICE-
     • Contains only lowercase letters, numbers and-
     • Does not end with a-
     • Does not exceed 63 characters

   metadata.labels sets labels on the service object, whilespec.template.metadata.label sets labels on the created revision.Only labels set on the revision are passed to logs and billing.

3. Create or update the service using the following command:

   gcloudrunservicesreplaceservice.yaml

Terraform

To learn how to apply or remove a Terraform configuration, seeBasic Terraform commands.

resource"google_cloud_run_v2_service""default"{name="cloudrun-service-labels"location="us-central1"deletion_protection=false # set to "true" in productiontemplate{containers{image="us-docker.pkg.dev/cloudrun/container/hello"}    # Labelslabels={foo:"bar"baz:"quux"}}}

The preceding snippet adds two labels,foo (whose value isbar) andbaz(whose value isquux), to your Cloud Run instance.

Adding the labels undertemplate sets the labels for the revision: onlylabels set for the revision are passed to logs and billing. If you add thelabels to a location other than undertemplate, the label is set for theservice not the revision.

Replace the following:

• name: the name of your service.
• location: the location used for your service.
• image: your container image.
• foo andbaz: your own label names.
• bar andquux: your own label values.

Console

1. In the Google Cloud console, go to the Cloud RunServices page:

   Go to Cloud Run

2. Check the checkbox at the left of the service you are deleting the labelfrom.

3. Make sure theInfo Panel at the far right is toggled on(Show Info Panel).

4. ClickLabels to display the labels pane.

5. Locate the label you want to delete.

6. Hover your cursor to the right of theValue textbox for the label todisplay the trash icon, and click the trash icon.

7. ClickSave.

gcloud

To clear all labels from a service:

gcloudrunservicesupdateSERVICE--clear-labels

To delete specific labels from a service, supply a comma delimited list ofkeys:

gcloudrunservicesupdateSERVICE--remove-labelsLABEL

Replace the following:

• SERVICE: the name of your Cloud Run service
• LABEL: the name of your label