Exportar (0) Imprimir
Expandir todo

Actualizar implementación

Actualizado: febrero de 2015

La operación asincrónica Upgrade Deployment inicia una actualización de las instancias de rol en una implementación con el paquete y la configuración que especifique. Para obtener más información acerca de la actualización de instancias de rol, vea Actualizar un servicio de Azure.

La solicitud Upgrade Deployment se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción, <cloudservice-name> por el nombre del servicio en la nube, <deployment-slot> por staging o production, o <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>/

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

 

Parámetro URI Descripción

comp=upgrade

Requerido. Especifica que se debe actualizar la implementación.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

Content-Type

Requerido. Establezca este encabezado en application/xml.

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 01/10/2009 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

El formato del cuerpo de la solicitud es el siguiente:


<?xml version="1.0" encoding="utf-8"?>
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">
  <Mode>type-of-upgrade</Mode>
  <PackageUrl>url-to-package</PackageUrl>
  <Configuration>base64-encoded-config-file</Configuration>
  <Label>base-64-encoded-label</Label>
  <RoleToUpgrade>role-name</RoleToUpgrade>
  <Force>true|false</Force>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>property-name</Name>
      <Value>property-value</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
      </Extension>
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</UpgradeDeployment>

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

 

Nombre del elemento Descripción

Mode

Requerido. Especifica el tipo de actualización que se va a iniciar. Las instancias de rol se asigna para actualizar dominios cuando se implementa el servicio. Las actualizaciones se pueden iniciar manualmente en cada dominio de actualización o iniciar automáticamente en todos dominios de actualización. Los valores posibles son:

  • Auto

  • Manual

  • Simultaneous

Si no se especifica, el valor predeterminado es Auto. Si se establece en Manual, se debe llamar a WalkUpgradeDomain para aplicar la actualización. Si se establece en Auto, la actualización se aplica automáticamente a cada dominio en secuencia.

El valor Simultaneous solamente se encuentra disponible en la versión 2012-12-01 o posterior.

PackageUrl

Requerido. Especifica una dirección URL que hace referencia a la ubicación del paquete de servicio del servicio Blob. El paquete de servicio puede encontrarse en una cuenta de almacenamiento bajo la misma suscripción o una URI de Firma de acceso compartido (SAS) de cualquier cuenta de almacenamiento. Para obtener más información sobre las Firmas de acceso compartido, vea Delegar el acceso con una firma de acceso compartido.

Configuración

Requerido. Especifica el archivo de configuración del servicio codificado en base 64 para la implementación.

Etiqueta

Requerido. Especifica el nombre del servicio en la nube que está codificado en base 64. El nombre puede tener hasta 100 caracteres. Se recomienda que la etiqueta sea única dentro de la suscripción. El nombre se puede utilizar para identificar el servicio en la nube con fines de seguimiento.

RoleToUpgrade

Opcional. Especifica el nombre de la instancia de rol específica que se va a actualizar.

Force

Requerido. Indica si la recuperación debe continuar aunque esta dé lugar a la pérdida de datos locales para algunas instancias de rol. True si la recuperación debe continuar; de lo contrario, false.

El elemento Force solamente se encuentra disponible si utiliza la versión 01/10/2011 o versiones posteriores.

Nombre

Opcional. Especifica el nombre de una propiedad de servicio en la nube extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede tener un máximo de 25 pares de valores y nombres de propiedad extendidos.

La longitud máxima del elemento Name es de 64 caracteres, solo los caracteres alfanuméricos y caracteres de subrayado son válidos en el nombre, y el nombre debe comenzar por una letra. Intentar utilizar otros caracteres, empezando con un carácter no alfanumérico, o escribir un nombre idéntico al de otra propiedad extendida propiedad del mismo servicio en la nube, producirá un error de código de estado 400 (Solicitud incorrecta).

El elemento Name solamente se encuentra disponible si utiliza la versión 2012-03-01 o versiones posteriores.

Valor

Opcional. Especifica el valor de una propiedad de servicio en la nube extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede tener un máximo de 25 pares de valores y nombres de propiedad extendidos, y cada valor de propiedad extendido tiene una longitud máxima de 255 caracteres.

Elimina una propiedad extendida estableciendo el valor NULL.

El elemento Value solamente se encuentra disponible si utiliza la versión 2012-03-01 o versiones posteriores.

ExtensionConfiguration

Opcional. Especifica una extensión que se agrega al servicio en la nube. En Azure, un proceso puede ejecutarse como una extensión de un servicio en la nube. Debe agregar una extensión al servicio en la nube usando Agregar extensión antes de poder agregarla a la implementación durante una actualización.

El elemento ExtensionConfiguration solamente se encuentra disponible si utiliza la versión 01/03/2013 o versiones posteriores.

Especifica una extensión que se agrega al servicio en la nube.

 

Nombre del elemento Descripción

AllRoles

Opcional. Especifica una lista de extensiones que se aplican a todos los roles en una implementación.

Extension

Requerido. Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

NamedRoles

Opcional. Especifica una lista de extensiones que se aplican a todos los roles especificados en una implementación.

Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

 

Nombre del elemento Descripción

Id

Requerido. Especifica el identificador de la extensión. Se crea el identificador cuando la extensión se agrega al servicio en la nube. Puede encontrar el id. de una extensión con Enumerar extensionesla que se ha agregado a un servicio en la nube.

Especifica una lista de extensiones que se aplican a todos los roles especificados en una implementación.

 

Nombre del elemento Descripción

Rol

Requerido. Especifica un rol específico al que se agrega la extensión.

RoleName

Requerido. Especifica el nombre del rol.

Extension

Requerido. Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

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

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

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 Obtener estado de la operación con el valor del encabezado para determinar si se ha completado la operación, ha generado un error o aún está en curso.

Para realizar una actualización automática de una implementación, llame a Actualizar implementación o a Cambiar configuración de implementación con el elemento Mode establecido en automatic. La actualización continúa desde ese punto sin necesidad de entrada adicional. Puede llamar a Obtener estado de la operación para determinar cuándo se completa la actualización.

Para realizar una actualización manual, primero llame a Actualizar implementación con el elemento Mode establecido en manual. A continuación, llame a Recorrer dominio de actualización para actualizar cada dominio en la implementación. Debe asegurarse de que la operación se completa llamando a Obtener el estado de la operación antes de actualizar el dominio siguiente.

ImportantImportante
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.

De forma predeterminada, un servicio en la nube se implementa con cinco dominios de actualización, que se actualizan de uno en uno durante una actualización en contexto. Para obtener información sobre la modificación del número de dominios de actualización en el archivo de definición del servicio, vea Esquema de definición del servicio de Windows Azure (archivo .csdef).

Para determinar el dominio de actualización en el que se ejecute una instancia determinada, utilice la propiedad UpdateDomain de la clase RoleInstance. Vea Microsoft Azure Managed Library Reference para obtener más información.

Mostrar:
© 2015 Microsoft