Percorrer Domínio de Atualização

Artigo
07/19/2023

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

Pedir

O Walk Upgrade Domain 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, e <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>/?comp=walkupgradedomain`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain`

Parâmetros do URI

Parâmetro URI	Description
`comp=walkupgradedomain`	Obrigatório. Especifica que as instâncias de função numa implementação são atualizadas um domínio de atualização de cada vez durante uma atualização manual no local.

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

A tabela seguinte descreve os elementos no corpo do pedido.

Nome do elemento	Descrição
UpgradeDomain	Obrigatório. Especifica um valor inteiro que identifica o domínio de atualização a atualizar. Os domínios de atualização são identificados com um índice baseado em zero: o primeiro domínio de atualização tem um ID de 0, o segundo tem um ID de 1, etc.

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

Observações

Antes de chamar a Walk Upgrade Domain operação, tem de ter chamado Implementação de Atualização, Alterar Configuração de Implementação ou Atualização de Reversão ou Atualização.

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

Para efetuar uma atualização manual de uma implementação, proceda por esta ordem:

Chamar Implementação de Atualização com o Mode elemento definido como manual.
Chame Walk Upgrade Domain para atualizar cada domínio na implementação. Os domínios de atualização têm de ser atualizados por ordem. Por exemplo, comece com o domínio 0, avance para o domínio 1 e assim sucessivamente.

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.

Enquanto uma atualização estiver em curso, chame Obter Implementação para determinar o respetivo estado. Se a atualização estiver em curso, Get Deployment devolve um UpgradeStatus elemento que contém informações sobre a atualização. Se a atualização estiver concluída ou se não estiver em curso nenhuma atualização, o UpgradeStatus elemento será nulo.

Partilhar via