gcloud: Wed Dec 11 10:18:23 UTC 2024

gcloud/eventarc/triggers/create

@@ -184,7 +184,12 @@ OPTIONAL FLAGS
         resourceName attribute for Cloud Audit Log events.
 
      --labels=[KEY=VALUE,...]
-        Labels to apply to the trigger.
+        List of label KEY=VALUE pairs to add.
+
+        Keys must start with a lowercase character and contain only hyphens
+        (-), underscores (_), lowercase characters, and numbers. Values must
+        contain only hyphens (-), underscores (_), lowercase characters, and
+        numbers.
 
      --service-account=SERVICE_ACCOUNT
         The IAM service account email associated with the trigger.

gcloud/eventarc/triggers/update

@@ -6,7 +6,8 @@ SYNOPSIS
         [--event-data-content-type=EVENT_DATA_CONTENT_TYPE]
         [--event-filters=[ATTRIBUTE=VALUE,...]]
         [--event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...]]
-        [--labels=[KEY=VALUE,...]]
+        [--update-labels=[KEY=VALUE,...]]
+        [--clear-labels | --remove-labels=[KEY,...]]
         [--clear-service-account | --service-account=SERVICE_ACCOUNT]
         [--destination-gke-namespace=DESTINATION_GKE_NAMESPACE
           --destination-gke-service=DESTINATION_GKE_SERVICE
@@ -87,8 +88,34 @@ FLAGS
         destination. Currently, path pattern format is only available for the
         resourceName attribute for Cloud Audit Log events.
 
-     --labels=[KEY=VALUE,...]
-        Labels to apply to the trigger.
+     --update-labels=[KEY=VALUE,...]
+        List of label KEY=VALUE pairs to update. If a label exists, its value
+        is modified. Otherwise, a new label is created.
+
+        Keys must start with a lowercase character and contain only hyphens
+        (-), underscores (_), lowercase characters, and numbers. Values must
+        contain only hyphens (-), underscores (_), lowercase characters, and
+        numbers.
+
+     At most one of these can be specified:
+
+       --clear-labels
+          Remove all labels. If --update-labels is also specified then
+          --clear-labels is applied first.
+
+          For example, to remove all labels:
+
+              $ gcloud eventarc triggers update --clear-labels
+
+          To remove all existing labels and create two new labels, foo and baz:
+
+              $ gcloud eventarc triggers update --clear-labels \
+                --update-labels foo=bar,baz=qux
+
+       --remove-labels=[KEY,...]
+          List of label keys to remove. If a label does not exist it is
+          silently ignored. If --update-labels is also specified then
+          --update-labels is applied first.
 
      At most one of these can be specified: