Reimage Role Instance

  • Artigo

A Reimage Role Instance operação assíncrona reinstala o sistema operativo em instâncias de funções Web ou funções de trabalho.

Pedir

O Reimage Role Instance 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, ou <deployment-name> pelo nome da implementação. Substitua <role-instance-name> pelo nome da instância de função.

Método URI do pedido
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/roleinstances/<role-instance-name>
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roleinstances/<role-instance-name>

Parâmetros do URI

Parâmetro URI Description
comp=reimage Obrigatório. Especificou que uma instância de uma função tem de ser reimageda.

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. O valor deste cabeçalho tem de ser definido como 2010-10-28 ou superior.
ContentLength Obrigatório. Tem de estar definido como 0.

Corpo do Pedido

Nenhum.

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

Quando a instância de função é reimageda, a instância é colocada offline e é aplicada uma nova imagem do sistema operativo convidado. Em seguida, a instância de função é novamente colocada online. É feita uma tentativa de manter os dados em quaisquer recursos de armazenamento local quando a função é reimageda; no entanto, em caso de falha transitória do hardware, o recurso de armazenamento local pode ser perdido. Se a sua aplicação exigir que estes dados sejam mantidos, recomenda-se que os escreva numa origem de dados durável, como uma unidade do Azure. Todos os dados escritos num diretório local diferente do definido pelo recurso de armazenamento local serão perdidos quando a função for recriada.