Condividi tramite

Batch Service REST API Versioning

Le operazioni fornite dall'API REST del servizio Batch possono avere più versioni per compatibilità retrocompatibile man mano che l'API evolve nel tempo. Devi specificare quale versione di un'operazione vuoi utilizzare quando viene chiamata, fornendo la versione con la tua chiamata REST. Se la tua applicazione chiama una versione più vecchia di un'operazione, puoi scegliere di continuare a chiamare la versione precedente o modificare il codice per chiamare una versione più recente. Se la versione non viene specificata o viene specificata una versione errata, viene restituito un errore.

Per specificare quale versione di un'operazione utilizzare, imposta il parametro di query di api-version . La versione è del formato Group.Major.Minor, dove Group è nel formato YYYY-MM-DD , Major è un intero e Minor è un intero.

Ultima versione: 2025-06-01

Versioni precedenti

Le versioni precedenti includono:

Versione: 2024-07-01.20.0

  • Operazioni aggiunte di deallocazione e avvio dei nodi di calcolo:
    • Aggiunta una nuova ComputeNode_Deallocate operazione (POST /pools/{poolId}/nodes/{nodeId}/deallocate) per disallocare un nodo di calcolo inattivo o in corso.
    • Aggiunta una nuova ComputeNode_Start operazione (POST /pools/{poolId}/nodes/{nodeId}/start) per riavviare un nodo di calcolo precedentemente allocato.
    • Aggiunto un nuovo NodeDeallocateParameter modello con una nodeDeallocateOption proprietà che specifica cosa fare con le attività di esecuzione durante la deallocation.
  • [Rottura] Operazione rimossa ComputeNode_GetRemoteDesktop (GET /pools/{poolId}/nodes/{nodeId}/rdp). Questa operazione era applicabile solo ai pool di configurazione dei servizi Cloud.
  • [Rottura] Rimosso il supporto per pool di configurazione dei servizi cloud:
    • Modello rimosso CloudServiceConfiguration .
    • Rimossi cloudServiceConfiguration proprietà da CloudPool, PoolAddParameter, e PoolSpecification.
  • [Rottura] Rimossi applicationLicenses proprietà da CloudPool, PoolAddParameter, e PoolSpecification.
  • Aggiunta la compatibilità per il montaggio di binding dei contenitori per i compiti:
    • Aggiunto un nuovo ContainerHostBatchBindMountEntry modello con source proprietà e isReadOnly proprietà.
    • Aggiunto nuovo ContainerHostDataPath enum con valori Shared, Startup, VfsMounts, Task, JobPrep, e Applications.
    • Aggiunta di una nuova containerHostBatchBindMounts proprietà a TaskContainerSettings.
  • Supporto Confidential VM aggiunto:
    • Aggiunto un nuovo VMDiskSecurityProfile modello con una securityEncryptionType proprietà.
    • Aggiunta di una nuova securityProfile proprietà a ManagedDisk.
    • Aggiunto confidentialVM come nuovo valore per SecurityProfile.securityType.
  • Aggiunto deallocated e deallocating come nuovi valori per ComputeNodeState.
  • Aggiunte nuove proprietà richieste deallocated e deallocating a NodeCounts.
  • Aggiunta la Galleria Condivisa e il supporto per i riferimenti delle immagini della Galleria Comunitaria:
    • Proprietà e communityGalleryImageId aggiunte sharedGalleryImageId a ImageReference.
  • Proprietà aggiunte skipWithdrawFromVNet per JobNetworkConfiguration controllare se i nodi rimangono uniti al VNet dopo la fine di un lavoro.
  • Proprietà aggiunte networkConfiguration a JobPatchParameter.
  • Capacità estese di patching pool: Aggiunte displayName, vmSize, taskSlotsPerNode, enableInterNodeCommunicationtaskSchedulingPolicy, virtualMachineConfiguration, networkConfiguration, userAccounts, mountConfiguration, upgradePolicye resourceTags proprietà a PoolPatchParameter. Le proprietà che influenzano la topologia del pool possono essere aggiornate solo quando il pool è vuoto.
  • Sono stati aggiunti force parametri di query booleani a Job_Delete, Job_Terminate, JobSchedule_Delete, e JobSchedule_Terminate operazioni per forzare l'operazione.

Versione: 2024-02-01.19.0

  • Aggiunta la policy di aggiornamento del sistema operativo per pool VM:
    • Aggiunto nuovo UpgradePolicy modello con proprietà mode, automaticOSUpgradePolicy, e rollingUpgradePolicy. La mode proprietà (UpgradeMode) accetta valori automatic, manual, e rolling.
    • Aggiunto nuovo AutomaticOSUpgradePolicy modello con proprietà disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, e osRollingUpgradeDeferral.
    • Aggiunto nuovo RollingUpgradePolicy modello con proprietà enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, e rollbackFailedInstancesOnPolicyBreach.
    • Aggiunta nuova upgradePolicy proprietà a CloudPool, PoolAddParameter, e PoolSpecification.
  • Aggiunto upgradingos come nuovo valore per ComputeNodeState.
  • Aggiunta una nuova proprietà obbligatoria upgradingOS per NodeCounts segnalare il numero di nodi nello upgradingos stato.

