Compute Node - Reimage

Serviço:

Batch Service

Versão da API:

2024-07-01.20.0

Reinstala o sistema operacional no nó de computação especificado.
Você pode reinstalar o sistema operacional em um nó de computação somente se ele estiver em um estado ocioso ou em execução.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2024-07-01.20.0

Com parâmetros opcionais:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2024-07-01.20.0

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
batchUrl	path	True	string	A URL base para todas as solicitações de serviço do Lote do Azure.
nodeId	path	True	string	A ID do nó de computação que você deseja reiniciar.
poolId	path	True	string	A ID do Pool que contém o Nó de Computação.
api-version	query	True	string	Versão da API do cliente.
timeout	query		integer int32	O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for maior que 30, o padrão será usado.

Cabeçalho do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Necessário	Tipo	Description
client-request-id		string uuid	A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Se o servidor deve retornar o client-request-id na resposta.
ocp-date		string date-time-rfc1123	A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Corpo do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Tipo	Description
nodeReimageOption	ComputeNodeReimageOption	Quando recriar a imagem do Nó de Computação e o que fazer com as Tarefas em execução no momento. O valor padrão é requeue.

Respostas

Name	Tipo	Description
202 Accepted		A solicitação para o serviço de lote foi bem-sucedida. Cabeçalhos client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	O erro do serviço de lote.

Segurança

azure_auth

Fluxo de código de autenticação do Microsoft Entra OAuth 2.0

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	Personificar a sua conta de utilizador

Authorization

Tipo: apiKey
Em: header

Exemplos

Node reimage

Pedido de amostra

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2024-07-01.20.0



{
  "nodeReimageOption": "terminate"
}

Resposta da amostra

Código de estado:

202

Definições

Name	Description
BatchError	Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail	Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
ComputeNodeReimageOption	Quando recriar a imagem do Nó de Computação e o que fazer com as Tarefas em execução no momento.
ErrorMessage	Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
NodeReimageParameter	Opções para criar novas imagens de um nó de computação.

BatchError

Uma resposta de erro recebida do serviço Batch do Azure.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message	ErrorMessage	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values	BatchErrorDetail[]	Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

BatchErrorDetail

Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.

Name	Tipo	Description
key	string	Um identificador que especifica o significado da propriedade Value.
value	string	As informações adicionais incluídas com a resposta de erro.

ComputeNodeReimageOption

Quando recriar a imagem do Nó de Computação e o que fazer com as Tarefas em execução no momento.

Name	Tipo	Description
requeue	string	Encerre os processos de Tarefas em execução e coloque novamente as Tarefas na fila. As Tarefas serão executadas novamente quando um Nó de Computação estiver disponível. Recrie a imagem do nó de computação assim que as tarefas forem encerradas.
retaineddata	string	Permita que as Tarefas atualmente em execução sejam concluídas e, em seguida, aguarde até que todos os períodos de retenção de dados da Tarefa expirem. Não agende novas tarefas enquanto espera. Crie uma nova imagem do nó de computação quando todos os períodos de retenção de tarefas tiverem expirado.
taskcompletion	string	Permitir que as Tarefas atualmente em execução sejam concluídas. Não agende novas tarefas enquanto espera. Recrie a imagem do nó de computação quando todas as tarefas forem concluídas.
terminate	string	Encerrar tarefas em execução. As Tarefas serão concluídas com failureInfo indicando que foram encerradas e não serão executadas novamente. Recrie a imagem do nó de computação assim que as tarefas forem encerradas.

ErrorMessage

Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.

Name	Tipo	Description
lang	string	O código de idioma da mensagem de erro
value	string	O texto da mensagem.

NodeReimageParameter

Opções para criar novas imagens de um nó de computação.

Name	Tipo	Description
nodeReimageOption	ComputeNodeReimageOption	Quando recriar a imagem do Nó de Computação e o que fazer com as Tarefas em execução no momento. O valor padrão é requeue.