Virtual Machines - Power Off

Служба:

Compute

Версия API:

2025-04-01

Операция отключения (остановки) виртуальной машины. Виртуальную машину можно перезапустить с теми же подготовленными ресурсами. Плата за эту виртуальную машину по-прежнему взимается.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/powerOff?api-version=2025-04-01

С использованием необязательных параметров:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/powerOff?api-version=2025-04-01&skipShutdown={skipShutdown}

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
vmName	path	True	string	Имя виртуальной машины.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
skipShutdown	query		boolean	Параметр для запроса некорректного завершения работы виртуальной машины. Значение true для этого флага указывает на неграциозное завершение работы, а значение false указывает в противном случае. Значение по умолчанию для этого флага false, если не указано

Ответы

Имя	Тип	Описание
200 OK		Запрос выполнен успешно.
202 Accepted		Операция ресурса принята. Заголовки Location: string Retry-After: integer
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

VirtualMachine_PowerOff_MaximumSet_Gen

VirtualMachine_PowerOff_MinimumSet_Gen

VirtualMachine_PowerOff_MaximumSet_Gen

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaa/powerOff?api-version=2025-04-01&skipShutdown=True

Пример ответа

Код состояния:

200

Код состояния:

202

location: https://foo.com/operationstatus

VirtualMachine_PowerOff_MinimumSet_Gen

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaa/powerOff?api-version=2025-04-01

Пример ответа

Код состояния:

200

Код состояния:

202

location: https://foo.com/operationstatus

Определения

Имя	Описание
ApiError	Ошибка API.
ApiErrorBase	База ошибок API.
CloudError	Ответ об ошибке от службы вычислений.
InnerError	Сведения о внутренней ошибке.

ApiError

Объект

Ошибка API.

Имя	Тип	Описание
code	string	Код ошибки.
details	ApiErrorBase[]	Сведения об ошибке Api
innererror	InnerError	Внутренняя ошибка Api
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

ApiErrorBase

Объект

База ошибок API.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

CloudError

Объект

Ответ об ошибке от службы вычислений.

Имя	Тип	Описание
error	ApiError	Ошибка API.

InnerError

Объект

Сведения о внутренней ошибке.

Имя	Тип	Описание
errordetail	string	Внутреннее сообщение об ошибке или дамп исключений.
exceptiontype	string	Тип исключения.