Versione: 2023-11-01.18.0

  • Aggiunta la compatibilità di Trusted Launch/profili di sicurezza per pool di VM:
    • Aggiunto nuovo SecurityProfile modello con proprietà encryptionAtHost, securityType, e uefiSettings.
    • Aggiunto nuovo UefiSettings modello con proprietà secureBootEnabled e vTpmEnabled.
    • Aggiunta di una nuova securityProfile proprietà a VirtualMachineConfiguration.
  • Aggiunta del supporto per il riferimento agli artefatti di servizio per scale set:
    • Aggiunto nuovo ServiceArtifactReference modello con una proprietà richiesta id (ID risorsa ARM).
    • Aggiunta una nuova serviceArtifactReference proprietà per VirtualMachineConfiguration impostare la stessa versione immagine per tutte le VM in un scalset quando si utilizza la latest versione immagine.
  • Configurazione migliorata del disco del sistema operativo:
    • Aggiunto un nuovo ManagedDisk modello con una storageAccountType proprietà.
    • Aggiunte nuove proprietà a OSDisk: caching, diskSizeGB, managedDisk, e writeAcceleratorEnabled.
  • Ha aggiunto StandardSSDLRS (standardssd_lrs) come nuovo valore per StorageAccountType.
  • Aggiunta una nuova proprietà resourceTags a CloudPool, PoolAddParameter e PoolSpecification per consentire la propagazione dei tag definiti dall'utente alle risorse di supporto Azure. Applicabile solo quando poolAllocationMode è UserSubscription.
  • Aggiunta una nuova scaleSetVmResourceId proprietà per VirtualMachineInfo esporre l'ID della risorsa della VM attuale Virtual Machine Scale Set del nodo di calcolo. Definiti solo quando l'Account poolAllocationMode Batch è UserSubscription.

Versione: 2023-05-01.17.0

  • [Rottura] Rimosso l'API di statistiche di vita di lavoro/pool batch: lifetimejobstats e lifetimepoolstats.
  • Aggiunta proprietà enableAcceleratedNetworking booleana a NetworkConfiguration.
    • Questa proprietà determina se questo pool dovrebbe abilitare il networking accelerato, con il valore predefinito come Falso.
    • Se questa funzione può essere abilitata dipende anche dal fatto che un'istanza di sistema operativo/VM sia supportata, il che dovrebbe essere in linea con la AcceleratedNetworking Policy.
  • Aggiunta proprietà enableAutomaticUpgrade booleana a VMExtension.
    • Questa proprietà determina se l'estensione debba essere aggiornata automaticamente se esiste una versione più recente dell'estensione disponibile.
  • La proprietà type di ContainerConfiguration, che ora supporta due valori: DockerCompatible e CriCompatible.

