Compartir a través de

Pools - Delete Pool

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

Elimina un grupo de la cuenta especificada.
Al solicitar que se elimine un grupo, se producen las siguientes acciones: el estado del grupo se establece en eliminar; cualquier operación de cambio de tamaño en curso en el grupo se detiene; El servicio Batch comienza a cambiar el tamaño del grupo a cero nodos de proceso; las tareas que se ejecutan en nodos de proceso existentes se finalizan y se vuelven a poner en cola (como si se hubiera solicitado una operación de grupo de cambio de tamaño con la opción de requeue predeterminada); Por último, el grupo se quita del sistema. Dado que las tareas en ejecución se vuelven a poner en cola, el usuario puede volver a ejecutar estas tareas actualizando su trabajo para tener como destino un grupo diferente. A continuación, las tareas se pueden ejecutar en el nuevo grupo. Si desea invalidar el comportamiento de requeue, debe llamar al tamaño del grupo explícitamente para reducir el tamaño del grupo a cero antes de eliminar el grupo. Si llama a una API Update, Patch o Delete en un grupo en el estado de eliminación, se producirá un error con el código de estado HTTP 409 con el código de error PoolBeingDeleted.

DELETE {endpoint}/pools/{poolId}?api-version=2025-06-01
Con parámetros opcionales: 
DELETE {endpoint}/pools/{poolId}?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

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.

Respuestas

Nombre Tipo Description
202 Accepted

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

Encabezados

  • 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 delete

Solicitud de ejemplo

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

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.

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.