Partilhar via

Versionamento da API REST do Serviço Batch

As operações fornecidas pela API REST do serviço Batch 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 Group.Major.Minor, onde Group está no formato YYYY-MM-DD e Major é um inteiro e Minor é um inteiro.

Última versão: 2025-06-01

Versões Anteriores

Versões anteriores incluem:

Versão: 2024-07-01.20.0

  • Adicionaram operações de deslocação de nós de computação e início:
    • Adicionada uma nova ComputeNode_Deallocate operação (POST /pools/{poolId}/nodes/{nodeId}/deallocate) para desalocar um nó de computação inativo ou em funcionamento.
    • Adicionada uma nova ComputeNode_Start operação (POST /pools/{poolId}/nodes/{nodeId}/start) para reiniciar um nó de computação previamente desalocado.
    • Adicionei um novo NodeDeallocateParameter modelo com uma nodeDeallocateOption propriedade que especifica o que fazer com as tarefas de execução durante a dealalocação.
  • [Quebra] Operação removida ComputeNode_GetRemoteDesktop (GET /pools/{poolId}/nodes/{nodeId}/rdp). Esta operação era aplicável apenas a pools de configuração de Serviços na Nuvem.
  • [Quebra] Remoção do suporte para pools de configuração de serviços na nuvem:
    • Modelo removido CloudServiceConfiguration .
    • Removeram cloudServiceConfiguration propriedades de CloudPool, PoolAddParameter, e PoolSpecification.
  • [Quebra] Removeram applicationLicenses propriedades de CloudPool, PoolAddParameter, e PoolSpecification.
  • Adicionado suporte para montagem de binding de contentores para tarefas:
    • Adicionei um novo ContainerHostBatchBindMountEntry modelo com source propriedades e isReadOnly proprietários.
    • Adicionou novo ContainerHostDataPath enum com os valores Shared, Startup, VfsMounts, Task, JobPrep, e Applications.
    • Adicionada nova containerHostBatchBindMounts propriedade ao TaskContainerSettings.
  • Suporte a VM Confidencial adicionado:
    • Adicionei um novo VMDiskSecurityProfile modelo com uma securityEncryptionType propriedade.
    • Adicionada nova securityProfile propriedade ao ManagedDisk.
    • Adicionado confidentialVM como um novo valor para SecurityProfile.securityType.
  • Adicionados deallocated e deallocating como novos valores para ComputeNodeState.
  • Adicionaram novos requisitos deallocated e deallocating propriedades a NodeCounts.
  • Adicionado suporte para referência de imagens da Galeria Partilhada e da Galeria Comunitária:
    • Propriedades e communityGalleryImageId adicionadas sharedGalleryImageId a ImageReference.
  • Foi adicionada skipWithdrawFromVNet uma propriedade para JobNetworkConfiguration controlar se os nós permanecem ligados ao VNet após o fim de um trabalho.
  • Propriedade adicionada networkConfiguration a JobPatchParameter.
  • Capacidades estendidas de patching de pool: Adicionadas displayName, vmSize, taskSlotsPerNode, taskSchedulingPolicy, virtualMachineConfigurationenableInterNodeCommunication, networkConfiguration, , userAccounts, mountConfiguration, , upgradePolicy, e resourceTags propriedades a PoolPatchParameter. Propriedades que afetam a topologia do pool só podem ser atualizadas quando o pool está vazio.
  • Adicionei force parâmetro de consulta booleano a Job_Delete, Job_Terminate, JobSchedule_Delete, e JobSchedule_Terminate operações para forçar a operação.

Versão: 2024-02-01.19.0

  • Acrescentou suporte a políticas de atualização do sistema operativo para pools de VM:
    • Adicionou um novo UpgradePolicy modelo com propriedades mode, automaticOSUpgradePolicy, e rollingUpgradePolicy. A mode propriedade (UpgradeMode) aceita valores automatic, manual, e rolling.
    • Adicionou um novo AutomaticOSUpgradePolicy modelo com propriedades disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, e osRollingUpgradeDeferral.
    • Adicionado novo RollingUpgradePolicy modelo com propriedades enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, e rollbackFailedInstancesOnPolicyBreach.
    • Adicionou nova upgradePolicy propriedade a CloudPool, PoolAddParameter, e PoolSpecification.
  • Adicionado upgradingos como um novo valor para ComputeNodeState.
  • Adicionei uma nova propriedade obrigatória upgradingOS para NodeCounts reportar a contagem de nós no upgradingos estado.

Versão: 2023-11-01.18.0

  • Adicionado suporte para Trusted Launch/perfil de segurança para pools de VM:
    • Adicionou um novo SecurityProfile modelo com propriedades encryptionAtHost, securityType, e uefiSettings.
    • Adicionei um novo UefiSettings modelo com propriedades secureBootEnabled e vTpmEnabled.
    • Adicionada nova securityProfile propriedade ao VirtualMachineConfiguration.
  • Reforço do suporte para referências de artefactos de serviço para conjuntos de escala:
    • Adicionado novo ServiceArtifactReference modelo com uma propriedade obrigatória id (ID de recurso ARM).
    • Foi adicionada uma nova serviceArtifactReference propriedade para VirtualMachineConfiguration definir a mesma versão da imagem para todas as VMs num conjunto de escala ao usar a latest versão da imagem.
  • Configuração melhorada do disco do sistema operativo:
    • Adicionei um novo ManagedDisk modelo com uma storageAccountType propriedade.
    • Adicionaram novas propriedades a OSDisk: caching, diskSizeGB, managedDisk, e writeAcceleratorEnabled.
  • Adicionou StandardSSDLRS (standardssd_lrs) como novo valor para StorageAccountType.
  • Adicionou nova propriedade resourceTags a CloudPool, PoolAddParameter e PoolSpecification para permitir que etiquetas definidas pelo utilizador sejam propagadas para recursos de suporte Azure. Aplicável apenas quando poolAllocationMode é UserSubscription.
  • Adicionada nova scaleSetVmResourceId propriedade para VirtualMachineInfo expor o ID de recurso da VM atual do Conjunto de Escala da Máquina Virtual do nó de computação. Só definido quando a Conta poolAllocationMode Batch é UserSubscription.

Versão: 2023-05-01.17.0

  • [Quebra] Remoção da API de Estatísticas Vitalícias de Trabalho/Pool em Batch: lifetimejobstats e lifetimepoolstats.
  • Adicionei propriedade enableAcceleratedNetworking booleana a NetworkConfiguration.
    • Esta propriedade determina se este pool deve permitir rede acelerada, com o valor padrão como False.
    • 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, que agora suporta dois valores: DockerCompatible e CriCompatible.

