Partager via


Consulter le domaine de mise à niveau

L'opération Walk Upgrade Domain asynchrone spécifie un domaine de mise à jour dans lequel une instance de rôle doit être mise à jour.

Requête

La demande Walk Upgrade Domain peut être spécifiée comme suit. remplacez par <subscription-id> l’ID d’abonnement, <cloudservice-name> par le nom du service cloud, <deployment-slot> par staging ou production, et <deployment-name> par le nom du déploiement.

Méthode URI de demande
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain

Paramètres URI

Paramètre d’URI Description
comp=walkupgradedomain Obligatoire. Spécifie que les instances de rôle dans un déploiement sont mises à jour un domaine de mise à jour à la fois pendant une mise à jour sur place manuelle.

En-têtes de requête

Le tableau suivant décrit les en-têtes de la demande.

En-tête de requête Description
Content-Type Obligatoire. Définissez cet en-tête sur la valeur application/xml.
x-ms-version Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur 2009-10-01 ou une valeur supérieure.

Corps de la requête

Le corps de la demande présente le format suivant :

  
<?xml version="1.0" encoding="utf-8"?>  
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">  
  <UpgradeDomain>update-domain-id</UpgradeDomain>  
</WalkUpgradeDomain>  
  

Le tableau suivant décrit les éléments du corps de la demande.

Nom de l'élément Description
UpgradeDomain Obligatoire. Spécifie un entier qui identifie le domaine de mise à jour à mettre jour. Les domaines de mise à jour sont identifiés avec un index de base zéro : le premier domaine de mise à jour a un ID égal à 0, le deuxième un ID égal à 1, etc.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.

En-tête de réponse Description
x-ms-request-id Valeur qui identifie de façon unique une demande effectuée au service de gestion. Pour une opération asynchrone, vous pouvez appeler Obtenir l’état de l’opération avec la valeur de l’en-tête pour déterminer si l’opération est terminée, a échoué ou est toujours en cours.

Corps de la réponse

Aucun.

Notes

Avant d’appeler l’opération Walk Upgrade Domain , vous devez avoir appelé Déploiement de mise à niveau, Modifier la configuration du déploiement ou Restaurer la mise à jour ou la mise à niveau.

Par défaut, un service est déployé avec cinq domaines de mise à jour, qui sont mis à jour un par un pendant une mise à jour sur place.

Pour effectuer une mise à jour manuelle d’un déploiement, procédez comme suit :

  1. Appelez Déploiement de mise à niveau avec l’élément Mode défini sur manual.

  2. Appelez Walk Upgrade Domain pour mettre à jour chaque domaine dans le déploiement. Les domaines de mise à jour doivent être mis à jour dans l'ordre. Par exemple, commencez par le domaine 0, puis passez au domaine 1, etc.

Une mise à jour qui ajoute ou supprime des instances de rôle provoque une mise à jour de la configuration sur tous les rôles qui sont 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.

Pendant qu’une mise à jour est en cours, appelez Get Deployment pour déterminer son status. Si la mise à jour est en cours, Get Deployment retourne un élément UpgradeStatus qui contient des informations sur la mise à jour. Si la mise à jour est terminée, ou si aucune mise à jour n'est en cours, l'élément UpgradeStatus a la valeur null.