Partilhar via

Nodes - Disable Node Scheduling

Serviço:
Batch Service
Versão da API:
2025-06-01

Desativa o agendamento de tarefas no Nó de Computação especificado.
Pode desativar o agendamento de tarefas num nó de computação apenas se o seu estado atual de agendamento estiver ativado.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/disablescheduling?api-version=2025-06-01
Com parâmetros opcionais: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/disablescheduling?api-version=2025-06-01&timeOut={timeOut}

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string (uri)

Ponto de extremidade da conta em lote (por exemplo: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

O ID do Nó de Computação onde pretende desativar o agendamento de tarefas.
poolId
 path True

string

A ID do Pool que contém o Nó de Computação.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.
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 superior a 30, será usado o padrão em vez disso.".

Cabeçalho do Pedido

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

Name Necessário Tipo Description
client-request-id

string

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-rfc7231)

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
nodeDisableSchedulingOption

BatchNodeDisableSchedulingOption

O que fazer com as Tarefas atualmente em execução ao desativar o agendamento de Tarefas no Nó de Computação. O valor padrão é requeue.

Respostas

Name Tipo Description
200 OK

O pedido foi bem-sucedido.

Cabeçalhos

  • DataServiceId: string
  • ETag: string
  • Last-Modified: string
  • client-request-id: string
  • request-id: string
Other Status Codes

BatchError

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

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

Âmbitos

Name Description
https://batch.core.windows.net//.default

Exemplos

Node disable scheduling

Pedido de amostra

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/disablescheduling?api-version=2025-06-01

Resposta da amostra

Código de estado:
200

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

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

BatchNodeDisableSchedulingOption enums
BatchNodeDisableSchedulingOptions

Parâmetros para desabilitar o agendamento em um nó de computação em lote do Azure.

BatchError

Object

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

BatchErrorMessage

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

Object

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.

BatchErrorMessage

Object

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

Name Tipo Description
lang

string

O código da linguagem da mensagem de erro.
value

string

O texto da mensagem.

BatchNodeDisableSchedulingOption

Enumeração

BatchNodeDisableSchedulingOption enums

Valor Description
requeue

Encerre os processos de Tarefas em execução e coloque novamente as Tarefas na fila. As Tarefas podem correr novamente noutros Nós de Computação, ou quando o agendamento de Tarefas for reativado neste Nó de Computação. Entrar no estado offline assim que as Tarefas forem terminadas.
terminate

Encerrar tarefas em execução. As Tarefas serão concluídas com failureInfo indicando que foram encerradas e não serão executadas novamente. Entrar no estado offline assim que as Tarefas forem terminadas.
taskcompletion

Permitir que as Tarefas atualmente em execução sejam concluídas. Não agende novas tarefas enquanto espera. Entra no estado offline quando todas as Tarefas estiverem concluídas.

BatchNodeDisableSchedulingOptions

Object

Parâmetros para desabilitar o agendamento em um nó de computação em lote do Azure.

Name Tipo Description
nodeDisableSchedulingOption

BatchNodeDisableSchedulingOption

O que fazer com as Tarefas atualmente em execução ao desativar o agendamento de Tarefas no Nó de Computação. O valor padrão é requeue.