Compartilhar 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. Você deve especificar qual versão de uma operação deseja usar quando ela for chamada, fornecendo a versão com sua chamada REST. Se sua aplicação chamar uma versão antiga de uma operação, você pode optar por continuar chamando a versão mais antiga ou modificar seu código para chamar uma versão mais recente. Se a versão não for especificada ou uma versão incorreta for especificada, um erro é retornado.

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 , Major é um inteiro e Minor é um inteiro.

Última versão: 01-06-2025

Versões anteriores

Versões anteriores incluem:

Versão: 2024-07-01.20.0

  • Adicionaram operações de deslocação e início de nós de computação:
    • Adicionada uma nova ComputeNode_Deallocate operação (POST /pools/{poolId}/nodes/{nodeId}/deallocate) para desalocar um nó de computação ocioso 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 especificando o que fazer com tarefas de execução durante a deallocation.
  • [Quebrando] Operação removida ComputeNode_GetRemoteDesktop (GET /pools/{poolId}/nodes/{nodeId}/rdp). Essa operação era aplicável apenas a pools de configuração de Serviços em Nuvem.
  • [Quebrando] Remoção do suporte para pool de configuração de serviços em nuvem:
    • Modelo removido CloudServiceConfiguration .
    • Removeu cloudServiceConfiguration propriedade de CloudPool, PoolAddParameter, e PoolSpecification.
  • [Quebrando] Removeu applicationLicenses propriedade de CloudPool, PoolAddParameter, e PoolSpecification.
  • Adicionei suporte para montagem de bind de contêineres para tarefas:
    • Adicionei um novo ContainerHostBatchBindMountEntry modelo com source propriedades e isReadOnly proprietários.
    • Adicionou novo ContainerHostDataPath enum com valores Shared, Startup, VfsMounts, Task, JobPrep, e Applications.
    • Adicionada nova containerHostBatchBindMounts propriedade a TaskContainerSettings.
  • Suporte adicional a VMs Confidenciais:
    • Adicionei um novo VMDiskSecurityProfile modelo com uma securityEncryptionType propriedade.
    • Adicionada nova securityProfile propriedade a ManagedDisk.
    • Somado confidentialVM como um novo valor para SecurityProfile.securityType.
  • Adicionados deallocated e deallocating como novos valores para ComputeNodeState.
  • Adicionaram novas propriedades obrigatórias deallocated e deallocating a NodeCounts.
  • Adicionado suporte para referência de imagens de Galeria Compartilhada e Galeria Comunitária:
    • Adicionaram sharedGalleryImageId propriedades e communityGalleryImageId a ImageReference.
  • Adicionada skipWithdrawFromVNet propriedade para JobNetworkConfiguration controlar se os nós permanecem conectados ao VNet após o término de um trabalho.
  • Adicionei networkConfiguration propriedade a JobPatchParameter.
  • Capacidades estendidas de patching de pool: Adicionadas displayName, vmSize, taskSlotsPerNode, enableInterNodeCommunicationtaskSchedulingPolicy, virtualMachineConfiguration, networkConfiguration, userAccounts, , mountConfiguration, upgradePolicye resourceTags propriedades a PoolPatchParameter. Propriedades que afetam a topologia do pool só podem ser atualizadas quando o pool está vazio.
  • Adicionou 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

  • Adicionado suporte a políticas de atualização do sistema operacional para pools de VM:
    • Adicionado novo UpgradePolicy modelo com propriedades mode, automaticOSUpgradePolicy, e rollingUpgradePolicy. A mode propriedade (UpgradeMode) aceita valores automatic, manual, e rolling.
    • Adicionado novo AutomaticOSUpgradePolicy modelo com propriedades disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, e osRollingUpgradeDeferral.
    • Adicionado novo RollingUpgradePolicy modelo com propriedades enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, e rollbackFailedInstancesOnPolicyBreach.
    • Adicionada nova upgradePolicy propriedade a CloudPool, PoolAddParameter, e PoolSpecification.
  • Somado upgradingos como um novo valor para ComputeNodeState.
  • Adicionada 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 a Trusted Launch/perfil de segurança para pools de VM:
    • Adicionado novo SecurityProfile modelo com propriedades encryptionAtHost, securityType, e uefiSettings.
    • Adicionado um novo UefiSettings modelo com propriedades secureBootEnabled e vTpmEnabled.
    • Adicionada nova securityProfile propriedade a VirtualMachineConfiguration.
  • Suporte adicional para referências de artefatos de serviço para conjuntos em escala:
    • Adicionado novo ServiceArtifactReference modelo com uma propriedade obrigatória id (ID de recurso ARM).
    • Adicionada uma nova serviceArtifactReference propriedade para VirtualMachineConfiguration definir a mesma versão de imagem para todas as VMs em um conjunto de escala ao usar a latest versão da imagem.
  • Configuração aprimorada do disco do sistema operacional:
    • Adicionei um novo ManagedDisk modelo com uma storageAccountType propriedade.
    • Adicionaram novas propriedades a OSDisk: caching, diskSizeGB, managedDisk, e writeAcceleratorEnabled.
  • Adicionou StandardSSDLRS (standardssd_lrs) como um novo valor para StorageAccountType.
  • Adicionada nova propriedade resourceTags a CloudPool, PoolAddParameter e PoolSpecification para permitir que tags definidas pelo usuário sejam propagadas para recursos de suporte Azure. Aplicável somente 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. Definido apenas quando a Conta poolAllocationMode Batch é UserSubscription.

