DeploymentOperationsExtensions.ReimageRoleInstanceByDeploymentSlotAsync Method (IDeploymentOperations, String, DeploymentSlot, String)

Asynchronously reimages 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

public static Task<OperationStatusResponse> ReimageRoleInstanceByDeploymentSlotAsync(
    this IDeploymentOperations operations,
    string serviceName,
    DeploymentSlot deploymentSlot,
    string roleInstanceName
)

public:
[ExtensionAttribute]
static Task<OperationStatusResponse^>^ ReimageRoleInstanceByDeploymentSlotAsync(
    IDeploymentOperations^ operations,
    String^ serviceName,
    DeploymentSlot deploymentSlot,
    String^ roleInstanceName
)

static member ReimageRoleInstanceByDeploymentSlotAsync : 
        operations:IDeploymentOperations *
        serviceName:string *
        deploymentSlot:DeploymentSlot *
        roleInstanceName:string -> Task<OperationStatusResponse>

<ExtensionAttribute>
Public Shared Function ReimageRoleInstanceByDeploymentSlotAsync (
    operations As IDeploymentOperations,
    serviceName As String,
    deploymentSlot As DeploymentSlot,
    roleInstanceName As String
) As Task(Of OperationStatusResponse)

Parameters

• operations
  Type: Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations

  The IDeploymentOperations object that specifies the deployment operations.

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

Return Value

Type: System.Threading.Tasks.Task<OperationStatusResponse>

The T:Microsoft.WindowsAzure.Management.Compute.Models.ComputeOperationStatusResponse object that contains the status of the operation.

Remarks

If the asynchronous operation succeeds, the response includes the HTTP status code for the successful request. If the asynchronous operation failed, the response includes the HTTP status code for the failed request, and also includes error information about the failure.

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

DeploymentOperationsExtensions Class
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top