Udostępnij przez


Virtual Machine Scale Set VMs - Reimage

Odwzorowuje (uaktualnia system operacyjny) określoną maszynę wirtualną w zestawie skalowania maszyn wirtualnych.

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

Parametry URI

Nazwa W Wymagane Typ Opis
instanceId
path True

string

Identyfikator wystąpienia maszyny wirtualnej.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

vmScaleSetName
path True

string

Nazwa zestawu skalowania maszyn wirtualnych.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Ciało żą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

osProfile

OSProfileProvisioningData

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 obrazu dysku tymczasowego jest obsługiwany tylko w przypadku maszyny wirtualnej/zestawu skalowania maszyn wirtualnych z efemerycznym dyskiem systemu operacyjnego.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zakończyło się pomyślnie.

202 Accepted

Operacja zasobu została zaakceptowana.

Nagłówki

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

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen

Przykładowa prośba

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

{
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Przykładowa odpowiedź

location: https://foo.com/operationstatus

VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

Przykładowa prośba

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

Przykładowa odpowiedź

location: https://foo.com/operationstatus

Definicje

Nazwa Opis
ApiError

Błąd API.

ApiErrorBase

Baza błędów API.

CloudError

Odpowiedź na błąd z usługi obliczeniowej.

InnerError

Szczegóły błędu wewnętrznego.

OSProfileProvisioningData

Dodatkowe parametry dla ponownego obrazowania nieefemerycznej maszyny wirtualnej.

VirtualMachineScaleSetVMReimageParameters

Opisuje parametry obrazu obrazu maszyny wirtualnej w zestawie skalowania maszyn wirtualnych.

ApiError

Błąd API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Wewnętrzny błąd interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów 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

ApiError

Błąd 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 dla ponownego obrazowania nieefemerycznej maszyny wirtualnej.

Nazwa Typ Opis
adminPassword

string (password)

Określa hasło konta administratora.

minimalna długość (Windows): 8 znaków

minimalna długość (Linux): 6 znaków

maksymalna długość (Windows): 123 znaków

maksymalna długość (Linux): 72 znaki

wymagania dotyczące złożoności: należy spełnić 3 na 4 poniższe warunki
Ma małe znaki
Ma wielkie znaki
Ma cyfrę
Ma znak specjalny (dopasowanie wyrażenia regularnego [\W_])

niedozwolone wartości: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"

Aby zresetować hasło, zobacz Jak zresetować usługę pulpitu zdalnego lub hasło logowania na maszynie wirtualnej z systemem Windows

Aby zresetować hasło główne, zobacz Zarządzanie użytkownikami, protokołem SSH i sprawdzanie lub naprawianie dysków na maszynach wirtualnych z systemem Linux platformy Azure przy użyciu rozszerzenia VMAccess

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 w celu zapisania jako plik, aby uzyskać więcej informacji, zobacz Dane niestandardowe na maszynach wirtualnych platformy Azure. Jeśli używasz pakietu cloud-init dla maszyny wirtualnej z systemem Linux, zobacz Dostosowywanie maszyny wirtualnej z systemem Linux przy użyciu pakietu cloud-init podczas tworzenia.

VirtualMachineScaleSetVMReimageParameters

Opisuje parametry obrazu obrazu maszyny wirtualnej w zestawie 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

osProfile

OSProfileProvisioningData

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 obrazu dysku tymczasowego jest obsługiwany tylko w przypadku maszyny wirtualnej/zestawu skalowania maszyn wirtualnych z efemerycznym dyskiem systemu operacyjnego.