.TH "GCLOUD_IMMERSIVE\-STREAM_XR_INSTANCES_CREATE" 1



.SH "NAME"
.HP
gcloud immersive\-stream xr instances create \- create an Immersive Stream for XR service instance



.SH "SYNOPSIS"
.HP
\f5gcloud immersive\-stream xr instances create\fR \fIINSTANCE\fR \fB\-\-add\-region\fR=[\fIautoscaling_buffer\fR=\fIAUTOSCALING_BUFFER\fR],[\fIautoscaling_min_capacity\fR=\fIAUTOSCALING_MIN_CAPACITY\fR],[\fIcapacity\fR=\fICAPACITY\fR],[\fIenable_autoscaling\fR=\fIENABLE_AUTOSCALING\fR],[\fIregion\fR=\fIREGION\fR] \fB\-\-version\fR=\fIVERSION\fR (\fB\-\-content\fR=\fICONTENT\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\fR] [\fB\-\-fallback\-url\fR=\fIFALLBACK_URL\fR] [\fB\-\-gpu\-class\fR=\fIGPU_CLASS\fR] [\fB\-\-mode\fR=\fIMODE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Create an Immersive Stream for XR service instance.



.SH "EXAMPLES"

To create a service instance called \f5my\-instance\fR serving content
\f5my\-content\fR with version \f5my\-version\fR that has availablilty for 2
concurent sessions in us\-west1 region and 3 concurrent sessions in us\-east4
region, run:

.RS 2m
$ gcloud immersive\-stream xr instances create my\-instance \e
    \-\-content=my\-content \-\-version=my\-version \e
    \-\-add\-region=region=us\-west1,capacity=2 \e
    \-\-add\-region=region=us\-east4,capacity=3
.RE

Optionally, a fallback url may be specified. Users will be redirected to this
fallback url when the service instance is unable to provide the streaming
experience. To create a service instance called \f5my\-instance\fR serving
content \f5my\-content\fR with version \f5my\-version\fR that has availablilty
for 2 concurent sessions in us\-west1 and uses fallback url
\f5https://www.google.com\fR run:

.RS 2m
$ gcloud immersive\-stream xr instances create my\-instance \e
    \-\-content=my\-content \-\-version=my\-version \e
    \-\-add\-region=region=us\-west1,capacity=2 \e
    \-\-fallback\-url="https://www.google.com"
.RE

.RS 2m
By default, the instance is created with mode=ar, which supports both
3D and AR experiences. Instances can also be configured to use
3D\-only mode. This configuration cannot be updated later.
To use 3D\-only mode, include:
.RE

.RS 2m
\-\-mode=3d
.RE

.RS 2m
By default, the instance is created with gpu\-class=t4. This uses the
NVIDIA T4 GPU for the instance. Instances can also be configured to
use NVIDIA L4 GPUs at creation. Note that only certain regions are
available for L4, and only 3D\-only mode is supported. This
configuration cannot be updated later.
To use NVIDIA L4 GPU for the instance, include:
.RE

.RS 2m
\-\-gpu\-class=l4
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIINSTANCE\fR

Name of the instance to be created


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-add\-region\fR=[\fIautoscaling_buffer\fR=\fIAUTOSCALING_BUFFER\fR],[\fIautoscaling_min_capacity\fR=\fIAUTOSCALING_MIN_CAPACITY\fR],[\fIcapacity\fR=\fICAPACITY\fR],[\fIenable_autoscaling\fR=\fIENABLE_AUTOSCALING\fR],[\fIregion\fR=\fIREGION\fR]

Flag used to specify region and capacity required for the service instance's
availability.

.RS 2m
'region' is the region in which the instance is deployed.
.RE

.RS 2m
'capacity' is the maxium number of concurrent streaming sessions that the instance can support in the given region.
.RE

This is a repeatable flag.

.TP 2m
\fB\-\-version\fR=\fIVERSION\fR

Build version tag of the content served by this instance

.TP 2m

Content resource \- Immersive Stream for XR content resource served by the
instance. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-content\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

This must be specified.


.RS 2m
.TP 2m
\fB\-\-content\fR=\fICONTENT\fR

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

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

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

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

Google Cloud location for the content.

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


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-fallback\-url\fR=\fIFALLBACK_URL\fR

Fallback url to redirect users to when this service instance is unable to
provide the streaming experience

.TP 2m
\fB\-\-gpu\-class\fR=\fIGPU_CLASS\fR

The class of GPU that is used by this service instance

.TP 2m
\fB\-\-mode\fR=\fIMODE\fR

The rendering mode that is supported by this service instance


.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 "NOTES"

This variant is also available:

.RS 2m
$ gcloud alpha immersive\-stream xr instances create
.RE