Alterar Configuração da Implementação

Artigo
08/05/2023

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.

Partilhar via