IDeploymentOperations::BeginReimagingRoleInstanceByDeploymentSlotAsync Method (String^, DeploymentSlot, String^, CancellationToken)
Asynchronously initiates a reimage of a specified role instance that is running in a specified deployment based on where the application is deployed.
Assembly: Microsoft.WindowsAzure.Management.Compute (in Microsoft.WindowsAzure.Management.Compute.dll)
Task<AzureOperationResponse^>^ BeginReimagingRoleInstanceByDeploymentSlotAsync( String^ serviceName, DeploymentSlot deploymentSlot, String^ roleInstanceName, CancellationToken cancellationToken )
Parameters
- serviceName
-
Type:
System::String^
The name of the cloud service that contains the deployment.
- deploymentSlot
-
Type:
Microsoft.WindowsAzure.Management.Compute.Models::DeploymentSlot
The name of the environment in which the application is deployed.
Possible values are:
- roleInstanceName
-
Type:
System::String^
The name of the role instance that should be reimaged.
- cancellationToken
-
Type:
System.Threading::CancellationToken
The cancellation token.
Return Value
Type: System.Threading.Tasks::Task<AzureOperationResponse^>^An OperationResponse object that includes an HTTP status code and request ID.
For more information about reimaging a role instance, see Reimage Role Instance.
When the role instance is reimaged, the instance is taken offline and a fresh guest operating system image is applied. The role instance is then brought back online. Azure attempts to maintain data in any local storage resources when the role is reimaged; however, in case of a transient hardware failure, the local storage resource may be lost. If your application requires that this data be persisted, it is recommended that you write it to a durable data source, such as a Azure drive. Any data that is written to a local directory other than that defined by the local storage resource will be lost when the role is reimaged.