Gestão em lote Versionamento da API REST

As operações fornecidas pela API REST de Gestão de Lotes podem ter múltiplas versões para compatibilidade retroativa à medida que a API evolui ao longo do tempo. Deve especificar qual a versão de uma operação que deseja usar quando for chamada, fornecendo a versão com a sua chamada REST. Se a sua aplicação chamar uma versão mais antiga de uma operação, pode optar por continuar a chamar a versão mais antiga ou modificar o seu código para chamar uma versão mais recente. Se a versão não for especificada ou for indicada uma versão incorreta, então é devolto um erro.

Para especificar qual versão de uma operação usar, defina o parâmetro de consulta de versão da api . A versão é do formato YYYY-MM-DD.

Última versão: 2025-06-01

• Nível profissional FIFO

  • Tipo adicionado JobDefaultOrder .
  • Ampliado TaskSchedulingPolicy com uma nova jobDefaultOrder propriedade para suportar o agendamento FIFO ao nível do trabalho.

• Suporte CMK em Pools

  • Adicionado DiskCustomerManagedKey para suporte de chaves geridas pelo cliente (CMK) em pools.
  • Ampliado DiskEncryptionConfiguration com uma nova customerManagedKey propriedade.
  • Ampliado ManagedDisk com uma nova diskEncryptionSet propriedade.
  • Adicionado DiskEncryptionSetParameters para referenciar conjuntos de encriptação de disco.

• Suporte IPv6 em Pools

  • Tipo adicionado IPFamily .
  • Ampliado PublicIPAddressConfiguration com novas ipFamilies e ipTags propriedades.

• Suporte ao Protocolo de Segurança de Metadados em Pools

  • Adicionado HostEndpointSettings e HostEndpointSettingsModeTypes.
  • Adicionado ProxyAgentSettings.
  • Estendido SecurityProfile com uma nova proxyAgentSettings propriedade para suporte a protocolos de segurança de metadados.

• Suporte a etiquetas IP

  • Tipo adicionado IPTag .
  • Estendido PublicIPAddressConfiguration com nova ipTags propriedade para suporte a etiquetas IP.

• [Quebra] Suporte removido para certificados:

  • APIs de Certificados removidas: Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, e Certificate_CancelDeletion.
  • Modelos de Certificados Removidos: Certificate, CertificateCreateOrUpdateParameters, CertificateBasePropertiesCertificateCreateOrUpdateProperties, , CertificateFormatCertificateProperties, CertificateProvisioningState, CertificateReference, CertificateStoreLocation, , CertificateVisibility, , e DeleteCertificateError.
  • Removi certificates propriedade da Pool.

• [Quebra] Removi NodeCommunicationMode o modelo e as propriedades targetNodeCommunicationMode e currentNodeCommunicationMode do Pool.

• [Quebra] Removi applicationLicenses propriedade da Pool.

• [Quebra] Removido storageAccountType de DataDisk. Utilize ManagedDisk.storageAccountType em substituição.

• [Quebra] Removido resourceTags do Pool.

Versões Anteriores

Versões anteriores incluem:

• 2024-07-01
• 2024-02-01
• 2023-11-01
• 2023-05-01
• 2022-10-01
• 2022-06-01
• 2022-01-01
• 2021-06-01
• 2021-01-01
• 2020-09-01
• 2020-05-01
• 2020-03-01
• 2019-08-01
• 2019-04-01
• 2018-12-01
• 2017-09-01
• 2017-05-01
• 2017-01-01
• 2015-12-01

Versão: 2024-07-01

• Suporte adicional para o Perímetro de Segurança de Rede (NSP):

  • Adicionada NetworkSecurityPerimeter_ListConfigurations a operação para listar todas as configurações NSP numa conta Batch.
  • Adicionei NetworkSecurityPerimeter_GetConfiguration operação para obter uma configuração específica de NSP.
  • Adicionada NetworkSecurityPerimeter_ReconcileConfiguration operação para reconciliar uma configuração NSP.
  • Valor acrescentado SecuredByPerimeter ao PublicNetworkAccessType enum.

• Suporte a VM Confidencial adicionado:

  • Modelo adicionado VMDiskSecurityProfile com uma securityEncryptionType propriedade.
  • Propriedade adicionada securityProfile a ManagedDisk.
  • Adicionado confidentialVM como um novo valor para SecurityTypes o enum.