Versão: 2023-05-01.17.0

  • [Quebrando] Removida API de Estatísticas Duradeiras de Trabalhos/Pools em Batch: lifetimejobstats e lifetimepoolstats.
  • Adicionei propriedade enableAcceleratedNetworking booleana a NetworkConfiguration.
    • Essa propriedade determina se esse pool deve permitir rede acelerada, com o valor padrão como False.
    • Se esse recurso pode ser ativado também está relacionado ao suporte de um sistema operacional/instância de VM, o que deve estar alinhado com a Política de Rede Acelerada.
  • Adicionei propriedade enableAutomaticUpgrade booleana a VMExtension.
    • Essa propriedade determina se a extensão deve ser atualizada automaticamente caso exista uma versão mais nova 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 uma nova NodeCommunicationMode propriedade que determina como um pool se comunica com o serviço Batch
  • Adicionada uma nova currentNodeCommunicationMode propriedade do NodeCommunicationMode tipo ao CloudPool modelo para se referir ao estado atual do modo de comunicação do pool.
  • Adicionada 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 que os usuários definissem cabeçalhos HTTP personalizados em uploads de arquivos de recursos.
  • Adicionada nova allowTaskPreemption propriedade aos seguintes modelos para suportar a preempção de tarefas de prioridade maior (requer Comms-Enabled ou Pool de Inquilino Único):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Versão: 2021-06-01.14.0

  • Adicionar a capacidade de atribuir identidades gerenciadas atribuídas pelo usuário a CloudPool. Essas identidades são disponibilizadas em cada nó do pool e podem ser usadas para acessar diversos recursos.
  • Propriedades adicionadas identityReference aos seguintes modelos para suportar o acesso a recursos via identidade gerenciada:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Adicionada nova extensions propriedade ao VirtualMachineConfiguration para CloudPool especificar extensões de máquina virtual 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 configurações para o disco do sistema operacional da Máquina Virtual.
    • A placement propriedade em DiffDiskSettings especifica a posição efêmera dos discos do sistema operacional para todas as VMs do pool. Configurando para "CacheDisk" para armazenar o disco efêmero do sistema operacional no cache da VM.
  • Adicionei maxParallelTasks uma propriedade para CloudJob controlar o número máximo de tarefas que podem ser executadas ao mesmo tempo por tarefa (padrão para -1 significa ilimitado). Atualmente, essa propriedade está em prévia privada.
  • 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á usando.
  • Adicionou recurrenceInterval uma propriedade para Schedule controlar o intervalo entre os horários de início de dois trabalhos sucessivos sob um cronograma de tarefas.

