Exportar (0) Imprimir
Expandir Tudo

Percorrer Domínio de Atualização

Atualizado: abril de 2014

A operação Walk Upgrade Domain especifica um domínio de atualização em que uma instância de função deve ser atualizada. Para obter mais informações sobre como atualizar instâncias de função, consulte Atualizar um serviço do Windows Azure.

A operação Walk Upgrade Domain é assíncrona. Para determinar se o serviço de Gerenciamento concluiu o processamento da solicitação, chame Obter status da operação. Para obter mais informações sobre operações assíncronas, consulte Controlando solicitações assíncronas de gerenciamento de serviço.

A solicitação Walk Upgrade Domain pode ser especificada da seguinte maneira. Você pode atualizar domínios especificando o ambiente de implantação (preparo ou produção) ou especificando o nome exclusivo da implantação.

Para gerar o URI da solicitação, substitua <subscription-id> por sua ID da assinatura, <cloudservice-name> pelo nome do serviço de nuvem, <deployment-slot> por staging ou production e <deployment-name> pelo nome exclusivo da sua implantação.

 

Método URI de solicitação Versão HTTP

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain

HTTP/1.1

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain

HTTP/1.1

 

Parâmetro URI Descrição

comp=walkupgradedomain

Obrigatório. 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.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

Content-Type

Obrigatório. Defina este cabeçalho como application/xml.

x-ms-version

Obrigatório. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 2009-10-01 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviç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 principais elementos no corpo da solicitação:

 

Nome do elemento Descrição

UpgradeDomain

Obrigatório. 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.

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

Como Walk Upgrade Domain é uma operação assíncrona, você deverá chamar Obter status da operação para determinar se a operação foi concluída, se falhou ou se ainda está em andamento. Se você estiver atualizando vários domínios, deverá chamar o Status da Operação Get para garantir que a atualização seja concluída antes da atualização do próximo domínio.

Como Walk Upgrade Domain é uma operação assíncrona, sempre retornará o código de status 202 (aceitar). Para determinar o código de status da operação assim que ela for concluída, chame Obter status da operação. O código de status é incorporado na resposta para esta operação; se for bem-sucedido, será código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

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 obter o status da operação com o valor do cabeçalho para determinar se a operação foi concluída, se falhou ou se ainda está em andamento. Consulte Controlando solicitações assíncronas de gerenciamento de serviço para obter mais informações.

Qualquer certificado de gerenciamento associado à assinatura especificada por <subscription-id> pode ser usado para autenticar esta operação. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Antes de chamar a operação Walk Upgrade Domain, você deverá ter chamado Atualizar implantação, Alterar configuração de implantação ou Atualização de reversã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 obter informações sobre como modificar o número de domínios de atualização no arquivo de definição de serviço, consulte Esquema de definição de serviço do Windows Azure (arquivo .csdef).

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

  1. Chame Atualizar implantação com o elemento Mode definido como manual.

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

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

Quando uma atualização estiver em andamento, chame Obter implantação para determinar seu 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.

Mostrar:
© 2014 Microsoft