Gestión por lotes de la API REST

Las operaciones proporcionadas por la API REST de Gestión de Lotes 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 YYYY-MM-DD.

Última versión: 01-06-2025

Nivel de trabajo FIFO
- Tipo añadido JobDefaultOrder .
- Ampliado TaskSchedulingPolicy con una nueva jobDefaultOrder propiedad para apoyar la programación FIFO a nivel de trabajo.
Soporte CMK en Pools
- Añadido DiskCustomerManagedKey para soporte de claves gestionadas por el cliente (CMK) en pools.
- Ampliado DiskEncryptionConfiguration con una nueva customerManagedKey propiedad.
- Ampliado ManagedDisk con una nueva diskEncryptionSet propiedad.
- Añadido DiskEncryptionSetParameters para referenciar conjuntos de cifrado de disco.
Soporte IPv6 en pools
- Tipo añadido IPFamily .
- Ampliado PublicIPAddressConfiguration con nuevas ipFamilies y ipTags propiedades.
Soporte para protocolos de seguridad de metadatos en pools
- Añadido HostEndpointSettings y HostEndpointSettingsModeTypes.
- Se ha agregado ProxyAgentSettings.
- Ampliado SecurityProfile con una nueva proxyAgentSettings propiedad para el soporte de protocolos de seguridad de metadatos.
Soporte de etiquetas IP
- Tipo añadido IPTag .
- Extendido PublicIPAddressConfiguration con nueva ipTags propiedad para soporte de etiquetas IP.
[Rompiendo] Soporte eliminado para certificados:
- Eliminaron las APIs de certificados: Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, y Certificate_CancelDeletion.
- Modelos de certificados eliminados: Certificate, CertificateCreateOrUpdateParameters, CertificateCreateOrUpdatePropertiesCertificateBaseProperties, CertificateProperties, CertificateFormat, CertificateProvisioningState, CertificateReference, CertificateStoreLocationCertificateVisibility, y DeleteCertificateError.
- Se eliminó certificates una propiedad de la piscina.
[Rompiendo] Eliminé NodeCommunicationMode el modelo y las propiedades targetNodeCommunicationMode y currentNodeCommunicationMode del pool.
[Rompiendo] Se eliminó applicationLicenses una propiedad de la piscina.
[Rompiendo] Eliminado storageAccountType de DataDisk. Use ManagedDisk.storageAccountType en su lugar.
[Rompiendo] Eliminado resourceTags de Pool.

Versiones anteriores

Las versiones anteriores incluyen:

Versión: 2024-07-01

Soporte adicional para el Perímetro de Seguridad de Red (NSP):
- Se añadió NetworkSecurityPerimeter_ListConfigurations una operación para listar todas las configuraciones NSP en una cuenta por lotes.
- Se añadió NetworkSecurityPerimeter_GetConfiguration operación para obtener una configuración específica de NSP.
- Se añadió NetworkSecurityPerimeter_ReconcileConfiguration operación para conciliar una configuración NSP.
- Valor añadido SecuredByPerimeter al PublicNetworkAccessType enum.
Soporte añadido de VM confidenciales:
- Modelo añadido VMDiskSecurityProfile con una securityEncryptionType propiedad.
- Propiedad añadida securityProfile a ManagedDisk.
- Añadido confidentialVM como un nuevo valor para SecurityTypes enum.
Se añadió el soporte de referencia de imágenes de la Galería Compartida y la Galería Comunitaria:
- Propiedades y sharedGalleryImageId añadidas communityGalleryImageId a ImageReference.
Se añadió soporte para montar la asignación de contenedores para tareas:
- Añadí ContainerHostBatchBindMountEntry el modelo con source propiedades y isReadOnly Y.
- Se añadió ContainerHostDataPath enum con los valores Shared, Startup, VfsMounts, Task, JobPrep, y Applications.
- Propiedad añadida containerHostBatchBindMounts a TaskContainerSettings.
[Rompiendo] Eliminación del soporte para pools de configuración de servicios en la nube:
- Modelo eliminado CloudServiceConfiguration .
- Se quitó cloudServiceConfiguration la propiedad de DeploymentConfiguration.
- Operación eliminada Location_ListSupportedCloudServiceSkus .