Versão: 2020-09-01.12.0

  • [Quebrando] Substituí a propriedade maxTasksPerNode por taskSlotsPerNode uma na piscina. Usando essa propriedade, tarefas em um trabalho podem consumir um número dinâmico de slots, permitindo um controle mais detalhado sobre o consumo de recursos.
  • [Quebrando] Alterou o tipo de resposta de GetTaskCounts para return TaskCountsResult, que é um objeto complexo contendo o objeto anterior TaskCounts e um novo TaskSlotCounts objeto fornecendo informações semelhantes no contexto dos slots usados.
  • Adicionada propriedade requiredSlots à tarefa permitindo que o usuário especifique quantos slots em um nó ele deve ocupar.

Versão: 2020-03-01.11.0

  • Adicionada a capacidade de criptografar unidades de disco ComputeNode usando a nova DiskEncryptionConfiguration propriedade de VirtualMachineConfiguration.
  • [Quebrando] A propriedade virtualMachineImageId de ImageReference agora só pode se referir a uma imagem Shared Image Gallery.
  • [Quebrando] A password propriedade do corpo de Add Certificate operação da solicitação é opcional para certificados formatados em PFX.
  • [Quebrando] Pools agora podem ser provisionados sem uma IP pública usando a nova PublicIPAddressConfiguration propriedade de NetworkConfiguration.
  • [Quebrando] A publicIPs propriedade de NetworkConfiguration também foi renomeada e ipAddressIds mudou-se para PublicIPAddressConfiguration ela. Essa 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 via NetworkConfiguration a nova publicIPs propriedade do pool. Isso garante que os nós do pool tenham um IP da lista de IPs fornecidos pelo usuário.
  • Adicionou a capacidade de montar sistemas de arquivos remotos em cada nó de um pool via a MountConfiguration propriedade.
  • Shared Image Gallery imagens agora podem ser especificadas na propriedade virtualMachineImageId de ImageReference referenciando a imagem via seu ID Azure Resource Manager.
  • [Quebrando] Quando não especificado, o valor padrão para waitForSuccess on StartTask é true (anteriormente, era false).
  • [Quebrando] Quando não especificado, o valor padrão para scope em AutoUserSpecification agora é sempre Pool (anteriormente, era Task em nós Windows e Pool em nós Linux).
  • Melhorou vários documentos confusos ou incompletos.

Versão: 2019-06-01.9.0

  • [Quebrando] Substituído ListNodeAgentSKUs por ListSupportedImages. ListSupportedImages contém todas as mesmas informações originalmente disponíveis, ListNodeAgentSKUs mas em um formato mais claro. Novas imagens não verificadas também são retornadas agora. Informações adicionais sobre Capabilities e BatchSupportEndOfLife estão acessíveis via ImageInformation.

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

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

  • Melhorou vários documentos confusos ou incompletos.

Versão: 2018-12-01.8.0

  • [Quebrando] Removi o suporte para upgradeos grupos on cloudServiceConfiguration .

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

  • [Quebrando] Removido dataEgressGiB e dataIngressGiB de poolusagemetrics. Essas propriedades não são mais suportadas.

  • [Quebrando]ResourceFile Melhorias

    • Adicionada a capacidade de especificar um contêiner inteiro do Azure Storage no ResourceFile. Agora existem três modos suportados para o ResourceFile:
      • httpUrl cria um ResourceFile apontamento para uma única URL HTTP.
      • storageContainerUrl cria um ResourceFile apontando para um contêiner Azure Blob Storage.
      • autoStorageContainerName cria um ResourceFile apontando para um contêiner de Azure Blob Storage na conta de autoarmazenamento registrada em lote.
    • As URLs fornecidas ResourceFile pelo httpUrl método agora podem ser qualquer URL HTTP. Anteriormente, essas URLs precisavam ser uma URL do Azure Blob Storage.
    • blobPrefix pode ser usado para filtrar downloads de um contêiner de armazenamento apenas para aqueles que correspondem ao prefixo.

  • [Quebrando] Removi osDisk propriedade de VirtualMachineConfiguration. Essa propriedade não é mais suportada.

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

    Observação

    Esse recurso está em versão prévia pública. Está desativado para todas as contas do lote, exceto aquelas que nos contataram e solicitaram participar do piloto.

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

  • Adicionado suporte em Windows pools para criar usuários 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

