IVirtualMachinesOperations.BeginReimageWithHttpMessagesAsync Method

Definition

Overloads

BeginReimageWithHttpMessagesAsync(String, String, VirtualMachineReimageParameters, Dictionary<String,List<String>>, CancellationToken)

Reimages (upgrade the operating system) a virtual machine 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. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.

BeginReimageWithHttpMessagesAsync(String, String, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

Reimages the virtual machine which has an ephemeral OS disk back to its initial state.

BeginReimageWithHttpMessagesAsync(String, String, VirtualMachineReimageParameters, Dictionary<String,List<String>>, CancellationToken)

Reimages (upgrade the operating system) a virtual machine 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. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> BeginReimageWithHttpMessagesAsync (string resourceGroupName, string vmName, Microsoft.Azure.Management.Compute.Models.VirtualMachineReimageParameters parameters = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member BeginReimageWithHttpMessagesAsync : string * string * Microsoft.Azure.Management.Compute.Models.VirtualMachineReimageParameters * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
Public Function BeginReimageWithHttpMessagesAsync (resourceGroupName As String, vmName As String, Optional parameters As VirtualMachineReimageParameters = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)

Parameters

resourceGroupName
String

The name of the resource group.

vmName
String

The name of the virtual machine.

parameters
VirtualMachineReimageParameters

Parameters supplied to the Reimage Virtual Machine operation.

customHeaders
Dictionary<String,List<String>>

The headers that will be added to request.

cancellationToken
CancellationToken

The cancellation token.

Returns

Exceptions

Thrown when the operation returned an invalid status code

Thrown when a required parameter is null

Applies to

BeginReimageWithHttpMessagesAsync(String, String, Nullable<Boolean>, Dictionary<String,List<String>>, CancellationToken)

Reimages the virtual machine which has an ephemeral OS disk back to its initial state.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> BeginReimageWithHttpMessagesAsync (string resourceGroupName, string vmName, bool? tempDisk = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member BeginReimageWithHttpMessagesAsync : string * string * Nullable<bool> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
Public Function BeginReimageWithHttpMessagesAsync (resourceGroupName As String, vmName As String, Optional tempDisk As Nullable(Of Boolean) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)

Parameters

resourceGroupName
String

The name of the resource group.

vmName
String

The name of the virtual machine.

tempDisk
Nullable<Boolean>

Specifies whether to reimage temp disk. Default value: false. Note: This temp disk reimage parameter is only supported for VM/VMSS with Ephemeral OS disk.

customHeaders
Dictionary<String,List<String>>

The headers that will be added to request.

cancellationToken
CancellationToken

The cancellation token.

Returns

Exceptions

Thrown when the operation returned an invalid status code

Thrown when a required parameter is null

Applies to