gcloud-help/gcloud/beta/app-lifecycle-manager/flags/update

NAME
    gcloud beta app-lifecycle-manager flags update - update Flag

SYNOPSIS
    gcloud beta app-lifecycle-manager flags update (FLAG : --location=LOCATION)
        [--evaluation-spec=[defaultTarget=DEFAULTTARGET],[variants=VARIANTS]]
        [--state=STATE]
        [--variants=[booleanValue=BOOLEANVALUE],[description=DESCRIPTION],
          [doubleValue=DOUBLEVALUE],
          [id=ID],[integerValue=INTEGERVALUE],[stringValue=STRINGVALUE]]
        [--annotations=[ANNOTATIONS,...]
          | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations
          | --remove-annotations=REMOVE_ANNOTATIONS]
        [--clear-description | --description=DESCRIPTION]
        [--clear-flag-set | --flag-set=FLAG_SET]
        [--labels=[LABELS,...]
          | --update-labels=[UPDATE_LABELS,...] --clear-labels
          | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Update a Flag

EXAMPLES
    To update a Flag, run:

        $ gcloud beta app-lifecycle-manager flags update

POSITIONAL ARGUMENTS
     Flag resource - ID of the Flag:

         "projects/{project}/locations/{location}/flags/{flag_id}"

     This follows the standard Google Cloud naming scheme (URI). 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 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
          ID of the flag or fully qualified identifier for the flag.

          To set the flag attribute:
          ▸ provide the argument flag 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 on the command line with a fully
            specified name;
          ▸ provide the argument --location on the command line.

FLAGS
     --evaluation-spec=[defaultTarget=DEFAULTTARGET],[variants=VARIANTS]
        Specification of how the Flag value should be evaluated.

         defaultTarget
            Default variant for the flag.

         variants
            A list of variants. Variant is an identifier for a value (name
            assigned to a value).

             boolValue
                Value is a single boolean flag value for the variant.

             name
                Name of the variant. Max length: 128 bytes.

        Shorthand Example:

            --evaluation-spec=defaultTarget=string,variants=[{boolValue=boolean,name=string}]

        JSON Example:

            --evaluation-spec='{"defaultTarget": "string", "variants": [{"boolValue": boolean, "name": "string"}]}'

        File Example:

            --evaluation-spec=path_to_file.(yaml|json)

     --state=STATE
        Current state of the flag. STATE must be one of:

         active
            The flag is in the active state.
         cleanup
            The flag is in the cleanup state and ready to be deleted.
         in-development
            The flag is currently in the in-development state.
         sunsetting
            The flag is in the sunsetting state, indicating it is being phased
            out.

     --variants=[booleanValue=BOOLEANVALUE],[description=DESCRIPTION],[doubleValue=DOUBLEVALUE],[id=ID],[integerValue=INTEGERVALUE],[stringValue=STRINGVALUE]
        A list of variants. Variant is an identifier for a value (name assigned
        to a value).

         booleanValue
            Value is a single boolean flag value for the variant.

         description
            A description of the variant. Max length: 500 bytes.

         doubleValue
            Value is a single double flag value for the variant.

         id
            Id of the variant. Max length: 128 bytes.

         integerValue
            Value is a single integer flag value for the variant.

         stringValue
            Value is a single string flag value for the variant. Max length:
            500 bytes.

        Shorthand Example:

            --variants=booleanValue=boolean,description=string,doubleValue=float,id=string,integerValue=int,stringValue=string --variants=booleanValue=boolean,description=string,doubleValue=float,id=string,integerValue=int,stringValue=string

        JSON Example:

            --variants='[{"booleanValue": boolean, "description": "string", "doubleValue": float, "id": "string", "integerValue": int, "stringValue": "string"}]'

        File Example:

            --variants=path_to_file.(yaml|json)

     Update annotations.

     At most one of these can be specified:

       --annotations=[ANNOTATIONS,...]
          Set annotations to new value. Unstructured key-value map stored with
          a resource that may be set by external tools to store and retrieve
          arbitrary metadata. Annotations 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. Unstructured
            key-value map stored with a resource that may be set by external
            tools to store and retrieve arbitrary metadata. Annotations 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 description.

     At most one of these can be specified:

       --clear-description
          Clear description value and set to null.

       --description=DESCRIPTION
          Set description to new value.

     Update flag_set.

     At most one of these can be specified:

       --clear-flag-set
          Clear flag_set value and set to null.

       --flag-set=FLAG_SET
          Set flag_set to new value.

     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.