- NAME
-
- gcloud beta saas-runtime flags revisions create - create Flag Revision
- SYNOPSIS
-
-
gcloud beta saas-runtime flags revisions createFLAG_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-flagin thegloballocation, run:gcloud beta saas-runtime flags revisions create my-revision-v1 --flag = my-flag --location = globalTo create a revision using a fully qualified resource name for the revision ID, run:
gcloud beta saas-runtime flags revisions create projects/my-project/locations/global/flagRevisions/my-revision-v1 --flag = my-flagTo create a revision with metadata for tracking, run:
gcloud beta saas-runtime 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
projectattribute:- provide the argument
flag_revisionon the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
flag_revisionon the command line with a fully specified name; - provide the argument
--locationon the command line.
This must be specified.
-
FLAG_REVISION - ID of the flagRevision or fully qualified identifier for the flagRevision.
To set the
flag_revisionattribute:- provide the argument
flag_revisionon the command line.
- provide the argument
- provide the argument
- FlagRevision resource - Flag Revision ID. Google Cloud resource name (full URI
of the resource) following the standard naming scheme:
- 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
projectattribute:- provide the argument
--flagon the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--flagon the command line with a fully specified name; - provide the argument
--locationon the command line.
This must be specified.
-
--flag=FLAG - ID of the flag or fully qualified identifier for the flag.
To set the
flagattribute:- provide the argument
--flagon the command line.
- provide the argument
- provide the argument
- 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.
- 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
KEYvalue. -
VALUE - Sets
VALUEvalue.
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 helpfor details. - API REFERENCE
- This command uses the
saasservicemgmt/v1beta1API. 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.
gcloud beta saas-runtime flags revisions create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

