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.

Namespace:   Microsoft.WindowsAzure.Management.Compute
Assembly:  Microsoft.WindowsAzure.Management.Compute (in Microsoft.WindowsAzure.Management.Compute.dll)

Syntax

Task<AzureOperationResponse> BeginReimagingRoleInstanceByDeploymentSlotAsync(
    string serviceName,
    DeploymentSlot deploymentSlot,
    string roleInstanceName,
    CancellationToken cancellationToken
)

Task<AzureOperationResponse^>^ BeginReimagingRoleInstanceByDeploymentSlotAsync(
    String^ serviceName,
    DeploymentSlot deploymentSlot,
    String^ roleInstanceName,
    CancellationToken cancellationToken
)

abstract BeginReimagingRoleInstanceByDeploymentSlotAsync : 
        serviceName:string *
        deploymentSlot:DeploymentSlot *
        roleInstanceName:string *
        cancellationToken:CancellationToken -> Task<AzureOperationResponse>

Function BeginReimagingRoleInstanceByDeploymentSlotAsync (
    serviceName As String,
    deploymentSlot As DeploymentSlot,
    roleInstanceName As String,
    cancellationToken As CancellationToken
) As Task(Of AzureOperationResponse)

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:

  • Staging

  • Production

• 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.

Remarks

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.

See Also

IDeploymentOperations Interface
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top