Exportar (0) Imprimir
Expandir todo

Cambiar configuración de implementación

Actualizado: abril de 2014

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

La operación Change Deployment Configuration es asincrónica. Para determinar si el servicio de administración ha terminado de procesar la solicitud, llame a Obtener estado de la operación. Para obtener más información sobre las llamadas a operaciones asincrónicas, vea Realizar seguimiento de solicitudes asincrónicas de administración de servicios.

La solicitud Change Deployment Configuration se puede especificar como sigue. Tenga en cuenta que puede cambiar la configuración de una implementación especificando el entorno de implementación (almacenamiento provisional o producción), o especificando el nombre único de la implementación.

Para generar la URI de solicitud 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 y <deployment-name> por el nombre único de la implementación.

 

Método URI de solicitud Versión de HTTP

POST

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

HTTP/1.1

POST

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

HTTP/1.1

 

Parámetro URI Descripción

comp=config

Obligatorio. Especifica que se debe realizar un cambio en la configuración de la implementación.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

Content-Type

Obligatorio. Establezca este encabezado en application/xml.

x-ms-version

Obligatorio. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse en 2009-10-01 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 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>
      </Extension>
      ...
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
          ...
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</ChangeConfiguration>

ImportantImportante
El orden de los elementos en el cuerpo de la solicitud es importante. Si se necesita un elemento, debe aparecer en el XML en el orden mostrado anteriormente.

La tabla siguiente describe los elementos clave del cuerpo de la solicitud:

 

Nombre del elemento Descripción

Configuration

Obligatorio. 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 elemento TreatWarningsAsError solamente se encuentra disponible si utiliza la versión 2011-04-01 o versiones posteriores.

Modo

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 elemento Mode solamente se encuentra disponible si utiliza la versión 2011-08-01 o versiones posteriores.

La opción Simultaneous solamente se encuentra disponible si utiliza la versión 2012-12-01 o versiones posteriores.

Name

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

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 valores y nombres de propiedad extendidos, y cada valor de propiedad extendido tiene una longitud máxima de 255 caracteres.

Puede eliminar 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. Representa una extensión que se agrega al servicio en la nube. En Windows Azure, un proceso puede ejecutarse como una extensión de un servicio en la nube. Por ejemplo, el Acceso de escritorio remoto o el Agente de diagnóstico de Windows Azure se pueden ejecutar como extensiones del 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 un cambio de configuración.

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

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

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

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

 

Nombre del elemento Descripción

Id

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

Role

Obligatorio. Representa un rol específico al que se agrega la extensión.

RoleName

Obligatorio. Especifica el nombre del rol.

Extensión

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

Dado que Change Deployment Configuration es una operación asincrónica, debe llamar a Obtener estado de la operación para determinar si la operación se completa, se ha generado un error o aún está en curso.

Dado que Change Deployment Configuration es una operación asincrónica, siempre devuelve el código de estado 202 (Aceptar). Para determinar el código de estado de la operación una vez que se ha completado, llame a Obtener estado de la operación. El código de estado se inserta en la respuesta para esta operación; si se realiza correctamente, será 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 el estado de la operación con el valor del encabezado para determinar si la operación se ha completado, ha generado un error o aún está en curso. Para obtener más información, vea Realizar seguimiento de solicitudes asincrónicas de administración de servicios.

Cualquier certificado de administración asociado a la suscripción especificada por <subscription-id> se puede usar para autenticar esta operación. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguno.

Mostrar:
© 2014 Microsoft