gcloud-help/gcloud/beta/saas-runtime/flags/attributes/update

NAME
    gcloud beta saas-runtime flags attributes update - update Flag Attribute

SYNOPSIS
    gcloud beta saas-runtime flags attributes update
        (FLAG_ATTRIBUTE : --location=LOCATION)
        [--annotations=[ANNOTATIONS,...]
          | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations
          | --remove-annotations=REMOVE_ANNOTATIONS]
        [--labels=[LABELS,...]
          | --update-labels=[UPDATE_LABELS,...] --clear-labels
          | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Update the metadata of a Flag Attribute. This command allows you to
    modify labels and annotations associated with the resource.

    Flag Attributes are foundational resources that define the evaluation
    context such as 'userID', 'tenantID', or 'region' used by targeting rules
    and randomization algorithms to determine flag values.

    Note that core fields like the attribute key and value type are immutable
    after creation to maintain evaluation consistency across your service. This
    command is primarily used for categorization via labels or for attaching
    audit metadata via annotations.

EXAMPLES
    To update labels and annotations for a flag attribute, run:

        $ gcloud beta saas-runtime flags attributes update my-attribute \
          --location=global --labels=env=prod --annotations=ticket=123

POSITIONAL ARGUMENTS
     FlagAttribute resource - Flag Attribute ID. Flag Attribute ID. Google
     Cloud resource name (full URI of the resource) following the standard
     naming scheme:

         "projects/{project}/locations/{location}/flagAttributes/{flag_attribute_id}" The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

     To set the project attribute:
      ◆ provide the argument flag_attribute on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     This must be specified.

       FLAG_ATTRIBUTE
          ID of the flagAttribute or fully qualified identifier for the
          flagAttribute.

          To set the flag_attribute attribute:
          ▸ provide the argument flag_attribute on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --location=LOCATION
          Location ID

          To set the location attribute:
          ▸ provide the argument flag_attribute on the command line with a
            fully specified name;
          ▸ provide the argument --location on the command line.

FLAGS
     Update annotations.

     At most one of these can be specified:

       --annotations=[ANNOTATIONS,...]
          Set annotations to new value. Annotations is an unstructured
          key-value map stored with a resource that may be set by external
          tools to store and retrieve arbitrary metadata. They are not
          queryable and should be preserved when modifying objects.

           KEY
              Sets KEY value.

           VALUE
              Sets VALUE value.

          Shorthand Example:

              --annotations=string=string

          JSON Example:

              --annotations='{"string": "string"}'

          File Example:

              --annotations=path_to_file.(yaml|json)

       Or at least one of these can be specified:

         --update-annotations=[UPDATE_ANNOTATIONS,...]
            Update annotations value or add key value pair. Annotations is an
            unstructured key-value map stored with a resource that may be set
            by external tools to store and retrieve arbitrary metadata. They
            are not queryable and should be preserved when modifying objects.

             KEY
                Sets KEY value.

             VALUE
                Sets VALUE value.

            Shorthand Example:

                --update-annotations=string=string

            JSON Example:

                --update-annotations='{"string": "string"}'

            File Example:

                --update-annotations=path_to_file.(yaml|json)

         At most one of these can be specified:

           --clear-annotations
              Clear annotations value and set to empty map.

           --remove-annotations=REMOVE_ANNOTATIONS
              Remove existing value from map annotations. Sets
              remove_annotations value.

              Shorthand Example:

                  --remove-annotations=string,string

              JSON Example:

                  --remove-annotations=["string"]

              File Example:

                  --remove-annotations=path_to_file.(yaml|json)

     Update labels.

     At most one of these can be specified:

       --labels=[LABELS,...]
          Set labels to new value. The labels on the resource, which can be
          used for categorization.

           KEY
              Keys must start with a lowercase character and contain only
              hyphens (-), underscores (_), lowercase characters, and numbers.

           VALUE
              Values must contain only hyphens (-), underscores (_), lowercase
              characters, and numbers.

          Shorthand Example:

              --labels=string=string

          JSON Example:

              --labels='{"string": "string"}'

          File Example:

              --labels=path_to_file.(yaml|json)

       Or at least one of these can be specified:

         --update-labels=[UPDATE_LABELS,...]
            Update labels value or add key value pair. The labels on the
            resource, which can be used for categorization.

             KEY
                Keys must start with a lowercase character and contain only
                hyphens (-), underscores (_), lowercase characters, and
                numbers.

             VALUE
                Values must contain only hyphens (-), underscores (_),
                lowercase characters, and numbers.

            Shorthand Example:

                --update-labels=string=string

            JSON Example:

                --update-labels='{"string": "string"}'

            File Example:

                --update-labels=path_to_file.(yaml|json)

         At most one of these can be specified:

           --clear-labels
              Clear labels value and set to empty map.

           --remove-labels=REMOVE_LABELS
              Remove existing value from map labels. Sets remove_labels value.

              Shorthand Example:

                  --remove-labels=string,string

              JSON Example:

                  --remove-labels=["string"]

              File Example:

                  --remove-labels=path_to_file.(yaml|json)

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

API REFERENCE
    This command uses the saasservicemgmt/v1beta1 API. The full documentation
    for this API can be found at: https://cloud.google.com/saas-runtime/docs

NOTES
    This command is currently in beta and might change without notice.