Versão: 2022-10-01.16.0

  • Adicionada nova NodeCommunicationMode propriedade que determina como um pool comunica com o serviço Batch
  • Foi adicionada uma nova currentNodeCommunicationMode propriedade do NodeCommunicationMode tipo ao CloudPool modelo para se referir ao estado atual do modo de comunicação do pool.
  • Foi adicionada uma nova targetNodeCommunicationMode propriedade do NodeCommunicationMode tipo aos seguintes modelos para se referir ao modo de comunicação de nós desejado para o pool:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Versão: 2022-01-01.15.0

  • Foi adicionada uma nova uploadHeaders propriedade ao OutputFileBlobContainerDestination modelo para permitir aos utilizadores definir cabeçalhos HTTP personalizados nos carregamentos de ficheiros de recursos.
  • Adicionou nova allowTaskPreemption propriedade aos seguintes modelos para suportar a preempção de tarefas para tarefas de maior prioridade (requer Comms-Enabled ou Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Versão: 2021-06-01.14.0

  • Adicionar a capacidade de atribuir identidades geridas atribuídas pelo utilizador a CloudPool. Estas identidades são disponibilizadas em cada nó do pool e podem ser usadas para aceder a vários recursos.
  • Adicionou identityReference propriedade aos seguintes modelos para suportar o acesso a recursos através de identidade gerida:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Adicionada nova extensions propriedade ao VirtualMachineConfiguration CloudPool para especificar extensões de máquinas virtuais para nós
  • Adicionada a capacidade de especificar zonas de disponibilidade usando uma nova propriedade nodePlacementConfiguration no VirtualMachineConfiguration
  • Adicionada nova osDisk propriedade ao VirtualMachineConfiguration, que contém definições para o disco do sistema operativo da Máquina Virtual.
    • A placement propriedade em DiffDiskSettings especifica a colocação efémera dos discos do sistema operativo para todas as VMs do pool. Definir para "CacheDisk" para armazenar o disco efémero do sistema operativo na cache da VM.
  • Adicionei maxParallelTasks uma propriedade CloudJob para controlar o número máximo de tarefas que podem ser executadas ao mesmo tempo por tarefa (por defeito, -1 significa ilimitada). Esta propriedade encontra-se atualmente em pré-visualização privada.
  • Foi adicionada virtualMachineInfo uma propriedade ComputeNode que contém informações sobre o estado atual da máquina virtual, incluindo a versão exata da imagem do marketplace que a VM está a usar.
  • Adicionou recurrenceInterval propriedade a Schedule para controlar o intervalo entre os horários de início de dois trabalhos sucessivos sob um calendário de tarefas.

Versão: 2020-09-01.12.0

  • [Quebra] Substituí a propriedade maxTasksPerNode por taskSlotsPerNode 'on the pool'. Usando esta propriedade, tarefas num trabalho podem consumir um número dinâmico de slots, permitindo um controlo mais detalhado sobre o consumo de recursos.
  • [Quebra] Alterou-se o tipo de resposta de GetTaskCounts para return TaskCountsResult, que é um objeto complexo contendo o objeto anterior TaskCounts e um novo TaskSlotCounts objeto que fornece informação semelhante no contexto dos slots usados.
  • Foi adicionada uma propriedade requiredSlots à tarefa que permite ao utilizador especificar quantos espaços num nó deve ocupar.

Versão: 2020-03-01.11.0

  • Foi adicionada a capacidade de encriptar unidades de disco ComputeNode usando a nova DiskEncryptionConfiguration propriedade de VirtualMachineConfiguration.
  • [Quebra] A propriedade virtualMachineImageId de ImageReference agora só pode referir-se a uma imagem Shared Image Gallery.
  • [Quebra] A password propriedade do corpo de Add Certificate operação do pedido é opcional para certificados formatados PFX.
  • [Quebra] Pools podem agora ser provisionados sem um IP público usando a nova PublicIPAddressConfiguration propriedade de NetworkConfiguration.
  • [Quebra] A publicIPs propriedade de NetworkConfiguration também mudou o nome e ipAddressIds mudou-se para PublicIPAddressConfiguration ela. Esta propriedade só pode ser especificada se provision a propriedade for usermanaged.

Versão: 2019-08-01.10.0

  • Adicionada a capacidade de especificar uma coleção de IPs públicos através NetworkConfiguration da nova publicIPs propriedade no pool. Isto garante que os nós do pool tenham um IP da lista de IPs fornecidos pelo utilizador.
  • Foi adicionada a capacidade de montar sistemas de ficheiros remotos em cada nó de um pool através da MountConfiguration propriedade.
  • Shared Image Gallery imagens podem agora ser especificadas na propriedade virtualMachineImageId de ImageReference referenciando a imagem através do seu ID de Azure Resource Manager.
  • [Quebra] Quando não especificado, o valor padrão para waitForSuccess em StartTask é true (anteriormente, era false).
  • [Quebra] Quando não especificado, o valor padrão para scope em AutoUserSpecification é agora sempre Pool (anteriormente, era Task em Windows nós e Pool nos nós Linux).
  • Melhorou vários documentos confusos ou incompletos.

Versão: 2019-06-01.9.0

  • [Quebra] Substituído ListNodeAgentSKUs por ListSupportedImages. ListSupportedImages contém toda a informação originalmente disponível mas ListNodeAgentSKUs num formato mais claro. Novas imagens, não verificadas, também são agora devolvidas. Informações adicionais sobre Capabilities e BatchSupportEndOfLife estão acessíveis através de ImageInformation.

  • Agora suporta regras de segurança de rede que bloqueiam o acesso da rede a CloudPool com base na porta de origem do tráfego. Esta regra é feita através da SourcePortRanges propriedade em NetworkSecurityGroupRule.

  • Ao executar um contêiner, o Batch agora suporta a execução da tarefa no diretório de trabalho do contêiner ou no diretório de trabalho da tarefa Batch. Isso é controlado pela WorkingDirectory propriedade em TaskContainerSettings.

  • Melhorou vários documentos confusos ou incompletos.

Versão: 2018-12-01.8.0

  • [Quebra] Removi o suporte para upgradeos em cloudServiceConfiguration pools.

    • Removido upgradeos.
    • Renomeado targetOSVersion para osVersion e removido currentOSVersion em CloudPool.
    • Removido upgrading de PoolState.

  • [Quebra] Removido dataEgressGiB e dataIngressGiB de poolusagemetrics. Estas propriedades já não são suportadas.

  • [Quebra]ResourceFile Melhorias

    • Adicionei a capacidade de especificar um contentor Azure Storage inteiro no ResourceFile. Existem agora três modos suportados para o ResourceFile:
      • httpUrl cria um ResourceFile apontamento para uma única URL HTTP.
      • storageContainerUrl cria um ResourceFile apontando para um contentor Azure Blob Storage.
      • autoStorageContainerName cria um ResourceFile apontando para um contentor de Azure Blob Storage na conta de autoarmazenamento registada em lote.
    • As URLs fornecidas ResourceFile através do httpUrl método podem agora ser qualquer URL HTTP. Anteriormente, estes URLs tinham de ser um URL do Azure Blob Storage.
    • blobPrefix pode ser usado para filtrar downloads de um contentor de armazenamento apenas para aqueles que correspondem ao prefixo.

  • [Quebra] Propriedade removida osDisk de VirtualMachineConfiguration. Esta propriedade já não é suportada.

  • Pools que definem o dynamicVNetAssignmentScope em NetworkConfiguration como job podem agora atribuir dinamicamente um Virtual Network a cada nó ao jobs tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Observação

    Esta funcionalidade está em pré-visualização pública. Está desativado para todas as contas de lote, exceto para aquelas que nos contactaram e pediram para participar no piloto.

  • A vida útil máxima de uma tarefa é agora de 180 dias (antes eram 7).

  • Foi adicionado suporte em Windows pools para criar utilizadores com um modo de login específico (seja batch ou interactive) via LoginMode.

  • O tempo padrão de retenção de tarefas para todas as tarefas é agora de sete dias, antes era infinito.

Versão 2018-08-01.7.0

As novas funcionalidades na versão 2018-08-01.7.0 incluem:

  • Veja a versão do Azure Batch Node Agent, através da nova propriedade NodeAgentInfo no ComputeNode.
  • Adicionei a capacidade de especificar um Filter no Result de uma tarefa. Veja aqui para mais detalhes.
    • Isto permite o cenário frequentemente solicitado de realizar uma consulta do lado do servidor para encontrar todas as tarefas que falharam.
  • [Quebra] Removi a ValidationStatus propriedade do TaskCounts.
  • [Quebra] O tipo de cache predefinido para DataDisk e OSDisk é agora ReadWrite em vez de None.
  • [Quebra] Renomeado o único valor de ContainerType de docker para dockerCompatible.

Versão 2018-03-01.6.1

As novas funcionalidades na versão 2018-03-01.6.1 incluem:

  • Contagens de nós do pool por estado: Esta versão adiciona a capacidade de consultar contagens de nós do pool por estado, através da nova operação ListPoolNodeCounts. Esta operação dá-lhe a capacidade de consultar todos os pools numa conta Batch para os estados dos nós.
  • Registos de agentes de nó: Esta versão adiciona a capacidade de carregar registos de agentes de nó do Azure Batch a partir de um determinado nó, através da operação UploadBatchServiceLogs. Este registo destina-se a ser utilizado na depuração pelo Microsoft Support caso ocorram problemas num nó.

Versão 2017-09-01.6.0

  • Benefício do Azure Hybrid Use: Agora pode criar pools de VMs Windows em lote especificando que a licença Azure Hybrid Use Benefit deve ser utilizada. Quando esta licença é utilizada, é aplicado um desconto ao preço da VM. Use a nova propriedade LicenseType no VirtualMachineConfiguration.

  • Pool de discos de dados VM: Pode ligar um ou mais discos de dados vazios a pools de VM usando a nova configuração de disco de dados que faz parte da configuração da máquina virtual. Use a propriedade DataDisks no VirtualMachineConfiguration.

  • (Mudança de última hora) Imagens personalizadas são agora criadas e implementadas usando recursos de imagem do Azure Resource Manager em vez de ficheiros blob VHD. O Batch agora utiliza discos geridos para criar as VMs do pool e, por isso, utiliza um recurso de Imagem . Agora não há limite para o número de VMs num pool criado usando uma imagem personalizada; além disso, já não são necessárias múltiplas cópias do blob VHD para grandes pools. Por isso, pools de imagens personalizados são muito mais fáceis de criar e escalar. Para mais informações, veja Usar uma imagem personalizada para criar um conjunto de máquinas virtuais.

    • A nova propriedade VirtualMachineImageId no ImageReference contém a referência à Image, e o OSDisk.ImageUris já não existe.

    • Devido a esta alteração, o ImageReference passou a ser uma propriedade obrigatória do VirtualMachineConfiguration.

  • (Troca de moedas) As tarefas de múltiplas instâncias (criadas usando MultiInstanceSettings) devem agora especificar CoordinationCommandLine, e o NumberOfInstances passa a ser opcional e por defeito é 1.

  • Adicionou suporte para tarefas executadas usando containers Docker. Para executar uma tarefa usando um contentor Docker, deve especificar um ContainerConfiguration no VirtualMachineConfiguration para um pool, e depois adicionar TaskContainerSettings à Task.

Versão 2017-06-01.5.1

A versão da API Batch descrita aqui é 2017-06-01.5.1. Recomenda-se usar a versão mais recente sempre que possível.

As novas funcionalidades na versão 2017-06-01.5.1 incluem:

  • Suporte para contagens de tarefas eficientes através da nova operação Get Task Counts. Ao chamar a operação Get Task Counts, pode obter uma contagem das tarefas ativas, em execução e concluídas, bem como das tarefas que tiveram sucesso ou falharam. Para mais informações, consulte Contar tarefas para um trabalho por estado (Pré-visualização).
  • Suporte para especificar endpoints de entrada em nós de computação de pool, através da nova propriedade poolEndpointConfiguration . Ao definir esta propriedade, pode endereçar portas específicas no nó externamente.

Versão 2017-05-01.5.0

As secções seguintes descrevem funcionalidades novas e alteradas na versão 2017-05-01.5.0.

Importante

A versão 2017-05-01.5.0 inclui várias alterações urgentes. Revise as alterações urgentes e atualize o seu código para ligar à versão 2017-05-01.5.0.

Nós de computação de baixa prioridade

O Azure Batch agora oferece nós de computação de baixa prioridade para reduzir o custo das cargas de trabalho Batch. VMs de baixa prioridade tornam possíveis novos tipos de cargas de trabalho Batch ao fornecer uma grande quantidade de poder de computação que também é económica.

Existem várias alterações na API REST para nós de baixa prioridade:

  • (Troca de moedas) As propriedades targetDedicated e currentDedicated de um pool ou especificação de pool foram renomeadas para targetDedicatedNodes e currentComputeNodes.
  • (Troca de moedas) A propriedade resizeError de um pool é agora uma coleção chamada resizeErrors.
  • Os nós de computação têm uma nova propriedade isDedicated . Esta propriedade é verdadeira para nós dedicados e falsa para nós de baixa prioridade.
  • Uma tarefa do Gestor de Tarefas tem uma nova propriedade allowLowPriorityNode . Se esta propriedade for verdadeira, a tarefa Gestor de Trabalhos pode correr num nó de baixa prioridade. Se for falso, então a tarefa do Gestor de Jobs corre num nó de computação dedicado.

Utilizadores nomeados no Linux

O Azure Batch oferece agora suporte extra para criar utilizadores nomeados em nós Linux.

  • A nova propriedade linuxUserConfiguration suporta especificar um uid (ID de utilizador) e gid (ID de grupo) ao criar um utilizador Linux.
  • (Troca de moedas) A propriedade sshPrivateKey foi transferida da propriedade userAccount para a nova propriedade linuxUserConfiguration . A propriedade linuxUserConfiguration é, ela própria, uma propriedade da propriedade UserAccount .

Para mais informações sobre contas de utilizador nomeadas, consulte Executar tarefas em contas de utilizador em Batch.

Ficheiros de saída para dados de tarefas

Agora pode especificar ficheiros de saída para carregar os dados da tarefa após a conclusão da tarefa.

  • A nova propriedade outputFiles suporta especificar ficheiros de tarefas a carregar para Azure Storage.
  • A nova propriedade fileUploadError da propriedade exitConditions suporta especificar ações a tomar com base no estado de carregamento de um ficheiro de saída.

Reporte de erros de tarefa

Foram feitas várias alterações para melhorar o relato de erros de tarefa.

  • A nova propriedade de resultado da propriedade executionInfo indica se uma tarefa teve sucesso ou falhou.
  • (Troca de moedas) A propriedade schedulingError da propriedade executionInfo foi renomeada failureInfo. A propriedade failureInfo é devolvida sempre que há uma falha na tarefa. Isto inclui todos os casos anteriores de erro de agendamento, todos os casos em que um código de saída de tarefa não nulo é retornado e quaisquer falhas de carregamento de ficheiros.
  • (Troca de moedas) A propriedade schedulingError da propriedade exitConditions foi renomeada para preProcessingError para esclarecer quando o erro ocorreu no ciclo de vida da tarefa.
  • (Troca de moedas) A propriedade schedulingErrorCateogry foi renomeada para errorCategory.

Licenças de aplicação

Agora pode solicitar que as licenças de aplicação sejam disponibilizadas para o seu pool, através da nova propriedade applicationLicenses numa pool ou especificação de pool.

Versão 2017-01-01.4.0

Esta versão estende todo o suporte da versão anterior, 2016-07-01.3.1. Além disso, suporta as seguintes capacidades:

  • Execute uma tarefa sob uma identidade de utilizador especificada.

    Agora pode executar uma tarefa ou coleção de tarefas sob uma das seguintes identidades de utilizador, especificadas através da nova propriedade userIdentity no recurso da tarefa:

    • Uma conta de utilizador com um nome que você define.

    • Uma conta de utilizador criada automaticamente (um utilizador automático). Um utilizador automático pode ser executado como utilizador administrativo ou como utilizador não administrativo. Por defeito, um utilizador automático executa como um utilizador não administrativo.

      Importante

      A propriedade userIdentity , com a sua propriedade elevationLevel , substitui a propriedade runElevated em pedidos que adicionam uma tarefa ou coleção de tarefas, e em respostas que obtêm informação sobre uma tarefa ou que listam tarefas.

      Se fizer um pedido que inclua a propriedade runElevated para a versão 2017-01-01.4.0 do serviço Batch, o pedido falha.

      Para executar como utilizador administrativo, atualize a sua aplicação para usar a propriedade userIdentity , definindo a propriedade elevationLevel para admin.

      Para executar como utilizador não-administrativo, atualize a sua aplicação para usar a propriedade userIdentity , definindo a propriedade elevationLevel para nonAdmin. Como esta definição é a padrão, também pode omitir a definição.

  • Defina contas de utilizador em todos os nós de um pool.

    Agora pode executar uma tarefa ou coleção de tarefas numa conta de utilizador que defina no recurso do pool. Defina uma conta de utilizador através da nova propriedade Contas de Utilizador nos pedidos para Adicionar Pool. Quando defines a conta, podes especificar o nome da conta, palavra-passe, nível de elevação (administrador ou não-administrador) e chave privada SSH (para pools Linux).

    Depois de definir a conta de utilizador, pode especificar essa conta de utilizador para a propriedade de Identidade de utilizador em pedidos que adicionam uma tarefa ou uma coleção de tarefas.

  • Forneça uma tarefa com um token para autenticar no serviço Batch quando a tarefa for executada.

    O serviço Batch pode agora fornecer um token de autenticação a uma tarefa quando esta é executada. O token de autenticação permite que uma tarefa emita pedidos relacionados com o trabalho para o serviço Batch, sem as chaves da conta Batch. O token é fornecido através da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN.

    Atualmente, os tokens de autenticação são suportados apenas para chamadas de operações no recurso do trabalho. O token de autenticação concede acesso a todas as operações no trabalho que contém a tarefa.

    Para que o serviço Batch forneça o token de autenticação, especifique a nova propriedade authenticationTokenSettings , juntamente com a sua propriedade de acesso , em pedidos para Adicionar Tarefa ou Adicionar Coleção de Tarefas.

  • Especifique uma ação a realizar nas dependências de uma tarefa caso a tarefa falhe.

    Agora pode especificar que as tarefas dependentes prosseguem mesmo que a tarefa de que dependem falhe. Defina a nova propriedade dependencyAction de um recurso de tarefa para satisfazer a execução de tarefas dependentes mesmo que a tarefa pai falhe. Alternativamente, defina dependencyAction para bloquear para evitar a execução de tarefas dependentes caso a tarefa principal falhe.

    Especifique a propriedade dependencyAction nos pedidos para Adicionar Tarefa ou Adicionar Coleção de Tarefas.

    Para mais informações sobre o uso de ações de dependência, veja Ações de dependência.

  • Use imagens de disco personalizadas do sistema operativo ao criar um pool.

    Agora pode usar imagens de disco personalizadas do sistema operativo para criar um pool.

    Para tal, deve especificar, ao criar a sua conta Batch, que os pools devem ser provisionados na subscrição do utilizador, em vez de numa subscrição gerida pelo serviço Batch. Numa chamada para Criar Conta, defina a propriedade poolAllocationMode para UserSubscription. Depois, use a propriedade osDisk para especificar uma referência a uma imagem de disco num pedido para Add Pool.

    Importante

    Quando cria a sua conta Batch, se especificar que os pools devem ser provisionados na subscrição do utilizador, então deve usar autenticação baseada no Azure Active Directory para todos os pedidos feitos através dessa conta.

  • Use autenticação baseada em Azure Active Directory para pedidos ao serviço Batch.

    O Azure Active Directory (Azure AD) é agora suportado para autenticar chamadas ao serviço Batch.

    Se a sua conta em lote estiver configurada para provisionar pools na subscrição do utilizador, então é necessário usar autenticação no Azure AD.

Versão 2016-07-01.3.1

Esta versão estende todo o suporte da versão anterior, 2016-02-01.3.0. Além disso, suporta as seguintes capacidades:

  • Capacidade de criar um pool e um autopool com configuração de rede

    • Foi adicionada uma nova rede de propriedades. A configuração foi adicionada tanto aos recursos do pool como do autopool. Esta propriedade pode ser usada para especificar que os nós de computação do pools network configuration, such as the subnet in which the poolsão criados.

  • Terminar automaticamente um trabalho quando todas as tarefas estiverem concluídas.

    • Foi adicionada uma nova propriedade em AllTasksComplete ao recurso do trabalho. Pode especificar esta propriedade ao criar ou atualizar um trabalho.

  • Terminar ou desativar automaticamente um trabalho quando uma tarefa falhar.

    • Foi adicionada uma nova propriedade onTaskFailure ao recurso do trabalho, e uma nova propriedade exitConditions foi adicionada ao recurso da tarefa. A definição do job onTaskFailure indica se a falha da tarefa pode ter impacto ao nível do trabalho, e a propriedade exit Conditions da tarefa permite que as tarefas adaptem o impacto ao nível do trabalho à natureza da falha.

  • Associe pacotes de aplicações a tarefas e pools.

    • Uma nova propriedade applicationPackageReferences adicionada ao recurso da tarefa e às definições de tarefa do jobManager. Esta propriedade permite que os pacotes de aplicações sejam implementados a pedido, conforme as tarefas o exigem, em vez de exigir que sejam especificados no momento da criação do pool. Esta propriedade é particularmente valiosa para pools de longa duração que podem ser chamados a executar diferentes tipos de trabalhos ou diferentes versões de aplicação ao longo da sua vida útil.

  • Capacidade de reativar uma tarefa falhada.

    • Foi adicionada uma nova operação, Reativar uma tarefa, para redefinir o estado de uma tarefa falhada para ativo. Isto permite que as falhas sejam tentadas novamente, por exemplo, se a falha foi transitória ou se conseguir corrigir a causa da falha, sem recriar a tarefa.

Versão 2016-02-01.3.0

Esta versão estende todo o suporte da versão anterior, 2015-12-01.2.2. Além disso, suporta as seguintes capacidades:

  • Capacidade de criar um pool e um autopool com configuração de VM IaaS

    • As propriedades osFamilyexistentes , targetOSVersion e currentOSVersion são transferidas das propriedades de topo dos recursos Pool e Autopool e são transferidas para dentro de uma nova propriedade chamada cloudServiceConfiguration.

    • Uma nova propriedade virtualMachineConfiguration é adicionada tanto aos recursos do Pool como do Autopool. Esta propriedade pode ser especificada para configurar um pool/auto pool com VMs IaaS.

    • É adicionada uma nova API para obter informações sobre todos os SKUs de agentes de nó suportados pelo serviço Batch. Ver Lista de SKUs de agentes de nó suportados.

    • É adicionada uma nova API para obter definições remotas de login que podem ser usadas para iniciar sessão remotamente num nó de computação criado com configuração de VM IaaS. Veja Obter definições de login remoto para um nó.

    • É adicionada uma nova API para adicionar um conjunto de tarefas a um trabalho. Veja: Adicionar uma coleção de tarefas a uma tarefa.

    • Uma nova propriedade sshPublicKey opcional é adicionada ao recurso do Utilizador que pode ser usada para adicionar/atualizar utilizadores num nó de computação Linux.

    • Duas novas propriedades totalTasksSucceeded e runningTasksCount são adicionadas ao recurso Node. Estas propriedades podem ser obtidas através de obter informação sobre um nó ou Listar os nós de computação num pool.

    • Uma nova propriedade fileMode é adicionada ao ResourceFile tipo complexo. Esta propriedade é aplicada apenas aos nós de computação do Linux e ignorada nos nós de computação do Windows.

    • Uma nova propriedade fileMode é adicionada ao FileProperties tipo complexo. Esta propriedade é devolvida pelo serviço Batch para nós de computação Linux como parte das APIs GetFileProperties ou ListFileProperties. Além disso, a propriedade creationTime existente sob o FileProperties tipo complexo é alterada para uma propriedade opcional porque esta propriedade não será devolvida para nós de computação Linux.

    • O tipo de dados da propriedade visibility existente dentro do CertificateReference tipo complexo é modificado de uma cadeia com valores separados por vírgulas para um conjunto de cadeias. Além disso, um dos valores existentes para visibilidade foi renomeado de "rdp" para "remoteuser".

  • Os URLs das APIs seguintes são alterados para substituir "?" no nome da ação para "/":

    • Substituir as propriedades de uma piscina

    • Desativar a escalabilidade automática num pool

    • Ativar a escalabilidade automática num pool

    • Avaliar uma fórmula de escalonamento automático

    • Mude o tamanho de uma piscina

    • Pare de mudar o tamanho de uma piscina

    • Atualizar o sistema operativo dos nós de computação num pool

    • Remover nós de computação de um pool

    • Reiniciar um nó

    • Reimaginar um nó

    • Desativar o agendamento de tarefas num nó

    • Ativar o agendamento de tarefas num nó

    • Desativar um horário de trabalho

    • Ativar um horário de trabalho

    • Terminar um horário de trabalho

    • Desativar um trabalho

    • Permitir um emprego

    • Terminar um emprego

    • Terminar uma tarefa

    • Cancelar a eliminação de um certificado

Versão 2015-12-01.2.2

Esta versão estende todo o suporte da versão anterior, 2015-11-01.2.1. Além disso, suporta as seguintes capacidades:

  • As aplicações podem agora ser implementadas para calcular nós usando pacotes de aplicação em vez de como ficheiros de recurso.

    • São fornecidas novas APIs para que os clientes possam navegar pela lista de aplicações e versões disponíveis, por exemplo, para exibir um seletor numa interface de utilizador.

    • As APIs relacionadas com pools são alteradas para permitir que um pool especifique pacotes de aplicações a serem descarregados para todos os nós desse pool.

  • As tarefas podem agora depender de outras tarefas. Uma tarefa dependente só começa depois de todas as tarefas de que depende terem sido concluídas com sucesso.

Esta versão inclui as seguintes outras alterações:

  • O tempo limite padrão para a redimensionação da piscina mudou para 15 minutos.

Versão 2015-11-01.2.1

Esta versão estende todo o suporte da versão anterior, 2015-06-01.2.0. Além disso, suporta as seguintes capacidades:

  • Capacidade para adicionar e executar tarefas multi-instância (por exemplo, MPI)

    • Uma nova propriedade multiInstanceSettings opcional é adicionada ao recurso Tarefa, que pode ser opcionalmente incluída nas APIs Adicionar Tarefa, Obter Tarefa, Listar Tarefas.

    • Uma nova API Lista das subtarefas de uma tarefa é adicionada para obter informações sobre as subtarefas.

    • É adicionada recentTasks uma nova propriedade subtaskId opcional para um Nó de Computação. Esta propriedade é devolvida como parte de Get Compute Node e List Compute Nodes

  • Capacidade de desativar ou ativar o agendamento de tarefas num nó de computação

    • Duas novas APIs: Desativar o agendamento de tarefas num nó e Ativar o agendamento de tarefas num nó, são adicionadas ao recurso do nó de computação.

    • É adicionado um novo estado offline do nó de computação. Para versões antigas da API, este estado é mapeado para unusable.

    • Uma nova propriedade schedulingState é adicionada ao recurso do nó de computação. Valores possíveis para enabled e disabled.

  • Capacidade de especificar intervalo de avaliação de -scale automática num pool/autopool

    • É adicionada uma nova propriedade autoScaleEvaluationInterval para pool de recursos. Esta propriedade pode ser incluída nas APIs Add Pool, Get Pool, Enable Auto Scale e List Pools.

    • De forma semelhante, nos auto-pools, uma nova propriedade autoScaleEvaluationInterval é adicionada à autoPoolSpecification propriedade. Esta propriedade pode ser incluída em Adicionar Trabalho, Obter Trabalho, Listar Empregos, Adicionar Horário de Trabalhos, Obter Horário de Trabalhos, Atualizar Calendário de Trabalhos, Listar Agendas de Trabalhos e Listar Empregos nas APIs de Agendamento de Trabalhos.

  • Melhoria das APIs de Tarefa para devolver o diretório raiz da tarefa no nó de computação.

    • Duas novas propriedades taskRootDirectorytaskRootDirectoryUrl são adicionadas ao recurso de Tarefa, que pode ser obtido como parte de Obter informação sobre uma tarefa, APIs de Listas de Tarefas

    • É adicionada jobPreparationTaskExecutionInfo uma nova propriedade taskRootDirectory que jobReleaseTaskExecutionInfo pode ser obtida através do Listar o estado das tarefas de preparação e libertação de tarefas para uma API de tarefas.

  • Last updated on