Novos recursos na versão 2018-08-01.7.0 incluem:

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

Versão 2018-03-01.6.1

Novos recursos 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, via a nova operação ListPoolNodeCounts. Essa operação permite consultar todos os pools em uma conta Batch para verificar os estados dos nós.
  • Logs de agentes de nó: Esta versão adiciona a capacidade de enviar logs de agentes de nó do Azure Batch a partir de um nó específico, via a operação UploadBatchServiceLogs. Este log é destinado ao uso em depuração pelo Microsoft Support caso ocorram problemas em um nó.

Versão 2017-09-01.6.0

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

  • Pool de discos de dados de VM: Você pode conectar um ou mais discos de dados vazios a pools de VMs 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 emergência) Imagens personalizadas agora são criadas e implantadas usando recursos de imagem do Azure Resource Manager em vez de arquivos blob VHD. O Batch agora usa discos gerenciados para criar as VMs do pool e, portanto, utiliza um recurso Image . Agora não há limite para o número de VMs em um pool criado usando uma imagem personalizada; além disso, múltiplas cópias do blob VHD para grandes pools não são mais necessárias. Pools de imagens personalizados, portanto, são muito mais fáceis de criar e escalar. Para mais informações, veja Use uma imagem personalizada para criar um pool de máquinas virtuais.

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

    • Por causa dessa mudança, o ImageReference agora é uma propriedade obrigatória do VirtualMachineConfiguration.

  • (Trocando troco) Tarefas de múltiplas instâncias (criadas usando MultiInstanceSettings) agora devem especificar CoordinationCommandLine, e NumberOfInstances agora é opcional e tem como padrão 1.

  • Adicionado suporte para tarefas executadas usando containers Docker. Para executar uma tarefa usando um container Docker, você deve especificar um ContainerConfiguration no VirtualMachineConfiguration para um pool e, em seguida, adicionar TaskContainerSettings na Task.

Versão 2017-06-01.5.1

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

Novos recursos na versão 2017-06-01.5.1 incluem:

  • Suporte para contagens de tarefas eficientes via a nova operação Get Task Counts. Ao chamar a operação Get Task Counts, você pode obter uma contagem das tarefas ativas, em execução e concluídas, e das tarefas que tiveram sucesso ou falharam. Para mais informações, veja Contar tarefas para um cargo por estado (Prévia).
  • Suporte para especificar endpoints de entrada em nós de computação de pool, via a nova propriedade poolEndpointConfiguration . Ao definir essa característica, você pode endereçar portas específicas no nó externamente.

Versão 2017-05-01.5.0

As seções a seguir descrevem novos recursos e recursos alterados na versão 2017-05-01.5.0.

Importante

A versão 2017-05-01.5.0 inclui várias mudanças urgentes. Revise as mudanças que não se importam e atualize seu código para ligar com a 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 em lote. VMs de baixa prioridade tornam possíveis novos tipos de cargas de trabalho em lote ao fornecer uma grande quantidade de poder de processamento que também é econômica.

