Virtual Machine Scale Sets - Reimage

Referentie

Service:: Compute

API Version:: 2024-03-01

Een of meer virtuele machines in een VM-schaalset die geen kortstondige besturingssysteemschijf hebben, worden opnieuw geïnstalleerd (upgraden van het besturingssysteem). Voor virtuele machines met een kortstondige besturingssysteemschijf wordt de virtuele machine opnieuw ingesteld op de beginstatus.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep.
subscriptionId	path	True	string	Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
vmScaleSetName	path	True	string	De naam van de VM-schaalset.
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Type	Description
exactVersion	string	Hiermee geeft u in decimaal getal de versie van de besturingssysteemschijf opnieuw moet worden geïnstalleerd. Als er geen exacte versie is opgegeven, wordt de besturingssysteemschijf opnieuw geïnstalleerd op de bestaande versie van de besturingssysteemschijf.
forceUpdateOSDiskForEphemeral	boolean	Parameter voor het geforceerd bijwerken van tijdelijke besturingssysteemschijf voor een VIRTUELE-machineschaalset-VM
instanceIds	string[]	De instantie-id's van de virtuele-machineschaalset. Als u de exemplaar-id's van de virtuele-machineschaalset weglaat, wordt de bewerking uitgevoerd op alle virtuele machines in de virtuele-machineschaalset.
osProfile	OSProfileProvisioningData	Hiermee geeft u de informatie op die is vereist voor het opnieuw opgeven van de niet-tijdelijke besturingssysteemschijf.
tempDisk	boolean	Hiermee geeft u op of de tijdelijke schijf opnieuw moet worden hersteld. Standaardwaarde: false. Opmerking: deze tijdelijke schijfreimageparameter wordt alleen ondersteund voor VM/VMSS met tijdelijke besturingssysteemschijf.

Antwoorden

Name	Type	Description
200 OK		OK
202 Accepted		Geaccepteerd
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

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
}

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

Sample Response

Status code:: 200

Status code:: 202

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Sample Request

HTTP
Go

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

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

Sample Response

Status code:: 200

Status code:: 202

location: https://foo.com/operationstatus

Definities

Name	Description
ApiError	API-fout.
ApiErrorBase	API-foutbasis.
CloudError	Een foutreactie van de Compute-service.
InnerError	Details van interne fout.
OSProfileProvisioningData	Aanvullende parameters voor het opnieuw opgeven van niet-tijdelijke virtuele machines.
VirtualMachineScaleSetReimageParameters	Beschrijft een vm-installatiekopieparameters voor virtuele-machineschaalsets.

ApiError

API-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	De API-foutdetails
innererror	InnerError	De interne API-fout
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

API-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

CloudError

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	API-fout.

InnerError

Details van interne fout.

Name	Type	Description
errordetail	string	Het interne foutbericht of de uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.

OSProfileProvisioningData

Aanvullende parameters voor het opnieuw opgeven van niet-tijdelijke virtuele machines.

Name	Type	Description
adminPassword	string	Hiermee geeft u het wachtwoord van het beheerdersaccount. Minimale lengte (Windows): 8 tekens Minimale lengte (Linux): 6 tekens Maximale lengte (Windows): 123 tekens Maximale lengte (Linux): 72 tekens Complexiteitsvereisten: aan 3 van de vier onderstaande voorwaarden moet worden voldaan Heeft lagere tekens Bevat bovenste tekens Heeft een cijfer Heeft een speciaal teken (regex-overeenkomst [\W_]) Niet-toegestane waarden: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Wachtwoord!", "Wachtwoord1", "Wachtwoord22", "iloveyou!" Zie De Extern bureaublad-service of het aanmeldingswachtwoord opnieuw instellen op een Windows-VM voor het opnieuw instellen van het wachtwoord Zie Gebruikers, SSH beheren en schijven controleren of herstellen op Azure Linux-VM's met behulp van de VMAccess-extensie voor het opnieuw instellen van het hoofdwachtwoord
customData	string	Hiermee geeft u een base-64 gecodeerde tekenreeks van aangepaste gegevens. De met base 64 gecodeerde tekenreeks wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes. Opmerking: geef geen geheimen of wachtwoorden door in de eigenschap customData. Deze eigenschap kan niet worden bijgewerkt nadat de VM is gemaakt. De eigenschap customData wordt doorgegeven aan de virtuele machine om als een bestand te worden opgeslagen. Zie Aangepaste gegevens op Azure-VM's voor meer informatie. Als u cloud-init gebruikt voor uw Linux-VM, raadpleegt u Cloud-init gebruiken om een Linux-VM aan te passen tijdens het maken.

VirtualMachineScaleSetReimageParameters

Beschrijft een vm-installatiekopieparameters voor virtuele-machineschaalsets.

Name	Type	Description
exactVersion	string	Hiermee geeft u in decimaal getal de versie van de besturingssysteemschijf opnieuw moet worden geïnstalleerd. Als er geen exacte versie is opgegeven, wordt de besturingssysteemschijf opnieuw geïnstalleerd op de bestaande versie van de besturingssysteemschijf.
forceUpdateOSDiskForEphemeral	boolean	Parameter voor het geforceerd bijwerken van tijdelijke besturingssysteemschijf voor een VIRTUELE-machineschaalset-VM
instanceIds	string[]	De instantie-id's van de virtuele-machineschaalset. Als u de exemplaar-id's van de virtuele-machineschaalset weglaat, wordt de bewerking uitgevoerd op alle virtuele machines in de virtuele-machineschaalset.
osProfile	OSProfileProvisioningData	Hiermee geeft u de informatie op die is vereist voor het opnieuw opgeven van de niet-tijdelijke besturingssysteemschijf.
tempDisk	boolean	Hiermee geeft u op of de tijdelijke schijf opnieuw moet worden hersteld. Standaardwaarde: false. Opmerking: deze tijdelijke schijfreimageparameter wordt alleen ondersteund voor VM/VMSS met tijdelijke besturingssysteemschijf.

Virtual Machine Scale Sets - Reimage

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Scopes

Voorbeelden

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Sample Request

Sample Response

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Sample Request

Sample Response

Definities

ApiError

ApiErrorBase

CloudError

InnerError

OSProfileProvisioningData

VirtualMachineScaleSetReimageParameters

Aanvullende resources