• Adicionado suporte para referência de imagens da Galeria Partilhada e da Galeria Comunitária:

  • Propriedades e sharedGalleryImageId adicionadas communityGalleryImageId a ImageReference.

• Adicionado suporte para montagem de binding de contentores para tarefas:

  • Adicionei ContainerHostBatchBindMountEntry modelo com source e isReadOnly propriedades.
  • Adicionou ContainerHostDataPath o enum com valores Shared, Startup, VfsMounts, Task, JobPrep, e Applications.
  • Propriedade adicionada containerHostBatchBindMounts a TaskContainerSettings.

• [Quebra] Remoção do suporte para pools de configuração de serviços na nuvem:

  • Modelo removido CloudServiceConfiguration .
  • Propriedade removida cloudServiceConfiguration do DeploymentConfiguration.
  • Operação removida Location_ListSupportedCloudServiceSkus .

Versão: 2024-02-02-01

• Acrescentou suporte a políticas de atualização do sistema operativo para pools de VM:

  • Acrescentou UpgradePolicy modelo com propriedades mode, automaticOSUpgradePolicy, e rollingUpgradePolicy.
  • Modelo adicionado AutomaticOSUpgradePolicy com propriedades disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, e osRollingUpgradeDeferral.
  • Acrescentou RollingUpgradePolicy modelo com propriedades enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, e rollbackFailedInstancesOnPolicyBreach.
  • Adicionei upgradePolicy propriedade à piscina.
  • Adicionou UpgradeMode o enum com os valores automatic, manual, e rolling.

• Propriedade adicionada batchSupportEndOfLife a SupportedSku.

Versão: 2023-11-01

• Adicionado suporte para Trusted Launch/perfil de segurança para pools de VM:

  • Acrescentou SecurityProfile modelo com propriedades encryptionAtHost, securityType, e uefiSettings.
  • Modelo adicionado UefiSettings com propriedades secureBootEnabled e vTpmEnabled.
  • Adicionei SecurityTypes enum com valores trustedLaunch.
  • Propriedade adicionada securityProfile a VirtualMachineConfiguration.

• Reforço do suporte para referências de artefactos de serviço para conjuntos de escala:

  • Modelo adicionado ServiceArtifactReference com uma propriedade obrigatória id .
  • Propriedade adicionada serviceArtifactReference a VirtualMachineConfiguration.

• Configuração melhorada do disco do sistema operativo:

  • Modelo adicionado ManagedDisk com uma storageAccountType propriedade.
  • Adicionou caching, diskSizeGB, managedDisk, e writeAcceleratorEnabled propriedades a OSDisk.

• Adicionado StandardSSD_LRS como um novo valor para StorageAccountType.

• Foi adicionada resourceTags propriedade ao Pool para permitir que etiquetas definidas pelo utilizador sejam propagadas para os recursos de suporte do Azure. Aplicável apenas quando poolAllocationMode é UserSubscription.

Versão: 2023-05-01

• Adicionei propriedade enableAcceleratedNetworking booleana a NetworkConfiguration.

  • Esta propriedade determina se este pool deve permitir rede acelerada, com o valor padrão como falso.
  • Se esta funcionalidade pode ser ativada também está relacionada com o suporte de uma instância do sistema operativo/VM, o que deve estar alinhado com a Política de Rede Acelerada.

• Adicionei propriedade enableAutomaticUpgrade booleana a VMExtension.

  • Esta propriedade determina se a extensão deve ser automaticamente atualizada caso exista uma versão mais recente da extensão disponível.

• A propriedade type de ContainerConfiguration agora suporta dois valores: DockerCompatible e CriCompatible.

Versão: 2022-10-01

• Adicionou NodeCommunicationMode enum com valores Default, Classic, e Simplified para determinar como um pool comunica com o serviço Batch.
• Adicionei currentNodeCommunicationMode uma propriedade ao Pool para se referir ao estado atual do modo de comunicação do pool.
• Adicionada targetNodeCommunicationMode propriedade ao Pool para se referir ao modo de comunicação do nó desejado para o pool.

Versão: 2022-06-01

• Adicionada PrivateEndpointConnection_Delete a operação para eliminar uma ligação privada ao endpoint.
• Adicionei allowedAuthenticationModes propriedade a BatchAccountCreateProperties e BatchAccountUpdateProperties para controlar modos de autenticação.
• Adicionado TaskAuthenticationToken como um novo valor para AuthenticationMode o enum.

