gcloud: Sat Jun 14 05:31:37 UTC 2025

gcloud/beta/workstations/configs/create

@@ -23,10 +23,8 @@ SYNOPSIS
         [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]]
         [--machine-type=MACHINE_TYPE; default="e2-standard-4"]
         [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT]
-        [--network-tags=[NETWORK_TAGS,...]]
-        [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"]
-        [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"]
-        [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]]
+        [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE]
+        [--replica-zones=[REPLICA_ZONES,...]]
         [--running-timeout=RUNNING_TIMEOUT; default=7200]
         [--service-account=SERVICE_ACCOUNT]
         [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]]
@@ -38,7 +36,9 @@ SYNOPSIS
           | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE;
           default="codeoss"]
         [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT]
-        [--pd-disk-size=PD_DISK_SIZE; default=200
+        [--no-persistent-storage | --pd-disk-type=PD_DISK_TYPE;
+          default="pd-standard" --pd-reclaim-policy=PD_RECLAIM_POLICY;
+          default="delete" --pd-disk-size=PD_DISK_SIZE; default=200
           | --pd-source-snapshot=PD_SOURCE_SNAPSHOT] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
@@ -272,7 +272,37 @@ FLAGS
         the root VM.
 
      --ephemeral-directory=[PROPERTY=VALUE,...]
-        Ephemeral directory which won't persist across workstation sessions.
+        Ephemeral directory which won't persist across workstation sessions. An
+        ephemeral directory is backed by a Compute Engine persistent disk whose
+        mount-path, source-snapshot, source-image, and read-only are
+        configurable.
+
+         mount-path
+            Location of this directory in the running workstation.
+
+         source-snapshot
+            Name of the snapshot to use as the source for the disk. Must be
+            empty if [source_image][] is set. Must be empty if [read_only][] is
+            false. Updating [source_snapshot][] will update content in the
+            ephemeral directory after the workstation is restarted.
+
+         source-image
+            Name of the disk image to use as the source for the disk. Must be
+            empty if [source_snapshot][] is set. Updating [source_image][] will
+            update content in the ephemeral directory after the workstation is
+            restarted.
+
+         read-only
+            Whether the disk is read only. If true, the disk may be shared by
+            multiple VMs and [source_snapshot][] must be set. Set to false when
+            not specified and true when specified.
+
+            Example:
+
+                $ gcloud beta workstations configs create \
+                    --ephemeral-directory="mount-path=/home2,disk-type=pd-balanced,s\
+                ource-snapshot=projects/my-project/global/snapshots/snapshot,read-on\
+                ly=true"
 
      --grant-workstation-admin-role-on-create
         Default value is false. If set, creator of a workstation will get
@@ -313,20 +343,6 @@ FLAGS
 
             $ gcloud beta workstations configs create --network-tags=tag_1,tag_2
 
-     --pd-disk-type=PD_DISK_TYPE; default="pd-standard"
-        Type of the persistent directory. PD_DISK_TYPE must be one of:
-        pd-standard, pd-balanced, pd-ssd.
-
-     --pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"
-        What should happen to the disk after the Workstation is deleted.
-        PD_RECLAIM_POLICY must be one of:
-
-         delete
-            The persistent disk will be deleted with the Workstation.
-         retain
-            The persistent disk will be remain after the workstation is deleted
-            and the administrator must manually delete the disk.
-
      --pool-size=POOL_SIZE
         Number of instances to pool for faster Workstation startup.
 
@@ -441,12 +457,34 @@ FLAGS
 
      At most one of these can be specified:
 
-       --pd-disk-size=PD_DISK_SIZE; default=200
-          Size of the persistent directory in GB. PD_DISK_SIZE must be one of:
-          10, 50, 100, 200, 500, 1000.
+       --no-persistent-storage
+          If set, workstations under this configuration will not have a
+          persistent directory.
 
-       --pd-source-snapshot=PD_SOURCE_SNAPSHOT
-          Name of the snapshot to use as the source for the home disk.
+       Persistent directory configuration.
+
+         --pd-disk-type=PD_DISK_TYPE; default="pd-standard"
+            Type of the persistent directory. PD_DISK_TYPE must be one of:
+            pd-standard, pd-balanced, pd-ssd.
+
+         --pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"
+            What should happen to the disk after the Workstation is deleted.
+            PD_RECLAIM_POLICY must be one of:
+
+             delete
+                The persistent disk will be deleted with the Workstation.
+             retain
+                The persistent disk will be remain after the workstation is
+                deleted and the administrator must manually delete the disk.
+
+         At most one of these can be specified:
+
+           --pd-disk-size=PD_DISK_SIZE; default=200
+              Size of the persistent directory in GB. PD_DISK_SIZE must be one
+              of: 10, 50, 100, 200, 500, 1000.
+
+           --pd-source-snapshot=PD_SOURCE_SNAPSHOT
+              Name of the snapshot to use as the source for the home disk.
 
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,