gcloud: Thu Jul 4 09:30:26 UTC 2024

gcloud/compute/instance-templates/create

@@ -11,6 +11,7 @@ SYNOPSIS
         [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE]
         [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]]
         [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION]
+        [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
         [--disk=[auto-delete=AUTO-DELETE],
           [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]]
         [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking]
@@ -26,6 +27,7 @@ SYNOPSIS
           [interface=INTERFACE],[size=SIZE]]
         [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT]
         [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY]
+        [--max-run-duration=MAX_RUN_DURATION]
         [--metadata=KEY=VALUE,[KEY=VALUE,...]]
         [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]]
         [--min-cpu-platform=PLATFORM] [--min-node-cpu=MIN_NODE_CPU]
@@ -43,6 +45,7 @@ SYNOPSIS
         [--shielded-vtpm] [--source-instance=SOURCE_INSTANCE]
         [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE]
         [--subnet=SUBNET] [--tags=TAG,[TAG,...]]
+        [--termination-time=TERMINATION_TIME]
         [--threads-per-core=THREADS_PER_CORE]
         [--visible-core-count=VISIBLE_CORE_COUNT]
         [--address=ADDRESS | --no-address]
@@ -319,6 +322,20 @@ FLAGS
      --description=DESCRIPTION
         Specifies a textual description for the instance template.
 
+     --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
+        Required to be set to true and only allowed for VMs that have one or
+        more local SSDs, use --instance-termination-action=STOP, and use either
+        --max-run-duration or --termination-time.
+
+        This flag indicates the value that you want Compute Engine to use for
+        the --discard-local-ssd flag in the automatic gcloud compute instances
+        stop command. This flag only supports the true value, which discards
+        local SSD data when automatically stopping this VM during its
+        terminationTimestamp.
+
+        For more information about the --discard-local-ssd flag, see
+        https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
+
      --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]
         Attaches an existing persistent disk to the instances.
 
@@ -471,6 +488,28 @@ FLAGS
          TERMINATE
             The instances should be terminated.
 
+     --max-run-duration=MAX_RUN_DURATION
+        Limits how long this VM instance can run, specified as a duration
+        relative to the last time when the VM began running. Format the
+        duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and
+        seconds followed by d, h, m, and s respectively. For example, specify
+        30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of
+        1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a
+        timestamp, use --termination-time instead.
+
+        If neither --max-run-duration nor --termination-time is specified
+        (default), the VM instance runs until prompted by a user action or
+        system event. If either is specified, the VM instance is scheduled to
+        be automatically terminated at the VM's termination timestamp
+        (terminationTimestamp) using the action specified by
+        --instance-termination-action.
+
+        Note: The terminationTimestamp is removed whenever the VM is stopped or
+        suspended and redefined whenever the VM is rerun. For
+        --max-run-duration specifically, the terminationTimestamp is the sum of
+        MAX_RUN_DURATION and the time when the VM last entered the RUNNING
+        state, which changes whenever the VM is rerun.
+
      --metadata=KEY=VALUE,[KEY=VALUE,...]
         Metadata to be made available to the guest operating system running on
         the instances. Each metadata entry is a key/value pair separated by an
@@ -799,6 +838,25 @@ FLAGS
 
             $ gcloud compute instances list --filter='tags:tag1'
 
+     --termination-time=TERMINATION_TIME
+        Limits how long this VM instance can run, specified as a time. Format
+        the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more
+        information, see https://tools.ietf.org/html/rfc3339. Alternatively, to
+        specify a duration, use --max-run-duration instead.
+
+        If neither --termination-time nor --max-run-duration is specified
+        (default), the VM instance runs until prompted by a user action or
+        system event. If either is specified, the VM instance is scheduled to
+        be automatically terminated at the VM's termination timestamp
+        (terminationTimestamp) using the action specified by
+        --instance-termination-action.
+
+        Note: The terminationTimestamp is removed whenever the VM is stopped or
+        suspended and redefined whenever the VM is rerun. For
+        --termination-time specifically, the terminationTimestamp remains the
+        same whenever the VM is rerun, but any requests to rerun the VM fail if
+        the specified timestamp is in the past.
+
      --threads-per-core=THREADS_PER_CORE
         The number of visible threads per physical core. To disable
         simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or