gcloud: Thu Dec 14 10:23:57 UTC 2023

gcloud/compute/instances/create

@@ -794,7 +794,7 @@ FLAGS
 
      --source-instance-template=SOURCE_INSTANCE_TEMPLATE
         The name of the instance template that the instance will be created
-        from.
+        from. An instance template can be a global/regional resource.
 
         Users can also override machine type and labels. Values of other flags
         will be ignored and --source-instance-template will be used instead.

gcloud/compute/instances/create-with-container

@@ -670,7 +670,7 @@ FLAGS
 
      --source-instance-template=SOURCE_INSTANCE_TEMPLATE
         The name of the instance template that the instance will be created
-        from.
+        from. An instance template can be a global/regional resource.
 
         Users can also override machine type and labels. Values of other flags
         will be ignored and --source-instance-template will be used instead.

gcloud/compute/instances/help

@@ -140,6 +140,9 @@ COMMANDS
      set-machine-type
         Set machine type for Compute Engine virtual machines.
 
+     set-name
+        Set the name of a Compute Engine virtual machine.
+
      set-scheduling
         Set scheduling options for Compute Engine virtual machines.
 

gcloud/compute/instances/set-name

@@ -0,0 +1,67 @@
+NAME
+    gcloud compute instances set-name - set the name of a Compute Engine
+        virtual machine
+
+SYNOPSIS
+    gcloud compute instances set-name INSTANCE_NAME --new-name=NEW_NAME
+        [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    gcloud compute instances set-name lets you change the name of a virtual
+    machine.
+
+EXAMPLES
+    To change the name of instance-1 to instance-2:
+
+        $ gcloud compute instances set-name instance-1 --new-name=instance-2
+
+POSITIONAL ARGUMENTS
+     INSTANCE_NAME
+        Name of the instance to operate on. For details on valid instance
+        names, refer to the criteria documented under the field 'name' at:
+        https://cloud.google.com/compute/docs/reference/rest/v1/instances
+
+REQUIRED FLAGS
+     --new-name=NEW_NAME
+        Specifies the new name of the instance.
+
+OPTIONAL FLAGS
+     --zone=ZONE
+        Zone of the instance to operate on. If not specified, you might be
+        prompted to select a zone (interactive mode only). gcloud attempts to
+        identify the appropriate zone by searching for resources in your
+        currently active project. If the zone cannot be determined, gcloud
+        prompts you for a selection with all available Google Cloud Platform
+        zones.
+
+        To avoid prompting when this flag is omitted, the user can set the
+        compute/zone property:
+
+            $ gcloud config set compute/zone ZONE
+
+        A list of zones can be fetched by running:
+
+            $ gcloud compute zones list
+
+        To unset the property, run:
+
+            $ gcloud config unset compute/zone
+
+        Alternatively, the zone can be stored in the environment variable
+        CLOUDSDK_COMPUTE_ZONE.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha compute instances set-name
+
+        $ gcloud beta compute instances set-name
+