DeploymentOperationsExtensions.UpgradeByNameAsync Méthode

Définition

Espace de noms:

Microsoft.WindowsAzure.Management.Compute

Assembly:

Microsoft.WindowsAzure.Management.Compute.dll

Paquet:

Microsoft.WindowsAzure.Management.Compute v14.0.0

L’opération Mettre à niveau le déploiement par nom lance une mise à jour des instances de rôle dans un déploiement à l’aide du package et de la configuration que vous spécifiez. Pour plus d’informations sur la mise à jour des instances de rôle, consultez Mettre à jour un service Azure à l’adresse http://msdn.microsoft.com/en-us/library/windowsazure/hh472157.aspx. Cette opération est une opération asynchrone. Pour déterminer si la demande a été traitée, appelez Obtenir l’état de l’opération. Pour plus d’informations sur les opérations asynchrones, consultez Suivi des demandes asynchrones de gestion des services à l’adresse http://msdn.microsoft.com/en-us/library/windowsazure/ee460791.aspx. Pour effectuer une mise à jour automatique d’un déploiement, appelez Déploiement de mise à niveau ou Modifier la configuration du déploiement avec l’élément Mode défini sur automatique. La mise à jour est effectuée à partir de ce point sans qu'aucune autre entrée ne soit requise. Vous pouvez appeler Obtenir l’état de l’opération pour déterminer quand la mise à jour est terminée. Pour effectuer une mise à jour manuelle, appelez d’abord Déploiement de mise à niveau avec l’élément Mode défini sur manuel. Ensuite, appelez Walk Upgrade Domain pour mettre à jour chaque domaine dans le déploiement. Vous devez vous assurer que l'opération est terminée en appelant l'état de l'opération avant de mettre à jour le domaine suivant. Important : une mise à jour qui ajoute ou supprime des instances de rôle entraîne une mise à jour de la configuration de tous les rôles déployés dans le service cloud. Les instances de rôle existantes doivent être informées des nouvelles instances de rôle afin que toutes les instances de rôle puissent communiquer ensemble dans le service cloud. Par défaut, un service cloud est déployé avec cinq domaines de mise à jour, qui sont mis à jour un par un pendant une mise à jour sur place. Pour plus d’informations sur la modification du nombre de domaines de mise à jour dans le fichier de définition de service, consultez Schéma de définition de service Azure (fichier .csdef). Pour déterminer le domaine de mise à jour dans lequel un instance particulier s’exécute dans Windows Azure, utilisez la propriété UpdateDomain de la classe RoleInstance. Pour plus d’informations, consultez les informations de référence sur la bibliothèque managée Azure à l’adresse http://msdn.microsoft.com/en-us/library/windowsazure/dd179380.aspx . (voir http://msdn.microsoft.com/en-us/library/windowsazure/ee460793.aspx pour plus d’informations)

public static System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse> UpgradeByNameAsync (this Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations operations, string serviceName, string deploymentName, Microsoft.WindowsAzure.Management.Compute.Models.DeploymentUpgradeParameters parameters);

static member UpgradeByNameAsync : Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations * string * string * Microsoft.WindowsAzure.Management.Compute.Models.DeploymentUpgradeParameters -> System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse>

<Extension()>
Public Function UpgradeByNameAsync (operations As IDeploymentOperations, serviceName As String, deploymentName As String, parameters As DeploymentUpgradeParameters) As Task(Of OperationStatusResponse)

Paramètres

operations

IDeploymentOperations

Référence à Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations.

serviceName

String

Obligatoire. Service cloud à mettre à niveau.

deploymentName

String

Obligatoire. Déploiement à mettre à niveau.

parameters

DeploymentUpgradeParameters

Obligatoire. Paramètres fournis à l’opération Mettre à niveau le déploiement par nom.

Retours

Task<Microsoft.Azure.OperationStatusResponse>

Le corps de la réponse contient le status de l’opération asynchrone spécifiée, indiquant si elle a réussi, est en cours ou a échoué. Notez que cette status est distincte du code http status retourné pour l’opération Obtenir l’état de l’opération elle-même. Si l'opération asynchrone réussit, le corps de la réponse inclut le code d'état HTTP indiquant que la demande a réussi. Si l’opération asynchrone a échoué, le corps de la réponse inclut le code http status pour la demande ayant échoué et les informations d’erreur relatives à l’échec.