File: //snap/google-cloud-cli/current/help/man/man1/gcloud_compute_instances.1
.TH "GCLOUD_COMPUTE_INSTANCES" 1
.SH "NAME"
.HP
gcloud compute instances \- read and manipulate Compute Engine virtual machine instances
.SH "SYNOPSIS"
.HP
\f5gcloud compute instances\fR \fIGROUP\fR | \fICOMMAND\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
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
Manipulate multiple Compute Engine virtual machines with single command
executions.
.TP 2m
\fBnetwork\-interfaces\fR
Read and manipulate Compute Engine instance network interfaces.
.TP 2m
\fBops\-agents\fR
Manage Google Cloud Observability agents for Compute Engine VM instances.
.TP 2m
\fBos\-inventory\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
Create a Compute Engine virtual machine access configuration.
.TP 2m
\fBadd\-iam\-policy\-binding\fR
Add IAM policy binding to a Compute Engine instance.
.TP 2m
\fBadd\-labels\fR
Add labels to Google Compute Engine virtual machine instances.
.TP 2m
\fBadd\-metadata\fR
Add or update instance metadata.
.TP 2m
\fBadd\-resource\-policies\fR
Add resource policies to Compute Engine VM instances.
.TP 2m
\fBadd\-tags\fR
Add tags to Compute Engine virtual machine instances.
.TP 2m
\fBattach\-disk\fR
Attach a disk to an instance.
.TP 2m
\fBcreate\fR
Create Compute Engine virtual machine instances.
.TP 2m
\fBcreate\-with\-container\fR
\fB(DEPRECATED)\fR Creates Compute Engine virtual machine instances running
container images.
.TP 2m
\fBdelete\fR
Delete Compute Engine virtual machine instances.
.TP 2m
\fBdelete\-access\-config\fR
Delete an access configuration from a virtual machine network interface.
.TP 2m
\fBdescribe\fR
Describe a virtual machine instance.
.TP 2m
\fBdetach\-disk\fR
Detach disks from Compute Engine virtual machine instances.
.TP 2m
\fBexport\fR
Export a Compute Engine virtual machine instance's configuration to a file.
.TP 2m
\fBget\-guest\-attributes\fR
Get the Guest Attributes for a compute instance.
.TP 2m
\fBget\-iam\-policy\fR
Get the IAM policy for a Compute Engine instance.
.TP 2m
\fBget\-screenshot\fR
Capture a screenshot (JPEG image) of the virtual machine instance's display.
.TP 2m
\fBget\-serial\-port\-output\fR
Read output from a virtual machine instance's serial port.
.TP 2m
\fBget\-shielded\-identity\fR
Get the Shielded identity for a Compute Engine instance.
.TP 2m
\fBimport\fR
Create Compute Engine virtual machine instances from virtual appliance in
OVA/OVF format.
.TP 2m
\fBlist\fR
List Compute Engine instances.
.TP 2m
\fBperform\-maintenance\fR
Perform maintenance of Google Compute Engine instance.
.TP 2m
\fBremove\-iam\-policy\-binding\fR
Remove IAM policy binding from a Compute Engine instance.
.TP 2m
\fBremove\-labels\fR
Remove labels from Google Compute Engine virtual machine instances.
.TP 2m
\fBremove\-metadata\fR
Remove instance metadata.
.TP 2m
\fBremove\-resource\-policies\fR
Remove resource policies from Compute Engine VM instances.
.TP 2m
\fBremove\-tags\fR
Remove tags from Compute Engine virtual machine instances.
.TP 2m
\fBreport\-host\-as\-faulty\fR
Report a host as faulty to start the repair process.
.TP 2m
\fBreset\fR
Reset a virtual machine instance.
.TP 2m
\fBresume\fR
Resume a virtual machine instance.
.TP 2m
\fBsend\-diagnostic\-interrupt\fR
Send a diagnostic interrupt to a virtual machine instance.
.TP 2m
\fBset\-disk\-auto\-delete\fR
Set auto\-delete behavior for disks.
.TP 2m
\fBset\-iam\-policy\fR
Set IAM policy for a Compute Engine instance.
.TP 2m
\fBset\-machine\-type\fR
Set machine type for Compute Engine virtual machines.
.TP 2m
\fBset\-name\fR
Set the name of a Compute Engine virtual machine.
.TP 2m
\fBset\-scheduling\fR
Set scheduling options for Compute Engine virtual machines.
.TP 2m
\fBset\-service\-account\fR
Set a service account and access scopes for a Compute Engine VM instance.
.TP 2m
\fBsimulate\-maintenance\-event\fR
Simulate host maintenance of VM instances.
.TP 2m
\fBstart\fR
Start a stopped virtual machine instance.
.TP 2m
\fBstop\fR
Stop a virtual machine instance.
.TP 2m
\fBsuspend\fR
Suspend a virtual machine instance.
.TP 2m
\fBtail\-serial\-port\-output\fR
Periodically fetch new output from a virtual machine instance's serial port and
display it as it becomes available.
.TP 2m
\fBupdate\fR
Update a Compute Engine virtual machine.
.TP 2m
\fBupdate\-access\-config\fR
Update a Compute Engine virtual machine access configuration.
.TP 2m
\fBupdate\-container\fR
\fB(DEPRECATED)\fR Updates Compute Engine virtual machine instances running
container images.
.TP 2m
\fBupdate\-from\-file\fR
Update a Compute Engine virtual machine instance using a configuration file.
.RE
.sp
.SH "NOTES"
These variants are also available:
.RS 2m
$ gcloud alpha compute instances
.RE
.RS 2m
$ gcloud beta compute instances
.RE