Share via


DeploymentOperationsExtensions.BeginReimagingRoleInstanceByDeploymentNameAsync Method

Asynchronously initiates a reimage of a specified role instance that is running in a specified deployment.

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

Usage

'Usage
Dim operations As IDeploymentOperations
Dim serviceName As String
Dim deploymentName As String
Dim roleInstanceName As String
Dim returnValue As Task(Of AzureOperationResponse)

returnValue = DeploymentOperationsExtensions.BeginReimagingRoleInstanceByDeploymentNameAsync(operations, serviceName, deploymentName, roleInstanceName)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function BeginReimagingRoleInstanceByDeploymentNameAsync ( _
    operations As IDeploymentOperations, _
    serviceName As String, _
    deploymentName As String, _
    roleInstanceName As String _
) As Task(Of AzureOperationResponse)
[ExtensionAttribute] 
public static Task<AzureOperationResponse> BeginReimagingRoleInstanceByDeploymentNameAsync (
    IDeploymentOperations operations,
    string serviceName,
    string deploymentName,
    string roleInstanceName
)
[ExtensionAttribute] 
public:
static Task<AzureOperationResponse^>^ BeginReimagingRoleInstanceByDeploymentNameAsync (
    IDeploymentOperations^ operations, 
    String^ serviceName, 
    String^ deploymentName, 
    String^ roleInstanceName
)
/** @attribute ExtensionAttribute() */ 
public static Task<AzureOperationResponse> BeginReimagingRoleInstanceByDeploymentNameAsync (
    IDeploymentOperations operations, 
    String serviceName, 
    String deploymentName, 
    String roleInstanceName
)
ExtensionAttribute 
public static function BeginReimagingRoleInstanceByDeploymentNameAsync (
    operations : IDeploymentOperations, 
    serviceName : String, 
    deploymentName : String, 
    roleInstanceName : String
) : Task<AzureOperationResponse>

Parameters

  • serviceName
    The name of the cloud service that contains the deployment.
  • deploymentName
    The name of deployment that contains the roles.
  • roleInstanceName
    The name of the role instance that should be reimaged.

Return Value

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.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Target Platforms

See Also

Reference

DeploymentOperationsExtensions Class
DeploymentOperationsExtensions Members
Microsoft.WindowsAzure.Management.Compute Namespace