Atualizar implantação

A operação Upgrade Deployment assíncrona inicia uma atualização de instâncias de função em uma implantação usando o pacote e a configuração que você especifica.

Solicitação

A solicitação Upgrade Deployment pode ser especificada da seguinte maneira. Substitua <subscription-id> pela ID de assinatura, <cloudservice-name> pelo nome do serviço em nuvem e <deployment-slot> por staging ou production, ou <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>/
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

Parâmetros de URI

Parâmetro do URI	Descrição
comp=upgrade	Obrigatórios. Especifica que a implantação deve ser atualizada.

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"?>  
<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 a seguir descreve os elementos no corpo da solicitação.

Nome do elemento	Descrição
Mode	Obrigatórios. Especifica o tipo de atualização a ser iniciada. As instâncias de função são alocadas para atualizar domínios quando o serviço é implantado. As atualizações podem ser iniciadas manualmente em cada domínio de atualização ou ser iniciadas automaticamente em todos os domínios da atualização. Os valores possíveis são: - Auto - Manual - Simultaneous Se esse campo não for especificado, o valor padrão será Auto. Se definido como Manual, WalkUpgradeDomain deverá ser chamado para aplicar a atualização. Se definido como Auto, a atualização será aplicada automaticamente a cada domínio da atualização na sequência. A configuração Simultaneous só estará disponível na versão 2012-12-01 ou superior.
PackageUrl	Obrigatórios. Especifica uma URL que faz referência ao local do pacote de serviço no serviço Blob. O pacote de serviço pode estar localizado em uma conta de armazenamento abaixo da mesma assinatura ou um URI de assinatura de acesso compartilhado (SAS) de qualquer conta de armazenamento. Para obter mais informações sobre assinaturas de acesso compartilhado, consulte Delegando acesso com uma assinatura de acesso compartilhado.
Configuração	Obrigatórios. Especifica o arquivo de configuração do serviço codificado em base 64 para a implantação.
Rótulo	Obrigatórios. Especifica o nome do serviço em nuvem codificado em base 64. O nome pode ter até 100 caracteres. É recomendável que o rótulo seja exclusivo dentro da assinatura. O nome pode ser usado para identificar o serviço de nuvem para suas finalidades de acompanhamento.
RoleToUpgrade	Opcional. Especifica o nome da instância de função específica a ser atualizada. Na atualização de função única, todas as outras funções ainda poderão ser recicladas se houver uma atualização interna do Azure agendada. O domínio de atualização é garantido nesse cenário.
Force	Obrigatórios. Indica se a atualização deve continuar mesmo quando ela faz com que os dados locais sejam perdidos de algumas instâncias de função. True se a atualização deve continuar; caso contrário false, . O Force elemento só está disponível usando a versão 2011-10-01 ou superior.
Nome	Opcional. Especifica o nome de uma propriedade estendida do serviço de nuvem. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter um máximo de 25 pares de nome e valor de propriedade estendida. O comprimento máximo do elemento Name é de 64 caracteres, somente os caracteres alfanuméricos e sublinhados são válidos no nome, e o nome deve começar com uma letra. Tentar usar outros caracteres, começar com um caractere diferente de letra ou inserir um nome que seja idêntico ao de outra propriedade estendida de propriedade do mesmo serviço de nuvem resultará em um erro de código de status 400 (Solicitação Incorreta). O Name elemento só está disponível usando a versão 2012-03-01 ou superior.
Valor	Opcional. Especifica o valor de uma propriedade estendida do serviço de nuvem. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter até 25 pares de nome e valor da propriedade estendida, e cada valor de propriedade estendida terá um comprimento máximo de 255 caracteres. Você exclui uma propriedade estendida ao definir o valor como NULL. O Value elemento só está disponível usando a versão 2012-03-01 ou superior.
ExtensionConfiguration	Opcional. Especifica uma extensão que é adicionada ao serviço de nuvem. No Azure, um processo pode ser executado como uma extensão de um serviço de nuvem. Você deve adicionar uma extensão ao serviço de nuvem usando Adicionar Extensão antes que ela possa ser adicionada à implantação durante uma atualização. O ExtensionConfiguration elemento só está disponível usando a versão 2013-03-01 ou superior.

ExtensionConfiguration

Especifica uma extensão que é adicionada ao serviço de nuvem.

Nome do elemento	Descrição
AllRoles	Opcional. Especifica uma lista de extensões aplicadas a todas as funções em uma implantação.
Extensão	Obrigatórios. Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.
NamedRoles	Opcional. Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

Extensão

Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.

Nome do elemento	Descrição
ID	Obrigatórios. Especifica o identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço de nuvem. Você pode encontrar a ID de uma extensão que foi adicionada a um serviço de nuvem usando extensões de lista.
Estado	Opcional. Especifica o status da extensão. Este elemento só se aplica a extensões configuradas JSON. Os valores possíveis são: - Enable - Disable - Uninstall O valor padrão é Enable. O State elemento só está disponível usando a versão 2014-06-01 ou superior.

NamedRoles

Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

Nome do elemento	Descrição
Função	Obrigatórios. Especifica uma função específica à qual a extensão é adicionada.
RoleName	Obrigatórios. Especifica o nome da função.
Extensão	Obrigatórios. Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.

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

Para executar uma atualização automática de uma implantação, chame Atualizar Implantação ou Alterar Configuração de Implantação com o Mode elemento definido como automatic. A atualização continuará a partir desse ponto sem a necessidade de uma entrada adicional. Você pode chamar Obter Status da Operação para determinar quando a atualização está concluída.

Para executar uma atualização manual, primeiro chame Upgrade Deployment com o Mode elemento definido como manual. Em seguida, chame WalkUpgradeDomain para atualizar cada domínio dentro da implantação. Você deve ter certeza de que a operação está completa chamando o Status de da Operação Get antes de atualizar o próximo domínio.

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.

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

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