Controle de versão da API REST do serviço de Lote
As operações fornecidas pela API REST de serviço de Lote podem ter várias versões para a compatibilidade conforme a API evolui ao longo do tempo. Especifique qual versão de uma operação você deseja usar quando for chamada, fornecendo a versão através da chamada REST. Se o seu aplicativo chamar uma versão anterior de uma operação, escolha continuar chamando a versão anterior ou modifique 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 será retornado.
Para especificar qual versão de uma operação usar, defina o parâmetro de consulta api-version . A versão está no formato Group.Major.Minor onde Group está no formato “AAAA-MM-DD” e Major é um número inteiro e Minor é um número inteiro.
Versão mais recente: 2023-05-01.17.0
- [Falha] Remoção da API de Estatísticas de Tempo de Vida do Pool/Trabalho em Lote:
lifetimejobstats
elifetimepoolstats
. - A propriedade booliana
enableAcceleratedNetworking
foi adicionada aNetworkConfiguration
.- Essa propriedade determina se esse pool deve habilitar a rede acelerada, com o valor padrão como False.
- Se esse recurso pode ser habilitado também está relacionado a se há suporte para uma instância de sistema operacional/VM, o que deve se alinhar com a Política de Rede Acelerada.
- A propriedade booliana
enableAutomaticUpgrade
foi adicionada aVMExtension
.- Essa propriedade determina se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível.
- A propriedade
type
deContainerConfiguration
, que agora dá suporte a dois valores:DockerCompatible
eCriCompatible
.
Versões anteriores
As versões anteriores incluem:
- 2022-10-01.16.0
- 2022-01-01.15.0
- 2021-06-01.14.0
- 2020-09-01.12.0
- 2020-03-01.11.0
- 2019-08-01.10.0
- 2019-06-01.9.0
- 2018-12-01.8.0
- 2018-08-01.7.0
- 2018-03-01.6.1
- 2017-09-01.6.0
- 2017-06-01.5.1
- 2017-05-01.5.0
- 2017-01-01.4.0
- 2016-07-01.3.1
- 2016-02-01.3.0
- 2015-12-01.2.2
- 2015-11-01.2.1
- 2015-06-01.2.0
- 2015-03-01.1.1
- 2014-10-01.1.0
Versão: 2022-10-01.16.0
- Adicionada nova
NodeCommunicationMode
propriedade que determina como um pool se comunica com o serviço do Lote - Adicionada nova
currentNodeCommunicationMode
propriedade doNodeCommunicationMode
tipo aoCloudPool
modelo para se referir ao estado atual do modo de comunicação do pool. - Adicionada nova
targetNodeCommunicationMode
propriedade doNodeCommunicationMode
tipo aos seguintes modelos para se referir ao modo de comunicação de nó desejado para o pool:
Versão: 2022-01-01.15.0
- Adicionada nova
uploadHeaders
propriedade aoOutputFileBlobContainerDestination
modelo para permitir que os usuários definam cabeçalhos HTTP personalizados em uploads de arquivo de recurso. - Adicionada nova
allowTaskPreemption
propriedade aos seguintes modelos para dar suporte à preempção de tarefa para tarefas de prioridade mais alta (requer Comms-Enabled ou pool de locatário único):
Versão: 2021-06-01.14.0
- Adicione a capacidade de atribuir identidades gerenciadas atribuídas pelo usuário ao
CloudPool
. Essas identidades serão disponibilizadas em cada nó no pool e poderão ser usadas para acessar vários recursos. - Propriedade adicionada
identityReference
aos seguintes modelos para dar suporte ao acesso a recursos por meio da identidade gerenciada: - Adicionada nova
extensions
propriedade a VirtualMachineConfiguration paraCloudPool
especificar extensões de máquina virtual para nós - Adicionada a capacidade de especificar zonas de disponibilidade usando uma nova propriedade
nodePlacementConfiguration
em VirtualMachineConfiguration - Adicionada nova
osDisk
propriedade a VirtualMachineConfiguration, que contém configurações para o disco do sistema operacional da Máquina Virtual.- A
placement
propriedade emDiffDiskSettings
especifica o posicionamento de disco efêmero para discos do sistema operacional para todas as VMs no pool. Defini-lo como "CacheDisk" armazenará o disco do sistema operacional efêmero no cache da VM.
- A
- Adicionada
maxParallelTasks
a propriedade emCloudJob
para controlar o número máximo de tarefas que podem ser executadas ao mesmo tempo por trabalho (o padrão é -1, o que significa ilimitado). Essa propriedade está atualmente em versão prévia privada. - Adicionada
virtualMachineInfo
a propriedade naComputeNode
qual 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. - Adicionada
recurrenceInterval
propriedade a paraSchedule
controlar o intervalo entre os horários de início de dois trabalhos sucessivos em um agendamento de trabalho.
Versão: 2020-09-01.12.0
- [Falha] Propriedade substituída
maxTasksPerNode
taskSlotsPerNode
por no pool. Usar essas tarefas de propriedade em um trabalho pode consumir um número dinâmico de slots, permitindo um controle mais refinado sobre o consumo de recursos. - [Falha] Alterou o tipo de resposta de
GetTaskCounts
para retornarTaskCountsResult
, que é um objeto complexo que contém o objeto anteriorTaskCounts
e um novoTaskSlotCounts
objeto que fornece informações semelhantes no contexto de slots que estão sendo usados. - Adicionada a propriedade
requiredSlots
à tarefa, permitindo que o usuário especifique quantos slots em um nó ele deve ocupar.
Versão: 2020-03-01.11.0
- Foi adicionada a capacidade de criptografar unidades de disco ComputeNode usando a nova
DiskEncryptionConfiguration
propriedade deVirtualMachineConfiguration
. - [Falha] A
virtualMachineImageId
propriedade deImageReference
agora só pode se referir a uma imagem Galeria de Imagens Compartilhadas. - [Falha] A
password
propriedade do corpo da solicitação daAdd Certificate
operação é opcional para certificados formatados PFX. - [Falha] Os pools agora podem ser provisionados sem um IP público usando a nova
PublicIPAddressConfiguration
propriedade deNetworkConfiguration
. - [Falha] A
publicIPs
propriedade deNetworkConfiguration
também foi renomeada comoipAddressIds
e movida paraPublicIPAddressConfiguration
. Essa propriedade só poderá ser especificada seprovision
a propriedade forusermanaged
.
Versão: 2019-08-01.10.0
- Foi adicionada a capacidade de especificar uma coleção de IPs públicos por
NetworkConfiguration
meio da novapublicIPs
propriedade no pool. Isso garante que os nós no pool terão um IP dos IPs fornecidos pelo usuário da lista. - Foi adicionada a capacidade de montar sistemas de arquivos remotos em cada nó de um pool por meio da
MountConfiguration
propriedade . - Galeria de Imagens Compartilhadas imagens agora podem ser especificadas na
virtualMachineImageId
propriedade deImageReference
referenciando a imagem por meio de sua ID de Resource Manager do Azure. - [Falha] Quando não especificado, o valor padrão para
waitForSuccess
emStartTask
étrue
(anteriormente, erafalse
). - [Falha] Quando não especificado, o valor padrão de
scope
emAutoUserSpecification
agora é semprePool
(anteriormente, ele estavaTask
em nós do Windows ePool
em nós do Linux). - Vários documentos confusos ou incompletos foram aprimorados.
Versão: 2019-06-01.9.0
[Falha] Substituído por
ListNodeAgentSKUs
ListSupportedImages
.ListSupportedImages
contém todas as mesmas informações originalmente disponíveis emListNodeAgentSKUs
, mas em um formato mais claro. Novas imagens não verificadas também são retornadas. Informações adicionais sobreCapabilities
eBatchSupportEndOfLife
podem ser acessadas por meio deImageInformation
.Agora, dê suporte a regras de segurança de rede que bloqueiam o acesso à rede a um
CloudPool
com base na porta de origem do tráfego. Isso é feito por meio da propriedadeSourcePortRanges
emNetworkSecurityGroupRule
.Ao executar um contêiner, o Lote agora é compatível com a 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 propriedade
WorkingDirectory
emTaskContainerSettings
.Vários documentos confusos ou incompletos foram aprimorados.
Versão: 2018-12-01.8.0
[Falha] Suporte removido para
upgradeos
emcloudServiceConfiguration
pools.[Falha] Removido
dataEgressGiB
edataIngressGiB
depoolusagemetrics
. Não há mais suporte para essas propriedades.[Falha]
ResourceFile
Melhorias- Adicionada a capacidade de especificar um contêiner inteiro do Armazenamento do Azure no ResourceFile. Agora há três modos com suporte para ResourceFile:
-
httpUrl
cria umResourceFile
apontando para uma única URL HTTP. -
storageContainerUrl
cria umResourceFile
apontando para um contêiner Armazenamento de Blobs do Azure. -
autoStorageContainerName
cria umResourceFile
apontando para um contêiner Armazenamento de Blobs do Azure na conta de autosstorage registrada do Lote.
-
- As URLs fornecidas para
ResourceFile
por meio dohttpUrl
método agora podem ser qualquer URL HTTP. Anteriormente, elas tinham que ser uma URL Armazenamento de Blobs do Azure. -
blobPrefix
pode ser usado para filtrar downloads de um contêiner de armazenamento para somente aqueles que correspondem ao prefixo.
- Adicionada a capacidade de especificar um contêiner inteiro do Armazenamento do Azure no ResourceFile. Agora há três modos com suporte para ResourceFile:
[Falha] Propriedade removida
osDisk
deVirtualMachineConfiguration
. Esta propriedade não é mais suportada.Os pools que definem o
dynamicVNetAssignmentScope
NetworkConfiguration
como ativadojob
agora podem atribuir dinamicamente uma Rede Virtual a cada nó em que as tarefas do trabalho são executadas. O Rede Virtual específico ao qual unir os nós é especificado na novaJobNetworkConfiguration
propriedade emCloudJob
eJobSpecification
.Observação
Esse recurso está em uma versão prévia. Ele está desabilitado para todas as contas do Lote, exceto aquelas que entraram em contato conosco e solicitaram que ele estivesse no piloto.
O tempo de vida máximo de uma tarefa agora é de 180 dias (anteriormente era 7).
Adicionado suporte em pools do Windows para criar usuários com um modo de logon específico (ou
batch
interactive
) por meio deLoginMode
.O tempo de retenção de tarefa padrão para todas as tarefas agora é de 7 dias, antes era infinito.
Versão 2018-08-01.7.0
Os novos recursos na versão 2018-08-01.7.0 incluem:
- Exiba a versão do agente do Lote do Azure Node por meio da nova propriedade NodeAgentInfo em ComputeNode.
- Adicionada a capacidade de especificar um
Filter
noResult
de uma tarefa. Veja aqui para obter mais detalhes.- Isso permite que o cenário frequentemente solicitado de executar uma consulta do lado do servidor encontre todas as tarefas que falharam.
-
[Falha]
ValidationStatus
A propriedade foi removida de TaskCounts. -
[Falha] O tipo de cache padrão para DataDisk e OSDisk agora
ReadWrite
é em vez deNone
. -
[Falha] Renomeado o único valor de ContainerType de
docker
paradockerCompatible
.
Versão 2018-03-01.6.1
Os novos recursos na versão 2018-03-01.6.1 incluem:
- Contagens de nós do pool por estado: essa versão adiciona a capacidade de consultar contagens de nós do pool por estado, por meio da nova operação ListPoolNodeCounts . Essa operação oferece a capacidade de consultar todos os pools em uma conta do Lote para estados de nó, incluindo criação, ociosidade, offline, preempção, reinicialização, reimaginação, inicialização e outros.
- Logs do agente do nó: essa versão adiciona a capacidade de carregar Lote do Azure logs do agente de nó de um nó específico, por meio da operação UploadBatchServiceLogs. Isso se destina a ser usado na depuração Suporte da Microsoft se ocorrerem problemas em um nó.
Versão 2017-09-01.6.0
Benefício de Uso Híbrido do Azure: agora você pode criar pools de VMs do Windows em Lote especificando que o licenciamento do Benefício de Uso Híbrido do Azure seja usado. Quando esse licenciamento é usado, um desconto é aplicado ao preço da VM. Use a nova propriedade LicenseType em VirtualMachineConfiguration.
Discos de dados da VM do pool: você pode anexar 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 em VirtualMachineConfiguration.
(Alteração interruptiva) Agora, as imagens personalizadas são criadas e implantadas usando recursos de imagem Resource Manager do Azure em vez de arquivos VHD de blob. O Lote agora usa discos gerenciados para criar as VMs do pool e, portanto, usa um recurso De imagem . Agora não há limite para o número de VMs em um pool criado usando uma imagem personalizada; além disso, várias cópias do blob VHD para pools grandes não são mais necessárias. Os pools de imagens personalizadas são, portanto, muito mais fáceis de criar e dimensionar. Para obter mais informações, consulte Use uma imagem personalizada para criar um pool de máquinas virtuais.
A nova propriedade VirtualMachineImageId em ImageReference contém a referência à Imagem e OSDisk.ImageUris não existe mais.
Devido a essa alteração, ImageReference agora é uma propriedade obrigatória de VirtualMachineConfiguration.
(Alteração interruptiva) As tarefas de várias instâncias (criadas usando MultiInstanceSettings) agora devem especificar CoordinationCommandLine e NumberOfInstances agora é opcional e o padrão é 1.
Adicionado suporte para tarefas executadas usando contêineres do Docker. Para executar uma tarefa usando um contêiner do Docker, você deve especificar um ContainerConfiguration no VirtualMachineConfiguration para um pool e, em seguida, adicionar TaskContainerSettings na Tarefa.
Versão 2017-06-01.5.1
A versão da API do Lote descrita aqui é 2017-06-01.5.1. Quando possível, é recomendável usar a versão mais recente.
Os novos recursos na versão 2017-06-01.5.1 incluem:
- Suporte para contagens de tarefas eficientes por meio da nova operação Obter Contagens de Tarefas . Chamando a operação Obter Contagens de Tarefas, você pode obter uma contagem de tarefas ativas, em execução e concluídas e de tarefas que tiveram êxito ou falharam. Para obter mais informações, consulte Contar tarefas para um trabalho por estado (versão prévia).
- Suporte para especificar pontos de extremidade de entrada em nós de computação do pool, por meio da nova propriedade poolEndpointConfiguration . Ao definir essa propriedade, você pode abordar portas específicas no nó externamente.
Versão 2017-05-01.5.0
As seções a seguir descrevem recursos novos e alterados na versão 2017-05-01.5.0.
Importante
A versão 2017-05-01.5.0 inclui várias alterações interruptivas. Examine as alterações interruptivas indicadas abaixo e atualize seu código para chamar a versão 2017-05-01.5.0.
Nós de computação de baixa prioridade
Lote do Azure agora oferece nós de computação de baixa prioridade para reduzir o custo das cargas de trabalho do Lote. VMs de baixa prioridade possibilitam novos tipos de cargas de trabalho do Lote, fornecendo uma grande capacidade de computação que também é mais econômica.
Há várias alterações na API REST para nós de baixa prioridade:
- (Alteração interruptiva) As propriedades targetDedicated e currentDedicated de uma especificação de pool ou pool foram renomeada para targetDedicatedNodes e currentComputeNodes.
- (Alteração interruptiva) 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 false 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 Trabalhos poderá ser executada em um nó de baixa prioridade. Se for falso, a tarefa Gerenciador de Trabalhos será executada em um nó de computação dedicado.
Usuários nomeados no Linux
Lote do Azure agora oferece suporte adicional para a criação de usuários nomeados em nós do Linux.
- A nova propriedade linuxUserConfiguration dá suporte à especificação de um uid (ID de usuário) e gid (ID de grupo) ao criar um usuário do Linux.
- (Alteração interruptiva) A propriedade sshPrivateKey foi movida da propriedade userAccount para a nova propriedade linuxUserConfiguration . A propriedade linuxUserConfiguration é uma propriedade da propriedade userAccount .
Para obter mais informações sobre contas de usuário nomeadas, consulte Executar tarefas em contas de usuário no Lote.
Arquivos de saída para dados de tarefa
Agora você pode especificar arquivos de saída para carregar dados de tarefa após a conclusão de uma tarefa.
- A nova propriedade outputFiles dá suporte à especificação de arquivos de tarefa a serem carregados no Armazenamento do Azure.
- A nova propriedade fileUploadError da propriedade exitConditions dá suporte à especificação de ações a serem executadas com base no status de upload de um arquivo de saída.
Relatório de erros de tarefa
Várias alterações foram feitas para melhorar os relatórios de erros de tarefa.
- A nova propriedade de resultado da propriedade executionInfo indica se uma tarefa foi bem-sucedida ou falhou.
- (Alteração interruptiva) A propriedade schedulingError da propriedade executionInfo foi renomeada como failureInfo. A propriedade failureInfo é retornada sempre que há uma falha de tarefa. Isso inclui todos os casos de erro de agendamento anteriores, todos os casos em que um código de saída de tarefa diferente de zero é retornado e quaisquer falhas de upload de arquivo.
- (Alteração interruptiva) A propriedade schedulingError da propriedade exitConditions foi renomeada para preProcessingError para esclarecer quando o erro ocorreu no ciclo de vida da tarefa.
- (Alteração interruptiva) A propriedade schedulingErrorCateogry foi renomeada para errorCategory.
Licenças de aplicativo
Agora você pode solicitar que as licenças de aplicativo sejam provisionadas no 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, ele dá suporte aos seguintes recursos:
Execute uma tarefa em uma identidade de usuário especificada.
Agora você pode executar uma tarefa ou coleção de tarefas em uma das seguintes identidades de usuário, especificadas por meio da nova propriedade userIdentity no recurso de 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 um usuário administrativo ou como um usuário não administrativo. Por padrão, um usuário automático é executado como um usuário não administrativo.
Importante
A propriedade userIdentity , com sua propriedade elevationLevel , substitui a propriedade runElevated em solicitações que adicionam uma tarefa ou uma coleção de tarefas e em respostas que obtêm informações sobre uma tarefa ou essas tarefas de lista.
Se você fizer uma solicitação que inclua a propriedade runElevated para a versão 2017-01-01.4.0 do serviço lote, a solicitação falhará.
Para executar como um usuário administrativo, atualize seu aplicativo para usar a propriedade userIdentity , definindo a propriedade elevationLevel como administrador.
Para ser executado como um usuário não administrativo, atualize seu aplicativo para usar a propriedade userIdentity , definindo a propriedade elevationLevel como nonAdmin. Como esse é o padrão, você também pode omitir a configuração.
Defina contas de usuário em todos os nós em um pool.
Agora você pode executar uma tarefa ou coleção de tarefas em uma conta de usuário definida no recurso do pool. Defina uma conta de usuário por meio da nova propriedade userAccounts em solicitações para Adicionar Pool. Ao definir a conta, você pode especificar o nome da conta, a senha, o nível de elevação (administrador ou não administrador) e a chave privada SSH (para pools do Linux).
Depois de definir a conta de usuário, você pode especificar essa conta de usuário para a propriedade userIdentity em solicitações que adicionam uma tarefa ou uma coleção de tarefas.
Forneça uma tarefa com um token para autenticar no serviço do Lote quando a tarefa for executada.
O serviço lote agora pode fornecer um token de autenticação para uma tarefa quando ele é executado. O token de autenticação permite que uma tarefa emita solicitações relacionadas ao trabalho para o serviço do Lote, sem as chaves da conta do Lote. O token é fornecido por meio da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN.
Atualmente, há suporte para tokens de autenticação para chamar operações somente no recurso de 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 do Lote forneça o token de autenticação, especifique a nova propriedade authenticationTokenSettings , juntamente 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 se a tarefa falhar.
Agora você pode especificar que as tarefas dependentes prossiga mesmo que a tarefa da qual elas dependem falhe. Defina a nova propriedade dependencyAction de um recurso de tarefa para atender à execução de tarefas dependentes, mesmo que a tarefa pai falhe. Como alternativa, defina dependencyAction para bloquear para impedir a execução de tarefas dependentes se a tarefa pai falhar.
Especifique a propriedade dependencyAction em solicitações para Adicionar Tarefa ou Adicionar Coleção de Tarefas.
Para obter mais informações sobre como usar ações de dependência, consulte Ações de dependência.
Use imagens personalizadas de disco do sistema operacional ao criar um pool.
Agora você pode usar imagens personalizadas de disco do sistema operacional para criar um pool.
Para fazer isso, você deve especificar ao criar sua conta do Lote que os pools devem ser provisionados na assinatura do usuário, em vez de em uma assinatura gerenciada pelo serviço do Lote. Em uma chamada para Criar Conta, defina a propriedade poolAllocationMode como UserSubscription. Em seguida, 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 do Lote, se você especificar que os pools devem ser provisionados na assinatura do usuário, deverá usar a autenticação baseada no Azure Active Directory para todas as solicitações feitas por meio dessa conta.
Use a autenticação baseada no Azure Active Directory para solicitações para o serviço do Lote.
O Azure Active Directory (Azure AD) agora tem suporte para autenticar chamadas para o serviço do Lote.
Se sua conta do Lote estiver configurada para provisionar pools na assinatura do usuário, será necessário usar Azure AD autenticação.
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, ele dá suporte aos seguintes recursos:
Capacidade de criar um pool e um pool automático com a configuração de rede
- Uma nova propriedade networkConfiguration foi adicionada aos recursos de pool e de pool automático. Essa propriedade pode ser usada para especificar a configuração de rede do pool, como a sub-rede na qual os nós de computação do pool são criados.
Encerre automaticamente um trabalho quando todas as tarefas forem concluídas.
- Uma nova propriedade onAllTasksComplete foi adicionada ao recurso de trabalho. Você pode especificar isso ao criar ou atualizar um trabalho.
Encerrar ou desabilitar automaticamente um trabalho quando uma tarefa falhar.
- Uma nova propriedade onTaskFailure foi adicionada ao recurso de trabalho e uma nova propriedade exitConditions foi adicionada ao recurso de tarefa. A configuração do trabalho onTaskFailure indica se a falha da tarefa pode ter um impacto no nível do trabalho e a propriedade task exitConditions permite que as tarefas adaptem o impacto no nível do trabalho à natureza da falha.
Associe pacotes de aplicativos a tarefas e pools.
- Uma nova propriedade applicationPackageReferences foi adicionada ao recurso de tarefa e às configurações jobManagerTask do trabalho. Isso permite que os pacotes de aplicativos sejam implantados sob demanda, pois as tarefas exigem que eles não sejam especificados no momento da criação do pool. Isso é particularmente valioso para pools de longa duração que podem ser chamados para executar diferentes tipos de trabalhos ou versões de aplicativo diferentes durante o tempo de vida ou se você tiver um pacote de aplicativo grande que não é exigido por todas as tarefas.
Capacidade de reativar uma tarefa com falha.
- Uma nova operação Reativar uma tarefa foi adicionada para redefinir o estado de uma tarefa com falha para ativa. Isso permite que as falhas sejam repetidas, 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, ele dá suporte aos seguintes recursos:
Capacidade de criar um pool e um pool automático com a configuração de VM IaaS
As propriedades existentes 'osFamily', 'targetOSVersion' e 'currentOSVersion' são movidas das 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 aos recursos Pool e Autopool. Essa propriedade pode ser especificada para configurar um pool/pool automático com VMs IaaS.
Uma nova API é adicionada para obter informações sobre todas as SKUs do agente de nó compatíveis com o serviço lote. Confira Listar SKUs de agente de nó com suporte.
Uma nova API é adicionada para obter configurações de logon remoto que podem ser usadas para fazer logon remotamente em um nó de computação criado com a configuração da VM IaaS. Confira Obter configurações de logon remoto para um nó.
Uma nova API é adicionada para adicionar uma coleção de tarefas a um trabalho. Consulte Adicionar uma coleção de tarefas a um trabalho.
Uma nova propriedade opcional 'sshPublicKey' é adicionada ao recurso Usuário que pode ser usado para adicionar/atualizar usuários em um nó de computação do 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 tipo complexo 'ResourceFile'. Essa propriedade é aplicada somente em nós de computação do Linux e ignorada para nós de computação do Windows.
Uma nova propriedade 'fileMode' é adicionada ao tipo complexo 'FileProperties'. Essa propriedade é retornada pelo serviço Lote para nós de computação do Linux como parte das APIs GetFileProperties ou ListFileProperties. Além disso, a propriedade existente 'creationTime' no tipo complexo 'FileProperties' é alterada para uma propriedade opcional porque essa propriedade não será retornada para nós de computação do Linux.
O tipo de dados da propriedade existente 'visibility' dentro do tipo complexo 'CertificateReference' é modificado de uma cadeia de caracteres com valores separados por vírgulas para uma coleção de cadeias de caracteres. Além disso, um dos valores existentes para visibilidade é renomeado de "rdp" para "remoteuser".
As URLs das seguintes APIs são alteradas para substituir "?" para o nome da ação como "/":
Atualizar o sistema operacional de nós de computação em um pool
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, ele dá suporte aos seguintes recursos:
Agora, os aplicativos podem ser implantados em nós de computação usando pacotes de aplicativos em vez de como arquivos de recurso.
Novas APIs são fornecidas para que os clientes naveguem na lista de aplicativos e versões disponíveis, por exemplo, para exibir um seletor em uma interface do usuário.
As APIs relacionadas ao pool são alteradas para permitir que um pool especifique os pacotes de aplicativos a serem baixados para todos os nós nesse pool.
As tarefas agora podem se tornar dependentes de outras tarefas. Uma tarefa dependente não será iniciada até que todas as tarefas das quais ela depende tenham sido concluídas com êxito.
Esta versão de versão inclui as seguintes outras alterações:
- O tempo limite de redimensionamento do pool padrão foi alterado 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, ele dá suporte aos seguintes recursos:
Capacidade de adicionar e executar a tarefa de várias instâncias (por exemplo, MPI)
Uma nova propriedade opcional 'multiInstanceSettings' é adicionada ao recurso Task que pode ser incluído opcionalmente nas APIs Adicionar Tarefa, Obter Tarefa, Listar Tarefas.
Uma nova Lista de API as subtarefas de uma tarefa é adicionada para obter informações sobre subtarefas.
Uma nova propriedade opcional 'subtaskId' é adicionada a 'recentTasks' para um Nó de Computação. Essa propriedade é retornada como parte de Obter Nós de Computação e Listar Nós de Computação
Capacidade de desabilitar ou habilitar o agendamento de tarefas em um nó de computação
Duas novas APIs Desabilitar agendamento de tarefas em um nó e Habilitar agendamento de tarefas em um nó são adicionadas no recurso de nó de computação.
Um novo estado de nó de computação 'offline' é adicionado. Para versões mais antigas da API, esse estado é mapeado para "inutilizável".
Uma nova propriedade 'schedulingState' é adicionada ao recurso de nó de computação. Valores possíveis para 'enabled' e 'disabled'.
Capacidade de especificar o intervalo de avaliação de dimensionamento automático em um pool/autopool
Uma nova propriedade 'autoScaleEvaluationInterval' é adicionada ao recurso de pool. Essa propriedade pode ser incluída nas APIs Adicionar Pool, Obter Pool, Habilitar Dimensionamento Automático e Listar Pools.
Da mesma forma, para pools automáticos, uma nova propriedade 'autoScaleEvaluationInterval' é adicionada à propriedade 'autoPoolSpecification'. Essa propriedade pode ser incluída em Adicionar Trabalho, Obter Trabalho, Listar Trabalhos, Adicionar Agenda de Trabalho, Obter Agenda de Trabalho, Atualizar Agenda de Trabalho, Listar Agendas de Trabalho e Listar Trabalhos em APIs de Agendamento de Trabalho.
Aprimoramento das 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 Task que pode ser obtido como parte de Obter informações sobre uma tarefa, APIs de Tarefas de Lista
Uma nova propriedade 'taskRootDirectory' é adicionada a 'jobPreparationTaskExecutionInfo' e 'jobReleaseTaskExecutionInfo' que podem ser obtidas por meio de Listar o status das tarefas de preparação de trabalho e liberação de trabalho para uma API de trabalho.