Virtual Machine Scale Sets - Reimage
Reimages (uaktualnij system operacyjny) co najmniej jedną maszynę wirtualną w zestawie skalowania maszyn wirtualnych, które nie mają efemerycznego dysku systemu operacyjnego, dla maszyn wirtualnych, które mają efemeryczny dysk systemu operacyjnego maszyna wirtualna jest resetowany do stanu początkowego.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2026-04-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
vm
|
path | True |
string |
Nazwa zestawu skalowania maszyn wirtualnych. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
| Nazwa | Typ | Opis |
|---|---|---|
| exactVersion |
string |
Określa w liczbie dziesiętnej, wersja dysku systemu operacyjnego powinna być odtwarzana z obrazu. Jeśli nie podano dokładnej wersji, dysk systemu operacyjnego jest odtwarzany z obrazu do istniejącej wersji dysku systemu operacyjnego. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parametr wymuszający aktualizację efemerycznego dysku systemu operacyjnego dla maszyny wirtualnej zestawu skalowania maszyn wirtualnych |
| instanceIds |
string[] |
Identyfikatory wystąpień zestawu skalowania maszyn wirtualnych. Pominięcie identyfikatorów wystąpień zestawu skalowania maszyn wirtualnych spowoduje wykonanie operacji na wszystkich maszynach wirtualnych w zestawie skalowania maszyn wirtualnych. |
| osProfile |
Określa informacje wymagane do ponownego obrazowania nieefemerycznego dysku systemu operacyjnego. |
|
| tempDisk |
boolean |
Określa, czy ma być odtwarzany dysk tymczasowy. Wartość domyślna: false Uwaga: ten parametr reimage dysku tymczasowego jest obsługiwany tylko dla maszyn wirtualnych/maszyn wirtualnych z efemerycznym dyskiem systemu operacyjnego. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Żądanie zakończyło się pomyślnie. |
|
| 202 Accepted |
Zaakceptowano operację zasobu. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 w usłudze Azure Active Directory.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | podszywaj się pod konto użytkownika |
Przykłady
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
Przykładowe żądanie
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
}
Przykładowa odpowiedź
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
Przykładowe żądanie
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2026-04-01
Przykładowa odpowiedź
location: https://foo.com/operationstatus
Definicje
| Nazwa | Opis |
|---|---|
|
Api |
Błąd interfejsu API. |
|
Api |
Baza błędów interfejsu API. |
|
Cloud |
Odpowiedź na błąd z usługi Obliczeniowej. |
|
Inner |
Szczegóły błędu wewnętrznego. |
|
OSProfile |
Dodatkowe parametry ponownego tworzenia maszyny wirtualnej innej niż efemeryczna. |
|
Virtual |
Opisuje parametry reimage maszyny wirtualnej zestawu skalowania maszyn wirtualnych. |
ApiError
Błąd interfejsu API.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu interfejsu API |
|
| innererror |
Błąd wewnętrzny interfejsu API |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Element docelowy określonego błędu. |
ApiErrorBase
Baza błędów interfejsu API.
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Kod błędu. |
| message |
string |
Komunikat o błędzie. |
| target |
string |
Element docelowy określonego błędu. |
CloudError
Odpowiedź na błąd z usługi Obliczeniowej.
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Błąd interfejsu API. |
InnerError
Szczegóły błędu wewnętrznego.
| Nazwa | Typ | Opis |
|---|---|---|
| errordetail |
string |
Wewnętrzny komunikat o błędzie lub zrzut wyjątku. |
| exceptiontype |
string |
Typ wyjątku. |
OSProfileProvisioningData
Dodatkowe parametry ponownego tworzenia maszyny wirtualnej innej niż efemeryczna.
| Nazwa | Typ | Opis |
|---|---|---|
| adminPassword |
string (password) |
Określa hasło konta administratora. |
| customData |
string |
Określa ciąg zakodowany w formacie base-64 danych niestandardowych. Ciąg zakodowany w formacie base-64 jest dekodowany do tablicy binarnej, która jest zapisywana jako plik na maszynie wirtualnej. Maksymalna długość tablicy binarnej wynosi 65535 bajtów. Uwaga: nie przekazuj żadnych wpisów tajnych ani haseł we właściwości customData. Nie można zaktualizować tej właściwości po utworzeniu maszyny wirtualnej. Właściwość customData jest przekazywana do maszyny wirtualnej, która ma zostać zapisana jako plik, aby uzyskać więcej informacji, zobacz Custom Data on Azure VMs. Jeśli używasz pakietu cloud-init dla maszyny wirtualnej z systemem Linux, zobacz Using cloud-init to customize a Linux VM during creation. |
VirtualMachineScaleSetReimageParameters
Opisuje parametry reimage maszyny wirtualnej zestawu skalowania maszyn wirtualnych.
| Nazwa | Typ | Opis |
|---|---|---|
| exactVersion |
string |
Określa w liczbie dziesiętnej, wersja dysku systemu operacyjnego powinna być odtwarzana z obrazu. Jeśli nie podano dokładnej wersji, dysk systemu operacyjnego jest odtwarzany z obrazu do istniejącej wersji dysku systemu operacyjnego. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parametr wymuszający aktualizację efemerycznego dysku systemu operacyjnego dla maszyny wirtualnej zestawu skalowania maszyn wirtualnych |
| instanceIds |
string[] |
Identyfikatory wystąpień zestawu skalowania maszyn wirtualnych. Pominięcie identyfikatorów wystąpień zestawu skalowania maszyn wirtualnych spowoduje wykonanie operacji na wszystkich maszynach wirtualnych w zestawie skalowania maszyn wirtualnych. |
| osProfile |
Określa informacje wymagane do ponownego obrazowania nieefemerycznego dysku systemu operacyjnego. |
|
| tempDisk |
boolean |
Określa, czy ma być odtwarzany dysk tymczasowy. Wartość domyślna: false Uwaga: ten parametr reimage dysku tymczasowego jest obsługiwany tylko dla maszyn wirtualnych/maszyn wirtualnych z efemerycznym dyskiem systemu operacyjnego. |