Stop a virtual machine instance. Stopping a VM instance performs a clean shutdown, much like invoking the shutdown functionality of a workstation or laptop. Stopping a VM instance which is already stopped will return without errors.
EXAMPLES
To stop an instance named "example-instance" in project "example-project", run:
gdcloud compute instances stop example-instance --project example-project
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis command stops a specified virtual machine instance.\u003c/p\u003e\n"],["\u003cp\u003eStopping an instance performs a clean shutdown of the VM.\u003c/p\u003e\n"],["\u003cp\u003eThe command will not return errors if the VM is already stopped.\u003c/p\u003e\n"],["\u003cp\u003eYou must specify the instance name, and optionally the project ID.\u003c/p\u003e\n"]]],[],null,["# gdcloud compute instances stop\n\nNAME\n----\n\ngdcloud compute instances stop - Stop a virtual machine instance.\n\nSYNOPSIS\n--------\n\n gdcloud compute instances stop INSTANCE_NAME [flags]\n\nDESCRIPTION\n-----------\n\nStop a virtual machine instance. Stopping a VM instance performs a clean shutdown, much like invoking the shutdown functionality of a workstation or laptop. Stopping a VM instance which is already stopped will return without errors.\n\n### EXAMPLES\n\n To stop an instance named \"example-instance\" in project \"example-project\", run:\n\n gdcloud compute instances stop example-instance --project example-project\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-reference/gdcloud) page."]]