Versión: 01-02-2024

Se añadió soporte para políticas de actualización del sistema operativo en pools de máquinas virtuales:
- Modelo añadido UpgradePolicy con propiedades mode, automaticOSUpgradePolicy, y rollingUpgradePolicy.
- Modelo añadido AutomaticOSUpgradePolicy con propiedades disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, y osRollingUpgradeDeferral.
- Modelo añadido RollingUpgradePolicy con propiedades enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, y rollbackFailedInstancesOnPolicyBreach.
- Se añadió upgradePolicy propiedad a la piscina.
- Se añadió UpgradeMode enum con valores automatic, manual, y rolling.
Propiedad añadida batchSupportEndOfLife a SupportedSku.

Versión: 01-11-2023

Se añadió el soporte para Trusted Launch / perfiles de seguridad para pools de VM:
- Modelo añadido SecurityProfile con propiedades encryptionAtHost, securityType, y uefiSettings.
- Añadí UefiSettings un modelo con propiedades secureBootEnabled y vTpmEnabled.
- Añadido SecurityTypes enum con valores trustedLaunch.
- Propiedad añadida securityProfile a VirtualMachineConfiguration.
Se ha añadido soporte para referencias de artefactos de servicio en conjuntos de escala:
- Modelo añadido ServiceArtifactReference con una propiedad requerida id .
- Propiedad añadida serviceArtifactReference a VirtualMachineConfiguration.
Configuración mejorada del disco del sistema operativo:
- Modelo añadido ManagedDisk con una storageAccountType propiedad.
- Añadimos caching, diskSizeGB, managedDisk, y writeAcceleratorEnabled propiedades a OSDisk.
Añadido StandardSSD_LRS como un nuevo valor para StorageAccountType.
Se añadió resourceTags una propiedad al Pool para permitir que las etiquetas definidas por el usuario se propaguen a los recursos de respaldo de Azure. Solo es aplicable cuando poolAllocationMode es UserSubscription.

Versión: 01-05-2023

Se añadió propiedad enableAcceleratedNetworking booleana a NetworkConfiguration.
- 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 enableAutomaticUpgrade booleana a VMExtension.
- Esta propiedad determina si la extensión debe actualizarse automáticamente si existe una versión más reciente disponible.
La propiedad type de ContainerConfiguration ahora soporta dos valores: DockerCompatible y CriCompatible.

Versión: 01-10-2022

Se añadió NodeCommunicationMode enum con valores Default, Classic, y Simplified para determinar cómo un pool se comunica con el servicio por lotes.
Se añadió currentNodeCommunicationMode una propiedad a Pool para referirse al estado actual del modo de comunicación del pool.
Se añadió targetNodeCommunicationMode una propiedad a Pool para referirse al modo de comunicación de nodos deseado para el pool.

Versión: 01-06-2022

Se ha añadido PrivateEndpointConnection_Delete la operación para eliminar una conexión privada de endpoint.
Se añadió allowedAuthenticationModes propiedad a BatchAccountCreateProperties y BatchAccountUpdateProperties para controlar los modos de autenticación.
Añadido TaskAuthenticationToken como un nuevo valor para AuthenticationMode enum.

Versión: 01-01-2022

Se añadió Location_ListSupportedVirtualMachineSkus operación para listar los SKUs de VM compatibles en una ubicación determinada.
Modelo añadido SupportedSku con propiedades name, familyName, y capabilities.
Modelo añadido SupportedSkusResult .
Modelo añadido SkuCapability .

Versión: 01-06-2021

