gcloud alpha compute instances set-machine-type

NAME
gcloud alpha compute instances set-machine-type - set machine type for Compute Engine virtual machines
SYNOPSIS
gcloud alpha compute instances set-machine-typeINSTANCE_NAME[--machine-type=MACHINE_TYPE][--zone=ZONE][--custom-cpu=CUSTOM_CPU--custom-memory=CUSTOM_MEMORY :--custom-extensions--custom-vm-type=CUSTOM_VM_TYPE][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA)gcloud alpha compute instancesset-machine-type lets you change the machine type of avirtual machine in theTERMINATED state (that is, a virtual machineinstance that has been stopped).

For example, ifexample-instance is ag1-small virtual machine currently in theTERMINATED state, running:

gcloudalphacomputeinstancesset-machine-typeexample-instance--zoneus-central1-b--machine-typen1-standard-4

will change the machine type ton1-standard-4, so that when you next startexample-instance, it will be provisioned asann1-standard-4 instead of ag1-small.

Seehttps://cloud.google.com/compute/docs/machine-typesfor more information on machine types.

EXAMPLES
To change the machine type of a VM ton1-standard-4, run:
gcloudalphacomputeinstancesset-machine-typeexample-instance--zone=us-central1-b--machine-type=n1-standard-4
POSITIONAL ARGUMENTS
INSTANCE_NAME
Name of the instance to operate on. For details on valid instance names, referto the criteria documented under the field 'name' at:https://cloud.google.com/compute/docs/reference/rest/v1/instances
FLAGS
--machine-type=MACHINE_TYPE
Specifies the machine type used for the instances. To get a list of availablemachine types, run 'gcloud compute machine-types list'. Either this flag,--custom-cpu, or --custom-memory must be specified.
--zone=ZONE
Zone of the instance to operate on. If not specified, you might be prompted toselect a zone (interactive mode only).gcloud attempts to identify theappropriate zone by searching for resources in your currently active project. Ifthe zone cannot be determined,gcloud prompts you for a selection withall available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user can set thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_COMPUTE_ZONE.

Custom machine type extensions.
--custom-cpu=CUSTOM_CPU
A whole number value specifying the number of cores that are needed in thecustom machine type.

For some machine types, shared-core values can also be used. For example, for E2machine types, you can specifymicro,small, ormedium.

This flag argument must be specified if any of the other arguments in this groupare specified.

--custom-memory=CUSTOM_MEMORY
A whole number value indicating how much memory is desired in the custom machinetype. A size unit should be provided (eg. 3072MB or 9GB) - if no units arespecified, GB is assumed.

This flag argument must be specified if any of the other arguments in this groupare specified.

--custom-extensions
Use the extended custom machine type.
--custom-vm-type=CUSTOM_VM_TYPE
Specifies a custom machine type. The default isn1. For moreinformation about custom machine types, see:https://cloud.google.com/compute/docs/general-purpose-machines#custom_machine_types
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
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcomputeinstancesset-machine-type
gcloudbetacomputeinstancesset-machine-type

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.