IVirtualMachinesOperations.BeginReimageWithHttpMessagesAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
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
