DeploymentOperationsExtensions.BeginReimagingRoleInstanceByDeploymentSlot Method (IDeploymentOperations, String, DeploymentSlot, String)
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
public static AzureOperationResponse BeginReimagingRoleInstanceByDeploymentSlot(
this IDeploymentOperations operations,
string serviceName,
DeploymentSlot deploymentSlot,
string roleInstanceName
)
public:
[ExtensionAttribute]
static AzureOperationResponse^ BeginReimagingRoleInstanceByDeploymentSlot(
IDeploymentOperations^ operations,
String^ serviceName,
DeploymentSlot deploymentSlot,
String^ roleInstanceName
)
static member BeginReimagingRoleInstanceByDeploymentSlot :
operations:IDeploymentOperations *
serviceName:string *
deploymentSlot:DeploymentSlot *
roleInstanceName:string -> AzureOperationResponse
<ExtensionAttribute>
Public Shared Function BeginReimagingRoleInstanceByDeploymentSlot (
operations As IDeploymentOperations,
serviceName As String,
deploymentSlot As DeploymentSlot,
roleInstanceName As String
) As AzureOperationResponse
Parameters
operations
Type: Microsoft.WindowsAzure.Management.Compute.IDeploymentOperationsThe IDeploymentOperations object that specifies the deployment operations.
serviceName
Type: System.StringThe name of the cloud service that contains the deployment.
deploymentSlot
Type: Microsoft.WindowsAzure.Management.Compute.Models.DeploymentSlotThe name of the environment in which the application is deployed.
Possible values are:
roleInstanceName
Type: System.StringThe 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