Skip to content

Stop Virtual Machine Instance ​

Initiate a graceful shutdown sequence for a virtual machine instance. This operation requires the instance's unique identifier to commence the shutdown process.

HTTP Request ​

GET {API_URL}/virtual-machines/{id}/stop

Path Parameters ​

ParameterRequirementTypeDescription
idRequiredstringTarget instance's unique identifier

Response Structure ​

status boolean ​

Operation result indicator. Returns true for successful execution, false when encountering an error.

message string ​

Descriptive response indicating the outcome of the shutdown request.

Implementation Example ​

Request ​

bash
curl -X GET '{API_URL}virtual-machines/{id}/stop' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'refresh-token: {REFRESH_TOKEN}' \
-H 'Content-Type: application/json'

Response ​

json
{
    "status": true,
    "message": "Instance shutdown sequence initiated successfully"
}