Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las operaciones proporcionadas por la API REST del servicio Batch pueden tener múltiples versiones para compatibilidad hacia atrás a medida que la API evoluciona con el tiempo. Debes especificar qué versión de una operación deseas usar cuando se llama, proporcionando la versión con tu llamada REST. Si tu aplicación llama a una versión antigua de una operación, puedes elegir seguir llamando a la versión anterior, o modificar tu código para llamar a una versión más reciente. Si la versión no se especifica o se especifica una versión incorrecta, se devuelve un error.
Para especificar qué versión de una operación utilizar, se establece el parámetro de consulta de versión de la api . La versión es del formato Group.Major.Minor, donde Group está en el formato y Major es un entero y Minor es un entero.
Última versión: 01-06-2025
Nivel de trabajo FIFO
- Tipos añadidos .
- Extended BatchTaskSchedulingPolicy con una nueva propiedad para soportar la programación FIFO a nivel de trabajo.
Soporte CMK en Pools
- Se añadió y para soporte de claves gestionadas por el cliente (CMK) en pools.
- Ampliado con una nueva propiedad.
- Ampliado con una nueva propiedad.
- Añadido para referenciar identidades gestionadas en escenarios de cifrado de disco.
Soporte IPv6 en pools
- Añadido a .
- Añadido y a .
Soporte para protocolos de seguridad de metadatos en pools
- Añadido y .
- Se ha agregado .
- Ampliado con una nueva propiedad para el soporte de protocolos de seguridad de metadatos.
Soporte de etiquetas IP
- Añadido y tipos.
- Extendido con nuevas propiedades para soporte de etiquetas IP.
[Rompiendo] Soporte eliminado para certificados:
- APIs de certificados eliminadas: , , , , y .
- Modelos/enums de certificados eliminados: , , , , , y
- Propiedades relacionadas con certificados eliminadas: , , , , , y
[Rompiendo] Eliminado . Use en su lugar.
[Rompiendo] Eliminado modelo y propiedades ,,, , , y .
[Rompiendo] Los siguientes modelos fueron renombrados:
Modelo antiguo Modelo nuevo CuentaListaImágenesApoyadasResultado BatchCuentaListaImágenesApoyadasResultado AffinityInformation BatchAffinityInfo ApplicationListResult BatchApplicationListResult ApplicationPackageReference ReferenciaPaquete de BatchAplicación Resumen de la Solicitud Aplicación por lotes AutomáticoOSUpgradePolicy Política de Actualización AutomáticaOsActualizada AutoPoolEspecificación Especificación de BatchAutoPool CIFSMountConfiguration cifsMountConfiguration de CloudJob BatchJob CloudListPreparaciónY LiberaciónTaretaEstado Preparación de TareaLiberaciónResultadoLista de EstadoDe la Tarea CloudJobListResult ResultadoDeListaDeEmpleos del Batch CloudJobSchedule Horario de TrabajoLote CloudJobScheduleListResult BatchJobScheduleListList CloudPool BatchPool CloudPoolListResult ResultadoDeListaLotePoolLista CloudTask BatchTask CloudTaskListResult ResultadoDeListaDeTareas del Batch ComputeNode BatchNode ComputeNodeDeallocationOption BatchNodeDeallocationOption ComputeNodeEndpointConfiguration BatchNodeEndpointConfiguration ComputeNodeError BatchNodeError ComputeNodeGetRemoteLoginSettingsResult BatchNodeRemoteLoginSettings ComputeNodeIdentityReference BatchNodeIdentityReference ComputeNodeInformation BatchNodeInfo ComputeNodeListResult BatchNodeListResult ComputeNodeUser BatchNodeUserCreateOptions ContainerConfiguration BatchContainerConfiguration RegistroDeContenedores ContainerRegistryReference DiffDiskSettings Configuración del discoDificultad por lote ErrorCategory BatchErrorSourceCategory Mensaje de error MensajeErrorDeLote HttpHeader CabeceraOutputFileUploadT ImageInformation Imagen Soportada por lote ImageReference BatchVmImageReference. InboundNATPool BatchInboundNatPool IPAddressProvisioningType IpAddressProvisioningType JobAddParameter BatchJobCreateOptions Restricciones del puesto RestriccionesDeTrabajos por Lotes JobDisableParameter. Opciones de Trabajo por Lote JobExecutionInformation BatchJobExecutionInfo Tarea de Gestor de Trabajo TareaGestorDe Trabajo JobNetworkConfiguration BatchJobNetworkConfiguration ParparámetroJobPatch OpcionesDeActualizaciónDeTrabajo de Batch Preparación y LiberaciónInformación de Ejecución de la Tarea EstadoEstadoPreparacióny LiberaciónTarea por lote Tarea de Preparación para el Trabajo TareaPreparaciónDeTrabajo por lote PreparaciónTarea EjecuciónInformación BatchJobPreparationTaskExecutionInfo Tarea de Liberación de Empleo TareaDeLiberaciónde de Trabajo por Lote JobReleaseTaskExecutionInformation BatchJobReleaseTaskExecutionInfo AsignaciónParadeEmpleoAdicional BatchJobScheduleCreateOptions JobScheduleExecutionInformation BatchJobScheduleExecutionInfo JobSchedulePatchParameter OpcionesDeActualizaciónDe EmpleoLaboral EmpleoEstadoHorario BatchJobScheduleState EmpleoEstadísticasHorario EstadísticasDeEmpleoAsignadoEmpleo JobSchedulingError BatchJobSchedulingError Especificación del puesto EspecificaciónDeTrabajo por Lote JobState BatchJobState EmpleoEstadísticas EstadísticasDeEmpleo por lotes JobTerminateParameter OpcionesDeTerminarDe BatchTrabajo MetadataItem BatchMetadataItem NFSMountConfiguration NfsMountConfiguration NodeAgentInformation BatchNodeAgentInfo NodeCommunicationMode ModoComunicaciónDe Nodo Batch NodeCounts BatchNodeCounts NodeDeallocateParameter BatchNodeDeallocateOptions ParaparámetroNoDeDisableSchedulingT BatchNodeDisableSchedulingOptions NodeFile Archivo BatchNodeFile NodeFileListResult BatchNodeFileListResult NodePlacementConfiguration ConfiguraciónDeNodeColocaciónLote NodePlacementPolicyType Tipo de PolíticaColocaciónDe NodosLotes NodeRebootParameter BatchNodeRebootOpciones NodeReimageParameter BatchNodeReimageOptions NodeRemoveParameter BatchNodeRemoveOptions NodeUpdateUserParameter BatchNodeUserUpdateOptions NodeVMExtension BatchNodeVMExtension NodeVMExtensionList BatchNodeVMExtensionListResult EnTodasTareas Completadas TodoTodoTareas CompletaModo EnEnTaskFailure ModoDeFalloDeTTarea de Batch OSDisk BatchOsDisk OutputFileUploadOptions OutputFileUploadConfig PoolAddParameter BatchPoolCreateOptions PoolEnableAuto -ScaleParameter [BatchPoolEnableAuto -OpcionesDeEscalar](/rest/api/batchservice/pools/enable-auto-scale#batchpoolenableauto -scaleoptions) PoolEndpointConfiguration BatchPoolEndpointConfiguration PoolEvaluateAuto -ScaleParameter [BatchPoolEvaluateAuto -ScaleOptions](/rest/api/batchservice/pools/evaluate-auto-scale#batchpoolevaluateauto -scaleoptions) PoolInformation Actualización de InfoPool de BatchPool PoolListUsageMetricsResult ResultadoResultadoListaListaUsoMétricas PoolNodeCounts ConteosNodePoolLote PoolNodeCountsListResult BatchPoolNodeCountsListResult ParparámetroPoolPatch Opciones de actualización de la piscina Parámetro de Tamaño de PoolResize Opciones de Tamaño de Lote Especificación de Piscina EspecificaciónPoolLote PoolEstadísticas EstadísticasPoolLote Parámetro de PropiedadesActualizaciónPool Opciones de Reemplazo de BatchPoolT PoolUsageMetrics MétricasDeUsoPoolLote PublicIPAddressConfiguration BatchPublicIpAddressConfiguration RecienteTrabajo RecentBatchJob ResourceStatistics EstadísticasRecursoPoolLote Programación BatchJobScheduleConfiguration StartTask BatchStartTask StartTaskInformation BatchStartTaskInfo SubtaskInformation Subtarea por lotes Subtarea BatchSubtaskState ParámetroAAdAdAdDeRecolección. Grupo de Tarea por Lotes TaskAddCollectionResult BatchCreateTaskCollectionResult TaskAddParameter BatchTareaCreateOpciones TaskAddResult BatchTareaCrearResultado Restricciones de tareas. RestriccionesDeTareaLote TaskContainerExecutionInformation BatchTaskContainerExecutionInfo TaskContainerSettings BatchTaskContainerSettings TaskCounts Cuenta de TareasLotes TaskCountsResultat ResultaTastasLoteCuenta TaskDependencies DependenciasDeTareaspor Batch TaskExecutionInformation BatchTaskExecutionInfo EjecuciónDe la tareaResultado BatchTaskExecutionResult InformaciónDefalloTareas InfoFalloDeTLote TaskIdRange BatchTaskIdRange TaskInformation BatchTaskInfo TaskSchedulingPolicy Política de Planificación de TareasLotes CuentasRanuras de Tarea Cuenta RanuraTareas por Lotes TaskState BatchTaskState Estadísticas de tarea EstadísticasDeTarea por lotes UefiSettings BatchUefiSettings UploadBatchServiceLogsConfiguration UploadBatchServiceLogsOptions EstadísticasUso EstadísticasUsoPoolLote UserAssignedIdentity BatchUsuarioAsignadoIdentidadAsignada VMDiskSecurityProfile BatchVmDiskSecurityProfile
Versiones anteriores
Las versiones anteriores incluyen:
- 2024-07-01.20.0
- 2024-02-01.19.0
- 2023-11-01.18.0
- 2023-05-01.17.0
- 2022-10-01.16.0
- 2022-01-01.15.0
- 2021-06-01.14.0
- 2020-09-01.12.0
- 2020-03-01.11.0
- 2019-08-01.10.0
- 2019-06-01.9.0
- 2018-12-01.8.0
- 2018-08-01.7.0
- 2018-03-01.6.1
- 2017-09-01.6.0
- 2017-06-01.5.1
- 2017-05-01.5.0
- 2017-01-01.4.0
- 2016-07-01.3.1
- 2016-02-01.3.0
- 2015-12-01.2.2
- 2015-11-01.2.1
Versión: 2024-07-01.20.0
- Se añadieron operaciones de desasignación de nodos de cómputo y de inicio:
- Se añadió una nueva operación () para desasignar un nodo de cómputo inactivo o en funcionamiento.
- Se añadió una nueva operación () para reiniciar un nodo de cómputo previamente desasignado.
- Añadido un nuevo modelo con una propiedad que especifica qué hacer con las tareas de ejecución durante la desalocación.
- [Rompiendo] Operación eliminada (). Esta operación solo era aplicable a pools de configuración de servicios en la nube.
- [Rompiendo] Eliminación del soporte para pools de configuración de servicios en la nube:
- Modelo eliminado .
- Propiedades eliminadas de , , y .
- [Rompiendo] Propiedades eliminadas de , , y .
- Se añadió soporte para montar la asignación de contenedores para tareas:
- Añadí un nuevo modelo con propiedades y S.
- Se añadió un nuevo enum con los valores , , , , , y .
- Se agregó una nueva propiedad a .
- Soporte añadido de VM confidenciales:
- Añadido un nuevo modelo con una propiedad.
- Se agregó una nueva propiedad a .
- Añadido como un nuevo valor para .
- Añadido y como nuevos valores para .
- Se añadieron nuevas propiedades requeridas y a .
- Se añadió el soporte de referencia de imágenes de la Galería Compartida y la Galería Comunitaria:
- Propiedades y añadidas a .
- Se añadió una propiedad para controlar si los nodos permanecen unidos al VNet después de que termina un trabajo.
- Propiedad añadida a .
- Capacidades extendidas de parche de pool: Se añadieron , , , , , , , , , , y propiedades a . Las propiedades que afectan a la topología del pool solo pueden actualizarse cuando el pool está vacío.
- Se añadió un parámetro de consulta booleano a , , , y operaciones para forzar la operación.
Versión: 2024-02-01.19.0
- Se añadió soporte para políticas de actualización del sistema operativo en pools de máquinas virtuales:
- Se añadió un nuevo modelo con propiedades , , y . La propiedad () acepta valores , , y .
- Añadido un nuevo modelo con propiedades , , , y .
- Se añadió un nuevo modelo con propiedades , , , , , , y .
- Se añadió nueva propiedad a , , y .
- Añadido como un nuevo valor para .
- Se añadió una nueva propiedad requerida para informar del número de nodos en el estado.
Versión: 2023-11-01.18.0
- Se añadió el soporte para Trusted Launch / perfiles de seguridad para pools de VM:
- Se añadió un nuevo modelo con propiedades , , y .
- Se añadió un nuevo modelo con propiedades y .
- Se agregó una nueva propiedad a .
- Se ha añadido soporte para referencias de artefactos de servicio en conjuntos de escala:
- Se añadió un nuevo modelo con una propiedad requerida (ID de recurso ARM).
- Se añadió una nueva propiedad para establecer la misma versión de imagen para todas las máquinas virtuales en un conjunto de escalas al usar la versión de imagen.
- Configuración mejorada del disco del sistema operativo:
- Añadido un nuevo modelo con una propiedad.
- Se añadieron nuevas propiedades a : , , , y .
- Sumado () como nuevo valor para .
- Se añadió nueva propiedad
resourceTagsaCloudPool,PoolAddParameteryPoolSpecificationpara permitir que las etiquetas definidas por el usuario se propaguen a recursos de respaldo Azure. Solo es aplicable cuando es . - Se añadió una nueva propiedad para exponer el ID de recurso de la VM actual del conjunto de escalas de la máquina virtual del nodo de cálculo. Solo se define cuando la cuenta por lotes es .
Versión: 2023-05-01.17.0
- [Rompiendo] Eliminada API de Estadísticas de Vida de Trabajo/Pool por Lotes: y .
- Se añadió propiedad booleana a .
- Esta propiedad determina si este pool debe habilitar redes aceleradas, con el valor por defecto como Falso.
- Si esta función puede activarse también está relacionada con si se soporta un sistema operativo/instancia de VM, lo que debería alinearse con la Política de Redes Aceleradas.
- Se añadió propiedad booleana a .
- Esta propiedad determina si la extensión debe actualizarse automáticamente si existe una versión más reciente disponible.
- La propiedad de , que ahora soporta dos valores: y .
Versión: 2022-10-01.16.0
- Se ha añadido una nueva propiedad que determina cómo un pool se comunica con el servicio Batch
- Se añadió una nueva propiedad de este tipo al modelo para referirse al estado actual del modo de comunicación del pool.
- Se añadió una nueva propiedad del tipo a los siguientes modelos para referirse al modo de comunicación de nodos deseado para el pool:
PoolSpecificationCloudPoolPoolAddParameterPoolPatchParameterPoolUpdatePropertiesParameter
Versión: 2022-01-01.15.0
- Se añadió una nueva propiedad al modelo para permitir a los usuarios establecer cabeceras HTTP personalizadas en la subida de archivos de recursos.
- Se añadió nueva propiedad a los siguientes modelos para soportar la preempción de tareas de mayor prioridad (requiere Comms-Enabled o Single Tenant Pool):
JobSpecificationCloudJobJobAddParameterJobPatchParameterJobUpdateParameter
Versión: 2021-06-01.14.0
- Añadir la capacidad de asignar identidades gestionadas asignadas por los usuarios a . Estas identidades están disponibles en cada nodo del pool y pueden usarse para acceder a diversos recursos.
- Se añadió propiedad a los siguientes modelos para facilitar el acceso a recursos mediante identidad gestionada:
AzureBlobFileSystemConfigurationOutputFileBlobContainerDestinationContainerRegistryResourceFileUploadBatchServiceLogs
- Se añadió una nueva propiedad a VirtualMachineConfiguration para especificar extensiones de máquina virtual para nodos
- Se añadió la capacidad de especificar zonas de disponibilidad usando una nueva propiedad en VirtualMachineConfiguration
- Se añadió una nueva propiedad a VirtualMachineConfiguration, que contiene la configuración del disco del sistema operativo de la Máquina Virtual.
- La propiedad en especifica la colocación efímera de disco para los discos del sistema operativo para todas las máquinas virtuales del pool. Configurándolo en "CacheDisk" para almacenar el efímero disco del sistema operativo en la caché de la VM.
- Se añadió una propiedad para controlar el número máximo de tareas que pueden ejecutarse al mismo tiempo por trabajo (por defecto -1 significa ilimitado). Esta propiedad está actualmente en vista previa privada.
- Se añadió una propiedad que contiene información sobre el estado actual de la máquina virtual, incluyendo la versión exacta de la imagen del marketplace que está usando la máquina virtual.
- Se añadió la propiedad de para controlar el intervalo entre los tiempos de inicio de dos trabajos sucesivos bajo un calendario de trabajos.
Versión: 2020-09-01.12.0
- [Rompiendo] Sustituyó la propiedad por la piscina. Usando esta propiedad, las tareas en un trabajo pueden consumir un número dinámico de ranuras, lo que permite un control más detallado sobre el consumo de recursos.
- [Rompiendo] Se cambió el tipo de respuesta de para devolver , que es un objeto complejo que contiene el objeto anterior y un nuevo objeto que proporciona información similar en el contexto de los espacios utilizados.
- Se añadió una propiedad a la tarea que permite al usuario especificar cuántos espacios en un nodo debe ocupar.
Versión: 2020-03-01.11.0
- Se añadió la capacidad de cifrar unidades de disco ComputeNode usando la nueva propiedad de .
- [Rompiendo] La propiedad
virtualMachineImageIddeImageReferenceahora solo puede referirse a una imagen Shared Image Gallery. - [Rompiendo] La propiedad del cuerpo de operación de la solicitud es opcional para certificados con formato PFX.
- [Rompiendo] Ahora los pools pueden aprovisionarse sin una IP pública usando la nueva propiedad de .
- [Rompiendo] La propiedad de también ha cambiado su nombre y se ha mudado a ella. Esta propiedad solo puede especificarse si la propiedad es .
Versión: 2019-08-01.10.0
- Se añadió la capacidad de especificar una colección de IPs públicas a través de la nueva propiedad del pool. Esto garantiza que los nodos del pool tengan una IP de la lista de IPs proporcionadas por el usuario.
- Se añadió la capacidad de montar sistemas de archivos remotos en cada nodo de un pool mediante la propiedad.
- Shared Image Gallery imágenes pueden ahora especificarse en la propiedad
virtualMachineImageIddeImageReferencereferenciando la imagen a través de su ID de Azure Resource Manager. - [Rompiendo] Cuando no se especifica, el valor por defecto de on es (anteriormente, era ).
- [Rompiendo] Cuando no se especifica, el valor por defecto de
scopeenAutoUserSpecificationahora siempre esPool(anteriormente eraTasken Windows nodos yPoolen nodos Linux). - Mejoré varios documentos confusos o incompletos.
Versión: 2019-06-01.9.0
[Rompiendo] Reemplazado por . contiene toda la información original disponible pero en un formato más claro. Ahora también se devuelven nuevas imágenes no verificadas. Información adicional sobre y es accesible a través de .
Ahora soportan reglas de seguridad de red que bloquean el acceso a la red basándose en el puerto de origen del tráfico. Esta regla se realiza mediante la propiedad sobre .
Cuando se ejecuta un contenedor, Batch ahora admite la ejecución de la tarea en el directorio de trabajo del contenedor o en el directorio de trabajo de la tarea Batch. Esto se controla mediante la propiedad en .
Mejoré varios documentos confusos o incompletos.
Versión: 2018-12-01.8.0
[Rompiendo] Se eliminó el soporte para los grupos de On .
- Se ha eliminado .
- Renombrado y eliminado en .
- Se ha quitado de .
[Rompiendo] Eliminado y de . Estas propiedades ya no están soportadas.
[Rompiendo] Mejoras
- Se añadió la capacidad de especificar un contenedor completo de Azure Storage en ResourceFile. Actualmente hay tres modos compatibles con ResourceFile:
- crea una señal que apunta a una única URL HTTP.
-
storageContainerUrlcrea un contenedorResourceFileapuntando a un contenedor Azure Blob Storage. -
autoStorageContainerNamecrea unResourceFileapuntando a un contenedor de Azure Blob Storage en la cuenta de almacenamiento automático registrada por lotes.
- Las URLs proporcionadas mediante el método ahora pueden ser cualquier URL HTTP. Anteriormente, estas URLs tenían que ser una URL de Azure Blob Storage.
- puede usarse para filtrar descargas de un contenedor de almacenamiento solo a aquellas que coincidan con el prefijo.
- Se añadió la capacidad de especificar un contenedor completo de Azure Storage en ResourceFile. Actualmente hay tres modos compatibles con ResourceFile:
[Rompiendo] Eliminaron propiedades de . Esta propiedad ya no está soportada.
Los pools que configuran el
dynamicVNetAssignmentScopeenNetworkConfigurationcomojobahora pueden asignar dinámicamente un Virtual Network a cada nodo el trabajos tasks run on. The specific Virtual Network to join the nodes to is specified in the newJobNetworkConfigurationproperty onCloudJobandJobSpecification'.Nota:
Esta característica está en versión preliminar pública. Está deshabilitado para todas las cuentas de lote excepto para aquellas que nos han contactado y solicitado participar en el piloto.
La vida máxima de una tarea es ahora de 180 días (antes eran 7).
Se añadió soporte en Windows pools para crear usuarios con un modo de inicio de sesión específico (ya sea
batchointeractive) medianteLoginMode.El tiempo predeterminado de retención de tareas para todas las tareas es ahora de siete días, antes era infinito.
Versión 2018-08-01.7.0
Las nuevas características en la versión 2018-08-01.7.0 incluyen:
- Consulta la versión del Azure Batch Node Agent, a través de la nueva propiedad NodeAgentInfo en ComputeNode.
- Se añadió la capacidad de especificar una en el de una tarea. Consulte aquí para obtener más detalles.
- Esto permite que el escenario frecuentemente solicitado de realizar una consulta en el lado del servidor encuentre todas las tareas que han fallado.
- [Rompiendo] He eliminado la propiedad de TaskCounts.
- [Rompiendo] El tipo de caché predeterminado para DataDisk y OSDisk es ahora en lugar de .
- [Rompiendo] Renombrado el único valor de ContainerType de a .
Versión 2018-03-01.6.1
Las nuevas características en la versión 2018-03-01.6.1 incluyen:
- Conteos de nodos de pool por estado: Esta versión añade la capacidad de consultar los recuentos de nodos de pool por estado, mediante la nueva operación ListPoolNodeCounts. Esta operación te da la capacidad de consultar todos los pools en una cuenta por lotes para conocer los estados de los nodos.
- Logs de agentes de nodos: Esta versión añade la capacidad de subir los logs de agentes de nodos de Azure Batch desde un nodo concreto, mediante la operación UploadBatchServiceLogs. Este registro está destinado a ser utilizado en la depuración por parte del Soporte técnico de Microsoft si ocurren problemas en un nodo.
Versión 2017-09-01.6.0
Beneficio de uso híbrido de Azure: Ahora puedes crear pools de máquinas virtuales de Windows en lote especificando que se utilice la licencia de beneficio de uso híbrido de Azure. Cuando se utiliza esta licencia, se aplica un descuento al precio de la VM. Utiliza la nueva propiedad LicenseType en VirtualMachineConfiguration.
Agrupar discos de datos de VM: Puedes conectar uno o más discos de datos vacíos a pools de VM utilizando la nueva configuración de disco de datos que forma parte de la configuración de la máquina virtual. Utiliza la propiedad DataDisks en VirtualMachineConfiguration.
(Cambio de última hora) Las imágenes personalizadas ahora se crean y despliegan utilizando recursos de imagen de Azure Resource Manager en lugar de archivos blob VHD. Ahora el lote utiliza discos gestionados para crear las máquinas virtuales del pool y, por tanto, utiliza un recurso de Imagen . Ahora no hay límite en el número de máquinas virtuales en un pool creado usando una imagen personalizada; además, ya no se requieren copias múltiples del blob VHD para grandes pools. Por tanto, los pools de imágenes personalizados son mucho más fáciles de crear y escalar. Para más información, véase Usar una imagen personalizada para crear un conjunto de máquinas virtuales.
La nueva propiedad VirtualMachineImageId en ImageReference contiene la referencia a la Image, y OSDisk.ImageUris ya no existe.
Debido a este cambio, ImageReference es ahora una propiedad obligatoria de VirtualMachineConfiguration.
(Cambio de moneda) Las tareas multiinstancia (creadas usando MultiInstanceSettings) deben ahora especificar CoordinationCommandLine, y NumberOfInstances es opcional y por defecto es 1.
Se añadió soporte para tareas ejecutadas usando contenedores Docker. Para ejecutar una tarea usando un contenedor Docker, debes especificar una Configuración de Contenedor en la ConfiguraciónVirtualMáquina para un pool, y luego añadir Configuración de Tareas en la Tarea.
Versión 2017-06-01.5.1
La versión de la API por lotes descrita aquí es 2017-06-01.5.1. Se recomienda usar la última versión siempre que sea posible.
Las nuevas características en la versión 2017-06-01.5.1 incluyen:
- Soporte para conteos de tareas eficientes mediante la nueva operación Get Task Counts. Al llamar a la operación Get Task Counts, puedes obtener un recuento de tareas activas, en ejecución y completadas, así como de las tareas que tuvieron éxito o fallaron. Para más información, consulte Contar tareas para un puesto por estado (Vista previa).
- Soporte para especificar los puntos finales entrantes en nodos de computación de pool, a través de la nueva propiedad poolEndpointConfiguration . Al configurar esta propiedad, puedes dirigir puertos específicos en el nodo externamente.
Versión 2017-05-01.5.0
Las siguientes secciones describen las funciones nuevas y modificadas en la versión 2017-05-01.5.0.
Importante
La versión 2017-05-01.5.0 incluye varios cambios de última hora. Revisa los cambios de última hora y actualiza tu código para poder llamar a la versión 2017-05-01.5.0.
Nodos de cómputo de baja prioridad
Azure Batch ahora ofrece nodos de cómputo de baja prioridad para reducir el coste de las cargas de trabajo por lotes. Las máquinas virtuales de baja prioridad hacen posibles nuevos tipos de cargas de trabajo por lotes al proporcionar una gran cantidad de potencia de cálculo que además es económica.
Hay varios cambios en la API REST para nodos de baja prioridad:
- (Cambio de moneda) Las propiedades Dedicat y Dedicated actual de una especificación de pool o pool han sido renombradas como Nodos Dedicados Objetivo y Nodos de Computación Actuales.
- (Cambio de moneda) La propiedad resizeError de un pool es ahora una colección llamada resizeErrors.
- Los nodos de cómputo tienen una nueva propiedad isDedicate . Esta propiedad es cierta para nodos dedicados y falsa para nodos de baja prioridad.
- Una tarea de Gestor de Trabajos tiene una nueva propiedad allowLowPriorityNode . Si esta propiedad es cierta, la tarea Administrador de Trabajos puede ejecutarse en un nodo de baja prioridad. Si es falso, entonces la tarea del Administrador de Trabajos se ejecuta en un nodo de cómputo dedicado.
Usuarios nombrados en Linux
Azure Batch ahora ofrece soporte adicional para crear usuarios nombrados en nodos de Linux.
- La nueva propiedad linuxUserConfiguration permite especificar un uid (ID de usuario) y gid (ID de grupo) al crear un usuario Linux.
- (Cambio de moneda) La propiedad sshPrivateKey se ha trasladado de la propiedad Cuenta de usuario a la nueva propiedad linuxUserConfiguration . La propiedad linuxUserConfiguration es en sí misma una propiedad de la propiedad de Cuentade de usuario .
Para más información sobre cuentas de usuario nombradas, consulte Ejecutar tareas bajo cuentas de usuario en Batch.
Archivos de salida para datos de tareas
Ahora puedes especificar archivos de salida para subir los datos de la tarea una vez que una tarea haya completado.
- La nueva propiedad outputFiles permite especificar archivos de tareas a subir a Azure Storage.
- La nueva propiedad fileUploadError de la propiedad exitConditions permite especificar acciones a realizar basándose en el estado de subida de un archivo de salida.
Informe de errores de tarea
Se han realizado varios cambios para mejorar la notificación de errores de tareas.
- La nueva propiedad de resultado de la propiedad executionInfo indica si una tarea tuvo éxito o falló.
- (Cambio de moneda) La propiedad SchedulingError de la propiedad executionInfo ha sido renombrada como failureInfo. La propiedad failureInfo se devuelve cada vez que hay un fallo de tarea. Esto incluye todos los casos anteriores de errores de planificación, todos los casos en los que se devuelve un código de salida de tarea distinto de cero y cualquier fallo en la subida de archivos.
- (Cambio de moneda) La propiedad schedulingError de la propiedad exitConditions ha sido renombrada como preProcessingError para aclarar cuándo se produjo el error en el ciclo de vida de la tarea.
- (Cambio de moneda) La propiedad schedulingErrorCateogry ha sido renombrada como errorCategory.
Licencias de aplicación
Ahora puedes solicitar que las licencias de aplicación se provisionen en tu pool, a través de la nueva propiedad applicationLicenses en una pool o especificación de pool.
Versión 2017-01-01.4.0
Esta versión extiende todo el soporte de la versión anterior, 2016-07-01.3.1. Además, soporta las siguientes capacidades:
Ejecuta una tarea bajo una identidad de usuario especificada.
Ahora puedes ejecutar una tarea o colección de tareas bajo una de las siguientes identidades de usuario, especificadas mediante la nueva propiedad Identidad de usuario en el recurso de tarea:
Una cuenta de usuario con un nombre que tú definas.
Una cuenta de usuario que se crea automáticamente (un usuario automático). Un usuario automático puede ejecutarse como usuario administrador o no administrador. Por defecto, un usuario automático funciona como usuario no administrativo.
Importante
La propiedad UsuarioIdentidade , con su propiedad elevationLevel , reemplaza la propiedad runElevated en las solicitudes que añaden una tarea o una colección de tareas, y en las respuestas que obtienen información sobre una tarea o que listan tareas.
Si haces una solicitud que incluye la propiedad runElevated a la versión 2017-01-01.4.0 del servicio Batch, la solicitud falla.
Para ejecutarlo como usuario administrativo, actualiza tu aplicación para que use la propiedad Identidad de usuario , configurando la propiedad elevationLevel como administrador.
Para ejecutarlo como usuario no administrativo, actualiza tu aplicación para que use la propiedad Identidad de usuario , configurando la propiedad elevationLevel como nonAdmin. Como esta configuración es la predeterminada, también puedes omitirla.
Define cuentas de usuario en todos los nodos de un pool.
Ahora puedes ejecutar una tarea o colección de tareas bajo una cuenta de usuario que definas en el recurso del pool. Define una cuenta de usuario a través de la nueva propiedad de cuentas de usuario en las solicitudes a Agregar Pool. Cuando defines la cuenta, puedes especificar el nombre de la cuenta, la contraseña, el nivel de elevación (administrador o no administrador) y la clave privada SSH (para pools de Linux).
Una vez que definas la cuenta de usuario, puedes especificar esa cuenta de usuario para la propiedad de Identidad de usuario en solicitudes que añadan una tarea o una colección de tareas.
Proporciona una tarea con un token para autenticar al servicio Batch cuando la tarea se ejecute.
El servicio por lotes puede ahora proporcionar un token de autenticación a una tarea cuando se ejecuta. El token de autenticación permite que una tarea emita solicitudes relacionadas con el trabajo al servicio Batch, sin las claves de cuenta Batch. El token se proporciona a través de la variable de entorno AZ_BATCH_AUTHENTICATION_TOKEN.
Actualmente, los tokens de autenticación son compatibles solo para operaciones de llamada en el recurso de trabajo. El token de autenticación otorga acceso a todas las operaciones del trabajo que contienen la tarea.
Para que el servicio por lotes proporcione el token de autenticación, se especifica la nueva propiedad authenticationTokenSettings , junto con su propiedad de acceso , en las peticiones a Añadir Tarea o Añadir Colección de Tareas.
Especifica una acción a realizar sobre las dependencias de una tarea si la tarea falla.
Ahora puedes especificar que las tareas dependientes continúen incluso si la tarea de la que dependen falla. Establece la nueva propiedad dependencyAction de un recurso de tarea para que se satisfaga para ejecutar tareas dependientes incluso si la tarea padre falla. Alternativamente, se puede configurar dependencyAction para bloquear y así evitar la ejecución de tareas dependientes si la tarea principal falla.
Especifica la propiedad dependencyAction en las peticiones para Añadir tarea o Añadir Colección de Tareas.
Para más información sobre el uso de acciones de dependencia, véase Acciones de dependencia.
Utiliza imágenes de disco personalizadas del sistema operativo al crear un pool.
Ahora puedes usar imágenes de disco personalizadas del sistema operativo para crear un pool.
Para ello, debes especificar al crear tu cuenta por lotes que los pools deben ser provisionados en la suscripción de usuario, en lugar de en una suscripción gestionada por el servicio por lotes. En una llamada para Crear Cuenta, establece la propiedad poolAllocationMode en SuscripciónUsuario. Luego usa la propiedad osDisk para especificar una referencia a una imagen de disco en una petición para Añadir Pool.
Importante
Cuando creas tu cuenta por lotes, si especificas que los pools se van a provisionar en la suscripción de usuario, entonces debes usar autenticación basada en Azure Active Directory para todas las solicitudes realizadas a través de esa cuenta.
Utiliza autenticación basada en Azure Active Directory para las solicitudes al servicio por lotes.
Azure Active Directory (Azure AD) ahora es compatible para autenticar llamadas al servicio Batch.
Si tu cuenta por lotes está configurada para provisionar pools en la suscripción de usuario, entonces es necesario usar autenticación de Azure AD.
Versión 2016-07-01.3.1
Esta versión extiende todo el soporte de la versión anterior, 2016-02-01.3.0. Además, soporta las siguientes capacidades:
Capacidad para crear un pool y un autopool con configuración de red
- Se ha añadido una nueva red de propiedades. Configuración se ha añadido tanto a los recursos del pool como al autopool. Esta propiedad puede usarse para especificar los nodos de cómputo del poolque se crean.
Termina automáticamente un trabajo cuando todas las tareas se completen.
- Se ha añadido una nueva propiedad en AllTasksComplete al recurso de trabajo. Puedes especificar esta propiedad cuando crees o actualices un trabajo.
Termina o desactiva automáticamente un trabajo cuando una tarea falla.
- Se ha añadido una nueva propiedad en TaskFailure al recurso de trabajo, y se ha añadido una nueva propiedad exitConditions al recurso de tareas. La configuración de trabajo onTaskFailure indica si el fallo de tarea puede tener un impacto a nivel de trabajo, y la propiedad de salida de tarea Condiciones permite que las tareas adapten el impacto a nivel de trabajo a la naturaleza del fallo.
Asocia los paquetes de aplicaciones con tareas y pools.
- Se añadió una nueva propiedad applicationPackageReferences al recurso de tarea y a la configuración de tareas del JobManager. Esta propiedad permite desplegar paquetes de aplicaciones bajo demanda según las tareas las requieran, en lugar de requerir que se especifiquen en el momento de la creación del pool. Esta propiedad es especialmente valiosa para pools de larga duración que pueden ser llamados para ejecutar diferentes tipos de trabajos o distintas versiones de aplicación a lo largo de su vida útil.
Capacidad para reactivar una tarea fallida.
- Se ha añadido una nueva operación: Reactivar una tarea para restablecer el estado de una tarea fallida a activo. Esto permite intentar de nuevo los fallos, por ejemplo si el fallo fue transitorio o si has podido arreglar la causa del fallo, sin recrear la tarea.
Versión 2016-02-01.3.0
Esta versión extiende todo el soporte de la versión anterior, 2015-12-01.2.2. Además, soporta las siguientes capacidades:
Capacidad para crear un pool y un autopool con configuración de VM IaaS
Las propiedades existentes , y se trasladan desde propiedades de nivel superior de recursos de Pool y Autopool y se trasladan dentro de una nueva propiedad llamada .
Se añade una nueva propiedad tanto a los recursos de Pool como de Autopool. Esta propiedad puede especificarse para configurar un pool/auto pool con máquinas virtuales IaaS.
Se añade una nueva API para obtener información sobre todos los SKUs de agentes nodo soportados por el servicio Batch. Ver Lista de SKUs de node agent compatibles.
Se añade una nueva API para obtener configuraciones de inicio de sesión remotas que pueden usarse para iniciar sesión remotamente en un nodo de cómputo creado con configuración de VM IaaS. Consulta Obtener ajustes de inicio de sesión remoto para un nodo.
Se añade una nueva API para añadir una colección de tareas a un trabajo. Véase Añadir una colección de tareas a un trabajo.
Se añade una nueva propiedad opcional al recurso de usuario que puede usarse para añadir o actualizar usuarios en un nodo de cómputo de Linux.
Se añaden dos nuevas propiedades al recurso Node. Estas propiedades pueden obtenerse mediante obtener información sobre un nodo o Listar los nodos de cómputo en un pool.
Se añade una nueva propiedad al tipo de complejo. Esta propiedad se aplica solo a los nodos de cómputo de Linux y se ignora en los nodos de cómputo de Windows.
Se añade una nueva propiedad al tipo de complejo. Esta propiedad se devuelve en el servicio Batch para nodos de cómputo Linux como parte de las APIs GetFileProperties o ListFileProperties. Además, la propiedad existente bajo el tipo complejo se cambia a una propiedad opcional porque esta propiedad no se devuelve para los nodos de cálculo de Linux.
El tipo de dato de la propiedad existente dentro del tipo complejo se modifica de una cadena con valores separados por comas a un conjunto de cadenas. Además, uno de los valores existentes de visibilidad se renombra de "rdp" a "remoteuser".
Las URLs de las siguientes APIs se cambian para reemplazar "?" del nombre de la acción a "/":
Sustituir las propiedades de una piscina
Desactiva el escalado automático en un pool
Activar la escalada automática en un pool
Evalúa una fórmula de escalado automático
Cambiar el tamaño de una piscina
Deja de cambiar el tamaño de una piscina
Actualizar el sistema operativo de los nodos de cómputo en un pool
Eliminar nodos de cómputo de un pool
Reiniciar un nodo
Reimaginar un nodo
Desactiva la planificación de tareas en un nodo
Habilitar la planificación de tareas en un nodo
Desactiva un horario de trabajo
Habilitar un horario de trabajo
Terminar un horario de trabajo
Desactivar un trabajo
Habilitar un empleo
Terminar un trabajo
Terminar una tarea
Cancelar la eliminación de un certificado
Versión 2015-12-01.2.2
Esta versión extiende todo el soporte de la versión anterior, 2015-11-01.2.1. Además, soporta las siguientes capacidades:
Ahora las aplicaciones pueden desplegarse para calcular nodos usando paquetes de aplicación en lugar de como archivos de recursos.
Se proporcionan nuevas APIs para que los clientes naveguen por la lista de aplicaciones y versiones disponibles, por ejemplo para mostrar un selector en una interfaz de usuario.
Las APIs relacionadas con el pool se modifican para permitir que un pool especifique paquetes de aplicaciones que se descarguen a todos los nodos de ese pool.
Las tareas ahora pueden depender de otras tareas. Una tarea dependiente no comenzará hasta que todas las tareas de las que depende se hayan completado con éxito.
Esta versión incluye los siguientes otros cambios:
- El tiempo de espera por defecto para el cambio de tamaño de la piscina ha cambiado a 15 minutos.
Versión 2015-11-01.2.1
Esta versión extiende todo el soporte de la versión anterior 2015-06-01.2.0. Además, soporta las siguientes capacidades:
Capacidad para añadir y ejecutar tareas multiinstancia (por ejemplo, MPI)
Se añade una nueva propiedad opcional al recurso Tarea que puede incluirse opcionalmente en las APIs Añadir Tarea, Obtener Tarea y Listar Tareas.
Se añade una nueva API Lista de las subtareas de una tarea para obtener información sobre las subtareas.
Se añade una nueva propiedad opcional para un Nodo de Cómputo. Esta propiedad se devuelve como parte de Get Compute Node y List Compute Nodes
Capacidad para desactivar o habilitar la planificación de tareas en un nodo de cómputo
Se añaden dos nuevas APIs: Desactivar la planificación de tareas en un nodo y Habilitar la planificación de tareas en un nodo, añadidas al recurso del nodo de cálculo.
Se añade un nuevo estado de nodo de cómputo. Para versiones antiguas de API, este estado se asigna a .
Se añade una nueva propiedad al recurso del nodo de cómputo. Valores posibles para y .
Capacidad para especificar intervalos de evaluación de -scale automática en un pool/autopool
Se añade una nueva propiedad para el recurso de pool. Esta propiedad puede incluirse en las APIs de Add Pool, Get Pool, Enable Auto Scale y List Pools.
De manera similar, en los autopools, se añade una nueva propiedad a la propiedad. Esta propiedad puede incluirse en Añadir trabajo, Obtener trabajo, Listar trabajos, Añadir Horario de Trabajos, Obtener Calendario de Trabajos, Actualizar Calendario de Trabajos, Listar Horarios de Trabajos y Listar Trabajos en las APIs de Calendario de Trabajos.
Mejora de las APIs de tareas para devolver el directorio raíz de la tarea en el nodo de cálculo.
Se añaden dos nuevas propiedades al recurso de tareas, que pueden obtenerse como parte de Obtener información sobre una tarea, APIs de Lista de tareas
Se añade una nueva propiedad que puede obtenerse mediante Listar el estado de las tareas de preparación y liberación de tareas para una API de trabajo.