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 maszyny wirtualnej jest resetowany do stanu początkowego.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/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.
|
vmScaleSetName
|
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 liczbę dziesiętną, do wersji dysku systemu operacyjnego powinien zostać wyświetlony obraz. Jeśli nie podano dokładnej wersji, dysk systemu operacyjnego jest odtwarzany do istniejącej wersji dysku systemu operacyjnego.
|
forceUpdateOSDiskForEphemeral
|
boolean
|
Parametr wymusza 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
|
OSProfileProvisioningData
|
Określa informacje wymagane do ponownego tworzenia efemerycznego 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/vmSS z efemerycznym dyskiem systemu operacyjnego.
|
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
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa |
Opis |
user_impersonation
|
personifikacja konta użytkownika
|
Przykłady
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
}
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python virtual_machine_scale_set_reimage_maximum_set_gen.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
client.virtual_machine_scale_sets.begin_reimage(
resource_group_name="rgcompute",
vm_scale_set_name="aaaaaaaaaaaaaaaaaaaaaaaaaa",
).result()
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MaximumSet_Gen.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MaximumSet_Gen.json
func ExampleVirtualMachineScaleSetsClient_BeginReimage_virtualMachineScaleSetReimageMaximumSetGen() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualMachineScaleSetsClient().BeginReimage(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaaaaaaaa", &armcompute.VirtualMachineScaleSetsClientBeginReimageOptions{VMScaleSetReimageInput: &armcompute.VirtualMachineScaleSetReimageParameters{
TempDisk: to.Ptr(true),
ForceUpdateOSDiskForEphemeral: to.Ptr(true),
InstanceIDs: []*string{
to.Ptr("aaaaaaaaaa")},
},
})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
_, err = poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Reimages (upgrade the operating system) one or more virtual machines in a VM scale set which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state.
*
* @summary Reimages (upgrade the operating system) one or more virtual machines in a VM scale set which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MaximumSet_Gen.json
*/
async function virtualMachineScaleSetReimageMaximumSetGen() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
const vmScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaaa";
const vmScaleSetReimageInput = {
forceUpdateOSDiskForEphemeral: true,
instanceIds: ["aaaaaaaaaa"],
tempDisk: true,
};
const options = {
vmScaleSetReimageInput,
};
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.virtualMachineScaleSets.beginReimageAndWait(
resourceGroupName,
vmScaleSetName,
options,
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
location: https://foo.com/operationstatus
VirtualMachineScaleSet_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
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python virtual_machine_scale_set_reimage_minimum_set_gen.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
client.virtual_machine_scale_sets.begin_reimage(
resource_group_name="rgcompute",
vm_scale_set_name="aaaaaaaaaaaaaaaaaaaaaaaaaaaa",
).result()
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MinimumSet_Gen.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MinimumSet_Gen.json
func ExampleVirtualMachineScaleSetsClient_BeginReimage_virtualMachineScaleSetReimageMinimumSetGen() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualMachineScaleSetsClient().BeginReimage(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaaaaaaaaaa", &armcompute.VirtualMachineScaleSetsClientBeginReimageOptions{VMScaleSetReimageInput: nil})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
_, err = poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Reimages (upgrade the operating system) one or more virtual machines in a VM scale set which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state.
*
* @summary Reimages (upgrade the operating system) one or more virtual machines in a VM scale set which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MinimumSet_Gen.json
*/
async function virtualMachineScaleSetReimageMinimumSetGen() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
const vmScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaaaaa";
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.virtualMachineScaleSets.beginReimageAndWait(
resourceGroupName,
vmScaleSetName,
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
location: https://foo.com/operationstatus
Definicje
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ź o błędzie 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
Dodatkowe parametry dotyczące ponownego tworzenia maszyny wirtualnej innej niż efemeryczna.
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: poniżej należy spełnić 3 z 4 warunków Zawiera 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. Tej właściwości nie można zaktualizować po utworzeniu maszyny wirtualnej. Właściwość customData jest przekazywana do maszyny wirtualnej do zapisania jako pliku, 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 Using cloud-init to customize a Linux VM during creation (Używanie pakietu cloud-init do dostosowywania maszyny wirtualnej z systemem Linux podczas tworzenia).
|
VirtualMachineScaleSetReimageParameters
Opisuje parametry ponownego obrazu maszyny wirtualnej zestawu skalowania maszyn wirtualnych.
Nazwa |
Typ |
Opis |
exactVersion
|
string
|
Określa liczbę dziesiętną, do wersji dysku systemu operacyjnego powinien zostać wyświetlony obraz. Jeśli nie podano dokładnej wersji, dysk systemu operacyjnego jest odtwarzany do istniejącej wersji dysku systemu operacyjnego.
|
forceUpdateOSDiskForEphemeral
|
boolean
|
Parametr wymusza 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
|
OSProfileProvisioningData
|
Określa informacje wymagane do ponownego tworzenia efemerycznego 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/vmSS z efemerycznym dyskiem systemu operacyjnego.
|