Share via


DeploymentOperationsExtensions.BeginReimagingRoleInstanceByDeploymentName Method (IDeploymentOperations, String, String, String)

 

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)

Syntax

public static AzureOperationResponse BeginReimagingRoleInstanceByDeploymentName(
    this IDeploymentOperations operations,
    string serviceName,
    string deploymentName,
    string roleInstanceName
)
public:
[ExtensionAttribute]
static AzureOperationResponse^ BeginReimagingRoleInstanceByDeploymentName(
    IDeploymentOperations^ operations,
    String^ serviceName,
    String^ deploymentName,
    String^ roleInstanceName
)
static member BeginReimagingRoleInstanceByDeploymentName : 
        operations:IDeploymentOperations *
        serviceName:string *
        deploymentName:string *
        roleInstanceName:string -> AzureOperationResponse
<ExtensionAttribute>
Public Shared Function BeginReimagingRoleInstanceByDeploymentName (
    operations As IDeploymentOperations,
    serviceName As String,
    deploymentName As String,
    roleInstanceName As String
) As AzureOperationResponse

Parameters

  • serviceName
    Type: System.String

    The name of the cloud service that contains the deployment.

  • deploymentName
    Type: System.String

    The name of deployment that contains the roles.

  • roleInstanceName
    Type: System.String

    The name of the role instance that should be reimaged.

Return Value

Type: Microsoft.Azure.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

DeploymentOperationsExtensions Class
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top