Recorrer dominio de actualización

La operación asincrónica Walk Upgrade Domain especifica un dominio de actualización en el que debe actualizarse una instancia de rol.

Request

La solicitud Walk Upgrade Domain se puede especificar como sigue. reemplace <subscription-id> por el identificador de suscripción, <cloudservice-name> por el nombre del servicio en la nube, <deployment-slot> por staging o production, y <deployment-name> por el nombre de la implementación.

Método	URI de solicitud
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

Parámetros de identificador URI

Parámetro del URI	Descripción
comp=walkupgradedomain	Necesario. Especifica que las instancias de rol en una implementación están actualizando un dominio de actualización a la vez durante una actualización manual en contexto.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
Content-Type	Necesario. Establezca este encabezado en application/xml.
x-ms-version	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse 2009-10-01 en o superior.

Cuerpo de la solicitud

El formato del cuerpo de la solicitud es el siguiente:

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

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

Nombre del elemento	Descripción
UpgradeDomain	Necesario. Especifica un valor entero que identifica el dominio de actualización que se va a actualizar. Los dominios de actualización se identifican mediante un índice basado en cero: el primer dominio de actualización tiene un identificador de 0, el segundo un identificador de 1, y así sucesivamente.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta	Descripción
x-ms-request-id	Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a Get Operation Status con el valor del encabezado para determinar si la operación se ha completado, ha producido un error o sigue en curso.

Cuerpo de la respuesta

Ninguno.

Comentarios

Antes de llamar a la Walk Upgrade Domain operación, debe haber llamado Upgrade Deployment, Change Deployment Configuration o Rollback Update Or Upgrade.

De forma predeterminada, un servicio se implementa con cinco dominios de actualización, que se actualizan a la vez durante una actualización en contexto.

Para realizar una actualización manual de una implementación, siga este orden:

1. Llame a Upgrade Deployment con el Mode elemento establecido en manual.

2. Llame a Walk Upgrade Domain para actualizar cada dominio en la implementación. Los dominios de actualización deben actualizarse en orden. Por ejemplo, comience con el dominio 0, después con el dominio 1, y así sucesivamente.

Una actualización que agregue o quite instancias de rol producirá una actualización de la configuración de todos los roles que se implementen en el servicio en la nube. Las instancias de rol existentes deben ser informadas de las nuevas instancias rol para todas ellas se pueda comunicar entre sí en el servicio en la nube.

Mientras una actualización está en curso, llame a Get Deployment para determinar su estado. Si la actualización está en curso, Get Deployment devuelve un elemento UpgradeStatus que contiene información acerca de la actualización. Si se completa la actualización, o si no hay ninguna actualización en curso, el elemento UpgradeStatus es NULL.