Versão: 2022-01-01

• A operação foi adicionada Location_ListSupportedVirtualMachineSkus para listar os SKUs de VM suportados numa determinada localização.
• Acrescentou SupportedSku modelo com propriedades name, familyName, e capabilities.
• Modelo adicionado SupportedSkusResult .
• Modelo adicionado SkuCapability .

Versão: 2021-06-01

• Adicionou a capacidade de atribuir identidades geridas atribuídas pelos utilizadores a BatchPoolIdentity.
• Propriedade adicionada identityReference a AzureBlobFileSystemConfiguration, ContainerRegistry, e ResourceFile para suportar o acesso a recursos através de identidade gerida.
• Suporte adicionado para Extensão de VM:
  • Propriedade adicionada extensions a VirtualMachineConfiguration.
  • Modelo adicionado VMExtension .
• Adicionada a capacidade de especificar zonas de disponibilidade usando uma nova propriedade nodePlacementConfiguration em VirtualMachineConfiguration.
  • Modelo adicionado NodePlacementConfiguration com uma policy propriedade.
  • Adicionei NodePlacementPolicyType enum com valores Regional e Zonal.
• Adicionada osDisk propriedade a VirtualMachineConfiguration com suporte a disco de sistema operativo efémero via DiffDiskSettings.

Versão: 2021-01-01

• Capacidade adicional de encriptar dados de clientes com chaves geridas pelo cliente:
  • Modelo adicionado EncryptionProperties com keySource e keyVaultProperties.
  • Adicionei KeySource enum.
  • Modelo adicionado KeyVaultProperties .
  • Acrescentou encryption propriedade a BatchAccountCreateProperties e BatchAccountProperties.
• Adicionei BatchAccountIdentity modelos que suportam SystemAssigned, UserAssigned, e None tipos de identidade.
• Acrescentou identity propriedade a BatchAccountCreateParameters e BatchAccountUpdateParameters.
• Propriedade adicionada allowedAuthenticationModes a BatchAccountProperties.
• Foi adicionada ListOutboundNetworkDependenciesEndpoints uma operação para listar os pontos finais que um nó de computação Batch pode chamar.

Versão: 2020-09-01

• Propriedade adicionada taskSlotsPerNode ao Pool, substituindo o comportamento fixo de tarefa por nó.
• Adicionado BatchAccountProperties.publicNetworkAccess para controlar o acesso à rede pública.
• Modelo adicionado NetworkProfile para controlar regras de acesso à rede por endpoint.

Versão: 2020-05-01

• Suporte adicionado para Links Privados:

  • Operação adicionada PrivateEndpointConnection_ListByBatchAccount .
  • Operação adicionada PrivateEndpointConnection_Get .
  • Operação adicionada PrivateEndpointConnection_Update .
  • Operação adicionada PrivateLinkResource_ListByBatchAccount .
  • Operação adicionada PrivateLinkResource_Get .
  • Adicionei PrivateEndpointConnection, PrivateEndpoint, PrivateLinkResource, e PrivateLinkServiceConnectionState modelos.

• Propriedade adicionada publicNetworkAccess a BatchAccountCreateProperties.

Versão: 2020-03-01

• Acrescentou a capacidade de encriptar discos de nó usando a DiskEncryptionConfiguration propriedade de VirtualMachineConfiguration.
• Adicionei PublicIPAddressConfiguration um modelo para NetworkConfiguration suportar pools sem IPs públicos.
  • Adicionou IPAddressProvisioningType o enum com os valores BatchManaged, UserManaged, e NoPublicIPAddresses.
  • Propriedade adicionada ipAddressIds a PublicIPAddressConfiguration.

Versão: 2019-08-01

• Foi adicionada a possibilidade de especificar uma coleção de IPs públicos através NetworkConfiguration da publicIPs propriedade.
• Capacidade adicional de montar sistemas de ficheiros remotos em cada nó de um pool através MountConfigurationde:
  • Adicionei AzureBlobFileSystemConfiguration, NFSMountConfiguration, CIFSMountConfiguration, e AzureFileShareConfiguration modelos.
  • Adicionei mountConfiguration propriedade à piscina.

Versão: 2019-04-01

