Compartilhar via

Alterar configuração de implantação

  • Artigo

A operação assíncrona Change Deployment Configuration inicia uma alteração na configuração de implantação.

Solicitação

A solicitação Change Deployment Configuration pode ser especificada da seguinte maneira. Substitua <subscription-id> pela sua ID de assinatura, <cloudservice-name> pelo nome do serviço em nuvem e <deployment-slot> por staging ou production, ou <deployment-name> pelo nome exclusivo da sua implantação.

Método URI da solicitação
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 URI

Parâmetro do URI Descrição
comp=config Obrigatórios. Especifica que uma alteração deve ser feita na configuração da implantação.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho da solicitação Descrição
Content-Type Obrigatórios. Defina este cabeçalho como application/xml.
x-ms-version Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. Esse cabeçalho deve ser definido como 2009-10-01 ou superior.

Corpo da solicitação

Formato do corpo da solicitação:

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

A tabela a seguir descreve os elementos no corpo da solicitação.

Nome do elemento Descrição
Configuração Obrigatórios. Especifica o arquivo de configuração do serviço codificado em base 64 para a implantação.
TreatWarningsAsError Opcional. Indica se os avisos devem ser tratados como erros.

Os valores possíveis são:

- true
- false

Se esse campo não for especificado, o valor padrão será false. Se definido como true, a atualização será bloqueada quando forem encontrados avisos.

O TreatWarningsAsError elemento só está disponível usando a versão 2011-04-01 ou superior.
Mode Opcional. Os valores possíveis são:

- Auto
- Manual
- Simultaneous

Se não for especificado, o valor padrão será Auto. Se definido como Manual, WalkUpgradeDomain deverá ser chamado para aplicar a atualização. Se definido como Auto, a atualização será aplicada automaticamente a cada domínio da atualização para o serviço.

O Mode elemento só está disponível usando a versão 2011-08-01 ou superior.

A Simultaneous configuração só está disponível usando a versão 2013-03-01 ou superior.
Nome Opcional. Representa o nome de uma propriedade estendida do serviço de nuvem. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter um máximo de 25 pares de nome e valor de propriedade estendida.

O comprimento máximo do elemento Name é de 64 caracteres, somente os caracteres alfanuméricos e sublinhados são válidos no nome, e ele deve começar com uma letra. Tentar usar outros caracteres, começar com um caractere diferente de letra ou inserir um nome que seja idêntico ao de outra propriedade estendida de propriedade do mesmo serviço de nuvem resultará em um erro de código de status 400 (Solicitação Incorreta).

O Name elemento só está disponível usando a versão 2012-03-01 ou superior.
Valor Opcional. Representa o valor de uma propriedade estendida do serviço de nuvem. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter até 25 pares de nome e valor da propriedade estendida, e cada valor de propriedade estendida terá um comprimento máximo de 255 caracteres.

Você pode excluir uma propriedade estendida ao definir o valor como NULL.

O Value elemento só está disponível usando a versão 2012-03-01 ou superior.
ExtensionConfiguration Opcional. Representa uma extensão adicionada ao serviço de nuvem. No Azure, um processo pode ser executado como uma extensão de um serviço de nuvem. Você deve adicionar uma extensão ao serviço de nuvem usando Adicionar Extensão antes que ela possa ser adicionada à implantação durante uma alteração de configuração.

O ExtensionConfiguration elemento só está disponível usando a versão 2013-03-01 ou superior.

ExtensionConfiguration

Representa uma extensão adicionada ao serviço de nuvem.

Nome do elemento Descrição
AllRoles Opcional. Especifica uma lista de extensões aplicadas a todas as funções em uma implantação.
Extensão Obrigatórios. Representa uma extensão que deve ser implantada em uma função em um serviço de nuvem.
NamedRoles Opcional. Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

Extensão

Representa uma extensão que deve ser implantada em uma função em um serviço de nuvem.

Nome do elemento Descrição
ID Obrigatórios. O identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço de nuvem. Você pode encontrar a ID de uma extensão que foi adicionada a um serviço de nuvem usando extensões de lista.
Estado Opcional. Especifica o status da extensão. Este elemento só se aplica a extensões configuradas JSON.

Os valores possíveis são:

- Enable
- Disable
- Uninstall

O valor padrão é Enable.

O State elemento só está disponível usando a versão 2014-06-01 ou superior.

NamedRoles

Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

Nome do elemento Descrição
Função Obrigatórios. Representa uma função específica à qual a extensão é adicionada.
RoleName Obrigatórios. Especifica o nome da função.
Extensão Obrigatórios. Representa uma extensão que deve ser implantada em uma função em um serviço de nuvem.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Como Change Deployment Configuration é uma operação assíncrona, você deve chamar Obter Status da Operação para determinar se a operação foi concluída, falhou ou ainda está em andamento.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais.

Cabeçalho de Resposta Descrição
x-ms-request-id Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento. Para uma operação assíncrona, você pode chamar Obter Status da Operação com o valor do cabeçalho para determinar se a operação foi concluída, falhou ou ainda está em andamento.

Corpo da resposta

Nenhum.