gcloud: Wed Dec 11 10:18:23 UTC 2024

gcloud/beta/compute/instances/create

@@ -23,6 +23,8 @@ SYNOPSIS
         [--[no-]enable-uefi-networking] [--erase-windows-vss-signature]
         [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS]
         [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH]
+        [--graceful-shutdown]
+        [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION]
         [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS]
         [--hostname=HOSTNAME]
         [--instance-termination-action=INSTANCE_TERMINATION_ACTION]
@@ -511,6 +513,17 @@ FLAGS
         be used together with --external-ipv6-address. Only the /96 IP address
         range is supported, and the default value is 96.
 
+     --graceful-shutdown
+        Enables graceful shutdown for the instance.
+
+     --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION
+        Specifies the maximum time for the graceful shutdown. After this time,
+        the instance is set to STOPPING even if tasks are still running.
+        Specify the time as the number of hours, minutes, or seconds followed
+        by h, m, and s respectively. For example, specify 30m for 30 minutes or
+        20m10s for 20 minutes and 10 seconds. The value must be between 1
+        second and 1 hour.
+
      --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS
         The timeout in seconds for host error detection. The value must be set
         with 30 second increments, with a range of 90 to 330 seconds. If unset,

gcloud/beta/compute/instances/delete

@@ -4,7 +4,8 @@ NAME
 
 SYNOPSIS
     gcloud beta compute instances delete INSTANCE_NAMES [INSTANCE_NAMES ...]
-        [--zone=ZONE] [--delete-disks=DISK_TYPE | --keep-disks=DISK_TYPE]
+        [--no-graceful-shutdown] [--zone=ZONE]
+        [--delete-disks=DISK_TYPE | --keep-disks=DISK_TYPE]
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
@@ -25,6 +26,11 @@ POSITIONAL ARGUMENTS
         https://cloud.google.com/compute/docs/reference/rest/v1/instances
 
 FLAGS
+     --no-graceful-shutdown
+        Deletes the instance immediately without gracefully shutting it down.
+        If a graceful shutdown is in progress, then the instance is forcefully
+        stopped and deleted.
+
      --zone=ZONE
         Zone of the instances to delete. If not specified, you might be
         prompted to select a zone (interactive mode only). gcloud attempts to

gcloud/beta/compute/instances/ops-agents/policies/create

@@ -249,6 +249,7 @@ REQUIRED FLAGS
             ubuntu             23.04
             ubuntu             23.10
             ubuntu             24.04
+            ubuntu             24.10
             windows            10.*
             windows            6.*
 

gcloud/beta/compute/instances/ops-agents/policies/update

@@ -286,6 +286,7 @@ FLAGS
             ubuntu             23.04
             ubuntu             23.10
             ubuntu             24.04
+            ubuntu             24.10
             windows            10.*
             windows            6.*
 

gcloud/beta/compute/instances/set-scheduling

@@ -4,7 +4,8 @@ NAME
 
 SYNOPSIS
     gcloud beta compute instances set-scheduling INSTANCE_NAME
-        [--clear-min-node-cpu]
+        [--clear-min-node-cpu] [--[no-]graceful-shutdown]
+        [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION]
         [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS]
         [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT]
         [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU]
@@ -43,6 +44,18 @@ FLAGS
         instance min-node-cpu will be cleared. The instance will not be
         overcommitted and utilize the full CPU count assigned.
 
+     --[no-]graceful-shutdown
+        Enables or disables graceful shutdown for the instance. Use
+        --graceful-shutdown to enable and --no-graceful-shutdown to disable.
+
+     --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION
+        Specifies the maximum time for the graceful shutdown. After this time,
+        the instance is set to STOPPING even if tasks are still running.
+        Specify the time as the number of hours, minutes, or seconds followed
+        by h, m, and s respectively. For example, specify 30m for 30 minutes or
+        20m10s for 20 minutes and 10 seconds. The value must be between 1
+        second and 1 hour.
+
      --host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS
         The timeout in seconds for host error detection. The value must be set
         with 30 second increments, with a range of 90 to 330 seconds. If unset,

gcloud/beta/compute/instances/stop

@@ -3,8 +3,8 @@ NAME
 
 SYNOPSIS
     gcloud beta compute instances stop INSTANCE_NAMES [INSTANCE_NAMES ...]
-        [--async] [--discard-local-ssd[=DISCARD_LOCAL_SSD]] [--zone=ZONE]
-        [GCLOUD_WIDE_FLAG ...]
+        [--async] [--discard-local-ssd[=DISCARD_LOCAL_SSD]]
+        [--no-graceful-shutdown] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (BETA) gcloud beta compute instances stop is used to stop a Compute Engine
@@ -52,6 +52,11 @@ FLAGS
      --discard-local-ssd[=DISCARD_LOCAL_SSD]
         If set to true, local SSD data is discarded.
 
+     --no-graceful-shutdown
+        Stops the instance immediately without gracefully shutting it down. If
+        a graceful shutdown is in progress, then the instance is forcefully
+        stopped.
+
      --zone=ZONE
         Zone of the instances to operate on. If not specified, you might be
         prompted to select a zone (interactive mode only). gcloud attempts to

gcloud/beta/compute/instances/update

@@ -5,6 +5,8 @@ NAME
 SYNOPSIS
     gcloud beta compute instances update INSTANCE_NAME
         [--[no-]deletion-protection] [--[no-]enable-display-device]
+        [--[no-]graceful-shutdown]
+        [--graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION]
         [--min-cpu-platform=PLATFORM]
         [--partner-metadata=[NAMESPACE/KEY=VALUE,...]]
         [--partner-metadata-from-file=LOCAL_FILE_PATH]
@@ -55,6 +57,18 @@ FLAGS
         Enable a display device on VM instances. Use --enable-display-device to
         enable and --no-enable-display-device to disable.
 
+     --[no-]graceful-shutdown
+        Enables or disables graceful shutdown for the instance. Use
+        --graceful-shutdown to enable and --no-graceful-shutdown to disable.
+
+     --graceful-shutdown-max-duration=GRACEFUL_SHUTDOWN_MAX_DURATION
+        Specifies the maximum time for the graceful shutdown. After this time,
+        the instance is set to STOPPING even if tasks are still running.
+        Specify the time as the number of hours, minutes, or seconds followed
+        by h, m, and s respectively. For example, specify 30m for 30 minutes or
+        20m10s for 20 minutes and 10 seconds. The value must be between 1
+        second and 1 hour.
+
      --min-cpu-platform=PLATFORM
         When specified, the VM will be scheduled on host with specified CPU
         architecture or a newer one. To list available CPU platforms in given