Cambiar configuración de implementación

Artículo
07/19/2023

La operación asincrónica Change Deployment Configuration inicia un cambio en la configuración de implementación.

Request

La solicitud Change Deployment Configuration 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 único 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=config`	Necesario. Especifica que se debe realizar un cambio en la configuración de 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"?>  
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">  
  <Configuration>base-64-encoded-configuration-file</Configuration>  
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>  
  <Mode>type-of-change</Mode>  
  <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>  
</ChangeConfiguration>

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

Nombre del elemento	Descripción
Configuración	Necesario. Especifica el archivo de configuración del servicio codificado en base 64 para la implementación.
TreatWarningsAsError	Opcional. Indica si las advertencias deben tratarse como errores. Los valores posibles son: - `true` - `false` Si no se especifica, el valor predeterminado es `false`. Si se establece en `true`, la actualización se bloqueará cuando se produzcan advertencias. El `TreatWarningsAsError` elemento solo está disponible con la versión 2011-04-01 o posterior.
Mode	Opcional. 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 de actualización para el servicio. El `Mode` elemento solo está disponible con la versión 2011-08-01 o posterior. La `Simultaneous` configuración solo está disponible con la versión 2013-03-01 o posterior.
Nombre	Opcional. Representa 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 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. Representa 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 y valor extendidos de propiedad, y cada valor de propiedad extendida tiene una longitud máxima de 255 caracteres. Puede eliminar una propiedad extendida estableciendo el valor NULL. El `Value` elemento solo está disponible con la versión 2012-03-01 o posterior.
ExtensionConfiguration	Opcional. Representa 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 un cambio de configuración. El `ExtensionConfiguration` elemento solo está disponible con la versión 2013-03-01 o posterior.

ExtensionConfiguration

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

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

Nombre del elemento	Descripción
Identificador	Necesario. 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. Representa un rol específico al que se agrega la extensión.
RoleName	Necesario. Especifica el nombre del rol.
Extensión	Necesario. Representa 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.

Dado Change Deployment Configuration que es una operación asincrónica, debe llamar a Get Operation Status para determinar si la operación se ha completado, ha producido un error o sigue en curso.

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.

Compartir a través de