.TH "GCLOUD_BETA_COMPUTE_INSTANCES" 1



.SH "NAME"
.HP
gcloud beta compute instances \- read and manipulate Compute Engine virtual machine instances



.SH "SYNOPSIS"
.HP
\f5gcloud beta compute instances\fR \fIGROUP\fR | \fICOMMAND\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Read and manipulate Compute Engine virtual machine instances.

For more information about virtual machine instances, see the virtual machine
instances documentation (https://cloud.google.com/compute/docs/instances/).

See also: Instances API
(https://cloud.google.com/compute/docs/reference/rest/v1/instances).



.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-help.

Run \fB$ gcloud help\fR for details.



.SH "GROUPS"

\f5\fIGROUP\fR\fR is one of the following:

.RS 2m
.TP 2m
\fBbulk\fR

\fB(BETA)\fR Manipulate multiple Compute Engine virtual machines with single
command executions.

.TP 2m
\fBnetwork\-interfaces\fR

\fB(BETA)\fR Read and manipulate Compute Engine instance network interfaces.

.TP 2m
\fBops\-agents\fR

\fB(BETA)\fR Manage Google Cloud Observability agents for Compute Engine VM
instances.

.TP 2m
\fBos\-inventory\fR

\fB(BETA)\fR Read Compute Engine OS Inventory Data and Related Resources.


.RE
.sp

.SH "COMMANDS"

\f5\fICOMMAND\fR\fR is one of the following:

.RS 2m
.TP 2m
\fBadd\-access\-config\fR

\fB(BETA)\fR Create a Compute Engine virtual machine access configuration.

.TP 2m
\fBadd\-iam\-policy\-binding\fR

\fB(BETA)\fR Add IAM policy binding to a Compute Engine instance.

.TP 2m
\fBadd\-labels\fR

\fB(BETA)\fR Add labels to Google Compute Engine virtual machine instances.

.TP 2m
\fBadd\-metadata\fR

\fB(BETA)\fR Add or update instance metadata.

.TP 2m
\fBadd\-partner\-metadata\fR

\fB(BETA)\fR Add or update partner metadata.

.TP 2m
\fBadd\-resource\-policies\fR

\fB(BETA)\fR Add resource policies to Compute Engine VM instances.

.TP 2m
\fBadd\-tags\fR

\fB(BETA)\fR Add tags to Compute Engine virtual machine instances.

.TP 2m
\fBattach\-disk\fR

\fB(BETA)\fR Attach a disk to an instance.

.TP 2m
\fBcreate\fR

\fB(BETA)\fR Create Compute Engine virtual machine instances.

.TP 2m
\fBcreate\-with\-container\fR

\fB(BETA)\fR \fB(DEPRECATED)\fR Creates Compute Engine virtual machine instances
running container images.

.TP 2m
\fBdelete\fR

\fB(BETA)\fR Delete Compute Engine virtual machine instances.

.TP 2m
\fBdelete\-access\-config\fR

\fB(BETA)\fR Delete an access configuration from a virtual machine network
interface.

.TP 2m
\fBdescribe\fR

\fB(BETA)\fR Describe a virtual machine instance.

.TP 2m
\fBdetach\-disk\fR

\fB(BETA)\fR Detach disks from Compute Engine virtual machine instances.

.TP 2m
\fBexport\fR

\fB(BETA)\fR Export a Compute Engine virtual machine instance's configuration to
a file.

.TP 2m
\fBget\-guest\-attributes\fR

\fB(BETA)\fR Get the Guest Attributes for a compute instance.

.TP 2m
\fBget\-iam\-policy\fR

\fB(BETA)\fR Get the IAM policy for a Compute Engine instance.

.TP 2m
\fBget\-screenshot\fR

\fB(BETA)\fR Capture a screenshot (JPEG image) of the virtual machine instance's
display.

.TP 2m
\fBget\-serial\-port\-output\fR

\fB(BETA)\fR Read output from a virtual machine instance's serial port.

.TP 2m
\fBget\-shielded\-identity\fR

\fB(BETA)\fR Get the Shielded identity for a Compute Engine instance.

.TP 2m
\fBimport\fR

\fB(BETA)\fR Create Compute Engine virtual machine instances from virtual
appliance in OVA/OVF format.

.TP 2m
\fBlist\fR

\fB(BETA)\fR List Compute Engine instances.

.TP 2m
\fBpatch\-partner\-metadata\fR

\fB(BETA)\fR Patch partner metadata.

.TP 2m
\fBperform\-maintenance\fR

\fB(BETA)\fR Perform maintenance of Google Compute Engine instance.

.TP 2m
\fBremove\-iam\-policy\-binding\fR

\fB(BETA)\fR Remove IAM policy binding from a Compute Engine instance.

.TP 2m
\fBremove\-labels\fR

\fB(BETA)\fR Remove labels from Google Compute Engine virtual machine instances.

.TP 2m
\fBremove\-metadata\fR

\fB(BETA)\fR Remove instance metadata.

.TP 2m
\fBremove\-partner\-metadata\fR

\fB(BETA)\fR Remove partner metadata.

.TP 2m
\fBremove\-resource\-policies\fR

\fB(BETA)\fR Remove resource policies from Compute Engine VM instances.

.TP 2m
\fBremove\-tags\fR

\fB(BETA)\fR Remove tags from Compute Engine virtual machine instances.

.TP 2m
\fBreport\-host\-as\-faulty\fR

\fB(BETA)\fR Report a host as faulty to start the repair process.

.TP 2m
\fBreset\fR

\fB(BETA)\fR Reset a virtual machine instance.

.TP 2m
\fBresume\fR

\fB(BETA)\fR Resume a virtual machine instance.

.TP 2m
\fBsend\-diagnostic\-interrupt\fR

\fB(BETA)\fR Send a diagnostic interrupt to a virtual machine instance.

.TP 2m
\fBset\-disk\-auto\-delete\fR

\fB(BETA)\fR Set auto\-delete behavior for disks.

.TP 2m
\fBset\-iam\-policy\fR

\fB(BETA)\fR Set IAM policy for a Compute Engine instance.

.TP 2m
\fBset\-machine\-type\fR

\fB(BETA)\fR Set machine type for Compute Engine virtual machines.

.TP 2m
\fBset\-name\fR

\fB(BETA)\fR Set the name of a Compute Engine virtual machine.

.TP 2m
\fBset\-scheduling\fR

\fB(BETA)\fR Set scheduling options for Compute Engine virtual machines.

.TP 2m
\fBset\-scopes\fR

\fB(BETA)\fR Set scopes and service account for a Compute Engine VM instance.

.TP 2m
\fBsimulate\-maintenance\-event\fR

\fB(BETA)\fR Simulate host maintenance of VM instances.

.TP 2m
\fBstart\fR

\fB(BETA)\fR Start a stopped virtual machine instance.

.TP 2m
\fBstop\fR

\fB(BETA)\fR Stop a virtual machine instance.

.TP 2m
\fBsuspend\fR

\fB(BETA)\fR Suspend a virtual machine instance.

.TP 2m
\fBtail\-serial\-port\-output\fR

\fB(BETA)\fR Periodically fetch new output from a virtual machine instance's
serial port and display it as it becomes available.

.TP 2m
\fBupdate\fR

\fB(BETA)\fR Update a Compute Engine virtual machine.

.TP 2m
\fBupdate\-access\-config\fR

\fB(BETA)\fR Update a Compute Engine virtual machine access configuration.

.TP 2m
\fBupdate\-container\fR

\fB(BETA)\fR \fB(DEPRECATED)\fR Updates Compute Engine virtual machine instances
running container images.

.TP 2m
\fBupdate\-from\-file\fR

\fB(BETA)\fR Update a Compute Engine virtual machine instance using a
configuration file.


.RE
.sp

.SH "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud compute instances
.RE

.RS 2m
$ gcloud alpha compute instances
.RE