Existem várias mudanças na API REST para nós de baixa prioridade:

  • (Trocando troco) As propriedades targetDedicated e currentDedicated de um pool ou especificação de pool foram renomeadas para targetDedicatedNodes e currentComputeNodes.
  • (Trocando troco) A propriedade resizeError de um pool agora é uma coleção chamada resizeErrors.
  • Os nós de computação têm uma nova propriedade isDedicated . Essa propriedade é verdadeira para nós dedicados e falsa para nós de baixa prioridade.
  • Uma tarefa do Gerenciador de Trabalhos tem uma nova propriedade allowLowPriorityNode . Se essa propriedade for verdadeira, a tarefa Gerenciador de Jobs pode rodar em um nó de baixa prioridade. Se for falso, então a tarefa do Gerenciador de Jobs roda em um nó de computação dedicado.

Usuários nomeados no Linux

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

  • A nova propriedade linuxUserConfiguration suporta especificar um uid (ID de usuário) e gid (ID de grupo) ao criar um usuário Linux.
  • (Trocando troco) A propriedade sshPrivateKey foi movida da propriedade userAccount para a nova propriedade linuxUserConfiguration . A propriedade linuxUserConfiguration é, em si, uma propriedade da propriedade userAccount .

Para mais informações sobre contas de usuário nomeadas, veja Executar tarefas sob contas de usuário em Batch.

Arquivos de saída para dados de tarefas

Agora você pode especificar arquivos de saída para enviar dados de tarefas após a conclusão de uma tarefa.

  • A nova propriedade outputFiles suporta especificar arquivos de tarefas para upload para Azure Storage.
  • A nova propriedade fileUploadError da propriedade exitConditions suporta especificar ações a serem tomadas com base no status de upload de um arquivo de saída.

Relatório de erro de tarefa

Várias mudanças foram feitas para melhorar o relato de erros de tarefas.

  • A nova propriedade de resultado da propriedade executionInfo indica se uma tarefa foi bem-sucedida ou falhou.
  • (Trocando troco) A propriedade SchedulingError da propriedade executionInfo foi renomeada failureInfo. A propriedade failureInfo é retornada sempre que há falha na tarefa. Isso inclui todos os casos anteriores de erro de agendamento, todos os casos em que um código de saída de tarefa diferente de zero é retornado e quaisquer falhas de upload de arquivos.
  • (Trocando troco) A propriedade SchedulingError da propriedade exitConditions foi renomeada para preProcessingError para esclarecer quando o erro ocorreu no ciclo de vida da tarefa.
  • (Trocando troco) A propriedade SchedulingErrorCateogry foi renomeada para errorCategory.

Licenças de aplicação

