Atualizar Implementação

Artigo
08/05/2023

A Upgrade Deployment operação assíncrona inicia uma atualização das instâncias de função numa implementação com o pacote e a configuração que especificar.

Pedir

O Upgrade Deployment pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo ID da subscrição, <cloudservice-name> pelo nome do serviço cloud, <deployment-slot> por staging ou production, ou <deployment-name> pelo nome da 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=upgrade`	Obrigatório. Especifica que a implementação tem de ser atualizada.

Cabeçalhos do 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"?>  
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Mode>type-of-upgrade</Mode>  
  <PackageUrl>url-to-package</PackageUrl>  
  <Configuration>base64-encoded-config-file</Configuration>  
  <Label>base-64-encoded-label</Label>  
  <RoleToUpgrade>role-name</RoleToUpgrade>  
  <Force>true|false</Force>  
  <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>  
</UpgradeDeployment>

A tabela seguinte descreve os elementos no corpo do pedido.

Nome do elemento	Descrição
Modo	Obrigatório. Especifica o tipo de atualização a iniciar. As instâncias de função são alocadas para atualizar domínios quando o serviço é implementado. Atualizações podem ser iniciadas manualmente em cada domínio de atualização ou iniciadas automaticamente em todos os domínios de atualização. Os valores possíveis são: - `Auto` - `Manual` - `Simultaneous` Se não for especificado, o valor predefinido é `Auto`. Se 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 em sequência. A `Simultaneous` definição só está disponível na versão 2012-12-01 ou superior.
PackageUrl	Obrigatório. Especifica um URL que se refere à localização do pacote de serviço no serviço Blob. O pacote de serviço pode estar localizado numa conta de armazenamento abaixo da mesma subscrição ou num URI de Assinatura de Acesso Partilhado (SAS) a partir de qualquer conta de armazenamento. Para obter mais informações sobre Assinaturas de Acesso Partilhado, consulte Delegar o Acesso com uma Assinatura de Acesso Partilhado.
Configuração	Obrigatório. Especifica o ficheiro de configuração de serviço codificado base-64 para a implementação.
Etiqueta	Obrigatório. Especifica o nome do serviço cloud que está codificado em base-64. O nome pode ter até 100 carateres de comprimento. Recomenda-se que a etiqueta seja exclusiva na subscrição. O nome pode ser utilizado para identificar o serviço cloud para as suas finalidades de controlo.
RoleToUpgrade	Opcional. Especifica o nome da instância de função específica a atualizar. Na atualização de função única, todas as outras funções ainda podem ser recicladas se existir uma atualização interna do Azure agendada. O domínio de atualização é garantido neste cenário.
Force	Obrigatório. Indica se a atualização deve continuar mesmo quando fará com que os dados locais sejam perdidos de algumas instâncias de função. `True` se a atualização continuar; caso contrário `false`, . O `Force` elemento só está disponível com a versão 2011-10-01 ou superior.
Name	Opcional. Especifica 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 propriedades e valores expandidos. O comprimento máximo do `Name` elemento é de 64 carateres, apenas os carateres alfanuméricos e os carateres de sublinhado são válidos no nome e o nome tem de começar com uma letra. Tentar utilizar outros carateres, começar com um caráter não letra ou introduzir um nome que seja idêntico ao de outra propriedade expandida pertencente ao mesmo serviço cloud, resultará num erro de código de estado 400 (Pedido Incorreto). O `Name` elemento só está disponível com a versão 2012-03-01 ou superior.
Valor	Opcional. Especifica 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. Elimina uma propriedade expandida ao definir o valor como NULL. O `Value` elemento só está disponível com a versão 2012-03-01 ou superior.
ExtensionConfiguration	Opcional. Especifica 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 utilizando Adicionar Extensão antes de poder ser adicionada à implementação durante uma atualização. O `ExtensionConfiguration` elemento só está disponível com a versão 2013-03-01 ou superior.

ExtensionConfiguration

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

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

Nome do elemento	Descrição
Id	Obrigatório. Especifica 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. Especifica uma função específica à qual a extensão é adicionada.
RoleName	Obrigatório. Especifica o nome da função.
Extensão	Obrigatório. Especifica 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.

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 relativamente ao 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, se falhou ou se ainda está em curso.

Corpo da Resposta

Nenhum.

Observações

Para efetuar uma atualização automática de uma implementação, chame a Implementação de Atualização ou Alterar a Configuração da Implementação com o Mode elemento definido como automatic. A atualização prossegue a partir desse ponto sem necessidade de mais entradas. Pode chamar Obter Estado da Operação para determinar quando a atualização está concluída.

Para efetuar uma atualização manual, chame primeiro a Implementação de Atualização com o Mode elemento definido como manual. Em seguida, chame WalkUpgradeDomain para atualizar cada domínio na implementação. Deve certificar-se de que a operação está concluída ao chamar Obter Estado da Operação antes de atualizar o domínio seguinte.

Uma atualização que adiciona ou remove instâncias de função resultará numa atualização de configuração para todas as funções implementadas no serviço cloud. As instâncias de função existentes têm de ser notificadas de novas instâncias de função para que todas as instâncias de função possam comunicar em conjunto no serviço cloud.

Por predefinição, um serviço cloud é implementado com cinco domínios de atualização, que são atualizados um de cada vez durante uma atualização no local.

Para determinar o domínio de atualização no qual uma determinada instância está em execução, utilize a UpdateDomain propriedade da RoleInstance classe .