BatchPoolSpecification interface
Especificación para crear un nuevo grupo.
Propiedades
| application |
Lista de paquetes que se van a instalar en cada nodo de proceso del grupo. Al crear un grupo, el identificador de aplicación del paquete debe estar completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Los cambios en las referencias de paquete afectan a todos los nodos nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear imágenes. Hay un máximo de 10 referencias de paquete en cualquier grupo determinado. |
| auto |
Intervalo de tiempo en el que se ajusta automáticamente el tamaño del grupo según la fórmula de escalado automático. El valor predeterminado es de 15 minutos. El valor mínimo y máximo son 5 minutos y 168 horas respectivamente. Si especifica un valor inferior a 5 minutos o superior a 168 horas, el servicio Batch rechaza la solicitud con un error de valor de propiedad no válido; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). |
| auto |
Fórmula para el número deseado de nodos de proceso en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en false. Es necesario si enableAutoScale está establecido en true. La fórmula se comprueba si hay validez antes de crear el grupo. Si la fórmula no es válida, el servicio Batch rechaza la solicitud con información de error detallada. |
| display |
Nombre para mostrar del grupo. El nombre para mostrar no debe ser único y puede contener caracteres Unicode de hasta una longitud máxima de 1024. |
| enable |
Si el tamaño del grupo se debe ajustar automáticamente con el tiempo. Si es false, se debe especificar al menos uno de targetDedicatedNodes y targetLowPriorityNodes. Si es true, se requiere el elemento autoScaleFormula. El grupo cambia automáticamente el tamaño según la fórmula. El valor predeterminado es false. |
| enable |
Si el grupo permite la comunicación directa entre nodos de proceso. Habilitar la comunicación entre nodos limita el tamaño máximo del grupo debido a restricciones de implementación en los nodos de proceso del grupo. Esto puede dar lugar a que el grupo no alcance su tamaño deseado. El valor predeterminado es false. |
| metadata | Lista de pares nombre-valor asociados al grupo como metadatos. El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario. |
| mount |
Lista de sistemas de archivos que se van a montar en cada nodo del grupo. Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse. |
| network |
Configuración de red para el grupo. |
| resize |
Tiempo de espera para la asignación de nodos de proceso al grupo. Este tiempo de espera solo se aplica al escalado manual; no tiene ningún efecto cuando enableAutoScale se establece en true. El valor predeterminado es de 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch rechaza la solicitud con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). |
| start |
Tarea que se va a ejecutar en cada nodo de proceso a medida que se une al grupo. La tarea se ejecuta cuando se agrega el nodo de proceso al grupo o cuando se reinicia el nodo de proceso. |
| target |
Número deseado de nodos de proceso dedicados en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale se establece en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos. |
| target |
Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale se establece en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos. |
| task |
Cómo se distribuyen las tareas entre nodos de proceso de un grupo. Si no se especifica, el valor predeterminado se propaga. |
| task |
Número de ranuras de tareas que se pueden usar para ejecutar tareas simultáneas en un único nodo de proceso del grupo. El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256. |
| upgrade |
Directiva de actualización para el grupo. Describe una directiva de actualización: automática, manual o gradual. |
| user |
Lista de cuentas de usuario que se van a crear en cada nodo de proceso del grupo. |
| virtual |
Configuración de la máquina virtual para el grupo. Esta propiedad debe especificarse. |
| vm |
Tamaño de las máquinas virtuales del grupo. Todas las máquinas virtuales de un grupo tienen el mismo tamaño. Para obtener información sobre los tamaños disponibles de las máquinas virtuales en grupos, consulte Elección de un tamaño de máquina virtual para nodos de proceso en un grupo de Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes). |
Detalles de las propiedades
applicationPackageReferences
Lista de paquetes que se van a instalar en cada nodo de proceso del grupo. Al crear un grupo, el identificador de aplicación del paquete debe estar completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Los cambios en las referencias de paquete afectan a todos los nodos nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear imágenes. Hay un máximo de 10 referencias de paquete en cualquier grupo determinado.
applicationPackageReferences?: BatchApplicationPackageReference[]
Valor de propiedad
autoScaleEvaluationInterval
Intervalo de tiempo en el que se ajusta automáticamente el tamaño del grupo según la fórmula de escalado automático. El valor predeterminado es de 15 minutos. El valor mínimo y máximo son 5 minutos y 168 horas respectivamente. Si especifica un valor inferior a 5 minutos o superior a 168 horas, el servicio Batch rechaza la solicitud con un error de valor de propiedad no válido; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
autoScaleEvaluationInterval?: string
Valor de propiedad
string
autoScaleFormula
Fórmula para el número deseado de nodos de proceso en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en false. Es necesario si enableAutoScale está establecido en true. La fórmula se comprueba si hay validez antes de crear el grupo. Si la fórmula no es válida, el servicio Batch rechaza la solicitud con información de error detallada.
autoScaleFormula?: string
Valor de propiedad
string
displayName
Nombre para mostrar del grupo. El nombre para mostrar no debe ser único y puede contener caracteres Unicode de hasta una longitud máxima de 1024.
displayName?: string
Valor de propiedad
string
enableAutoScale
Si el tamaño del grupo se debe ajustar automáticamente con el tiempo. Si es false, se debe especificar al menos uno de targetDedicatedNodes y targetLowPriorityNodes. Si es true, se requiere el elemento autoScaleFormula. El grupo cambia automáticamente el tamaño según la fórmula. El valor predeterminado es false.
enableAutoScale?: boolean
Valor de propiedad
boolean
enableInterNodeCommunication
Si el grupo permite la comunicación directa entre nodos de proceso. Habilitar la comunicación entre nodos limita el tamaño máximo del grupo debido a restricciones de implementación en los nodos de proceso del grupo. Esto puede dar lugar a que el grupo no alcance su tamaño deseado. El valor predeterminado es false.
enableInterNodeCommunication?: boolean
Valor de propiedad
boolean
metadata
Lista de pares nombre-valor asociados al grupo como metadatos. El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.
metadata?: BatchMetadataItem[]
Valor de propiedad
mountConfiguration
Lista de sistemas de archivos que se van a montar en cada nodo del grupo. Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse.
mountConfiguration?: MountConfiguration[]
Valor de propiedad
networkConfiguration
Configuración de red para el grupo.
networkConfiguration?: NetworkConfiguration
Valor de propiedad
resizeTimeout
Tiempo de espera para la asignación de nodos de proceso al grupo. Este tiempo de espera solo se aplica al escalado manual; no tiene ningún efecto cuando enableAutoScale se establece en true. El valor predeterminado es de 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch rechaza la solicitud con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
resizeTimeout?: string
Valor de propiedad
string
startTask
Tarea que se va a ejecutar en cada nodo de proceso a medida que se une al grupo. La tarea se ejecuta cuando se agrega el nodo de proceso al grupo o cuando se reinicia el nodo de proceso.
startTask?: BatchStartTask
Valor de propiedad
targetDedicatedNodes
Número deseado de nodos de proceso dedicados en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale se establece en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetDedicatedNodes?: number
Valor de propiedad
number
targetLowPriorityNodes
Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale se establece en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetLowPriorityNodes?: number
Valor de propiedad
number
taskSchedulingPolicy
Cómo se distribuyen las tareas entre nodos de proceso de un grupo. Si no se especifica, el valor predeterminado se propaga.
taskSchedulingPolicy?: BatchTaskSchedulingPolicy
Valor de propiedad
taskSlotsPerNode
Número de ranuras de tareas que se pueden usar para ejecutar tareas simultáneas en un único nodo de proceso del grupo. El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256.
taskSlotsPerNode?: number
Valor de propiedad
number
upgradePolicy
Directiva de actualización para el grupo. Describe una directiva de actualización: automática, manual o gradual.
upgradePolicy?: UpgradePolicy
Valor de propiedad
userAccounts
Lista de cuentas de usuario que se van a crear en cada nodo de proceso del grupo.
userAccounts?: UserAccount[]
Valor de propiedad
virtualMachineConfiguration
Configuración de la máquina virtual para el grupo. Esta propiedad debe especificarse.
virtualMachineConfiguration?: VirtualMachineConfiguration
Valor de propiedad
vmSize
Tamaño de las máquinas virtuales del grupo. Todas las máquinas virtuales de un grupo tienen el mismo tamaño. Para obtener información sobre los tamaños disponibles de las máquinas virtuales en grupos, consulte Elección de un tamaño de máquina virtual para nodos de proceso en un grupo de Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).
vmSize: string
Valor de propiedad
string