Virtual Machine Scale Sets - Reimage
Повторное создание образов (обновление операционной системы) одной или нескольких виртуальных машин в масштабируемом наборе виртуальных машин, не имеющих временного диска ОС, для виртуальных машин с временным диском ОС, для которых виртуальная машина сбрасывается до начального состояния.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-03-01Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Имя группы ресурсов. |
|
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы. |
|
vm
|
path | True |
string |
Имя масштабируемого набора виртуальных машин. |
|
api-version
|
query | True |
string |
Версия API клиента. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| exactVersion |
string |
Указывает в десятичном разряде версию диска ОС, в который необходимо переимыслить. Если точная версия не указана, диск ОПЕРАЦИОННОй системы будет переосмыслен на существующую версию диска ОС. |
| forceUpdateOSDiskForEphemeral |
boolean |
Параметр для принудительного обновления временного диска ОС для виртуальной машины масштабируемого набора виртуальных машин |
| instanceIds |
string[] |
Идентификаторы экземпляров масштабируемого набора виртуальных машин. Пропуск идентификаторов экземпляров масштабируемого набора виртуальных машин приведет к выполнению операции на всех виртуальных машинах в масштабируемом наборе виртуальных машин. |
| osProfile |
Указывает сведения, необходимые для повторного создания образа неэфемерного диска ОС. |
|
| tempDisk |
boolean |
Указывает, следует ли повторно создавать временный диск. Значение по умолчанию: false. Примечание. Этот параметр повторного создания образа временного диска поддерживается только для виртуальных машин или VMSS с временным диском ОС. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
ОК |
|
| 202 Accepted |
Принято |
|
| Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Sample Response
location: https://foo.com/operationstatusVirtualMachineScaleSet_Reimage_MinimumSet_Gen
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
Sample Response
location: https://foo.com/operationstatusОпределения
| Имя | Описание |
|---|---|
|
Api |
Ошибка API. |
|
Api |
База ошибок API. |
|
Cloud |
Ответ об ошибке от службы вычислений. |
|
Inner |
Сведения о внутренней ошибке. |
|
OSProfile |
Дополнительные параметры для повторного создания образа неэфемерной виртуальной машины. |
|
Virtual |
Описание параметров повторного создания образа виртуальной машины масштабируемого набора виртуальных машин. |
ApiError
Ошибка API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке API |
|
| innererror |
Внутренняя ошибка API |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
ApiErrorBase
База ошибок API.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект конкретной ошибки. |
CloudError
Ответ об ошибке от службы вычислений.
| Имя | Тип | Описание |
|---|---|---|
| error |
Ошибка API. |
InnerError
Сведения о внутренней ошибке.
| Имя | Тип | Описание |
|---|---|---|
| errordetail |
string |
Внутреннее сообщение об ошибке или дамп исключений. |
| exceptiontype |
string |
Тип исключения. |
OSProfileProvisioningData
Дополнительные параметры для повторного создания образа неэфемерной виртуальной машины.
| Имя | Тип | Описание |
|---|---|---|
| adminPassword |
string |
Указывает пароль учетной записи администратора. |
| customData |
string |
Указывает строку пользовательских данных в кодировке base-64. Строка в кодировке base-64 кодируется в двоичный массив, который сохраняется в виде файла на виртуальной машине. Максимальная длина двоичного массива — 65 535 байт. Примечание. Не передайте секреты или пароли в свойстве customData. Это свойство не может быть обновлено после создания виртуальной машины. Свойство customData передается виртуальной машине для сохранения в виде файла. Дополнительные сведения см. в статье Пользовательские данные на виртуальных машинах Azure. При использовании cloud-init для виртуальной машины Linux см. статью Использование cloud-init для настройки виртуальной машины Linux во время создания. |
VirtualMachineScaleSetReimageParameters
Описание параметров повторного создания образа виртуальной машины масштабируемого набора виртуальных машин.
| Имя | Тип | Описание |
|---|---|---|
| exactVersion |
string |
Указывает в десятичном разряде версию диска ОС, в который необходимо переимыслить. Если точная версия не указана, диск ОПЕРАЦИОННОй системы будет переосмыслен на существующую версию диска ОС. |
| forceUpdateOSDiskForEphemeral |
boolean |
Параметр для принудительного обновления временного диска ОС для виртуальной машины масштабируемого набора виртуальных машин |
| instanceIds |
string[] |
Идентификаторы экземпляров масштабируемого набора виртуальных машин. Пропуск идентификаторов экземпляров масштабируемого набора виртуальных машин приведет к выполнению операции на всех виртуальных машинах в масштабируемом наборе виртуальных машин. |
| osProfile |
Указывает сведения, необходимые для повторного создания образа неэфемерного диска ОС. |
|
| tempDisk |
boolean |
Указывает, следует ли повторно создавать временный диск. Значение по умолчанию: false. Примечание. Этот параметр повторного создания образа временного диска поддерживается только для виртуальных машин или VMSS с временным диском ОС. |