DeploymentOperationsExtensions.WalkUpgradeDomainByDeploymentSlotAsync Method

Definition

The Walk Upgrade Domain By Deployment Slot operation specifies an update domain in which a role instance must be updated. For more information about updating role instances, see Update an Azure Service at http://msdn.microsoft.com/en-us/library/windowsazure/hh472157.aspx. This operation is an asynchronous operation. To determine whether the Management service has finished processing the request, call Get Operation Status. For more information on asynchronous operations, see Tracking Asynchronous Service Management Requests at http://msdn.microsoft.com/en-us/library/windowsazure/ee460791.aspx. Prior to calling the Walk Upgrade Domain operation you must have called Upgrade Deployment, Change Deployment Configuration, or Rollback Update Or Upgrade. By default, a service is deployed with five update domains, which are updated one at a time during an in-place update. For information on modifying the number of update domains in the service definition file, see the Azure Service Definition Schema (.csdef File). To perform a manual update of your deployment, proceed in this order: Call Upgrade Deployment with the Mode element set to manual. Call Walk Upgrade Domain to update each domain within the deployment. Update domains must be updated in order. For example, begin with domain 0, proceed to domain 1, and so on. Important: An update that adds or removes role instances will result in a configuration update to all roles that are deployed in the cloud service. Existing role instances need to be notified of new role instances so that all role instances can communicate together in the cloud service. While an update is in progress, call Get Deployment to determine its status. If the update is in progress, Get Deployment returns an UpgradeStatus element that contains information about the update. If the update is complete, or if no update is in progress, then the UpgradeStatus element is null. (see http://msdn.microsoft.com/en-us/library/windowsazure/ee460800.aspx for more information)

public static System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse> WalkUpgradeDomainByDeploymentSlotAsync (this Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations operations, string serviceName, Microsoft.WindowsAzure.Management.Compute.Models.DeploymentSlot deploymentSlot, Microsoft.WindowsAzure.Management.Compute.Models.DeploymentWalkUpgradeDomainParameters parameters);
static member WalkUpgradeDomainByDeploymentSlotAsync : Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations * string * Microsoft.WindowsAzure.Management.Compute.Models.DeploymentSlot * Microsoft.WindowsAzure.Management.Compute.Models.DeploymentWalkUpgradeDomainParameters -> System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse>
<Extension()>
Public Function WalkUpgradeDomainByDeploymentSlotAsync (operations As IDeploymentOperations, serviceName As String, deploymentSlot As DeploymentSlot, parameters As DeploymentWalkUpgradeDomainParameters) As Task(Of OperationStatusResponse)

Parameters

operations
IDeploymentOperations

Reference to the Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations.

serviceName
String

Required. The name of the cloud service.

deploymentSlot
DeploymentSlot

Required. The deployment slot.

parameters
DeploymentWalkUpgradeDomainParameters

Required. Parameters supplied to the Walk Upgrade Domain By Deployment Slot operation.

Returns

Task<Microsoft.Azure.OperationStatusResponse>

The response body contains the status of the specified asynchronous operation, indicating whether it has succeeded, is inprogress, or has failed. Note that this status is distinct from the HTTP status code returned for the Get Operation Status operation itself. If the asynchronous operation succeeded, the response body includes the HTTP status code for the successful request. If the asynchronous operation failed, the response body includes the HTTP status code for the failed request and error information regarding the failure.

Applies to