Alterar Configuração da Implementação

  • Artigo

A Change Deployment Configuration operação assíncrona inicia uma alteração à configuração da implementação.

Pedir

O Change Deployment Configuration pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo seu ID de subscrição, <cloudservice-name> pelo nome do serviço cloud, <deployment-slot> por staging ou production, ou <deployment-name> pelo nome exclusivo da sua implementação.

Método URI do pedido
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 do URI

Parâmetro URI Description
comp=config Obrigatório. Especifica que tem de ser feita uma alteração à configuração da implementação.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Description
Content-Type Obrigatório. Defina este cabeçalho como application/xml.
x-ms-version Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como 2009-10-01 ou superior.

Corpo do Pedido

O formato do corpo do pedido é o seguinte:

  
<?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 seguinte descreve os elementos no corpo do pedido.

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

Os valores possíveis são:

- true
- false

Se não for especificado, o valor predefinido é false. Se estiver definida como true, a atualização será bloqueada quando forem encontrados avisos.

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

- Auto
- Manual
- Simultaneous

Se não for especificado, o valor predefinido é Auto. Se estiver definido como Manual, WalkUpgradeDomain tem de ser chamado para aplicar a atualização. Se estiver definida como Auto, a atualização é aplicada automaticamente a cada domínio de atualização do serviço.

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

A Simultaneous definição só está disponível através da versão 2013-03-01 ou superior.
Name Opcional. Representa o nome de uma propriedade de serviço cloud expandida. Cada propriedade expandida tem de ter um nome e um valor definidos. Pode ter um máximo de 25 pares de nomes de propriedades e valores expandidos.

O comprimento máximo do Name elemento é de 64 carateres, apenas carateres alfanuméricos e carateres de sublinhado são válidos no nome e tem de começar com uma letra. Tentar utilizar outros carateres, começar com um caráter sem letra ou introduzir um nome idêntico ao de outra propriedade expandida que pertence ao mesmo serviço cloud, resultará num erro de código de estado 400 (Pedido Incorreto).

O Name elemento só está disponível através da versão 2012-03-01 ou superior.
Valor Opcional. Representa o valor de uma propriedade de serviço cloud expandida. Cada propriedade expandida tem de ter um nome e um valor definidos. Pode ter um máximo de 25 pares de nomes de propriedades e valores expandidos e cada valor de propriedade expandida tem um comprimento máximo de 255 carateres.

Pode eliminar uma propriedade expandida ao definir o valor como NULL.

O Value elemento só está disponível através da versão 2012-03-01 ou superior.
ExtensionConfiguration Opcional. Representa uma extensão que é adicionada ao serviço cloud. No Azure, um processo pode ser executado como uma extensão de um serviço cloud. Tem de adicionar uma extensão ao serviço cloud através da opção Adicionar Extensão antes de poder ser adicionada à implementação durante uma alteração de configuração.

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

ExtensionConfiguration

Representa uma extensão que é adicionada ao serviço cloud.

Nome do elemento Descrição
AllRoles Opcional. Especifica uma lista de extensões que são aplicadas a todas as funções numa implementação.
Extensão Obrigatório. Representa uma extensão que deve ser implementada numa função num serviço cloud.
NamedRoles Opcional. Especifica uma lista de extensões que são aplicadas a funções específicas numa implementação.

Extensão

Representa uma extensão que deve ser implementada numa função num serviço cloud.

Nome do elemento Descrição
Id Obrigatório. O identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço cloud. Pode encontrar o ID de uma extensão que foi adicionada a um serviço cloud com Extensões de Lista.
Estado Opcional. Especifica o estado da extensão. Este elemento aplica-se apenas a extensões configuradas por JSON.

Os valores possíveis são:

- Enable
- Disable
- Uninstall

O valor predefinido é Enable.

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

NamedRoles

Especifica uma lista de extensões que são aplicadas a funções específicas numa implementação.

Nome do elemento Descrição
Função Obrigatório. Representa uma função específica à qual a extensão é adicionada.
RoleName Obrigatório. Especifica o nome da função.
Extensão Obrigatório. Representa uma extensão que deve ser implementada numa função num serviço cloud.

Resposta

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

Uma Change Deployment Configuration vez que é uma operação assíncrona, tem de chamar Obter Estado da Operação para determinar se a operação está concluída, falhou ou ainda está em curso.

Código de Estado

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

Cabeçalhos de Resposta

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

Cabeçalho de Resposta Description
x-ms-request-id Um valor que identifica exclusivamente um pedido feito no serviço de gestão. Para uma operação assíncrona, pode chamar Obter Estado da Operação com o valor do cabeçalho para determinar se a operação está concluída, falhou ou ainda está em curso.

Corpo da Resposta

Nenhum.