Поделиться через


Virtual Machines - Reimage

Повторное создание образа (обновление операционной системы) виртуальной машины, на которой нет временного диска ОС, для виртуальных машин с временным диском ОС, для которых виртуальная машина сбрасывается в исходное состояние. ПРИМЕЧАНИЕ. Сохранение старого диска ОС зависит от значения deleteOption диска ОС. Если параметр deleteOption отключен, старый диск ОС будет сохранен после повторного образа. Если параметр deleteOption имеет значение delete, старый диск ОС будет удален после повторного воспроизведения образа. Перед выполнением повторного образа необходимо соответствующим образом обновить deleteOption диска ОС.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

Имя группы ресурсов.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.

vmName
path True

string

Имя виртуальной машины.

api-version
query True

string

Версия API клиента.

Текст запроса

Имя Тип Описание
parameters

VirtualMachineReimageParameters

Параметры, предоставленные для операции повторного создания образа виртуальной машины.

Ответы

Имя Тип Описание
200 OK

ОК

202 Accepted

Принято

Other Status Codes

CloudError

Ответ об ошибке, описывающий причину сбоя операции.

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

azure_auth

Поток OAuth2 в Azure Active Directory

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

Области

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

Примеры

Reimage a Non-Ephemeral Virtual Machine.
Reimage a Virtual Machine.

Reimage a Non-Ephemeral Virtual Machine.

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

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01

{
  "tempDisk": true,
  "exactVersion": "aaaaaa",
  "osProfile": {
    "adminPassword": "{your-password}",
    "customData": "{your-custom-data}"
  }
}

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

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Reimage a Virtual Machine.

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

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01

{
  "tempDisk": true
}

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

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Определения

Имя Описание
ApiError

Ошибка API.

ApiErrorBase

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

CloudError

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

InnerError

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

OSProfileProvisioningData

Указывает сведения, необходимые для повторного создания образа неэфемерного диска ОС.

VirtualMachineReimageParameters

Параметры, предоставленные для операции повторного создания образа виртуальной машины.

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

Тип исключения.

OSProfileProvisioningData

Указывает сведения, необходимые для повторного создания образа неэфемерного диска ОС.

Имя Тип Описание
adminPassword

string

Указывает пароль учетной записи администратора.

Минимальная длина (Windows): 8 символов

Минимальная длина (Linux): 6 символов

Максимальная длина (Windows): 123 символа

Максимальная длина (Linux): 72 символа

Требования к сложности: 3 из 4 условий, приведенных ниже, должны быть выполнены
Содержит более низкие символы
Содержит верхние символы
Имеет цифру
Имеет специальный символ (соответствие регулярных выражений [\W_])

Запрещенные значения: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"

Сведения о сбросе пароля см. в статье Как сбросить службу удаленного рабочего стола или ее пароль для входа на виртуальной машине Windows.

Сведения о сбросе корневого пароля см. в статье Управление пользователями, SSH и проверка или восстановление дисков на виртуальных машинах Linux в Azure с помощью расширения VMAccess.

customData

string

Указывает строку пользовательских данных в кодировке base-64. Строка в кодировке base-64 кодируется в двоичный массив, который сохраняется в виде файла на виртуальной машине. Максимальная длина двоичного массива — 65 535 байт. Примечание. Не передайте секреты или пароли в свойстве customData. Это свойство не может быть обновлено после создания виртуальной машины. Свойство customData передается виртуальной машине для сохранения в виде файла. Дополнительные сведения см. в статье Пользовательские данные на виртуальных машинах Azure. При использовании cloud-init для виртуальной машины Linux см. статью Использование cloud-init для настройки виртуальной машины Linux во время создания.

VirtualMachineReimageParameters

Параметры, предоставленные для операции повторного создания образа виртуальной машины.

Имя Тип Описание
exactVersion

string

Указывает в десятичном разряде версию диска ОС, в который необходимо переимыслить. Если точная версия не указана, диск ОПЕРАЦИОННОй системы будет переосмыслен на существующую версию диска ОС.

osProfile

OSProfileProvisioningData

Указывает сведения, необходимые для повторного создания образа неэфемерного диска ОС.

tempDisk

boolean

Указывает, следует ли повторно создавать временный диск. Значение по умолчанию: false. Примечание. Этот параметр повторного создания образа временного диска поддерживается только для виртуальных машин или VMSS с временным диском ОС.