Udostępnij za pośrednictwem


Virtual Machines - Reimage

Reimages (uaktualnianie systemu operacyjnego) maszyny wirtualnej, która nie ma efemerycznego dysku systemu operacyjnego, dla maszyn wirtualnych, które mają efemeryczny dysk systemu operacyjnego, maszyna wirtualna jest resetowany do stanu początkowego. UWAGA: Zachowanie starego dysku systemu operacyjnego zależy od wartości deleteOption dysku systemu operacyjnego. Jeśli polecenie deleteOption jest odłączone, stary dysk systemu operacyjnego zostanie zachowany po odtworzeniu obrazu. Jeśli polecenie deleteOption zostanie usunięte, stary dysk systemu operacyjnego zostanie usunięty po odtworzeniu obrazu. Przed wykonaniem obrazu z obrazu należy odpowiednio zaktualizować element deleteOption dysku systemu operacyjnego.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/reimage?api-version=2024-03-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów.

subscriptionId
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.

vmName
path True

string

Nazwa maszyny wirtualnej.

api-version
query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Typ Opis
parameters

VirtualMachineReimageParameters

Parametry dostarczone do operacji Reimage Virtual Machine.

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

202 Accepted

Zaakceptowano

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ 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

Reimage a Non-Ephemeral Virtual Machine.
Reimage a Virtual Machine.

Reimage a Non-Ephemeral Virtual Machine.

Przykładowe żądanie

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01

{
  "tempDisk": true,
  "exactVersion": "aaaaaa",
  "osProfile": {
    "adminPassword": "{your-password}",
    "customData": "{your-custom-data}"
  }
}

Przykładowa odpowiedź

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Reimage a Virtual Machine.

Przykładowe żądanie

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01

{
  "tempDisk": true
}

Przykładowa odpowiedź

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Definicje

Nazwa Opis
ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

CloudError

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

InnerError

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

OSProfileProvisioningData

Określa informacje wymagane do ponownego odtworzenia dysku systemu operacyjnego innego niż efemeryczny.

VirtualMachineReimageParameters

Parametry dostarczone do operacji Reimage Virtual Machine.

ApiError

Błąd interfejsu 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 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 Compute.

Nazwa Typ Opis
error

ApiError

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

Określa informacje wymagane do ponownego odtworzenia dysku systemu operacyjnego innego niż efemeryczny.

Nazwa Typ Opis
adminPassword

string

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 znaki

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

Wymagania dotyczące złożoności: 3 na 4 poniższe warunki muszą zostać spełnione
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 na platformie 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, która ma zostać zapisana jako plik. Aby uzyskać więcej informacji, zobacz Custom Data on Azure VMs (Dane niestandardowe na maszynach wirtualnych platformy Azure). Jeśli używasz pakietu cloud-init dla maszyny wirtualnej z systemem Linux, zobacz Korzystanie z pakietu cloud-init w celu dostosowania maszyny wirtualnej z systemem Linux podczas tworzenia.

VirtualMachineReimageParameters

Parametry dostarczone do operacji Reimage Virtual Machine.

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.

osProfile

OSProfileProvisioningData

Określa informacje wymagane do ponownego odtworzenia 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 w przypadku maszyn wirtualnych/zestawów skalowania maszyn wirtualnych z efemerycznym dyskiem systemu operacyjnego.