Compartir a través de


Pool - Resize

Cambia el número de nodos de proceso asignados a un grupo.
Solo puede cambiar el tamaño de un grupo cuando su estado de asignación sea estable. Si el grupo ya cambia el tamaño, se produce un error en la solicitud con el código de estado 409. Al cambiar el tamaño de un grupo, el estado de asignación del grupo cambia de constante a cambio de tamaño. No se puede cambiar el tamaño de los grupos configurados para el escalado automático. Si intenta hacerlo, el servicio Batch devuelve un error 409. Si cambia el tamaño de un grupo hacia abajo, el servicio Batch elige qué nodos de proceso se van a quitar. Para quitar nodos de proceso específicos, use la API de quitar nodos de proceso en su lugar.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
batchUrl
path True

string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.

poolId
path True

string

Identificador del grupo que se va a cambiar de tamaño.

api-version
query True

string

Versión de la API de cliente.

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 (uuid)

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

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

If-Modified-Since

string (date-time-rfc1123)

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

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.

Cuerpo de la solicitud

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

Nombre Tipo Description
nodeDeallocationOption

ComputeNodeDeallocationOption

Determina qué hacer con un nodo de proceso y sus tareas en ejecución si el tamaño del grupo está disminuyendo.
El valor predeterminado es requeue.

resizeTimeout

string (duration)

Tiempo de espera para la asignación de nodos al grupo o eliminación de nodos de proceso del 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).

targetDedicatedNodes

integer (int32)

Número deseado de nodos de proceso dedicados en el grupo.

targetLowPriorityNodes

integer (int32)

Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo.

Respuestas

Nombre Tipo Description
202 Accepted

La solicitud al servicio Batch se realizó correctamente.

Encabezados

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

BatchError

Error del servicio Batch.

Seguridad

azure_auth

Flujo de código de autenticación de Microsoft Entra OAuth 2.0

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

Ámbitos

Nombre Description
user_impersonation Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Pool resize

Solicitud de ejemplo

POST account.region.batch.azure.com/pools/resizePool/resize?api-version=2024-07-01.20.0



{
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0
}

Respuesta de muestra

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.

ComputeNodeDeallocationOption

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.

ErrorMessage

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

PoolResizeParameter

Opciones para cambiar el tamaño de un grupo.

BatchError

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

ErrorMessage

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

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.

ComputeNodeDeallocationOption

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.

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.

retaineddata

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.

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.

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.

ErrorMessage

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

Texto del mensaje.

PoolResizeParameter

Opciones para cambiar el tamaño de un grupo.

Nombre Tipo Description
nodeDeallocationOption

ComputeNodeDeallocationOption

Determina qué hacer con un nodo de proceso y sus tareas en ejecución si el tamaño del grupo está disminuyendo.
El valor predeterminado es requeue.

resizeTimeout

string (duration)

Tiempo de espera para la asignación de nodos al grupo o eliminación de nodos de proceso del 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).

targetDedicatedNodes

integer (int32)

Número deseado de nodos de proceso dedicados en el grupo.

targetLowPriorityNodes

integer (int32)

Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo.