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 |
---|---|---|---|---|
batch
|
path | True |
string |
O URL base para todos os pedidos de serviço Azure Batch. |
node
|
path | True |
string |
O ID do Nó de Computação que pretende reiniciar. |
pool
|
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 |
Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução. |
Respostas
Name | Tipo | Description |
---|---|---|
202 Accepted |
O pedido para o serviço Batch foi efetuado com êxito. Cabeçalhos
|
|
Other Status Codes |
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 |
---|---|
Batch |
Uma resposta de erro recebida do serviço Azure Batch. |
Batch |
Um item de informações adicionais incluídas numa resposta de erro Azure Batch. |
Compute |
Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução. |
Error |
Uma mensagem de erro recebida numa resposta de erro Azure Batch. |
Node |
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 |
Uma mensagem que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador. |
|
values |
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 |
Quando reiniciar o Nó de Computação e o que fazer com tarefas atualmente em execução. |