.TH "GCLOUD_BETA_SAAS\-RUNTIME_RELEASES_CREATE" 1



.SH "NAME"
.HP
gcloud beta saas\-runtime releases create \- create a Release



.SH "SYNOPSIS"
.HP
\f5gcloud beta saas\-runtime releases create\fR \fIRELEASE\fR \fB\-\-blueprint\-package\fR=\fIBLUEPRINT_PACKAGE\fR \fB\-\-unit\-kind\fR=\fIUNIT_KIND\fR [\fB\-\-input\-variable\-defaults\fR=[\fItype\fR=\fITYPE\fR],[\fIvalue\fR=\fIVALUE\fR],[\fIvariable\fR=\fIVARIABLE\fR]] [\fB\-\-labels\fR=[\fILABELS\fR,...]] [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-upgradeable\-from\-releases\fR=[\fIUPGRADEABLE_FROM_RELEASES\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Create a Release



.SH "EXAMPLES"

To create the Release, run:

.RS 2m
$ gcloud beta saas\-runtime releases create
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Release resource \- Identifier. The resource name (full URI of the resource)
following the standard naming scheme:

.RS 2m
"projects/{project}/locations/{location}/releases/{release}" This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.
.RE

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5release\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5release\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIRELEASE\fR

ID of the release or fully qualified identifier for the release.

To set the \f5release\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5release\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Blueprints are OCI Images that contain all of the artifacts needed to provision
a unit. Metadata such as, type of the engine used to actuate the blueprint (e.g.
terraform, helm etc) and version will come from the image manifest. If the
hostname is omitted, it will be assumed to be the regional path to Artifact
Registry (eg. us\-east1\-docker.pkg.dev).

This must be specified.


.RS 2m
.TP 2m
\fB\-\-blueprint\-package\fR=\fIBLUEPRINT_PACKAGE\fR

URI to a blueprint used by the Unit.

.RE
.sp
.TP 2m

UnitKind resource \- Reference to the UnitKind this Release corresponds to
(required and immutable once created). 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-unit\-kind\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-unit\-kind\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-unit\-kind\fR=\fIUNIT_KIND\fR

ID of the unitKind or fully qualified identifier for the unitKind.

To set the \f5unit\-kind\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-unit\-kind\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-input\-variable\-defaults\fR=[\fItype\fR=\fITYPE\fR],[\fIvalue\fR=\fIVALUE\fR],[\fIvariable\fR=\fIVARIABLE\fR]

Mapping of input variables to default values. Maximum 100.

.RS 2m
.TP 2m
\fBtype\fR
Name of a supported variable type. Supported types are string, int, bool.

.TP 2m
\fBvalue\fR
String encoded value for the variable.

.TP 2m
\fBvariable\fR
Name of the variable from actuation configs.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-input\-variable\-defaults=type=string,value=string,variable=string \-\-input\-variable\-defaults=type=string,value=string,variable=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-input\-variable\-defaults='[{"type": "string", "value": "string", "variable": "string"}]'
.RE


\fBFile Example:\fR


.RS 2m
\-\-input\-variable\-defaults=path_to_file.(yaml|json)
.RE


.TP 2m
\fB\-\-labels\fR=[\fILABELS\fR,...]

The labels on the resource, which can be used for categorization. similar to
Kubernetes resource labels.

.RS 2m
.TP 2m
\fBKEY\fR
Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers.

.TP 2m
\fBVALUE\fR
Values must contain only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase
characters, and numbers.

.RE
.sp
\fBShorthand Example:\fR


.RS 2m
\-\-labels=string=string
.RE


\fBJSON Example:\fR


.RS 2m
\-\-labels='{"string": "string"}'
.RE


\fBFile Example:\fR


.RS 2m
\-\-labels=path_to_file.(yaml|json)
.RE


.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

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

.TP 2m
\fB\-\-upgradeable\-from\-releases\fR=[\fIUPGRADEABLE_FROM_RELEASES\fR,...]

A list of releases from which a unit can be upgraded to this one (optional). If
left empty no constraints will be applied. When provided, unit upgrade requests
to this release will check and enforce this constraint.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

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



.SH "NOTES"

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