• Foi adicionada Location_CheckNameAvailability uma operação para verificar se existe um nome de conta de lote disponível.
• Adicionados CheckNameAvailabilityParameters e CheckNameAvailabilityResult modelos.
• Suporte adicional DetectorResponse :
  • Operação adicionada BatchAccount_ListDetectors .
  • Operação adicionada BatchAccount_GetDetector .

Versão: 2018-12-01

• Adicionei containerConfiguration propriedade a VirtualMachineConfiguration para pools com contentores habilitados.
  • Modelo adicionado ContainerConfiguration .
  • Modelo adicionado ContainerRegistry .
  • Modelo adicionado TaskContainerSettings .
• Adicionei startTask propriedade ao Pool com suporte total StartTask de modelos.
• Adicionei dataDisks propriedade para VirtualMachineConfiguration anexar discos de dados.
• Adicionei licenseType propriedade ao VirtualMachineConfiguration Azure Hybrid Use Benefit.
• Adicionei AutoStorageAuthenticationMode enum com valores StorageKeys e BatchAccountManagedIdentity.
• Propriedade adicionada nodeIdentityReference a AutoStorageBaseProperties.
• Adicionei NetworkConfiguration modelo com subnetId, endpointConfiguration, e dynamicVnetAssignmentScope propriedades.
• Adicionados PoolEndpointConfiguration e InboundNatPool modelos para especificar endpoints de entrada.

Versão: 2017-09-01

• Suporte adicionado para gestão de pools via ARM:
  • Adicionado Pool_ListByBatchAccount, Pool_Get, Pool_Create, Pool_Update, operações Pool_Delete .
  • Adicionado Pool_DisableAutoScale e Pool_StopResize operações.
  • Modelo de recursos adicionado Pool com propriedades abrangentes de piscina.
• Gestão de certificados adicionada via ARM:
  • Adicionados Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, , operações Certificate_CancelDeletion .
• Gestão adicionada de aplicações e pacotes de aplicação:
  • Adicionado Application_List, Application_Get, Application_Create, Application_Update, operações Application_Delete .
  • Adicionado ApplicationPackage_List, ApplicationPackage_Get, ApplicationPackage_Create, ApplicationPackage_Delete, operações ApplicationPackage_Activate .
• Modelo adicionado VirtualMachineConfiguration para a configuração de pools baseadas em VMs IaaS.
• Adicionei ScaleSettings um modelo com FixedScaleSettings e AutoScaleSettings para controlar o tamanho da piscina.

Versão: 2017-05-01

• Modelo adicionado KeyVaultReference para integração Azure Key Vault com contas em lote.
• Adicionei poolAllocationMode propriedade aos BatchAccountCreateProperties modos with BatchService e UserSubscription .
• Propriedades e dedicatedCoreQuotaPerVMFamily adicionadas dedicatedCoreQuotaPerVMFamilyEnforced a BatchAccountProperties.
• Propriedade adicionada lowPriorityCoreQuota a BatchAccountProperties.

Versão: 2017-01-01

• Foi adicionado suporte para contas de armazenamento atribuídas pelos utilizadores através da configuração de armazenamento automático.
• Propriedade adicionada storageAccountId a AutoStorageBaseProperties.
• Modelo adicionado AutoStorageProperties com lastKeySync propriedade.
• Operação adicionada BatchAccount_SynchronizeAutoStorageKeys .

Versão: 2015-12-01

Esta é a versão inicial da API REST de Gestão de Lotes. Fornece as seguintes capacidades essenciais:

• Gestão de Contas em Lote:
  • BatchAccount_Create - Cria uma nova conta Batch com parâmetros especificados.
  • BatchAccount_Update - Atualiza as propriedades de uma conta Batch existente.
  • BatchAccount_Delete - Elimina a conta de lote especificada.
  • BatchAccount_Get - Obtém informações sobre a conta de lote especificada.
  • BatchAccount_List - Lista todas as contas Batch sob subscrição.
  • BatchAccount_ListByResourceGroup - Lista todas as contas Batch sob um grupo de recursos.
  • BatchAccount_GetKeys - Obtém as chaves de conta para a conta Batch especificada.
  • BatchAccount_RegenerateKey - Regenera a chave de conta especificada para a conta Batch.
• Operações de Localização:
  • Location_GetQuotas - Recebe as quotas de serviço por lote para a subscrição especificada na localização indicada.
• Operações:
  • Operations_List - Lista as operações disponíveis para o fornecedor de lote.