gcloud-help/gcloud/alpha/immersive-stream/xr/instances/create

NAME
    gcloud alpha immersive-stream xr instances create - create an Immersive
        Stream for XR service instance

SYNOPSIS
    gcloud alpha immersive-stream xr instances create INSTANCE
        --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],
          [autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],
          [capacity=CAPACITY],
          [enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION]
        --version=VERSION (--content=CONTENT : --location=LOCATION) [--async]
        [--fallback-url=FALLBACK_URL] [--gpu-class=GPU_CLASS] [--mode=MODE]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create an Immersive Stream for XR service instance.

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

        $ gcloud alpha immersive-stream xr instances create my-instance \
            --content=my-content --version=my-version \
            --add-region=region=us-west1,capacity=2 \
            --add-region=region=us-east4,capacity=3

    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 my-instance
    serving content my-content with version my-version that has availablilty
    for 2 concurent sessions in us-west1 and uses fallback url
    https://www.google.com run:

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

        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:

        --mode=3d

        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:

        --gpu-class=l4

POSITIONAL ARGUMENTS
     INSTANCE
        Name of the instance to be created

REQUIRED FLAGS
     --add-region=[autoscaling_buffer=AUTOSCALING_BUFFER],[autoscaling_min_capacity=AUTOSCALING_MIN_CAPACITY],[capacity=CAPACITY],[enable_autoscaling=ENABLE_AUTOSCALING],[region=REGION]
        Flag used to specify region and capacity required for the service
        instance's availability.

            'region' is the region in which the instance is deployed.

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

        This is a repeatable flag.

     --version=VERSION
        Build version tag of the content served by this instance

     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 project attribute:
      ◆ provide the argument --content 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.

       --content=CONTENT
          ID of the content or fully qualified identifier for the content.

          To set the name attribute:
          ▸ provide the argument --content on the command line.

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

       --location=LOCATION
          Google Cloud location for the content.

          To set the location attribute:
          ▸ provide the argument --content on the command line with a fully
            specified name;
          ▸ provide the argument --location on the command line;
          ▸ location is always global.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --fallback-url=FALLBACK_URL
        Fallback url to redirect users to when this service instance is unable
        to provide the streaming experience

     --gpu-class=GPU_CLASS
        The class of GPU that is used by this service instance

     --mode=MODE
        The rendering mode that is supported by this service instance

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.

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. This variant is also available:

        $ gcloud immersive-stream xr instances create