Actualizar implementación

Artículo
07/19/2023

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.

Request

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>/`

Parámetros de identificador URI

Parámetro del URI	Descripción
`comp=upgrade`	Necesario. Especifica que se debe actualizar la implementación.

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"?>  
<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>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </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	Necesario. 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	Necesario. Especifica una dirección URL que hace referencia a la ubicación del paquete de Blob service. 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, consulte Delegación de acceso con una firma de acceso compartido.
Configuración	Necesario. Especifica el archivo de configuración del servicio codificado en base 64 para la implementación.
Etiqueta	Necesario. 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. En la actualización de un solo rol, todos los demás roles pueden seguir reciclando si hay una actualización interna de Azure programada. El dominio de actualización se garantiza en este escenario.
Force	Necesario. Indica si la actualización debe continuar incluso cuando se pierdan datos locales de algunas instancias de rol. `True` si la actualización debe continuar; de lo contrario `false`, . El `Force` elemento solo está disponible con la versión 2011-10-01 o posterior.
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 nombre y valor extendidos de propiedad. 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 `Name` elemento solo está disponible con la versión 2012-03-01 o posterior.
Value	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 nombre de propiedad extendida y valor, y cada valor de propiedad extendida tiene una longitud máxima de 255 caracteres. Elimina una propiedad extendida estableciendo el valor NULL. El `Value` elemento solo está disponible con la versión 2012-03-01 o posterior.
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 mediante Agregar extensión para poder agregarla a la implementación durante una actualización. El `ExtensionConfiguration` elemento solo está disponible con la versión 2013-03-01 o posterior.

ExtensionConfiguration

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.
Extensión	Necesario. 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.

Extensión

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

Nombre del elemento	Descripción
Identificador	Necesario. 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 identificador de una extensión que se agregó a un servicio en la nube mediante extensiones de lista.
State	Opcional. Especifica el estado de la extensión. Este elemento se aplica solo a extensiones configuradas con JSON. Los valores posibles son: - `Enable` - `Disable` - `Uninstall` El valor predeterminado es `Enable`. El `State` elemento solo está disponible con la versión 2014-06-01 o posterior.

NamedRoles

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

Nombre del elemento	Descripción
Role	Necesario. Especifica un rol específico al que se agrega la extensión.
RoleName	Necesario. Especifica el nombre del rol.
Extensión	Necesario. Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

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

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

Para realizar una actualización manual, llame primero a Upgrade Deployment con el Mode elemento establecido en manual. A continuación, llame a WalkUpgradeDomain para actualizar cada dominio dentro de 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.

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 determinar el dominio de actualización en el que se ejecute una instancia determinada, utilice la propiedad UpdateDomain de la clase RoleInstance.