Virtual Machine Scale Sets - Reimage

Повторное создание образов (обновление операционной системы) одной или нескольких виртуальных машин в масштабируемом наборе виртуальных машин, не имеющих временных дисков ОС, для виртуальных машин с временным диском ОС, которые сбрасываются на начальное состояние.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2026-04-01

Параметры URI

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

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя нечувствительно к регистру.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

vmScaleSetName
path True

string

Имя масштабируемого набора виртуальных машин.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

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

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

string

Указывает десятичное число, версия диска ОС должна быть переосмыслена. Если указана точную версию, диск ОС переимыкается в существующую версию диска ОС.

forceUpdateOSDiskForEphemeral

boolean

Параметр для принудительного обновления временного диска ОС для виртуальной машины масштабируемого набора виртуальных машин

instanceIds

string[]

Идентификаторы экземпляра масштабируемого набора виртуальных машин. Пропуск идентификаторов экземпляра масштабируемого набора виртуальных машин приведет к выполнению операции на всех виртуальных машинах в масштабируемом наборе виртуальных машин.

osProfile

OSProfileProvisioningData

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

tempDisk

boolean

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

Ответы

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

Запрос выполнен успешно.

202 Accepted

Операция ресурса принята.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

Имя Описание
user_impersonation выдать себя за учетную запись пользователя

Примеры

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

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

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2026-04-01

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

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

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

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

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2026-04-01

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

location: https://foo.com/operationstatus

Определения

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

Ошибка API.

ApiErrorBase

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

CloudError

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

InnerError

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

OSProfileProvisioningData

Дополнительные параметры для повторной подготовки неэфемерных виртуальных машин.

VirtualMachineScaleSetReimageParameters

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

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 (password)

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

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

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

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

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

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

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

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

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

customData

string

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

VirtualMachineScaleSetReimageParameters

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

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

string

Указывает десятичное число, версия диска ОС должна быть переосмыслена. Если указана точную версию, диск ОС переимыкается в существующую версию диска ОС.

forceUpdateOSDiskForEphemeral

boolean

Параметр для принудительного обновления временного диска ОС для виртуальной машины масштабируемого набора виртуальных машин

instanceIds

string[]

Идентификаторы экземпляра масштабируемого набора виртуальных машин. Пропуск идентификаторов экземпляра масштабируемого набора виртуальных машин приведет к выполнению операции на всех виртуальных машинах в масштабируемом наборе виртуальных машин.

osProfile

OSProfileProvisioningData

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

tempDisk

boolean

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