Versiones de API de REST del servicio por lotes
Las operaciones que permite realizar la API de REST del servicio por lotes pueden tener varias versiones de compatibilidad con versiones anteriores a medida que evoluciona la API con el tiempo. Debe especificar qué versión de una operación desea utilizar cuando realiza la llamada a dicha operación; para ello, debe indicar la versión con la llamada de REST. Si la aplicación llama a una versión anterior de una operación, puede elegir seguir llamando a la versión anterior, o bien modificar el código para llamar a una versión más reciente. Si no se especifica la versión o se especifica una versión incorrecta, se devuelve un error.
Para especificar la versión de una operación que se va a usar, establezca el parámetro de consulta api-version . La versión tiene el formato Group.Major.Minor, donde Group tiene el formato "DD-MM-AAAA", y los valores Mayor y Minor se corresponden con números enteros.
Versión más reciente: 2023-05-01.17.0
- [Interrupción] Se ha quitado batch Job/Pool Lifetime Statistics API:
lifetimejobstats
ylifetimepoolstats
. - Se agregó la propiedad
enableAcceleratedNetworking
booleana aNetworkConfiguration
.- Esta propiedad determina si este grupo debe habilitar las redes aceleradas, con el valor predeterminado como False.
- Si esta característica se puede habilitar también está relacionada con si se admite una instancia de máquina virtual o sistema operativo, que debe alinearse con la directiva AcceleratedNetworking.
- Se agregó la propiedad
enableAutomaticUpgrade
booleana aVMExtension
.- Esta propiedad determina si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible.
- La propiedad
type
deContainerConfiguration
, que ahora admite dos valores:DockerCompatible
yCriCompatible
.
Versiones anteriores
Las versiones anteriores incluyen:
- 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
- 2015-06-01.2.0
- 2015-03-01.1.1
- 2014-10-01.1.0
Versión: 2022-10-01.16.0
- Se ha agregado una nueva
NodeCommunicationMode
propiedad que determina cómo se comunica un grupo con el servicio Batch. - Se agregó una nueva
currentNodeCommunicationMode
propiedad delNodeCommunicationMode
tipo alCloudPool
modelo para hacer referencia al estado actual del modo de comunicación del grupo. - Se agregó una nueva
targetNodeCommunicationMode
propiedad delNodeCommunicationMode
tipo a los siguientes modelos para hacer referencia al modo de comunicación de nodo deseado para el grupo:
Versión: 2022-01-01.15.0
- Se ha agregado una nueva
uploadHeaders
propiedad alOutputFileBlobContainerDestination
modelo para permitir a los usuarios establecer encabezados HTTP personalizados en cargas de archivos de recursos. - Se ha agregado una nueva
allowTaskPreemption
propiedad a los siguientes modelos para admitir el adelantamiento de tareas para tareas de mayor prioridad (requiere Comms-Enabled o grupo de inquilinos únicos):
Versión: 2021-06-01.14.0
- Agregue la capacidad de asignar identidades administradas asignadas por el usuario a
CloudPool
. Estas identidades estarán disponibles en cada nodo del grupo y se pueden usar para acceder a varios recursos. - Se agregó
identityReference
la propiedad a los siguientes modelos para admitir el acceso a los recursos a través de la identidad administrada: - Se agregó una nueva
extensions
propiedad a VirtualMachineConfiguration enCloudPool
para especificar extensiones de máquina virtual para los nodos. - Se ha agregado la capacidad de especificar zonas de disponibilidad mediante una nueva propiedad
nodePlacementConfiguration
en VirtualMachineConfiguration. - Se ha agregado una nueva
osDisk
propiedad a VirtualMachineConfiguration, que contiene la configuración del disco del sistema operativo de la máquina virtual.- La
placement
propiedad deDiffDiskSettings
especifica la ubicación del disco efímero para los discos del sistema operativo para todas las máquinas virtuales del grupo. Si se establece en "CacheDisk" se almacenará el disco del sistema operativo efímero en la memoria caché de la máquina virtual.
- La
- Se agregó
maxParallelTasks
la propiedad enCloudJob
para controlar el número máximo de tareas que se pueden ejecutar al mismo tiempo por trabajo (el valor predeterminado es -1, lo que significa ilimitado). Esta propiedad está actualmente en versión preliminar privada. - Se agregó
virtualMachineInfo
la propiedad en laComputeNode
que contiene información sobre el estado actual de la máquina virtual, incluida la versión exacta de la imagen de Marketplace que usa la máquina virtual. - Se agregó
recurrenceInterval
la propiedad aSchedule
para controlar el intervalo entre las horas de inicio de dos trabajos sucesivos en una programación de trabajos.
Versión: 2020-09-01.12.0
- [Interrupción] Propiedad
maxTasksPerNode
reemplazada portaskSlotsPerNode
en el grupo. El uso de estas tareas de propiedad en un trabajo puede consumir un número dinámico de ranuras, lo que permite un control más específico sobre el consumo de recursos. - [Interrupción] Se ha cambiado el tipo de respuesta de
GetTaskCounts
para devolverTaskCountsResult
, que es un objeto complejo que contiene el objeto anteriorTaskCounts
y un nuevoTaskSlotCounts
objeto que proporciona información similar en el contexto de las ranuras que se usan. - Se agregó la propiedad
requiredSlots
a la tarea que permite al usuario especificar cuántas ranuras de un nodo debe ocupar.
Versión: 2020-03-01.11.0
- Se ha agregado la capacidad de cifrar unidades de disco ComputeNode mediante la nueva
DiskEncryptionConfiguration
propiedad deVirtualMachineConfiguration
. - [Interrupción] La
virtualMachineImageId
propiedad deImageReference
ahora solo puede hacer referencia a una imagen de Shared Image Gallery. - [Interrupción] La
password
propiedad del cuerpo de la solicitud deAdd Certificate
operación es opcional para los certificados con formato PFX. - [Interrupción] Los grupos ahora se pueden aprovisionar sin una dirección IP pública mediante la nueva
PublicIPAddressConfiguration
propiedad deNetworkConfiguration
. - [Interrupción] También
publicIPs
se ha cambiado el nombreipAddressIds
de la propiedad deNetworkConfiguration
como y se ha movido aPublicIPAddressConfiguration
. Esta propiedad solo se puede especificar siprovision
la propiedad esusermanaged
.
Versión: 2019-08-01.10.0
- Se ha agregado la capacidad de especificar una colección de direcciones IP públicas en
NetworkConfiguration
a través de la nuevapublicIPs
propiedad del grupo. Esto garantiza que los nodos del grupo tendrán una dirección IP de las direcciones IP proporcionadas por el usuario de lista. - Se ha agregado la capacidad de montar sistemas de archivos remotos en cada nodo de un grupo a través de la
MountConfiguration
propiedad . - Shared Image Gallery imágenes ahora se pueden especificar en la
virtualMachineImageId
propiedad deImageReference
haciendo referencia a la imagen a través de su identificador de Resource Manager de Azure. - [Interrupción] Cuando no se especifica, el valor predeterminado de
waitForSuccess
enStartTask
estrue
(anteriormente, erafalse
). - [Interrupción] Cuando no se especifica, el valor predeterminado de
scope
onAutoUserSpecification
ahora es siemprePool
(anteriormente, estabaTask
en nodos de Windows yPool
en nodos de Linux). - Se han mejorado varios documentos confusos o incompletos.
Versión: 2019-06-01.9.0
[Interrupción] Se ha
ListNodeAgentSKUs
reemplazado porListSupportedImages
.ListSupportedImages
contiene toda la misma información disponible originalmente enListNodeAgentSKUs
pero en un formato más claro. Ahora también se devuelven imágenes nuevas y no comprobadas. Se puede acceder a información adicional sobreCapabilities
yBatchSupportEndOfLife
a través deImageInformation
.Ahora admite reglas de seguridad de red que bloquean el acceso de red a un
CloudPool
basado en el puerto de origen del tráfico. Esto se hace mediante la propiedadSourcePortRanges
enNetworkSecurityGroupRule
.Cuando ejecuta un contenedor, Batch ahora permite ejecutar la tarea en el directorio de trabajo del contenedor o en el directorio de trabajo de la tarea de Batch. Esto se controla mediante la propiedad
WorkingDirectory
enTaskContainerSettings
.Se han mejorado varios documentos confusos o incompletos.
Versión: 2018-12-01.8.0
[Interrupción] Se ha quitado la compatibilidad con
upgradeos
en gruposcloudServiceConfiguration
.[Interrupción] Se ha quitado
dataEgressGiB
ydataIngressGiB
depoolusagemetrics
. Estas propiedades ya no se admiten.[Interrupción]
ResourceFile
Mejoras- Se ha agregado la capacidad de especificar un contenedor de Azure Storage completo en ResourceFile. Ahora hay tres modos admitidos para ResourceFile:
-
httpUrl
crea un queResourceFile
apunta a una única dirección URL HTTP. -
storageContainerUrl
crea un queResourceFile
apunta a un contenedor de Azure Blob Storage. -
autoStorageContainerName
crea un queResourceFile
apunta a un contenedor de Azure Blob Storage en la cuenta de almacenamiento automático registrado de Batch.
-
- Las direcciones URL proporcionadas a
ResourceFile
través delhttpUrl
método ahora pueden ser cualquier dirección URL HTTP. Anteriormente, estos tenían que ser una dirección URL de Azure Blob Storage. -
blobPrefix
se puede usar para filtrar las descargas de un contenedor de almacenamiento solo para aquellos que coincidan con el prefijo.
- Se ha agregado la capacidad de especificar un contenedor de Azure Storage completo en ResourceFile. Ahora hay tres modos admitidos para ResourceFile:
[Breaking] Se quitó
osDisk
la propiedad deVirtualMachineConfiguration
. Este propiedad ya no se admite.Los grupos que establecen el
dynamicVNetAssignmentScope
activadoNetworkConfiguration
job
ahora pueden asignar dinámicamente un Virtual Network a cada nodo en el que se ejecutan las tareas del trabajo. El Virtual Network específico para unir los nodos a se especifica en la nuevaJobNetworkConfiguration
propiedad enCloudJob
yJobSpecification
.Nota:
Esta característica está en versión preliminar pública. Está deshabilitado para todas las cuentas de Batch excepto para las que nos han contactado y han solicitado estar en el piloto.
La duración máxima de una tarea es ahora de 180 días (anteriormente era 7).
Se ha agregado compatibilidad con grupos de Windows para crear usuarios con un modo de inicio de sesión específico (ya sea
batch
ointeractive
) a través deLoginMode
.El tiempo de retención de tareas predeterminado para todas las tareas es ahora 7 días, anteriormente era infinito.
Versión 2018-08-01.7.0
Las nuevas características de la versión 2018-08-01.7.0 incluyen:
- Vea la versión del agente de nodo de Azure Batch a través de la nueva propiedad NodeAgentInfo en ComputeNode.
- Se ha agregado la capacidad de especificar un en
Filter
deResult
una tarea. Obtenga más información aquí.- Esto permite que el escenario solicitado a menudo realice una consulta del lado servidor para buscar todas las tareas con errores.
-
[Breaking] Se quitó la
ValidationStatus
propiedad de TaskCounts. -
[Breaking] El tipo de almacenamiento en caché predeterminado para DataDisk y OSDisk ahora es
ReadWrite
en lugar deNone
. -
[Breaking] Se ha cambiado el nombre del único valor de ContainerType de
docker
adockerCompatible
.
Versión 2018-03-01.6.1
Las nuevas características de la versión 2018-03-01.6.1 incluyen:
- Recuentos de nodos de grupo por estado: esta versión agrega la capacidad de consultar los recuentos de nodos del grupo por estado a través de la nueva operación ListPoolNodeCounts . Esta operación le ofrece la capacidad de consultar todos los grupos de una cuenta de Batch para los estados de nodo, como la creación, inactividad, sin conexión, adelantado, reinicio, reimposición, inicio y otros.
- Registros del agente de Node: esta versión agrega la capacidad de cargar Azure Batch registros del agente de nodo desde un nodo determinado a través de la operación UploadBatchServiceLogs. Esto está pensado para su uso en la depuración Soporte técnico de Microsoft si se producen problemas en un nodo.
Versión 2017-09-01.6.0
Ventaja de uso híbrido de Azure: ahora puede crear grupos de máquinas virtuales Windows de Batch que especifican que se usen las licencias de ventaja de uso híbrido de Azure. Cuando se usa esta licencia, se aplica un descuento al precio de la máquina virtual. Use la nueva propiedad LicenseType en VirtualMachineConfiguration.
Discos de datos de máquina virtual de grupo: puede conectar uno o varios discos de datos vacíos a grupos de máquinas virtuales mediante la nueva configuración del disco de datos que forma parte de la configuración de la máquina virtual. Use la propiedad DataDisks en VirtualMachineConfiguration.
(Cambio importante) Las imágenes personalizadas ahora se crean e implementan con recursos de imagen de Azure Resource Manager en lugar de archivos VHD de blob. Batch ahora usa discos administrados para crear las máquinas virtuales del grupo y, por tanto, usa un recurso image . Ahora no hay ningún límite en el número de máquinas virtuales de un grupo creado mediante una imagen personalizada; además, ya no se requieren varias copias del blob VHD para grupos grandes. Por lo tanto, los grupos de imágenes personalizados son mucho más fáciles de crear y escalar. Para más información, consulte Uso de una imagen personalizada para crear un grupo de máquinas virtuales.
La nueva propiedad VirtualMachineImageId de ImageReference contiene la referencia a image y ya no existe OSDisk.ImageUris .
Debido a este cambio, ImageReference es ahora una propiedad necesaria de VirtualMachineConfiguration.
(Cambio importante) Las tareas de varias instancias (creadas con MultiInstanceSettings) ahora deben especificar CoordinationCommandLine y NumberOfInstances ahora es opcional y el valor predeterminado es 1.
Se ha agregado compatibilidad con las tareas que se ejecutan mediante contenedores de Docker. Para ejecutar una tarea mediante un contenedor de Docker, debe especificar containerConfiguration en VirtualMachineConfiguration para un grupo y, a continuación, agregar TaskContainerSettings en la tarea.
Versión 2017-06-01.5.1
La versión de la API de Batch que se describe aquí es 2017-06-01.5.1. Cuando sea posible, se recomienda usar la versión más reciente.
Las nuevas características de la versión 2017-06-01.5.1 incluyen:
- Compatibilidad con recuentos de tareas eficaces a través de la nueva operación Obtener recuentos de tareas . Al llamar a la operación Obtener recuentos de tareas, puede obtener un recuento de tareas activas, en ejecución y completadas, y de tareas que se han realizado correctamente o con errores. Para más información, consulte Recuento de tareas de un trabajo por estado (versión preliminar).
- Compatibilidad con la especificación de puntos de conexión de entrada en los nodos de proceso del grupo, a través de la nueva propiedad poolEndpointConfiguration . Al establecer esta propiedad, puede abordar puertos específicos en el nodo externamente.
Versión 2017-05-01.5.0
En las secciones siguientes se describen las características nuevas y modificadas de la versión 2017-05-01.5.0.
Importante
La versión 2017-05-01.5.0 incluye varios cambios importantes. Revise los cambios importantes que se indican a continuación y actualice el código para llamar a la versión 2017-05-01.5.0.
Nodos de proceso de prioridad baja
Azure Batch ahora ofrece nodos de proceso de prioridad baja para reducir el costo de las cargas de trabajo de Batch. Las máquinas virtuales de prioridad baja posibilitan nuevos tipos de cargas de trabajo de Batch al proporcionar elevada capacidad de proceso que también resulta económica.
Hay varios cambios en la API REST para los nodos de prioridad baja:
- (Cambio importante) Se ha cambiado el nombre de las propiedades targetDedicated y currentDedicated de una especificación de grupo o grupo a targetDedicatedNodes y currentComputeNodes.
- (Cambio importante) La propiedad resizeError de un grupo es ahora una colección denominada resizeErrors.
- Los nodos de proceso tienen una nueva propiedad isDedicated . Esta propiedad es verdadera para los nodos dedicados y false para los nodos de prioridad baja.
- Una tarea del Administrador de trabajos tiene una nueva propiedad allowLowPriorityNode . Si esta propiedad es true, la tarea Administrador de trabajos se puede ejecutar en un nodo de prioridad baja. Si es false, la tarea Administrador de trabajos se ejecutará en un nodo de proceso dedicado.
Usuarios con nombre en Linux
Azure Batch ahora ofrece compatibilidad adicional para crear usuarios con nombre en nodos de Linux.
- La nueva propiedad linuxUserConfiguration admite la especificación de un uid (id. de usuario) y gid (id. de grupo) al crear un usuario de Linux.
- (Cambio importante) La propiedad sshPrivateKey se ha movido de la propiedad userAccount a la nueva propiedad linuxUserConfiguration . La propiedad linuxUserConfiguration es en sí misma una propiedad de la propiedad userAccount .
Para obtener más información sobre las cuentas de usuario con nombre, consulte Ejecución de tareas en cuentas de usuario en Batch.
Archivos de salida para datos de tareas
Ahora puede especificar archivos de salida para cargar datos de tareas una vez completada una tarea.
- La nueva propiedad outputFiles admite la especificación de archivos de tareas que se van a cargar en Azure Storage.
- La nueva propiedad fileUploadError de la propiedad exitConditions admite la especificación de acciones que se deben realizar en función del estado de carga de un archivo de salida.
Informes de errores de tareas
Se han realizado varios cambios para mejorar los informes de errores de tareas.
- La nueva propiedad result de la propiedad executionInfo indica si una tarea se realizó correctamente o no.
- (Cambio importante) Se ha cambiado el nombre de la propiedad schedulingError de la propiedad executionInfo. La propiedad failureInfo se devuelve cada vez que se produce un error en la tarea. Esto incluye todos los casos de error de programación anteriores, todos los casos en los que se devuelve un código de salida de tarea distinto de cero y los errores de carga de archivos.
- (Cambio importante) Se ha cambiado el nombre de la propiedad schedulingError de la propiedad exitConditions a preProcessingError para aclarar cuándo se produjo el error en el ciclo de vida de la tarea.
- (Cambio importante) Se ha cambiado el nombre de la propiedad schedulingErrorCateogry a errorCategory.
Licencias de aplicación
Ahora puede solicitar que las licencias de aplicación se aprovisionen en el grupo a través de la nueva propiedad applicationLicenses en una especificación de grupo o grupo.
Versión 2017-01-01.4.0
Esta versión amplía toda la compatibilidad con la versión anterior, 2016-07-01.3.1. Además, admite las siguientes funcionalidades:
Ejecute una tarea bajo una identidad de usuario especificada.
Ahora puede ejecutar una colección de tareas o tareas en una de las siguientes identidades de usuario, especificadas a través de la nueva propiedad userIdentity en el recurso de tarea:
Una cuenta de usuario con un nombre que defina.
Una cuenta de usuario que se crea automáticamente (un usuario automático). Un usuario automático puede ejecutarse como un usuario administrativo o como un usuario no administrativo. De forma predeterminada, un usuario automático se ejecuta como un usuario no administrativo.
Importante
La propiedad userIdentity , con su propiedad elevationLevel , reemplaza la propiedad runElevated en las solicitudes que agregan una tarea o una colección de tareas, y en respuestas que obtienen información sobre una tarea o esa lista de tareas.
Si realiza una solicitud que incluye la propiedad runElevated a la versión 2017-01-01.4.0 del servicio Batch, se producirá un error en la solicitud.
Para ejecutarse como usuario administrativo, actualice la aplicación para que use la propiedad userIdentity y establezca la propiedad elevationLevel en admin.
Para ejecutarse como usuario no administrativo, actualice la aplicación para que use la propiedad userIdentity y establezca la propiedad elevationLevel en nonAdmin. Dado que este es el valor predeterminado, también puede omitir la configuración.
Defina las cuentas de usuario en todos los nodos de un grupo.
Ahora puede ejecutar una colección de tareas o tareas en una cuenta de usuario que defina en el recurso de grupo. Defina una cuenta de usuario a través de la nueva propiedad userAccounts en las solicitudes a Agregar grupo. Al definir la cuenta, puede especificar el nombre de la cuenta, la contraseña, el nivel de elevación (administrador o no administrador) y la clave privada SSH (para grupos de Linux).
Una vez definida la cuenta de usuario, puede especificar esa cuenta de usuario para la propiedad userIdentity en las solicitudes que agregan una tarea o una colección de tareas.
Proporcione una tarea con un token para autenticarse en el servicio Batch cuando se ejecute la tarea.
El servicio Batch ahora puede 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 la cuenta de Batch. El token se proporciona a través de la variable de entorno AZ_BATCH_AUTHENTICATION_TOKEN.
Actualmente, solo se admiten tokens de autenticación para llamar a operaciones en el recurso de trabajo. El token de autenticación concede acceso a todas las operaciones del trabajo que contiene la tarea.
Para que el servicio Batch proporcione el token de autenticación, especifique la nueva propiedad authenticationTokenSettings , junto con su propiedad de acceso , en solicitudes para Agregar tarea o Agregar colección de tareas.
Especifique una acción que se realizará en las dependencias de una tarea si se produce un error en la tarea.
Ahora puede especificar que las tareas dependientes continúen incluso si se produce un error en la tarea en la que dependen. Establezca la nueva propiedad dependencyAction de un recurso de tarea para satisfacer la ejecución de tareas dependientes aunque se produzca un error en la tarea primaria. Como alternativa, establezca dependencyAction para bloquear para evitar la ejecución de tareas dependientes si se produce un error en la tarea primaria.
Especifique la propiedad dependencyAction en las solicitudes para Agregar tarea o Agregar colección de tareas.
Para obtener más información sobre el uso de acciones de dependencia, consulte Acciones de dependencia.
Use imágenes de disco del sistema operativo personalizadas al crear un grupo.
Ahora puede usar imágenes de disco del sistema operativo personalizadas para crear un grupo.
Para ello, debe especificar cuándo se crea la cuenta de Batch que los grupos se van a aprovisionar en la suscripción de usuario, en lugar de en una suscripción administrada por el servicio Batch. En una llamada a Crear cuenta, establezca la propiedad poolAllocationMode en UserSubscription. A continuación, use la propiedad osDisk para especificar una referencia a una imagen de disco en una solicitud para agregar grupo.
Importante
Al crear la cuenta de Batch, si especifica que los grupos se van a aprovisionar en la suscripción de usuario, debe usar la autenticación basada en Azure Active Directory para todas las solicitudes realizadas a través de esa cuenta.
Use la autenticación basada en Azure Active Directory para las solicitudes al servicio Batch.
Azure Active Directory (Azure AD) ahora se admite para autenticar llamadas al servicio Batch.
Si la cuenta de Batch está configurada para aprovisionar grupos en la suscripción de usuario, se requiere la autenticación de Azure AD.
Versión 2016-07-01.3.1
Esta versión amplía toda la compatibilidad con la versión anterior, 2016-02-01.3.0. Además, admite las siguientes funcionalidades:
Capacidad para crear un grupo y un grupo automático con configuración de red
- Se ha agregado una nueva propiedad networkConfiguration a los recursos de grupo y de grupo automático. Esta propiedad se puede usar para especificar la configuración de red del grupo, como la subred en la que se crean los nodos de proceso del grupo.
Finalice automáticamente un trabajo cuando se completen todas las tareas.
- Se ha agregado una nueva propiedad onAllTasksComplete al recurso de trabajo. Puede especificar esto al crear o actualizar un trabajo.
Finalice o deshabilite automáticamente un trabajo cuando se produce un error en una tarea.
- Se ha agregado una nueva propiedad onTaskFailure al recurso de trabajo y se ha agregado una nueva propiedad exitConditions al recurso de tarea. El valor de job onTaskFailure indica si el error de la tarea puede tener un impacto en el nivel de trabajo y la propiedad exitConditions de la tarea permite a las tareas adaptar el impacto de nivel de trabajo a la naturaleza del error.
Asocie paquetes de aplicación con tareas y grupos.
- Se ha agregado una nueva propiedad applicationPackageReferences al recurso de tarea y a la configuración jobManagerTask del trabajo. Esto permite que los paquetes de aplicación se implementen a petición, ya que las tareas requieren que se especifiquen en el momento de la creación del grupo. Esto es especialmente útil para los grupos de larga duración en los que se puede llamar para ejecutar diferentes tipos de trabajos o versiones de aplicación diferentes durante su duración, o si tiene un paquete de aplicación grande que no es necesario para todas las tareas.
Capacidad para reactivar una tarea con errores.
- Se ha agregado una nueva operación Reactivar una tarea para restablecer el estado de una tarea con error en activo. Esto permite reintentar los errores, por ejemplo, si el error era transitorio o si ha podido corregir la causa del error, sin volver a crear la tarea.
Versión 2016-02-01.3.0
Esta versión amplía toda la compatibilidad con la versión anterior, 2015-12-01.2.2. Además, admite las siguientes funcionalidades:
Capacidad para crear un grupo y un grupo automático con la configuración de máquina virtual de IaaS
Las propiedades existentes "osFamily", "targetOSVersion" y "currentOSVersion" se mueven de las propiedades de nivel superior de los recursos Pool y Autopool y se mueven dentro de una nueva propiedad denominada "cloudServiceConfiguration".
Se agrega una nueva propiedad "virtualMachineConfiguration" a los recursos Pool y Autopool. Esta propiedad se puede especificar para configurar un grupo o grupo automático con máquinas virtuales IaaS.
Se agrega una nueva API para obtener información sobre todas las SKU del agente de nodo compatibles con el servicio Batch. Consulte Enumeración de las SKU de agente de nodo compatibles.
Se agrega una nueva API para obtener la configuración de inicio de sesión remota que se puede usar para iniciar sesión de forma remota en un nodo de proceso creado con la configuración de máquina virtual de IaaS. Consulte Obtención de la configuración de inicio de sesión remoto para un nodo.
Se agrega una nueva API para agregar una colección de tareas a un trabajo. Consulte Adición de una colección de tareas a un trabajo.
Se agrega una nueva propiedad opcional "sshPublicKey" al recurso User que se puede usar para agregar o actualizar usuarios en un nodo de proceso de Linux.
Se agregan dos nuevas propiedades "totalTasksSucceeded" y "runningTasksCount" al recurso Node. Estas propiedades se pueden obtener a través de Obtener información sobre un nodo o Enumerar los nodos de proceso de un grupo.
Se agrega una nueva propiedad "fileMode" al tipo complejo "ResourceFile". Esta propiedad solo se aplica en los nodos de proceso de Linux y se omite para los nodos de proceso de Windows.
Se agrega una nueva propiedad "fileMode" al tipo complejo "FileProperties". El servicio Batch devuelve esta propiedad para los nodos de proceso de Linux como parte de las API GetFileProperties o ListFileProperties. Además, la propiedad existente "creationTime" en el tipo complejo "FileProperties" se cambia a una propiedad opcional porque esta propiedad no se devolverá para los nodos de proceso de Linux.
El tipo de datos de la propiedad existente "visibility" dentro del tipo complejo "CertificateReference" se modifica de una cadena con valores separados por comas en una colección de cadenas. También se cambia el nombre de uno de los valores existentes para la visibilidad de "rdp" a "remoteuser".
Las direcciones URL de las SIGUIENTES API se cambian para reemplazar "?" por el nombre de la acción por "/":
Actualización del sistema operativo de los nodos de proceso en un grupo
Versión 2015-12-01.2.2
Esta versión amplía toda la compatibilidad con la versión anterior, 2015-11-01.2.1. Además, admite las siguientes funcionalidades:
Las aplicaciones ahora se pueden implementar en nodos de proceso mediante paquetes de aplicación en lugar de como archivos de recursos.
Se proporcionan nuevas API para que los clientes examinen la lista de aplicaciones y versiones disponibles, por ejemplo, para mostrar un selector en una interfaz de usuario.
Las API relacionadas con el grupo se cambian para permitir que un grupo especifique los paquetes de aplicación que se descargarán en todos los nodos de ese grupo.
Las tareas ahora se pueden realizar en función de otras tareas. Una tarea dependiente no se iniciará hasta que todas las tareas de las que depende se hayan completado correctamente.
Esta versión incluye los siguientes cambios:
- El tiempo de espera de cambio de tamaño del grupo predeterminado ha cambiado a 15 minutos.
Versión 2015-11-01.2.1
Esta versión amplía toda la compatibilidad con la versión anterior 2015-06-01.2.0. Además, admite las siguientes funcionalidades:
Capacidad para agregar y ejecutar tareas de varias instancias (por ejemplo, MPI)
Se agrega una nueva propiedad opcional "multiInstanceSettings" al recurso Task que se puede incluir opcionalmente en Add Task, Get Task, List Tasks API.
Una nueva API Enumera las subtareas de una tarea se agrega para obtener información sobre las subtareas.
Se agrega una nueva propiedad opcional "subtaskId" a "recentTasks" para un nodo de proceso. Esta propiedad se devuelve como parte de Get Compute Node y List Compute Nodes
Funcionalidad para deshabilitar o habilitar la programación de tareas en un nodo de proceso
Dos nuevas API Deshabilitan la programación de tareas en un nodo y Habilitación de la programación de tareas en un nodo se agregan en el recurso de nodo de proceso.
Se agrega un nuevo estado de nodo de proceso "sin conexión". En el caso de las versiones anteriores de la API, este estado se asigna a "inutilizable".
Se agrega una nueva propiedad "schedulingState" al recurso de nodo de proceso. Valores posibles para "enabled" y "disabled".
Capacidad para especificar el intervalo de evaluación de escalado automático en un grupo o un grupo automático
Se agrega una nueva propiedad "autoScaleEvaluationInterval" al recurso de grupo. Esta propiedad se puede incluir en las API Agregar grupo, Obtener grupo, Habilitar escalabilidad automática y Grupos de listas.
Del mismo modo, para los grupos automáticos, se agrega una nueva propiedad "autoScaleEvaluationInterval" a la propiedad "autoPoolSpecification". Esta propiedad se puede incluir en Add Job, Get Job, List Jobs, Add Job Schedule, Get Job Schedule, Update Job Schedule, List Job Schedules y List Jobs in Job Schedule API.
Mejora de las API de tareas para devolver el directorio raíz de la tarea en el nodo de proceso.
Se agregan dos nuevas propiedades "taskRootDirectory" y "taskRootDirectoryUrl" al recurso Task que se puede obtener como parte de Obtención de información acerca de una tarea, List Tasks API
Se agrega una nueva propiedad "taskRootDirectory" a "jobPreparationTaskExecutionInfo" y "jobReleaseTaskExecutionInfo", que se puede obtener a través de Enumerar el estado de las tareas de preparación del trabajo y liberación de trabajos para una API de trabajo.