Pool - Enable Auto Scale
Habilita el escalado automático para un grupo.
No se puede habilitar el escalado automático en un grupo si hay una operación de cambio de tamaño en curso en el grupo. Si el escalado automático del grupo está deshabilitado actualmente, debe especificar una fórmula de escalabilidad automática válida como parte de la solicitud. Si el escalado automático del grupo ya está habilitado, puede especificar una nueva fórmula de escalado automático o un nuevo intervalo de evaluación. No se puede llamar a esta API para el mismo grupo de más de una vez cada 30 segundos.
POST {batchUrl}/pools/{poolId}/enableautoscale?api-version=2023-11-01.18.0POST {batchUrl}/pools/{poolId}/enableautoscale?timeout={timeout}&api-version=2023-11-01.18.0Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
batch
|
path | True |
string |
Dirección URL base de todas las solicitudes de servicio de Azure Batch. |
|
pool
|
path | True |
string |
Identificador del grupo en el que se va a habilitar el escalado automático. |
|
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. |
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 a la que se emitió la solicitud. Normalmente, las bibliotecas cliente establecen esto en la hora actual del reloj del sistema; 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 se realizará solo 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 la ú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 la última modificación del recurso conocido para el cliente. La operación se realizará solo 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 |
|---|---|---|
| autoScaleEvaluationInterval |
string |
Intervalo de tiempo en el que ajustar automáticamente el tamaño del grupo según la fórmula de escalado automático. |
| autoScaleFormula |
string |
Fórmula para el número deseado de nodos de proceso en el grupo. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La solicitud al servicio Batch se realizó correctamente. Headers
|
|
| Other Status Codes |
Error del servicio Batch. |
Seguridad
azure_auth
flujo de código de autenticación de OAuth 2.0 Microsoft Entra
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Nombre | Description |
|---|---|
| user_impersonation | Suplantación de su cuenta de usuario |
Authorization
Type:
apiKey
In:
header
Ejemplos
Pool enable autoscale
Sample Request
POST account.region.batch.azure.com/pools/poolId/enableautoscale?api-version=2023-11-01.18.0
{
"autoScaleFormula": "$TargetDedicated=0",
"autoScaleEvaluationInterval": "PT8M"
}
Sample Response
Definiciones
| Nombre | Description |
|---|---|
|
Batch |
Respuesta de error recibida del servicio Azure Batch. |
|
Batch |
Elemento de información adicional incluida en una respuesta de error Azure Batch. |
|
Error |
Mensaje de error recibido en una respuesta de error Azure Batch. |
|
Pool |
Opciones para habilitar el escalado automático en 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 |
Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
|
| values |
Colección de pares clave-valor que contiene detalles adicionales sobre el error. |
BatchErrorDetail
Elemento de información adicional incluida en una respuesta de error 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. |
ErrorMessage
Mensaje de error recibido en una respuesta de error Azure Batch.
| Nombre | Tipo | Description |
|---|---|---|
| lang |
string |
Código de idioma del mensaje de error |
| value |
string |
Texto del mensaje. |
PoolEnableAutoScaleParameter
Opciones para habilitar el escalado automático en un grupo.
| Nombre | Tipo | Description |
|---|---|---|
| autoScaleEvaluationInterval |
string |
Intervalo de tiempo en el que ajustar automáticamente el tamaño del grupo según la fórmula de escalado automático. |
| autoScaleFormula |
string |
Fórmula para el número deseado de nodos de proceso en el grupo. |