Agora você pode solicitar que licenças de aplicação sejam provisionadas para seu pool, por meio da nova propriedade applicationLicenses em uma especificação de pool ou 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 usuário especificada.

    Agora você pode executar uma tarefa ou coleção de tarefas sob uma das seguintes identidades de usuário, especificadas via a nova propriedade userIdentity no recurso da tarefa:

    • Uma conta de usuário com um nome que você define.

    • Uma conta de usuário que é criada automaticamente (um usuário automático). Um usuário automático pode ser executado como usuário administrativo ou não administrativo. Por padrão, um usuário automático roda como um usuário não administrativo.

      Importante

      A propriedade userIdentity , com sua propriedade elevationLevel , substitui a propriedade runElevated em requisições que adicionam uma tarefa ou coleção de tarefas, e em respostas que recebem informações sobre uma tarefa ou que listam tarefas.

      Se você fizer uma solicitação que inclua a propriedade runElevated para a versão 2017-01-01.4.0 do serviço Batch, a solicitação falha.

      Para rodar como usuário administrativo, atualize seu aplicativo para usar a propriedade Identidade do Usuário , definindo a propriedade elevationLevel para administrador.

      Para rodar como usuário não administrativo, atualize sua aplicação para usar a propriedade userIdentity , definindo a propriedade elevationLevel para nonAdmin. Como essa configuração é a padrão, você também pode omitir essa configuração.

  • Defina contas de usuário em todos os nós de um pool.

    Agora você pode executar uma tarefa ou coleção de tarefas sob uma conta de usuário que você define no recurso do pool. Defina uma conta de usuário via a nova propriedade de usuárioContas nas requisições para Adicionar Pool. Quando você define a conta, pode especificar o nome da conta, senha, nível de elevação (administrador ou não-administrador) e chave privada SSH (para pools Linux).

    Depois de definir a conta de usuário, você pode especificar essa conta de usuário para a propriedade Identidade do usuário em requisições 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 agora pode fornecer um token de autenticação para uma tarefa quando ela é executada. O token de autenticação permite que uma tarefa emita requisições relacionadas ao trabalho para o serviço Batch, sem as chaves da conta Batch. O token é fornecido por meio da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN.

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

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

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

    Agora você pode especificar que as tarefas dependentes prossigam mesmo que a tarefa da qual dependem falhe. Defina a nova propriedade dependencyAction de um recurso de tarefa para satisfazer para executar tarefas dependentes mesmo que a tarefa pai falhe. Alternativamente, defina dependencyAction para bloquear para impedir a execução de tarefas dependentes caso a tarefa pai falhar.

    Especifique a propriedade dependencyAction nas solicitações 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 operacional ao criar um pool.

    Agora você pode usar imagens de disco do sistema operacional personalizadas para criar um pool.

    Para isso, você deve especificar ao criar sua conta Batch que os pools devem ser provisionados na assinatura do usuário, e não em uma assinatura gerenciada pelo serviço Batch. Em uma 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 em uma solicitação para Adicionar Pool.

    Importante

    Ao criar sua conta Batch, se especificar que os pools serão provisionados na assinatura do usuário, então deve usar autenticação baseada no Azure Active Directory para todas as solicitações feitas por essa conta.

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

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

    Se sua conta em lote está configurada para provisionar pools na assinatura do usuário, então é necessário usar autenticação do 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

    • Uma nova rede de propriedades. A configuração foi adicionada tanto aos recursos do pool quanto do autopool. Essa 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.

  • Encerrar automaticamente uma tarefa quando todas as tarefas estiverem concluídas.

    • Uma nova propriedade em AllTasksComplete foi adicionada ao recurso de trabalho. Você pode especificar essa propriedade ao criar ou atualizar um trabalho.

  • Encerrar ou desativar automaticamente uma tarefa quando uma tarefa falhar.

    • Uma nova propriedade onTaskFailure foi adicionada ao recurso do trabalho, e uma nova propriedade exitConditions foi adicionada ao recurso da tarefa. A configuração do job onTaskFail indica se a falha da tarefa pode ter impacto no nível do trabalho, e a propriedade de saída da tarefa permite que as tarefas adaptem o impacto no 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 configurações de tarefa do jobManager. Essa propriedade permite que pacotes de aplicações sejam implantados sob demanda conforme as tarefas exigem, em vez de exigir que sejam especificados no momento da criação do pool. Essa propriedade é particularmente valiosa para pools de longa duração que podem ser chamados para executar diferentes tipos de trabalhos ou diferentes versões de aplicação ao longo de sua vida útil.

  • Capacidade de reativar uma tarefa fracassada.

    • Uma nova operação, Reativar uma tarefa, foi adicionada para redefinir o estado da tarefa falhada para ativo. Isso permite que falhas sejam tentadas novamente, por exemplo, se a falha foi transitória ou se você conseguiu 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

    • Propriedades osFamilyexistentes , targetOSVersion e currentOSVersion são movidas de propriedades de nível superior dos recursos Pool e Autopool e são movidas para dentro de uma nova propriedade chamada cloudServiceConfiguration.

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

    • Uma nova API é adicionada para obter informações sobre todos os SKUs de agentes de nós suportados pelo serviço Batch. Veja Listar SKUs de agentes de nó suportados.

    • Uma nova API é adicionada para obter configurações remotas de login que podem ser usadas para fazer login remoto em um nó de computação criado com configuração de VM IaaS. Veja Obter configurações de login remoto para um nó.

    • Uma nova API é adicionada para adicionar uma coleção de tarefas a uma tarefa. Veja: Adicionar uma coleção de tarefas a uma tarefa.

    • Uma nova propriedade sshPublicKey opcional é adicionada ao recurso Usuário que pode ser usada para adicionar/atualizar usuários em um nó de computação Linux.

    • Duas novas propriedades totalTasksSucceeded e runningTasksCount são adicionadas ao recurso Node. Essas propriedades podem ser obtidas por meio de obter informações sobre um nó ou listar os nós de computação em um pool.

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

    • Uma nova propriedade fileMode é adicionada ao FileProperties tipo complexo. Essa propriedade é retornada 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 essa propriedade não será retornada para nós de computação Linux.

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

  • As URLs das seguintes APIs foram alteradas para substituir "?" no nome da ação para "/":

    • Substituir as propriedades de uma piscina

    • Desative a escalabilidade automática em um pool

    • Ativer a escalabilidade automática em um pool

    • Avalie uma fórmula de escalonamento automático

    • Altere o tamanho de uma piscina

    • Pare de mudar o tamanho da piscina

    • Atualize o sistema operacional dos nós de computação em um pool

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

    • Reiniciar um nó

    • Reimaginar um nó

    • Desative o agendamento de tarefas em um nó

    • Ativer o agendamento de tarefas em um nó

    • Desative um cronograma de trabalho

    • Ativem um cronograma de trabalho

    • Encerrar um cronograma de trabalho

    • Desativar um trabalho

    • Habilitar um emprego

    • Encerrar um emprego

    • Encerrar uma tarefa

    • Cancelar a exclusã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 agora podem ser implantadas para calcular nós usando pacotes de aplicação em vez de como arquivos de recursos.

    • Novas APIs são fornecidas para que os clientes naveguem pela lista de aplicações e versões disponíveis, por exemplo, para exibir um seletor em uma interface de usuário.

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

  • As tarefas agora podem depender de outras tarefas. Uma tarefa dependente só começará quando todas as tarefas das quais depende forem concluídas com sucesso.