Se añadió la capacidad de asignar identidades gestionadas asignadas por el usuario a BatchPoolIdentity.
Se añadió identityReference propiedad a AzureBlobFileSystemConfiguration, ContainerRegistry, y ResourceFile para apoyar el acceso a recursos mediante identidad gestionada.
Se añadió soporte para extensiones de VM:
- Propiedad añadida extensions a VirtualMachineConfiguration.
- Modelo añadido VMExtension .
Se añadió la capacidad de especificar zonas de disponibilidad usando una nueva propiedad nodePlacementConfiguration en VirtualMachineConfiguration.
- Modelo añadido NodePlacementConfiguration con una policy propiedad.
- Se añadió NodePlacementPolicyType enum con valores Regional y Zonal.
Se añadió osDisk propiedad a VirtualMachineConfiguration con soporte efímero de disco del sistema operativo mediante DiffDiskSettings.

Versión: 2021-01-01

Capacidad añadida para cifrar datos de clientes con claves gestionadas por el cliente:
- Modelo añadido EncryptionProperties con keySource y keyVaultProperties.
- Añadido KeySource enum.
- Modelo añadido KeyVaultProperties .
- Propiedades añadidas encryption a BatchAccountCreateProperties y BatchAccountProperties.
Se añadió BatchAccountIdentity el modelo que soporta SystemAssigned, UserAssigned, y None los tipos de identidad.
Propiedades añadidas identity a BatchAccountCreateParameters y BatchAccountUpdateParameters.
Propiedad añadida allowedAuthenticationModes a BatchAccountProperties.
Se añadió ListOutboundNetworkDependenciesEndpoints una operación para listar los puntos finales que puede llamar un nodo de cómputo por lotes.

Versión: 2020-09-01

Se añadió taskSlotsPerNode una propiedad al Pool, reemplazando el comportamiento fijo de tarea por nodo.
Se añadió BatchAccountProperties.publicNetworkAccess para controlar el acceso público a la red.
Se añadió NetworkProfile un modelo para controlar las reglas de acceso a la red por punto final.

Versión: 01-05-2020

Soporte adicional para enlaces privados:
- Operación añadida PrivateEndpointConnection_ListByBatchAccount .
- Operación añadida PrivateEndpointConnection_Get .
- Operación añadida PrivateEndpointConnection_Update .
- Operación añadida PrivateLinkResource_ListByBatchAccount .
- Operación añadida PrivateLinkResource_Get .
- Añadido PrivateEndpointConnection, PrivateEndpoint, PrivateLinkResource, y PrivateLinkServiceConnectionState modelos.
Propiedad añadida publicNetworkAccess a BatchAccountCreateProperties.

Versión: 2020-03-01

Se añadió la capacidad de cifrar unidades de disco de nodo usando la DiskEncryptionConfiguration propiedad de VirtualMachineConfiguration.
Se añadió PublicIPAddressConfiguration un modelo NetworkConfiguration para soportar pools sin IPs públicas.
- Se añadió IPAddressProvisioningType enum con valores BatchManaged, UserManaged, y NoPublicIPAddresses.
- Propiedad añadida ipAddressIds a PublicIPAddressConfiguration.

Versión: 01-08-2019

Se añadió la capacidad de especificar una colección de IPs públicas a NetworkConfiguration través de la publicIPs propiedad.
Capacidad añadida para montar sistemas de archivos remotos en cada nodo de un pool a través de MountConfiguration:
- Añadido AzureBlobFileSystemConfiguration, NFSMountConfiguration, CIFSMountConfiguration, y AzureFileShareConfiguration modelos.
- Se añadió mountConfiguration propiedad a la piscina.

Versión: 01-04-2019

Se añadió Location_CheckNameAvailability una operación para comprobar si está disponible un nombre de cuenta por lote.
Añadido CheckNameAvailabilityParameters y CheckNameAvailabilityResult modelos.
Soporte adicional DetectorResponse :
- Operación añadida BatchAccount_ListDetectors .
- Operación añadida BatchAccount_GetDetector .

Versión: 01-12-2018

