Partilhar via


Compute Node - Reboot

Reinicia o Nó de Computação especificado.
Só pode reiniciar um Nó de Computação se estiver inativo ou em execução.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?timeout={timeout}&api-version=2023-11-01.18.0

Parâmetros do URI

Name Em Necessário Tipo Description
batchUrl
path True

string

O URL base para todos os pedidos de serviço Azure Batch.

nodeId
path True

string

O ID do Nó de Computação que pretende reiniciar.

poolId
path True

string

O ID do Conjunto que contém o Nó de Computação.

api-version
query True

string

Versão da API de Cliente.

timeout
query

integer

int32

O tempo máximo que o servidor pode gastar a processar o pedido, em segundos. A predefinição é 30 segundos.

Cabeçalho do Pedido

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

Name Necessário Tipo Description
client-request-id

string

uuid

A identidade do pedido gerado pelo autor da chamada, sob a forma de um GUID sem decoração, como chavetas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Se o servidor deve devolver o client-request-id na resposta.

ocp-date

string

date-time-rfc1123

A hora em que o pedido foi emitido. Normalmente, as bibliotecas de cliente definem isto como a hora atual do relógio do sistema; defina-a explicitamente se estiver a chamar a API REST diretamente.

Corpo do Pedido

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

Name Tipo Description
nodeRebootOption

ComputeNodeRebootOption

Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução.
O valor predefinido é voltar à fila.

Respostas

Name Tipo Description
202 Accepted

O pedido para o serviço Batch foi efetuado com êxito.

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 Batch.

Segurança

azure_auth

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

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

Âmbitos

Name Description
user_impersonation Representar a sua conta de utilizador

Authorization

Tipo: apiKey
Em: header

Exemplos

Node reboot

Pedido de amostra

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2023-11-01.18.0



{
  "nodeRebootOption": "terminate"
}

Resposta da amostra

Definições

Name Description
BatchError

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

BatchErrorDetail

Um item de informações adicionais incluídas numa resposta de erro Azure Batch.

ComputeNodeRebootOption

Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução.

ErrorMessage

Uma mensagem de erro recebida numa resposta de erro Azure Batch.

NodeRebootParameter

Opções para reiniciar um Nó de Computação.

BatchError

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

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 que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador.

values

BatchErrorDetail[]

Uma coleção de pares chave-valor que contém detalhes adicionais sobre o erro.

BatchErrorDetail

Um item de informações adicionais incluídas numa resposta de erro Azure Batch.

Name Tipo Description
key

string

Um identificador que especifica o significado da propriedade Valor.

value

string

As informações adicionais incluídas na resposta do erro.

ComputeNodeRebootOption

Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução.

Name Tipo Description
requeue

string

Termine os processos de tarefas em execução e volte a pôr em fila as Tarefas. As Tarefas serão novamente executadas quando um Nó de Computação estiver disponível. Reinicie o Nó de Computação assim que as Tarefas tiverem sido terminadas.

retaineddata

string

Permita que as Tarefas atualmente em execução sejam concluídas e, em seguida, aguarde que todos os períodos de retenção de dados da Tarefa expirem. Não agende tarefas novas enquanto aguarda. Reinicie o 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 estejam concluídas. Não agende tarefas novas enquanto aguarda. Reinicie o Nó de Computação quando todas as Tarefas estiverem concluídas.

terminate

string

Terminar Tarefas em execução. As Tarefas serão concluídas com failureInfo a indicar que foram terminadas e que não serão executadas novamente. Reinicie o Nó de Computação assim que as Tarefas tiverem sido terminadas.

ErrorMessage

Uma mensagem de erro recebida numa resposta de erro Azure Batch.

Name Tipo Description
lang

string

O código de idioma da mensagem de erro

value

string

O texto da mensagem.

NodeRebootParameter

Opções para reiniciar um Nó de Computação.

Name Tipo Description
nodeRebootOption

ComputeNodeRebootOption

Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução.
O valor predefinido é voltar à fila.