Versione: 2022-10-01.16.0

  • Aggiunta una nuova NodeCommunicationMode proprietà che determina come un pool comunica con il servizio Batch
  • Aggiunta una nuova currentNodeCommunicationMode proprietà di questo NodeCommunicationMode tipo al CloudPool modello per riferirsi allo stato attuale della modalità di comunicazione del pool.
  • Aggiunta una nuova targetNodeCommunicationMode proprietà del NodeCommunicationMode tipo ai seguenti modelli per riferirsi alla modalità di comunicazione del nodo desiderata per il pool:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Versione: 2022-01-01.15.0

  • Aggiunta una nuova uploadHeaders proprietà al OutputFileBlobContainerDestination modello per permettere agli utenti di impostare header HTTP personalizzati durante il caricamento dei file di risorse.
  • Aggiunta una nuova allowTaskPreemption proprietà ai seguenti modelli per supportare la preemption dei compiti per compiti di priorità più alta (richiede Comms-Enabled o Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Versione: 2021-06-01.14.0

  • Aggiungere la possibilità di assegnare identità gestite assegnate dagli utenti a CloudPool. Queste identità sono rese disponibili su ogni nodo del pool e possono essere utilizzate per accedere a varie risorse.
  • Proprietà aggiunte identityReference ai seguenti modelli per supportare l'accesso alle risorse tramite identità gestita:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Aggiunta una nuova extensions proprietà a VirtualMachineConfiguration CloudPool per specificare le estensioni delle macchine virtuali per i nodi
  • Aggiunta la possibilità di specificare le zone di disponibilità usando una nuova proprietà nodePlacementConfiguration su VirtualMachineConfiguration
  • Aggiunta una nuova osDisk proprietà a VirtualMachineConfiguration, che contiene le impostazioni per il disco del sistema operativo della Macchina Virtuale.
    • La placement proprietà su DiffDiskSettings specifica la posizione effimera dei dischi del sistema operativo per tutte le VM del pool. Impostandolo su "CacheDisk" per memorizzare il disco effimero del sistema operativo nella cache della VM.
  • Aggiunta maxParallelTasks una proprietà CloudJob per controllare il numero massimo di task che possono essere eseguiti contemporaneamente per ogni job (predefinito -1 significa illimitato). Questa proprietà è attualmente in anteprima privata.
  • Aggiunta virtualMachineInfo una proprietà ComputeNode che contiene informazioni sullo stato attuale della macchina virtuale, inclusa la versione esatta dell'immagine marketplace che la VM sta utilizzando.
  • Proprietà aggiunta recurrenceInterval per Schedule controllare l'intervallo tra gli orari di inizio di due lavori successivi sotto un programma di lavoro.

Versione: 2020-09-01.12.0

  • [Rottura] Ho sostituito la proprietà maxTasksPerNode con taskSlotsPerNode la piscina in piscina. Utilizzando questa proprietà, i compiti in un lavoro possono consumare un numero dinamico di slot, permettendo un controllo più dettagliato sul consumo delle risorse.
  • [Rottura] Modificato il tipo di risposta di GetTaskCounts per restituire TaskCountsResult, che è un oggetto complesso contenente l'oggetto precedente TaskCounts e un nuovo TaskSlotCounts oggetto che fornisce informazioni simili nel contesto degli slot utilizzati.
  • Aggiunta una proprietà requiredSlots al task che permette all'utente di specificare quanti slot su un nodo dovrebbe occupare.

Versione: 2020-03-01.11.0

  • Aggiunta la possibilità di cifrare i dischi ComputeNode utilizzando la nuova DiskEncryptionConfiguration proprietà di VirtualMachineConfiguration.
  • [Rottura] La proprietà virtualMachineImageId di ImageReference ora può riferirsi solo a un'immagine Shared Image Gallery.
  • [Rottura] La password proprietà del corpo operativo Add Certificate della richiesta è opzionale per i certificati formattati PFX.
  • [Rottura] I pool possono ora essere provisionati senza un IP pubblico utilizzando la nuova PublicIPAddressConfiguration proprietà di NetworkConfiguration.
  • [Rottura] Anche la publicIPs proprietà di NetworkConfiguration è stata rinominata come ipAddressIds e si è trasferita PublicIPAddressConfiguration . Questa proprietà può essere specificata solo se provision la proprietà è usermanaged.

Versione: 2019-08-01.10.0

  • Aggiunta la possibilità di specificare una collezione di IP pubblici tramite NetworkConfiguration la nuova publicIPs proprietà del pool. Questo garantisce che i nodi nel pool abbiano un IP fornito dalla lista degli IP forniti dagli utenti.
  • Aggiunta la possibilità di montare file system remoti su ogni nodo di un pool tramite la MountConfiguration proprietà.
  • Shared Image Gallery immagini possono ora essere specificate sulla proprietà virtualMachineImageId di ImageReference facendo riferimento all'immagine tramite il suo ID Azure Resource Manager.
  • [Rottura] Quando non specificato, il valore predefinito di waitForSuccess su StartTask è true (in precedenza, era false).
  • [Rottura] Quando non specificato, il valore predefinito per scope su AutoUserSpecification ora è sempre Pool (in precedenza era Task su Windows nodi e Pool su nodi Linux).
  • Ha migliorato vari documenti confusi o incompleti.

Versione: 2019-06-01.9.0

  • [Rottura] Sostituito ListNodeAgentSKUs con ListSupportedImages. ListSupportedImages contiene tutte le stesse informazioni originariamente disponibili in ListNodeAgentSKUs un formato più chiaro. Ora vengono restituite anche nuove immagini non verificate. Ulteriori informazioni su Capabilities e BatchSupportEndOfLife sono accessibili tramite ImageInformation.

  • Ora supporta regole di sicurezza di rete che bloccano l'accesso di rete a CloudPool basandosi sulla porta di origine del traffico. Questa regola viene eseguita tramite la SourcePortRanges proprietà su NetworkSecurityGroupRule.

  • Quando si esegue un contenitore, Batch supporta ora l'esecuzione dell'attività nella directory di lavoro del contenitore o nella directory di lavoro dell'attività Batch. Questa proprietà è controllata dalla WorkingDirectory proprietà in TaskContainerSettings.

  • Ha migliorato vari documenti confusi o incompleti.

Versione: 2018-12-01.8.0

  • [Rottura] Rimosso il supporto per upgradeos i pool on cloudServiceConfiguration .

    • Rimosso upgradeos.
    • Rinominato targetOSVersion in osVersion e rimosso currentOSVersion su CloudPool.
    • Rimosso upgrading da PoolState.

  • [Rottura] Rimosso dataEgressGiB e dataIngressGiB da poolusagemetrics. Queste proprietà non sono più supportate.

  • [Rottura]ResourceFile Miglioramenti

    • Aggiunta la possibilità di specificare un intero container Azure Storage in ResourceFile. Ora sono supportate tre modalità per ResourceFile:
      • httpUrl crea un ResourceFile puntamento a un singolo URL HTTP.
      • storageContainerUrl crea un contenitore ResourceFile che punta a un contenitore Azure Blob Storage.
      • autoStorageContainerName crea un ResourceFile che punta a un contenitore Azure Blob Storage nell'account autostorage registrato per batti.
    • Gli URL forniti ResourceFile tramite il httpUrl metodo possono ora essere qualsiasi URL HTTP. In precedenza, questi URL dovevano essere un Azure Blob Storage.
    • blobPrefix può essere usato per filtrare i download da un contenitore di archiviazione solo a quelli che corrispondono al prefisso.

  • [Rottura] Rimosso osDisk proprietà da VirtualMachineConfiguration. Questa proprietà non è più supportata.

  • I pool che impostano il dynamicVNetAssignmentScope su NetworkConfiguration come job ora possono assegnare dinamicamente un Virtual Network a ogni nodo il jobs tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Annotazioni

    Questa funzionalità è disponibile in anteprima pubblica. È disabilitato per tutti gli account Batch tranne quelli che ci hanno contattato e richiesto di partecipare al pilot.

  • La durata massima di un compito ora è di 180 giorni (prima era 7).

  • Aggiunta la compatibilità ai Windows pool per creare utenti con una specifica modalità di login (batch o interactive) tramite LoginMode.

  • Il tempo predefinito di mantenimento dei task per tutte le attività ora è di sette giorni, prima era infinito.

Versione 2018-08-01.7.0

Le nuove funzionalità nella versione 2018-08-01.7.0 includono:

  • Visualizza la versione di Azure Batch Node Agent, tramite la nuova proprietà NodeAgentInfo su ComputeNode.
  • Aggiunta la possibilità di specificare una Filter su Result un compito. Per altri dettagli, vedere qui.
    • Questo consente lo scenario spesso richiesto di eseguire una query lato server per trovare tutte le attività fallite.
  • [Rottura] Rimosso la ValidationStatus proprietà da TaskCounts.
  • [Rottura] Il tipo di cache predefinito per DataDisk e OSDisk ora ReadWrite è invece di None.
  • [Rottura] Rinominato l'unico valore di ContainerType da docker a dockerCompatible.

Versione 2018-03-01.6.1

Le nuove funzionalità nella versione 2018-03-01.6.1 includono:

  • Conteggio dei nodi del pool per stato: questa versione aggiunge la possibilità di interrogare il conteggio dei nodi del pool per stato, tramite la nuova operazione ListPoolNodeCounts. Questa operazione ti dà la possibilità di interrogare tutti i pool in un account Batch per gli stati dei nodi.
  • Log degli agenti nodi: Questa versione aggiunge la possibilità di caricare i log degli agenti nodi Azure Batch da un particolare nodo, tramite l'operazione UploadBatchServiceLogs. Questo log è destinato all'uso nel debug da parte del Microsoft Support se si verificano problemi su un nodo.

Versione 2017-09-01.6.0

  • Vantaggio Azure Hybrid Use Benefit: ora puoi creare pool VM Windows batch specificando che la licenza Azure Hybrid Use Benefit venga utilizzata. Quando viene utilizzata questa licenza, viene applicato uno sconto al prezzo della VM. Usa la nuova proprietà LicenseType su VirtualMachineConfiguration.

  • Pool di dischi dati VM: Puoi collegare uno o più dischi dati vuoti a pool VM utilizzando la nuova configurazione del disco dati che fa parte della configurazione della macchina virtuale. Usa la proprietà DataDisks su VirtualMachineConfiguration.

  • (Cambio in prima fase) Le immagini personalizzate ora vengono create e distribuite utilizzando le risorse immagine di Azure Resource Manager invece dei file blob VHD. Il batch ora utilizza dischi gestiti per creare le VM del pool e quindi utilizza una risorsa Image . Ora non c'è limite al numero di VM in un pool creato utilizzando un'immagine personalizzata; inoltre, non sono più necessarie più copie del blob VHD per grandi pool. I pool di immagini personalizzati sono quindi molto più facili da creare e scalare. Per maggiori informazioni, vedi Usa un'immagine personalizzata per creare un pool di macchine virtuali.

    • La nuova proprietà VirtualMachineImageId su ImageReference contiene il riferimento all'Image, e OSDisk.ImageUris non esiste più.

    • A causa di questo cambiamento, ImageReference è ora una proprietà obbligatoria di VirtualMachineConfiguration.

  • (Spicciolo) I compiti multi-istanze (creati usando MultiInstanceSettings) devono ora specificare CoordinationCommandLine, e NumberOfInstances è ora opzionale e di default imposta 1.

  • Aggiunta la compatibilità per le attività eseguite tramite container Docker. Per eseguire un compito utilizzando un container Docker, devi specificare un ContainerConfiguration su VirtualMachineConfiguration per un pool, e poi aggiungere TaskContainerSettings al Task.

Versione 2017-06-01.5.1

La versione dell'API Batch descritta qui è 2017-06-01.5.1. Si consiglia l'uso dell'ultima versione quando possibile.

Le nuove funzionalità nella versione 2017-06-01.5.1 includono:

  • Supporto per conteggi di compiti efficienti tramite la nuova operazione Get Task Counts. Chiamando l'operazione Get Task Counts, puoi ottenere un conteggio dei compiti attivi, in esecuzione e completati, e di quelli che sono riusciti o falliti. Per maggiori informazioni, vedi Conteggio delle attività per un lavoro per stato (Anteprima).
  • Supporto per la specificazione degli endpoint in entrata sui nodi di calcolo del pool, tramite la nuova proprietà poolEndpointConfiguration . Impostando questa proprietà, puoi indirizzare porti specifiche sul nodo esternamente.

Versione 2017-05-01.5.0

Le sezioni seguenti illustrano le nuove funzionalità e le funzionalità modificate nella versione 2017-05-01.5.0.

Importante

La versione 2017-05-01.5.0 include diversi cambiamenti notevoli. Rivedi le modifiche aggiornate e aggiorna il tuo codice per poter chiamare la versione 2017-05-01.5.0.

Nodi di calcolo a bassa priorità

Azure Batch ora offre nodi di calcolo a bassa priorità per ridurre il costo dei carichi di lavoro Batch. Le VM a bassa priorità rendono possibili nuovi tipi di carichi di lavoro Batch fornendo una grande quantità di potenza di calcolo che è anche economica.

Ci sono diverse modifiche all'API REST per i nodi a bassa priorità:

  • (Spicciolo) Le proprietà targetDedicated e currentDedicated di un pool o specifica di pool sono state rinominate in targetDedicatedNodes e currentComputeNodes.
  • (Spicciolo) La proprietà resizeError di un pool è ora una collezione chiamata resizeErrors.
  • I nodi di calcolo hanno una nuova proprietà isDedicate . Questa proprietà vale per i nodi dedicati e falsa per quelli a bassa priorità.
  • Un compito di Job Manager ha una nuova proprietà allowLowPriorityNode . Se questa proprietà è vera, il task Job Manager può essere eseguito su un nodo a bassa priorità. Se è falso, allora il task del Job Manager viene eseguito su un nodo di calcolo dedicato.

Utenti nominati su Linux

Azure Batch ora offre un supporto aggiuntivo per creare utenti nominati sui nodi Linux.

  • La nuova proprietà linuxUserConfiguration supporta la specificazione di un uid (ID utente) e di un gid (ID di gruppo) quando si crea un utente Linux.
  • (Spicciolo) La proprietà sshPrivateKey è stata spostata dalla proprietà userAccount alla nuova proprietà linuxUserConfiguration . La proprietà linuxUserConfiguration è essa stessa una proprietà della proprietà useraccount .

Per maggiori informazioni sugli account utente nominati, vedi Esegui le attività sotto account utente in Batch.

File di output per i dati dei compiti

Ora puoi specificare i file di output per caricare i dati delle attività dopo che un'attività è stata completata.

  • La nuova proprietà outputFiles supporta la specificazione dei file di attività da caricare su Azure Storage.
  • La nuova proprietà fileUploadError della proprietà exitConditions supporta la specificazione delle azioni da intraprendere in base allo stato di upload di un file di output.

Segnalazione degli errori del task

Sono state apportate diverse modifiche per migliorare la segnalazione degli errori dei compiti.

  • La nuova proprietà di risultato della proprietà executionInfo indica se un compito è riuscito o fallito.
  • (Spicciolo) La proprietà schedulingError della proprietà executionInfo è stata rinominata failureInfo. La proprietà failureInfo viene restituita ogni volta che c'è un fallimento del compito. Questo include tutti i precedenti casi di errore di programmazione, tutti i casi in cui viene restituito un codice di uscita di compito non nulo e eventuali fallimenti nel caricamento del file.
  • (Spicciolo) La proprietà schedulingError della proprietà exitConditions è stata rinominata in preProcessingError per chiarire quando l'errore si è verificato nel ciclo di vita del compito.
  • (Spicciolo) La proprietà schedulingErrorCateogry è stata rinominata in errorCategory.

Licenze applicative

Ora puoi richiedere che le licenze applicative vengano fornite al tuo pool, tramite la nuova proprietà applicationLicenses su una specifica di pool o pool.

Versione 2017-01-01.4.0

Questa versione estende tutto il supporto rispetto alla versione precedente, 2016-07-01.3.1. Inoltre, supporta le seguenti funzionalità:

  • Esegui un'attività con un'identità utente specificata.

    Ora puoi eseguire un'attività o una raccolta di attività sotto una delle seguenti identità utente, specificate tramite la nuova proprietà userIdentity sulla risorsa task:

    • Un account utente con un nome che definisci tu.

    • Un account utente che viene creato automaticamente (un autoutente). Un autoutente può essere eseguito come utente amministrativo o come utente non amministrativo. Di default, un autoutente funziona come utente non amministrativo.

      Importante

      La proprietà userIdentity , con la sua proprietà elevationLevel , sostituisce la proprietà runElevated nelle richieste che aggiungono un compito o una raccolta di compiti, e nelle risposte che ottengono informazioni su un compito o che elencano i compiti.

      Se fai una richiesta che include la proprietà runElevated alla versione 2017-01-01.4.0 del servizio Batch, la richiesta fallisce.

      Per eseguire come utente amministrativo, aggiorna la tua applicazione per usare la proprietà userIdentity , impostando la proprietà elevationLevel su admin.

      Per eseguire come utente non amministrativo, aggiorna la tua applicazione per usare la proprietà userIdentity , impostando la proprietà elevationLevel su nonAdmin. Dato che questa impostazione è la predefinita, puoi anche ometterla.

  • Definisci gli account utente su tutti i nodi di un pool.

    Ora puoi eseguire un'attività o una raccolta di task sotto un account utente che definisci sulla risorsa del pool. Definisci un account utente tramite la nuova proprietà userAccounts nelle richieste per aggiungere un pool. Quando definisci l'account, puoi specificare il nome dell'account, la password, il livello di elevazione (amministratore o non-admin) e la chiave privata SSH (per pool Linux).

    Una volta definito l'account utente, puoi specificare quell'account utente per la proprietà userIdentity nelle richieste che aggiungono un compito o una collezione di attività.

  • Fornire un task con un token da autenticare al servizio Batch quando il task viene eseguito.

    Il servizio Batch ora può fornire un token di autenticazione a un'attività quando viene eseguita. Il token di autenticazione consente a un task di inviare richieste relative al lavoro al servizio Batch, senza le chiavi del conto Batch. Il token viene fornito tramite la variabile di ambiente AZ_BATCH_AUTHENTICATION_TOKEN.

    Attualmente i token di autenticazione sono supportati solo per le operazioni di chiamata sulla risorsa del lavoro. Il token di autenticazione concede l'accesso a tutte le operazioni sul lavoro che contengono il compito.

    Per far sì che il servizio Batch fornisca il token di autenticazione, specifica la nuova proprietà authenticationTokenSettings , insieme alla sua proprietà di accesso , nelle richieste di Aggiungi Compito o Aggiungi Collezione Task.

  • Specifica un'azione da compiere sulle dipendenze di un compito se il compito fallisce.

    Ora puoi specificare che i compiti dipendenti procedano anche se il compito da cui dipendono fallisce. Imposta la nuova proprietà dependencyAction di una risorsa di task per soddisfare per eseguire task dipendenti anche se il task genitore fallisce. In alternativa, imposta dependencyAction su blocco per impedire l'esecuzione di task dipendenti se il task genitore fallisce.

    Specifica la proprietà dependencyAction nelle richieste per Aggiungi Compito o Aggiungi Collezione Task.

    Per maggiori informazioni sull'uso delle azioni di dipendenza, vedi Azioni di dipendenza.

  • Usa immagini disco personalizzate del sistema operativo quando crei un pool.

    Ora puoi usare immagini disco personalizzate del sistema operativo per creare un pool.

    Per farlo, devi specificare quando crei il tuo account Batch che i pool devono essere provisionati nell'abbonamento utente, anziché in un abbonamento gestito dal servizio Batch. Durante una chiamata per creare account, imposta la proprietà poolAllocationMode su UserSubscription. Poi usa la proprietà osDisk per specificare un riferimento a un'immagine disco in una richiesta ad aggiungere pool.

    Importante

    Quando crei il tuo account Batch, se specifichi che i pool devono essere provisionati nell'abbonamento utente, allora devi usare l'autenticazione basata su Azure Active Directory per tutte le richieste effettuate tramite quell'account.

  • Usa l'autenticazione basata su Azure Active Directory per le richieste al servizio Batch.

    Azure Active Directory (Azure AD) è ora supportato per l'autenticazione delle chiamate al servizio Batch.

    Se il tuo account batch è configurato per fornire pool nell'abbonamento utente, allora è necessario utilizzare l'autenticazione Azure AD.

Versione 2016-07-01.3.1

Questa versione estende tutto il supporto rispetto alla versione precedente, 2016-02-01.3.0. Inoltre, supporta le seguenti funzionalità:

  • Capacità di creare un pool e un autopool con configurazione di rete

    • Una nuova proprietà networkConfiguration è stata aggiunta sia alle risorse del pool che dell'autopool. Questa proprietà può essere utilizzata per specificare i nodi di calcolo del pools network configuration, such as the subnet in which the poolcreati.

  • Terminare automaticamente un lavoro quando tutte le attività sono completate.

    • Una nuova proprietà, AllTasksComplete, è stata aggiunta alla risorsa del lavoro. Puoi specificare questa proprietà quando crei o aggiorni un lavoro.

  • Termina o disabilita automaticamente un lavoro quando un compito fallisce.

    • Una nuova proprietà onTaskFailure è stata aggiunta alla risorsa del lavoro, e una nuova proprietà exitConditions è stata aggiunta alla risorsa del compito. L'impostazione job onTaskFailure indica se il fallimento del compito può avere un impatto a livello di lavoro, e la proprietà task exitConditions permette ai compiti di adattare l'impatto a livello di lavoro alla natura del fallimento.

  • Associa i pacchetti applicativi a task e pool.

    • Una nuova proprietà, applicationPackageReferences, aggiunta alla risorsa del compito e alle impostazioni del jobManagerTask. Questa proprietà permette di distribuire pacchetti applicativi su richiesta quando le attività lo richiedono, invece di richiedere che vengano specificate al momento della creazione del pool. Questa proprietà è particolarmente preziosa per pool di lunga durata che possono essere chiamati a eseguire diversi tipi di lavori o diverse versioni di applicazione nel corso della loro vita.

  • Capacità di riattivare un compito fallito.

    • È stata aggiunta una nuova operazione: Riattiva un compito, per reimpostare lo stato di un compito fallito su attivo. Questo permette di riprovare i fallimenti, ad esempio se il guasto è stato transitorio o se sei riuscito a risolvere la causa del fallimento senza ricreare il compito.

Versione 2016-02-01.3.0

Questa versione estende tutto il supporto rispetto alla versione precedente, 2015-12-01.2.2. Inoltre, supporta le seguenti funzionalità:

  • Capacità di creare un pool e un autopool con configurazione VM IaaS

    • Le proprietà osFamilyesistenti , targetOSVersion e currentOSVersion vengono spostate da proprietà di livello superiore di risorse Pool e Autopool e vengono spostate all'interno di una nuova proprietà chiamata cloudServiceConfiguration.

    • Una nuova proprietà virtualMachineConfiguration viene aggiunta sia alle risorse del Pool che dell'Autopool. Questa proprietà può essere specificata per configurare un pool/auto pool con VM IaaS.

    • Viene aggiunta una nuova API per ottenere informazioni su tutti gli SKU degli agenti nodi supportati dal servizio Batch. Vedi Elenco degli SKU node agent supportati.

    • Viene aggiunta una nuova API per ottenere le impostazioni di login remoto, che possono essere utilizzate per accedere remotamente a un nodo di calcolo creato con configurazione IaaS VM. Vedi Ottenere impostazioni di accesso remoto per un nodo.

    • Viene aggiunta una nuova API per aggiungere una raccolta di attività a un lavoro. Vedi Aggiungi una raccolta di compiti a un lavoro.

    • Viene aggiunta una nuova proprietà sshPublicKey opzionale alla risorsa Utente che può essere utilizzata per aggiungere/aggiornare utenti su un nodo di calcolo Linux.

    • Due nuove proprietà totalTasksSucceeded e runningTasksCount vengono aggiunte alla risorsa Node. Queste proprietà possono essere ottenute tramite Ottenere informazioni su un nodo o Elencare i nodi di calcolo in un pool.

    • Una nuova proprietà fileMode viene aggiunta al ResourceFile tipo complesso. Questa proprietà viene applicata solo ai nodi di calcolo Linux e ignorata per i nodi di calcolo di Windows.

    • Una nuova proprietà fileMode viene aggiunta al FileProperties tipo complesso. Questa proprietà viene restituita dal servizio Batch per i nodi di calcolo Linux come parte delle API GetFileProperties o ListFileProperties. Inoltre, la proprietà creationTime esistente sotto il FileProperties tipo complesso viene cambiata in una proprietà opzionale perché questa proprietà non verrà restituita per i nodi di calcolo Linux.

    • Il tipo di dato della proprietà visibility esistente all'interno del CertificateReference tipo complesso viene modificato da una stringa con valori separati da virgole a una raccolta di stringhe. Inoltre, uno dei valori esistenti per la visibilità è stato rinominato da "rdp" a "remoteuser".

  • Gli URL delle seguenti API vengono modificati per sostituire "?" del nome dell'azione in "/":

    • Sostituire le proprietà di un pool

    • Disabilita la scalabilità automatica su un pool

    • Abilita la scalabilità automatica su un pool

    • Valuta una formula di scalabilità automatica

    • Cambia la dimensione di una piscina

    • Smetti di cambiare la dimensione di una piscina

    • Aggiorna il sistema operativo dei nodi di calcolo in un pool

    • Rimuovere i nodi di calcolo da un pool

    • Riavvia un nodo

    • Rivisualizzare un nodo

    • Disabilita la pianificazione dei compiti su un nodo

    • Abilita la pianificazione delle attività su un nodo

    • Disabilita un orario di lavoro

    • Abilita un orario di lavoro

    • Terminare un orario di lavoro

    • Disabilita un lavoro

    • Abilita un lavoro

    • Licenziare un lavoro

    • Termina un compito

    • Annulla la cancellazione di un certificato

Versione 2015-12-01.2.2

Questa versione estende tutto il supporto rispetto alla versione precedente, 2015-11-01.2.1. Inoltre, supporta le seguenti funzionalità:

  • Le applicazioni possono ora essere distribuite per calcolare i nodi utilizzando pacchetti applicativi invece che come file risorsa.

    • Vengono fornite nuove API per permettere ai clienti di consultare l'elenco delle applicazioni e versioni disponibili, ad esempio per visualizzare un selettore nell'interfaccia utente.

    • Le API relative al pool sono state modificate per permettere a un pool di specificare pacchetti applicativi da scaricare a tutti i nodi di quel pool.

  • I compiti ora possono essere resi dipendenti da altri compiti. Un compito dipendente non inizierà finché tutti i compiti di cui dipende non saranno completati con successo.

Questa versione include le seguenti altre modifiche:

  • Il timeout predefinito per la ridimensionazione del pool è cambiato a 15 minuti.

Versione 2015-11-01.2.1

Questa versione estende tutto il supporto della versione precedente 2015-06-01.2.0. Inoltre, supporta le seguenti funzionalità:

  • Capacità di aggiungere ed eseguire task multi-istanze (ad esempio, MPI)

    • Una nuova proprietà multiInstanceSettings opzionale viene aggiunta alla risorsa Task che può essere inclusa opzionalmente nelle API Aggiungi Attività, Ottieni Compito, Elenca Attività.

    • Viene aggiunta una nuova API List dei sottocompiti di un compito per ottenere informazioni sui sottocompiti.

    • Viene aggiunta recentTasks una nuova proprietà subtaskId opzionale per un Nodo di Calcolo. Questa proprietà viene restituita come parte di Get Compute Node e List Compute Nodes

  • Capacità di disabilitare o abilitare la pianificazione delle attività su un nodo di calcolo

    • Due nuove API: Disabilita la pianificazione dei compiti su un nodo e Abilita la pianificazione dei compiti su un nodo, sono aggiunte sulla risorsa del nodo di calcolo.

    • Viene aggiunto un nuovo stato offline del nodo di calcolo. Per le versioni API più vecchie, questo stato viene mappato a unusable.

    • Una nuova proprietà schedulingState viene aggiunta alla risorsa del nodo di calcolo. Valori possibili per enabled e disabled.

  • Capacità di specificare intervalli di valutazione di auto-scale su un pool/autopool

    • Viene aggiunta una nuova proprietà autoScaleEvaluationInterval al pool di risorse. Questa proprietà può essere inclusa nelle API Add Pool, Get Pool, Enable Auto Scale e List Pool.

    • Analogamente, per gli auto pool, una nuova proprietà autoScaleEvaluationInterval viene aggiunta alla autoPoolSpecification proprietà. Questa proprietà può essere inclusa in Aggiungi lavoro, Ottieni lavoro, Elenca lavori, Aggiungi Programma Lavoro, Ottieni Programma Lavoro, Aggiorna Programma Lavoro, Elenca Programmi Job e Elenca Lavori nelle API Job Schedule.

  • Miglioramento delle API del compito per restituire la directory radice del compito sul nodo di calcolo.

    • Due nuove proprietà taskRootDirectory vengono taskRootDirectoryUrl aggiunte alla risorsa Task che può essere ottenuta come parte di Ottieni informazioni su un task, List Task API

    • Viene aggiunta jobPreparationTaskExecutionInfo una nuova proprietàtaskRootDirectory, jobReleaseTaskExecutionInfo che può essere ottenuta tramite Lista lo stato dei compiti di preparazione e rilascio del lavoro per un'API del lavoro.

  • Last updated on