Percorrer Domínio de Atualização

Artigo
07/19/2023

A operação assíncrona Walk Upgrade Domain especifica um domínio de atualização em que uma instância de função deve ser atualizada.

Solicitação

A solicitação Walk Upgrade Domain pode ser especificada da seguinte maneira. substitua <subscription-id> pela ID da assinatura, <cloudservice-name> pelo nome do serviço de nuvem, <deployment-slot> por staging ou productione <deployment-name> pelo nome da implantação.

Método	URI da solicitação
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain`

Parâmetros de URI

Parâmetro do URI	Descrição
`comp=walkupgradedomain`	Obrigatórios. Especifica que as instâncias em uma implantação são atualizadas um domínio de atualização de cada vez durante uma atualização in-loco manual.

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"?>  
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">  
  <UpgradeDomain>update-domain-id</UpgradeDomain>  
</WalkUpgradeDomain>

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

Nome do elemento	Descrição
UpgradeDomain	Obrigatórios. Especifica um valor inteiro que identifica o domínio de atualização a ser atualizado. Os domínios de atualização são identificados com um índice de base zero: o primeiro domínio de atualização tem uma ID 0, o segundo domínio de atualização tem uma ID 1 e assim por diante.

Resposta

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

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.

Comentários

Antes de chamar a Walk Upgrade Domain operação, você deve ter chamado Implantação de Atualização, Alterar Configuração de Implantação ou Reverter Atualização ou Atualização.

Por padrão, um serviço é implantado com cinco domínios de atualização, que são atualizados um de cada vez durante uma atualização in-loco.

Para executar uma atualização manual de uma implantação, prossiga nesta ordem:

Chame Upgrade Deployment com o Mode elemento definido como manual.
Chame Walk Upgrade Domain para atualizar cada domínio na implantação. Os domínios de atualização devem ser atualizados em ordem. Por exemplo, inicie com o domínio 0, prossiga para o domínio 1 e assim por diante.

Uma atualização que adiciona ou remove instâncias de função resultará em uma atualização de configuração para todas as funções implantadas no serviço de nuvem. As instâncias de função existentes a serem notificadas de novas instâncias de função de forma que todas as instâncias de função possam se comunicar no serviço de nuvem.

Enquanto uma atualização estiver em andamento, chame Obter Implantação para determinar sua status. Se a atualização estiver em andamento, Get Deployment retornará um elemento UpgradeStatus que contém informações sobre a atualização. Se a atualização tiver sido concluída, ou se nenhuma atualização estiver em andamento, o elemento UpgradeStatus será nulo.

Compartilhar via