Compartir a través de

Pools - Remove Nodes

Servicio:
Batch Service
Versión de la API:
2025-06-01

Quita los nodos de proceso del grupo especificado.
Esta operación solo se puede ejecutar cuando el estado de asignación del grupo es estable. Cuando se ejecuta esta operación, el estado de asignación cambia de constante a cambio de tamaño. Cada solicitud puede quitar hasta 100 nodos.

POST {endpoint}/pools/{poolId}/removenodes?api-version=2025-06-01
Con parámetros opcionales: 
POST {endpoint}/pools/{poolId}/removenodes?api-version=2025-06-01&timeOut={timeOut}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string (uri)

Punto de conexión de la cuenta de Batch (por ejemplo: https://batchaccount.eastus2.batch.azure.com).
poolId
 path True

string

Identificador del grupo que se va a obtener.
api-version
 query True

string

minLength: 1

La versión de API que se va a utilizar para esta operación.
timeOut
 query

integer (int32)

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.".

Encabezado de la solicitud

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

Nombre Requerido Tipo Description
client-request-id

string

La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date

string (date-time-rfc7231)

Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.
If-Modified-Since

string (date-time-rfc7231)

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.
If-Unmodified-Since

string (date-time-rfc7231)

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.
If-Match

string

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.
If-None-Match

string

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

Cuerpo de la solicitud

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

Nombre Requerido Tipo Description
nodeList True

string[]

Lista que contiene los identificadores de los nodos de proceso que se van a quitar del grupo especificado. Se puede quitar un máximo de 100 nodos por solicitud.
nodeDeallocationOption

BatchNodeDeallocationOption

Determina qué hacer con un nodo de proceso y sus tareas en ejecución después de que se haya seleccionado para la desasignación. El valor predeterminado es requeue.
resizeTimeout

string (duration)

Tiempo de espera para la eliminación de nodos de proceso en el grupo. El valor predeterminado es 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch devuelve un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).

Respuestas

Nombre Tipo Description
202 Accepted

La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado.

Encabezados

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

BatchError

Una respuesta de error inesperada.

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ámbitos

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

Ejemplos

Pool remove nodes

Solicitud de ejemplo

POST {endpoint}/pools/poolId/removenodes?api-version=2025-06-01



{
  "nodeList": [
    "tvm-1695681911_1-20161122t224741z",
    "tvm-1695681911_2-20161122t224741z"
  ]
}

Respuesta de muestra

status code:
202

Definiciones

Nombre Description
BatchError

Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.
BatchErrorMessage

Mensaje de error recibido en una respuesta de error de Azure Batch.
BatchNodeDeallocationOption

BatchNodeDeallocationOption enums
BatchNodeRemoveOptions

Parámetros para quitar nodos de un grupo de Azure Batch.

BatchError

Objeto

Respuesta de error recibida del servicio Azure Batch.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message

BatchErrorMessage

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values

BatchErrorDetail[]

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Objeto

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.

Nombre Tipo Description
key

string

Identificador que especifica el significado de la propiedad Value.
value

string

La información adicional incluida con la respuesta de error.

BatchErrorMessage

Objeto

Mensaje de error recibido en una respuesta de error de Azure Batch.

Nombre Tipo Description
lang

string

El código de idioma del mensaje de error.
value

string

El texto del mensaje.

BatchNodeDeallocationOption

Enumeración

BatchNodeDeallocationOption enums

Valor Description
requeue

Finalice los procesos de tarea en ejecución y vuelva a poner en cola las tareas. Las tareas se ejecutarán de nuevo cuando haya un nodo de proceso disponible. Quite los nodos de proceso tan pronto como se hayan terminado las tareas.
terminate

Finalizar las tareas en ejecución. Las tareas se completarán con failureInfo que indica que finalizaron y no se volverán a ejecutar. Quite los nodos de proceso tan pronto como se hayan terminado las tareas.
taskcompletion

Permitir que las tareas en ejecución se completen actualmente. Programe ninguna nueva tarea mientras espera. Quite nodos de proceso cuando se hayan completado todas las tareas.
retaineddata

En desuso, le recomendamos que cargue los datos de la tarea en Azure Storage en su tarea y los use TaskCompletion en su lugar. Permita que las tareas en ejecución se completen y espere a que expiren todos los períodos de retención de datos de tareas. Programe ninguna nueva tarea mientras espera. Quite nodos de proceso cuando hayan expirado todos los períodos de retención de tareas.

BatchNodeRemoveOptions

Objeto

Parámetros para quitar nodos de un grupo de Azure Batch.

Nombre Tipo Description
nodeDeallocationOption

BatchNodeDeallocationOption

Determina qué hacer con un nodo de proceso y sus tareas en ejecución después de que se haya seleccionado para la desasignación. El valor predeterminado es requeue.
nodeList

string[]

Lista que contiene los identificadores de los nodos de proceso que se van a quitar del grupo especificado. Se puede quitar un máximo de 100 nodos por solicitud.
resizeTimeout

string (duration)

Tiempo de espera para la eliminación de nodos de proceso en el grupo. El valor predeterminado es 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch devuelve un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).