Esta versão inclui as seguintes outras mudanças:

  • O tempo padrão para redimensionar a 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 de 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 List as subtarefas de uma tarefa é adicionada para obter informações sobre subtarefas.

    • Uma nova propriedade subtaskId opcional é adicionada recentTasks para um Nó de Computação. Essa propriedade é retornada como parte de Get Compute Node e List Compute Nodes

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

    • Duas novas APIs: Desabilitar o agendamento de tarefas em um nó e Habilitar o agendamento de tarefas em um nó, são adicionadas ao recurso do nó de computação.

    • Um novo estado offline de nó de computação é adicionado. Para versões antigas da API, esse 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 em um pool/autopool

    • Uma nova propriedade autoScaleEvaluationInterval é adicionada ao pool de recursos. Essa propriedade pode ser incluída nas APIs Add Pool, Get Pool, Enable Auto Scale e List Pools.

    • Da mesma forma, para autopools, uma nova propriedade autoScaleEvaluationInterval é adicionada à autoPoolSpecification propriedade. Essa propriedade pode ser incluída em Adicionar Trabalho, Obter Trabalho, Listar Empregos, Adicionar Cronograma de Tarefas, Obter Cronograma de Tarefas, Atualizar Cronograma de Tarefas, Listar Cronogramas de Tarefas e Listar Empregos nas APIs de Agendamento de Tarefas.

  • Aprimoramento nas APIs de Tarefa para retornar o diretório raiz da tarefa no nó de computação.

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

    • Uma nova propriedade taskRootDirectory é adicionada jobPreparationTaskExecutionInfo e jobReleaseTaskExecutionInfo pode ser obtida via Listar o status das tarefas de preparação e liberação de tarefas para uma API de tarefas.

  • Last updated on