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

gcloud/beta/compute/instances/create-with-container

@@ -24,6 +24,7 @@ SYNOPSIS
         [--container-restart-policy=POLICY; default="always"]
         [--container-stdin] [--container-tty]
         [--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],
           [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]]
         [--[no-]enable-nested-virtualization]
@@ -37,6 +38,7 @@ SYNOPSIS
         [--local-ssd=[device-name=DEVICE-NAME],[interface=INTERFACE]]
         [--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] [--network=NETWORK]
@@ -50,6 +52,7 @@ SYNOPSIS
         [--shielded-integrity-monitoring] [--shielded-secure-boot]
         [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE]
         [--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] [--zone=ZONE]
         [--address=ADDRESS | --no-address]
@@ -392,6 +395,20 @@ FLAGS
      --description=DESCRIPTION
         Specifies a textual description of the instances.
 
+     --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],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]
         Attaches an existing persistent disk to the instances.
 
@@ -539,6 +556,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
@@ -814,6 +853,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

gcloud/beta/compute/instances/help

@@ -32,7 +32,7 @@ GROUPS
         interfaces.
 
      ops-agents
-        (BETA) Manage Operation Suite (Ops) agents for Compute Engine VM
+        (BETA) Manage Google Cloud Observability agents for Compute Engine VM
         instances.
 
      os-inventory

gcloud/beta/compute/instances/ops-agents/help

@@ -1,12 +1,13 @@
 NAME
-    gcloud beta compute instances ops-agents - manage Operation Suite (Ops)
-        agents for Compute Engine VM instances
+    gcloud beta compute instances ops-agents - manage Google Cloud
+        Observability agents for Compute Engine VM instances
 
 SYNOPSIS
     gcloud beta compute instances ops-agents GROUP [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (BETA) Manage Operation Suite (Ops) agents for Compute Engine VM instances.
+    (BETA) Manage Google Cloud Observability agents for Compute Engine VM
+    instances.
 
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --help.
@@ -17,7 +18,7 @@ GROUPS
     GROUP is one of the following:
 
      policies
-        (BETA) Manage Operation Suite (Ops) agents policies that install,
+        (BETA) Manage Google Cloud Observability agents policies that install,
         update, and uninstall agents for Compute Engine VM instances.
 
 NOTES

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

@@ -343,8 +343,10 @@ GCLOUD WIDE FLAGS
     Run $ gcloud help for details.
 
 NOTES
-    This command is currently in beta and might change without notice. This
-    variant is also available:
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud compute instances ops-agents policies create
 
         $ gcloud alpha compute instances ops-agents policies create
 

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

@@ -46,8 +46,10 @@ GCLOUD WIDE FLAGS
     Run $ gcloud help for details.
 
 NOTES
-    This command is currently in beta and might change without notice. This
-    variant is also available:
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud compute instances ops-agents policies delete
 
         $ gcloud alpha compute instances ops-agents policies delete
 

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

@@ -62,8 +62,10 @@ GCLOUD WIDE FLAGS
     Run $ gcloud help for details.
 
 NOTES
-    This command is currently in beta and might change without notice. This
-    variant is also available:
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud compute instances ops-agents policies describe
 
         $ gcloud alpha compute instances ops-agents policies describe
 

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

@@ -1,15 +1,15 @@
 NAME
-    gcloud beta compute instances ops-agents policies - manage Operation Suite
-        (Ops) agents policies that install, update, and uninstall agents for
-        Compute Engine VM instances
+    gcloud beta compute instances ops-agents policies - manage Google Cloud
+        Observability agents policies that install, update, and uninstall
+        agents for Compute Engine VM instances
 
 SYNOPSIS
     gcloud beta compute instances ops-agents policies COMMAND
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (BETA) Manage Operation Suite (Ops) agents policies that install, update,
-    and uninstall agents for Compute Engine VM instances.
+    (BETA) Manage Google Cloud Observability agents policies that install,
+    update, and uninstall agents for Compute Engine VM instances.
 
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --help.

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

@@ -65,8 +65,10 @@ GCLOUD WIDE FLAGS
     Run $ gcloud help for details.
 
 NOTES
-    This command is currently in beta and might change without notice. This
-    variant is also available:
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud compute instances ops-agents policies list
 
         $ gcloud alpha compute instances ops-agents policies list
 

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

@@ -394,8 +394,10 @@ GCLOUD WIDE FLAGS
     Run $ gcloud help for details.
 
 NOTES
-    This command is currently in beta and might change without notice. This
-    variant is also available:
+    This command is currently in beta and might change without notice. These
+    variants are also available:
+
+        $ gcloud compute instances ops-agents policies update
 
         $ gcloud alpha compute instances ops-agents policies update