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=2024-07-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
vm
|
path | True |
string |
Nazwa zestawu skalowania maszyn wirtualnych. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
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 wymuszania aktualizacji 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 zmagania dysku systemu operacyjnego innego niż efemeryczny. |
|
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 |
OK |
|
202 Accepted |
Akceptowane |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta 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=2024-07-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Przykładowa odpowiedź
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
Przykładowe żądanie
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 |
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 wymuszania aktualizacji 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 zmagania dysku systemu operacyjnego innego niż efemeryczny. |
|
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. |