VENDAS: 1-800-867-1389

Alterar configuração de implantação

Atualizado: fevereiro de 2015

A operação assíncrona Change Deployment Configuration inicia uma alteração na configuração de implantação.

A solicitação Change Deployment Configuration pode ser especificada da seguinte maneira. Substitua <subscription-id> pela sua ID de assinatura, <cloudservice-name> pelo nome do serviço em nuvem e <deployment-slot> por staging ou production, ou <deployment-name> pelo nome exclusivo da sua implantação.

 

Método URI de 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>/

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

 

Parâmetro URI Descrição

comp=config

Obrigatória. Especifica que uma alteração deve ser feita na configuração da implantação.

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

 

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

Content-Type

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

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01.10.09 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"?>
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">
  <Configuration>base-64-encoded-configuration-file</Configuration>
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>
  <Mode>type-of-change</Mode>
  <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>
</ChangeConfiguration>

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

 

Nome do elemento Descrição

Configuração

Obrigatória. Especifica o arquivo de configuração do serviço codificado em base 64 para a implantação.

TreatWarningsAsError

Opcional. Indica se os avisos devem ser tratados como erros.

Os possíveis valores são:

  • true

  • false

Se não for especificado, o valor padrão será false. Se definido como true, a atualização será bloqueada quando forem encontrados avisos.

O elemento TreatWarningsAsError só estará disponível com a versão 01.04.11 ou superior.

Modo

Opcional. Os possíveis valores são:

  • Auto

  • Manual

  • Simultaneous

Se 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 para o serviço.

O elemento Mode só estará disponível com a versão 01.08.11 ou superior.

A configuração Simultaneous só estará disponível com a versão 2012-12-01 ou superior.

Nome

Opcional. Representa 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 ele 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 elemento Name só estará disponível com a versão 01.03.12 ou superior.

Valor

Opcional. Representa 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ê pode excluir uma propriedade estendida ao definir o valor como NULL.

O elemento Value só estará disponível com a versão 01.03.12 ou superior.

ExtensionConfiguration

Opcional. Representa uma extensão 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 do serviço de nuvem usando Adicionar extensão antes que ela possa ser adicionada à implantação em uma alteração de configuração.

O elemento ExtensionConfiguration só estará disponível com a versão 01.03.13 ou superior.

Representa uma extensão 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ória. Representa 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.

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

 

Nome do elemento Descrição

Id

Obrigatória. O identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço de nuvem. Você pode localizar a Id de uma extensão que foi adicionada a um serviço de nuvem usando Listar extensões.

Estado

Opcional. Especifica o status da extensão. Este elemento só se aplica a extensões configuradas JSON.

Os possíveis valores são:

  • Enable

  • Disable

  • Uninstall

O valor padrão é Enable.

O elemento State só estará disponível com a versão 01.06.14 ou superior.

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

 

Nome do elemento Descrição

Função

Obrigatória. Representa uma função específica à qual a extensão é adicionada.

RoleName

Obrigatória. Especifica o nome da função.

Extensão

Obrigatória. Representa uma extensão que deve ser implantada em uma função em um serviço de nuvem.

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

Como Change Deployment Configuration é 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.

Uma operação bem-sucedida retorna o 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 chamar Obter 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.

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2015 Microsoft