Exportar (0) Imprimir
Expandir Tudo

Função de desligamento

Atualizado: maio de 2014

A operação Shutdown Role desliga a Máquina Virtual especificada.

A solicitação Shutdown Role pode ser especificada da seguinte maneira. Substitua <subscription-id> pela ID da assinatura, <cloudservice-name> pelo nome do serviço em nuvem, <deployment-name> pelo nome da implantação e <role-name> pelo nome da máquina virtual.

 

Método URI de solicitação

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roleinstances/<role-name>/Operations

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.

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

 

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

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

    
<ShutdownRoleOperation xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <OperationType>ShutdownRoleOperation</OperationType>
  <PostShutdownAction>shutdown-action</PostShutdownAction>
</ShutdownRoleOperation>

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

 

Nome do elemento Descrição

OperationType

Obrigatória. Especifica a operação a ser executada.

O valor deve ser definido como ShutdownRoleOperation.

PostShutdownAction

Opcional. Especifica como a Máquina Virtual deve ser desligada.

Os possíveis valores são:

  • Parado – desliga a Máquina Virtual mas retém os recursos de computação. Você continuará a ser cobrado pelos recursos usados pela máquina parada.

  • StoppedDeallocated – desliga a Máquina Virtual e libera os recursos de computação. Você não é cobrado pelos recursos de computação usados por essa Máquina Virtual. Se um endereço IP estático da Rede Virtual for atribuído à Máquina Virtual, ele será reservado. Para obter mais informações, consulte StaticVirtualNetworkIPAddress em Obter função.

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

Se esse elemento não for especificado, a ação padrão será Parada.

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

Uma operação bem-sucedida retorna o código de status 202 (Aceito). 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.

Você também pode desligar uma máquina virtual usando o Portal de Gerenciamento ou usando o cmdlet Stop-AzureVM.

Se você está fechando a última execução da máquina virtual na implantação com um PostShutdownAction do StoppedDeallocated e a implantação está usando um endereço IP reservado, o endereço continua a ser reservado para a sua assinatura. O endereço IP reservado não utilizado continua a incorrer em custos. Para obter mais informações, consulte Preços de IP reservado. Para excluir o endereço IP reservado, se não é mais necessário, use Delete Reserved IP Address.

Mostrar:
© 2015 Microsoft