gcloud-help/gcloud/beta/app-lifecycle-manager/flags/revisions/create

NAME
    gcloud beta app-lifecycle-manager flags revisions create - create Flag
        Revision

SYNOPSIS
    gcloud beta app-lifecycle-manager flags revisions create FLAG_REVISION
        --flag=FLAG [--annotations=[ANNOTATIONS,...]] [--labels=[LABELS,...]]
        [--location=LOCATION] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Create a new flag revision resource. Flag revisions act as immutable
    snapshots of a flag's configuration (variants, rules, and allocations) at a
    specific point in time.

    This snapshot is a required prerequisite for creating a Flag Release and
    initiating a Flag Rollout. Creating a revision ensures that the
    configuration state is frozen and safely decoupled from the live flag
    definition during the rollout process.

EXAMPLES
    To create a Flag Revision for a flag named my-flag in the global location,
    run:

        $ gcloud beta app-lifecycle-manager flags revisions create \
          my-revision-v1 --flag=my-flag --location=global

    To create a revision using a fully qualified resource name for the revision
    ID, run:

        $ gcloud beta app-lifecycle-manager flags revisions create \
          projects/my-project/locations/global/flagRevisions/\
        my-revision-v1 --flag=my-flag

    To create a revision with metadata for tracking, run:

        $ gcloud beta app-lifecycle-manager flags revisions create \
          prod-ready-rev --flag=search-optimizations \
          --location=us-central1 --labels=env=prod,owner=search-team \
          --annotations=ticket=123

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

         "projects/{project}/locations/{location}/flagRevisions/{flag_revision_id}" This represents a Cloud 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_revision on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

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

     This must be specified.

       FLAG_REVISION
          ID of the flagRevision or fully qualified identifier for the
          flagRevision.

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

REQUIRED FLAGS
     Flag resource - Name (ID) of the Flag this is a revision of. This
     represents a Cloud 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.

     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.

     This must be specified.

       --flag=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.

OPTIONAL FLAGS
     --annotations=[ANNOTATIONS,...]
        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)

     --labels=[LABELS,...]
        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)

     --location=LOCATION
        For resources [flag, flag_revision], provides fallback value for
        resource location attribute. When the resource's full URI path is not
        provided, location will fallback to this flag value.

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.