Se añadió containerConfiguration una propiedad para VirtualMachineConfiguration pools habilitados por contenedores.
- Modelo añadido ContainerConfiguration .
- Modelo añadido ContainerRegistry .
- Modelo añadido TaskContainerSettings .
Se añadió startTask propiedad al Pool con soporte completo StartTask para modelos.
Se añadió dataDisks una propiedad para VirtualMachineConfiguration conectar discos de datos.
Se añadió licenseType una propiedad para VirtualMachineConfiguration Azure Hybrid Use Benefit.
Se añadió AutoStorageAuthenticationMode enum con valores StorageKeys y BatchAccountManagedIdentity.
Propiedad añadida nodeIdentityReference a AutoStorageBaseProperties.
Añadí NetworkConfiguration modelo con subnetId, endpointConfiguration, y dynamicVnetAssignmentScope propiedades.
Añadidos PoolEndpointConfiguration y InboundNatPool modelos para especificar los endpoints entrantes.

Versión: 01-09-2017

Soporte adicional para la gestión de pools vía ARM:
- Añadido Pool_ListByBatchAccount, Pool_Get, Pool_Create, Pool_Update, operaciones Pool_Delete .
- Añadido Pool_DisableAutoScale y Pool_StopResize operaciones.
- Modelo de recursos añadido Pool con propiedades integrales de piscina.
Gestión de certificados añadida mediante ARM:
- Añadido Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, , operaciones Certificate_CancelDeletion .
Gestión adicional de aplicaciones y paquetes de aplicaciones:
- Añadido Application_List, Application_Get, Application_Create, Application_Update, operaciones Application_Delete .
- Añadido ApplicationPackage_List, ApplicationPackage_Get, ApplicationPackage_Create, ApplicationPackage_Delete, operaciones ApplicationPackage_Activate .
Se añadió VirtualMachineConfiguration un modelo para la configuración de pools basadas en VMs IaaS.
Modelo añadido ScaleSettings con FixedScaleSettings y AutoScaleSettings para controlar el tamaño de la piscina.

Versión: 01-05-2017

Se añadió KeyVaultReference un modelo para la integración de Azure Key Vault con cuentas por lotes.
Se añadió poolAllocationMode propiedad a BatchAccountCreateProperties los modos con BatchService y UserSubscription .
Propiedades y dedicatedCoreQuotaPerVMFamily añadidas dedicatedCoreQuotaPerVMFamilyEnforced a BatchAccountProperties.
Propiedad añadida lowPriorityCoreQuota a BatchAccountProperties.

Versión: 01-01-2017

Se añadió soporte para cuentas de almacenamiento asignadas por el usuario mediante la configuración de almacenamiento automático.
Propiedad añadida storageAccountId a AutoStorageBaseProperties.
Modelo añadido AutoStorageProperties con lastKeySync propiedad.
Operación añadida BatchAccount_SynchronizeAutoStorageKeys .

Versión: 01-12-2015

Esta es la versión inicial de la API REST de Gestión por Lotes. Proporciona las siguientes capacidades básicas:

Gestión de cuentas por lotes:
- BatchAccount_Create - Crea una nueva cuenta por lotes con parámetros especificados.
- BatchAccount_Update - Actualiza las propiedades de una cuenta de lote existente.
- BatchAccount_Delete - Elimina la cuenta de lote especificada.
- BatchAccount_Get - Obtiene información sobre la cuenta de lote especificada.
- BatchAccount_List - Lista todas las cuentas por lotes bajo suscripción.
- BatchAccount_ListByResourceGroup - Lista todas las cuentas por lotes bajo un grupo de recursos.
- BatchAccount_GetKeys - Obtiene las claves de cuenta para la cuenta Batch especificada.
- BatchAccount_RegenerateKey - Regenera la clave de cuenta especificada para la cuenta por lotes.
Operaciones de localización:
- Location_GetQuotas - Recibe las cuotas de servicio por lotes para la suscripción especificada en la ubicación indicada.
Operaciones:
- Operations_List - Lista las operaciones disponibles para el proveedor de lotes.

Last updated on 2026-03-11

Compartir a través de