Delen via

Batch Service REST API versiebeheer

Operaties die door de Batch-service REST API worden geleverd, kunnen meerdere versies hebben voor achterwaartse compatibiliteit naarmate de API zich in de loop van de tijd ontwikkelt. Je moet aangeven welke versie van een operatie je wilt gebruiken wanneer deze wordt aangeroepen door de versie je REST-aanroep te geven. Als je applicatie een oudere versie van een operatie aanroept, kun je ervoor kiezen om de oudere versie aan te roepen, of je code aanpassen om een nieuwere versie aan te roepen. Als de versie niet wordt gespecificeerd of een onjuiste versie wordt gespecificeerd, wordt een foutmelding teruggegeven.

Om aan te geven welke versie van een operatie gebruikt moet worden, stel je de api-versie-queryparameter in. De versie is van het formaat Group.Major.Mineur, waarbij Group in het formaat YYYY-MM-DD is en Majeur een geheel getal is en Mineur een geheel getal.

Laatste versie: 2025-06-01

Vorige versies

Eerdere versies zijn onder andere:

Versie: 2024-07-01.20.0

  • Toegevoegde rekenknoopdeallocatie en startoperaties:
    • Nieuwe ComputeNode_Deallocate operatie (POST /pools/{poolId}/nodes/{nodeId}/deallocate) toegevoegd om een inactieve of draaiende rekenknoop te decentraliseren.
    • Nieuwe ComputeNode_Start bewerking (POST /pools/{poolId}/nodes/{nodeId}/start) toegevoegd om een eerder gereserveerde rekenknoop opnieuw te starten.
    • Nieuw NodeDeallocateParameter model toegevoegd met een nodeDeallocateOption eigenschap die specificeert wat te doen met het uitvoeren van taken tijdens de deallocatie.
  • [Breken] Verwijderde ComputeNode_GetRemoteDesktop operatie (GET /pools/{poolId}/nodes/{nodeId}/rdp). Deze operatie was alleen van toepassing op Cloud Service-configuratiepools.
  • [Breken] Ondersteuning voor Cloud Service Configuration Pool verwijderd:
    • Model verwijderd CloudServiceConfiguration .
    • Verwijderde cloudServiceConfiguration eigenschap uit CloudPool, PoolAddParameter, en PoolSpecification.
  • [Breken] Verwijderde applicationLicenses eigenschap uit CloudPool, PoolAddParameter, en PoolSpecification.
  • Ondersteuning voor containerbinding voor taken toegevoegd:
    • Nieuw ContainerHostBatchBindMountEntry model toegevoegd met source en isReadOnly eigenschappen.
    • Nieuwe ContainerHostDataPath enum toegevoegd met waarden Shared, Startup, , VfsMountsTask, JobPrep, en Applications.
    • containerHostBatchBindMounts Nieuwe eigenschap toegevoegd aan TaskContainerSettings.
  • Ondersteuning voor vertrouwelijke VM's toegevoegd:
    • Nieuw VMDiskSecurityProfile model toegevoegd met een securityEncryptionType eigenschap.
    • securityProfile Nieuwe eigenschap toegevoegd aan ManagedDisk.
    • Toegevoegd confidentialVM als nieuwe waarde voor SecurityProfile.securityType.
  • Toegevoegd deallocated en deallocating als nieuwe waarden voor ComputeNodeState.
  • Nieuwe vereisten deallocated en deallocating eigenschappen toegevoegd aan NodeCounts.
  • Toegevoegde ondersteuning voor afbeeldingen van Gedeelde Galerij en Community Galerij:
    • Toegevoegd sharedGalleryImageId en communityGalleryImageId eigenschappen aan ImageReference.
  • Property toegevoegd skipWithdrawFromVNet om JobNetworkConfiguration te bepalen of nodes nog steeds aan de VNet gekoppeld blijven nadat een taak is beëindigd.
  • Toegevoegde networkConfiguration eigenschap aan JobPatchParameter.
  • Uitgebreide poolpatchmogelijkheden: Toegevoegd , , , , taskSchedulingPolicyenableInterNodeCommunication, virtualMachineConfiguration, networkConfigurationuserAccounts, upgradePolicymountConfiguration, , en resourceTags eigenschappen aan .PoolPatchParametertaskSlotsPerNodevmSizedisplayName Eigenschappen die de pooltopologie beïnvloeden, kunnen alleen worden bijgewerkt wanneer de pool leeg is.
  • Booleaanse queryparameter toegevoegd force aan Job_Delete, Job_Terminate, JobSchedule_Delete, en JobSchedule_Terminate operaties om de operatie af te dwingen.

Versie: 2024-02-01.19.0

  • Ondersteuning voor OS-upgradebeleid toegevoegd voor VM-pools:
    • Nieuw UpgradePolicy model toegevoegd met eigenschappen mode, automaticOSUpgradePolicy, en rollingUpgradePolicy. De mode eigenschap (UpgradeMode) accepteert de waarden automatic, manual, en rolling.
    • Nieuw AutomaticOSUpgradePolicy model toegevoegd met eigenschappen disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, en osRollingUpgradeDeferral.
    • Nieuw RollingUpgradePolicy model toegevoegd met eigenschappen enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, , en rollbackFailedInstancesOnPolicyBreach.
    • Nieuwe upgradePolicy eigenschap toegevoegd aan CloudPool, PoolAddParameter, en PoolSpecification.
  • Toegevoegd upgradingos als nieuwe waarde voor ComputeNodeState.
  • Nieuwe vereiste upgradingOS eigenschappen toegevoegd om NodeCounts het aantal knooppunten in de upgradingos staat te rapporteren.

Versie: 2023-11-01.18.0

  • Ondersteuning voor Trusted Launch / beveiligingsprofielen toegevoegd voor VM-pools:
    • Nieuw SecurityProfile model toegevoegd met eigenschappen encryptionAtHost, securityType, en uefiSettings.
    • Nieuw UefiSettings model toegevoegd met eigenschappen secureBootEnabled en vTpmEnabled.
    • securityProfile Nieuwe eigenschap toegevoegd aan VirtualMachineConfiguration.
  • Ondersteuning voor referenties van service-artefacten toegevoegd voor schaalsets:
    • Nieuw ServiceArtifactReference model toegevoegd met een vereiste id eigenschap (ARM resource ID).
    • Nieuwe serviceArtifactReference eigenschap VirtualMachineConfiguration toegevoegd om dezelfde imageversie in te stellen voor alle VM's in een schaalset wanneer de imageversie wordt latest gebruikt.
  • Verbeterde OS-schijfconfiguratie:
    • Nieuw ManagedDisk model toegevoegd met een storageAccountType eigenschap.
    • Nieuwe eigenschappen toegevoegd aan OSDisk: caching, , diskSizeGB, managedDisken writeAcceleratorEnabled.
  • Toegevoegd StandardSSDLRS (standardssd_lrs) als nieuwe waarde voor StorageAccountType.
  • Nieuwe eigenschap resourceTags toegevoegd aan CloudPool, PoolAddParameter en PoolSpecification om door gebruikers gedefinieerde tags te kunnen doorgeven aan backing Azure resources. Alleen van toepassing wanneer poolAllocationMode is UserSubscription.
  • Nieuwe scaleSetVmResourceId eigenschap VirtualMachineInfo toegevoegd om de resource ID van de huidige Virtual Machine Scale Set VM van de compute-node bloot te stellen. Alleen gedefinieerd wanneer de batchaccounts poolAllocationMode .UserSubscription

Versie: 2023-05-01.17.0

  • [Breken] Batch job/pool Lifetime Statistics API verwijderd: lifetimejobstats en lifetimepoolstats.
  • Booleaanse eigenschap enableAcceleratedNetworking toegevoegd aan NetworkConfiguration.
    • Deze eigenschap bepaalt of deze pool versnelde netwerken mogelijk moet maken, met de standaardwaarde als False.
    • Of deze functie kan worden ingeschakeld, hangt ook samen met de vraag of een besturingssysteem/VM-instantie wordt ondersteund, wat in lijn zou moeten zijn met het AcceleratedNetworking Policy.
  • Booleaanse eigenschap enableAutomaticUpgrade toegevoegd aan VMExtension.
    • Deze eigenschap bepaalt of de extensie automatisch moet worden geüpgraded als er een nieuwere versie van de extensie beschikbaar is.
  • De eigenschap type van ContainerConfiguration, die nu twee waarden ondersteunt: DockerCompatible en CriCompatible.

Versie: 2022-10-01.16.0

  • Nieuwe NodeCommunicationMode eigenschap toegevoegd die bepaalt hoe een pool communiceert met de Batch-service
  • Nieuwe currentNodeCommunicationMode eigenschap van het NodeCommunicationMode type aan het CloudPool model toegevoegd om te verwijzen naar de huidige staat van de poolcommunicatiemodus.
  • Nieuwe targetNodeCommunicationMode eigenschap van het NodeCommunicationMode type toegevoegd aan de volgende modellen om te verwijzen naar de gewenste nodecommunicatiemodus voor de pool:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Versie: 2022-01-01.15.0

  • Nieuwe uploadHeaders eigenschappen aan het OutputFileBlobContainerDestination model toegevoegd zodat gebruikers aangepaste HTTP-headers kunnen instellen op resourcebestanduploads.
  • Nieuwe allowTaskPreemption eigenschappen toegevoegd aan de volgende modellen om taakpreëmptie te ondersteunen voor taken met hogere prioriteit (vereist Comms-Enabled of Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Versie: 2021-06-01.14.0

  • Voeg de mogelijkheid toe om door gebruikers toegewezen beheerde identiteiten toe te wijzen aan CloudPool. Deze identiteiten worden beschikbaar gesteld op elke node in de pool en kunnen worden gebruikt om toegang te krijgen tot diverse bronnen.
  • Eigenschappen toegevoegd identityReference aan de volgende modellen om toegang tot bronnen via beheerde identiteit te ondersteunen:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Nieuwe extensions eigenschap toegevoegd aan VirtualMachineConfiguration om CloudPool virtuele machine-extensies voor nodes te specificeren
  • Mogelijkheid toegevoegd om beschikbaarheidszones te specificeren met een nieuwe eigenschap nodePlacementConfiguration op VirtualMachineConfiguration
  • Nieuwe osDisk eigenschap toegevoegd aan VirtualMachineConfiguration, die instellingen bevat voor de besturingssysteemschijf van de Virtual Machine.
    • De placement eigenschap op DiffDiskSettings specificeert de plaatsing van de efemere schijf voor besturingssysteemschijven voor alle VM's in de pool. Ik zet het op "CacheDisk" om de vluchtige OS-schijf op de VM-cache op te slaan.
  • Toegevoegde maxParallelTasks eigenschap toegevoegd CloudJob om het maximale aantal taken te regelen dat per taak tegelijk kan draaien (standaard is -1 betekent onbeperkt). Dit pand is momenteel in privé preview.
  • Toegevoegde virtualMachineInfo eigenschap daarop ComputeNode bevat informatie over de huidige status van de virtuele machine, inclusief de exacte versie van het marketplace-image dat de VM gebruikt.
  • Eigenschap Schedule toegevoegd recurrenceInterval om het interval tussen de starttijden van twee opeenvolgende taken onder een taakschema te regelen.

Versie: 2020-09-01.12.0

  • [Breken] Vervangen door taskSlotsPerNode het zwembadmaxTasksPerNode. Met deze eigenschap kunnen taken in een taak een dynamisch aantal slots innemen, wat zorgt voor fijnmazigere controle over het resourceverbruik.
  • [Breken] Het responstype van GetTaskCounts veranderde naar retour TaskCountsResult, wat een complex object is dat het vorige TaskCounts object bevat en een nieuw TaskSlotCounts object dat vergelijkbare informatie levert in de context van gebruikte slots.
  • Eigenschap requiredSlots toegevoegd aan de taak, waardoor de gebruiker kan specificeren hoeveel slots op een node deze moet innemen.

Versie: 2020-03-01.11.0

  • Mogelijkheid toegevoegd om ComputeNode-schijven te versleutelen met de nieuwe DiskEncryptionConfiguration eigenschap .VirtualMachineConfiguration
  • [Breken] De eigenschap virtualMachineImageId van ImageReference kan nu alleen nog verwijzen naar een Shared Image Gallery afbeelding.
  • [Breken] De password eigenschap van het aanvraaglichaam van Add Certificate werking is optioneel voor PFX-geformatteerde certificaten.
  • [Breken] Pools kunnen nu worden geprovisioneerd zonder publiek IP met behulp van de nieuwe PublicIPAddressConfiguration eigenschap .NetworkConfiguration
  • [Breken] Het publicIPs pand is NetworkConfiguration hernoemd ipAddressIds en ook verhuisd PublicIPAddressConfiguration . Deze eigenschap kan alleen worden gespecificeerd als provision eigenschap is usermanaged.

Versie: 2019-08-01.10.0

  • Toegevoegde mogelijkheid om een verzameling publieke IP's NetworkConfiguration te specificeren via de nieuwe publicIPs eigenschap in de pool. Dit garandeert dat nodes in de pool een IP hebben van de door gebruikers verstrekte IP's.
  • Mogelijkheid toegevoegd om externe bestandssystemen op elke node van een pool te mounten via de MountConfiguration eigenschap.
  • Shared Image Gallery afbeeldingen kunnen nu worden gespecificeerd op de eigenschap virtualMachineImageIdImageReference door de afbeelding te refereren via zijn Azure Resource Manager ID.
  • [Breken] Wanneer niet gespecificeerd, is true de standaardwaarde voor waitForSuccess op StartTask (voorheen was falsehet ).
  • [Breken] Wanneer niet gespecificeerd, is de standaardwaarde voor scope op AutoUserSpecification nu altijd Pool (voorheen was het Task op Windows knooppunten en Pool op Linux-knooppunten).
  • Verbeterde verschillende verwarrende of onvolledige documenten.

Versie: 2019-06-01.9.0

  • [Breken] Vervangen ListNodeAgentSKUs door ListSupportedImages. ListSupportedImages bevat alle informatie die oorspronkelijk beschikbaar was ListNodeAgentSKUs , maar in een duidelijker formaat. Nieuwe, niet-geverifieerde afbeeldingen worden nu ook teruggestuurd. Aanvullende informatie over Capabilities en BatchSupportEndOfLife is toegankelijk via ImageInformation.

  • Ondersteun nu netwerkbeveiligingsregels die netwerktoegang blokkeren op CloudPool basis van de bronpoort van het verkeer. Deze regel wordt gedaan via de SourcePortRanges eigenschap op NetworkSecurityGroupRule.

  • Wanneer u een container uitvoert, ondersteunt Batch nu het uitvoeren van de taak in de werkmap van de container of in de werkmap batchtaken. Dit wordt bepaald door de WorkingDirectory eigenschap op TaskContainerSettings.

  • Verbeterde verschillende verwarrende of onvolledige documenten.

Versie: 2018-12-01.8.0

  • [Breken] Ondersteuning voor upgradeos on-pools cloudServiceConfiguration verwijderd.

    • Verwijderd upgradeos.
    • Hernoemd targetOSVersion naar osVersion en verwijderd currentOSVersion op CloudPool.
    • Verwijderd upgrading uit PoolState.

  • [Breken] Verwijderd dataEgressGiB en dataIngressGiB uit poolusagemetrics. Deze eigenschappen worden niet langer ondersteund.

  • [Breken]ResourceFile Verbeteringen

    • De mogelijkheid toegevoegd om een volledige Azure Storage-container te specificeren in ResourceFile. Er zijn nu drie ondersteunde modi voor ResourceFile:
      • httpUrl maakt een ResourceFile verwijzing naar een enkele HTTP-URL.
      • storageContainerUrl maakt een ResourceFile die naar een Azure Blob Storage container wijst.
      • autoStorageContainerName maakt een ResourceFile aan die verwijst naar een Azure Blob Storage container in het batch-geregistreerde autostorage-account.
    • URL's die via de httpUrl methode worden ResourceFile aangeboden, kunnen nu elke HTTP-URL zijn. Voorheen moesten deze URL's een Azure Blob Storage-URL zijn.
    • blobPrefix kan worden gebruikt om downloads uit een opslagcontainer te filteren naar alleen die welke overeenkomen met het prefix.

  • [Breken] Eigendom verwijderd osDisk van VirtualMachineConfiguration. Deze eigenschap wordt niet langer ondersteund.

  • Pools die de dynamicVNetAssignmentScope op NetworkConfiguration instellen op job kunnen nu dynamisch een Virtual Network toewijzen aan elke node van de taaks tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Opmerking

    Deze functie is beschikbaar voor openbare preview. Het is uitgeschakeld voor alle batchaccounts behalve die welke contact met ons hebben opgenomen en gevraagd hebben om in de pilot te komen.

  • De maximale levensduur van een taak is nu 180 dagen (voorheen was dat 7).

  • Ondersteuning toegevoegd voor Windows pools om gebruikers met een specifieke inlogmodus aan te maken (ofwel batch of interactive) via LoginMode.

  • De standaard taakbehoudtijd voor alle taken is nu zeven dagen, voorheen was die oneindig.

Versie 2018-08-01.7.0

Nieuwe functies in versie 2018-08-01.7.0 zijn onder andere:

  • Bekijk de versie van de Azure Batch Node Agent, via de nieuwe NodeAgentInfo-eigenschap op ComputeNode.
  • Toegevoegd de mogelijkheid om een Filter op de achterkant Result van een taak te specificeren. Zie hier voor meer informatie.
    • Dit maakt het vaak gevraagde scenario mogelijk om een server-side query uit te voeren om alle taken te vinden die mislukt zijn.
  • [Breken] Het eigendom uit TaskCounts verwijderd ValidationStatus .
  • [Breken] Het standaard cachingtype voor DataDisk en OSDisk is nu ReadWrite in plaats van None.
  • [Breken] De enige waarde van ContainerType werd hernoemd van docker naar dockerCompatible.

Versie 2018-03-01.6.1

Nieuwe functies in versie 2018-03-01.6.1 zijn onder andere:

  • Poolknooppuntentellingen per toestand: Deze versie voegt de mogelijkheid toe om poolknopentellingen per staat te bevragen via de nieuwe ListPoolNodeCounts-operatie. Deze operatie geeft je de mogelijkheid om alle pools in een batchaccount te bevragen naar node-toestanden.
  • Node-agentlogs: Deze versie voegt de mogelijkheid toe om Azure Batch-logs van een bepaalde node te uploaden via de UploadBatchServiceLogs-operatie. Dit logboek is bedoeld voor gebruik bij debugging door Microsoft Support als er problemen optreden op een node.

Versie 2017-09-01.6.0

  • Azure Hybrid Use Advantage: Je kunt nu Batch Windows VM-pools maken waarin wordt aangegeven dat Azure Hybrid Use Benefit-licenties worden gebruikt. Wanneer deze licentie wordt gebruikt, wordt er korting toegepast op de prijs van de VM. Gebruik de nieuwe LicenseType-eigenschap op VirtualMachineConfiguration.

  • Pool VM-datadisks: Je kunt één of meer lege datadisks aan VM-pools koppelen door gebruik te maken van de nieuwe datadiskconfiguratie die deel uitmaakt van de virtual machine-configuratie. Gebruik de DataDisks-eigenschap op VirtualMachineConfiguration.

  • (Verandering breken) Aangepaste images worden nu gemaakt en uitgerold met Azure Resource Manager imageresources in plaats van blob VHD-bestanden. Batch gebruikt nu managed disks om de pool-VM's te maken en gebruikt daarom een imageresource . Er is nu geen limiet meer aan het aantal VM's in een pool dat is gemaakt met een aangepaste image; ook zijn meerdere kopieën van de VHD-blob voor grote pools niet langer nodig. Aangepaste image pools zijn daardoor veel makkelijker te maken en op te schalen. Voor meer informatie, zie Gebruik een aangepaste image om een pool van virtuele machines te maken.

    • De nieuwe VirtualMachineImageId-eigenschap op ImageReference bevat de verwijzing naar de afbeelding, en OSDisk.ImageUris bestaat niet meer.

    • Door deze wijziging is ImageReference nu een verplichte eigenschap van VirtualMachineConfiguration.

  • (Wisselgeld breekt) Multi-instance taken (gemaakt met MultiInstanceSettings) moeten nu CoordinationCommandLine specificeren, en NumberOfInstances is nu optioneel en standaard 1.

  • Ondersteuning toegevoegd voor taken die worden uitgevoerd met Docker-containers. Om een taak te draaien met een Docker-container , moet je een ContainerConfiguration specificeren op de VirtualMachineConfiguration voor een pool, en vervolgens TaskContainerSettings toevoegen aan de Task.

Versie 2017-06-01.5.1

De versie van de Batch API die hier wordt beschreven is 2017-06-01.5.1. Het gebruik van de nieuwste versie wordt aanbevolen waar mogelijk.

Nieuwe functies in versie 2017-06-01.5.1 zijn onder andere:

  • Ondersteuning voor efficiënte taaktellingen via de nieuwe operatie Get Task Counts. Door de operatie 'Get Task Counts' aan te roepen, kun je een telling krijgen van actieve, lopende en voltooide taken, en van taken die zijn geslaagd of mislukt. Voor meer informatie, zie Taken tellen voor een taak per staat (Preview).
  • Ondersteuning voor het specificeren van inkomende eindpunten op pool-rekenknooppunten, via de nieuwe poolEndpointConfiguration-eigenschap . Door deze eigenschap in te stellen, kun je specifieke poorten op de node extern adresseren.

Versie 2017-05-01.5.0

De volgende secties beschrijven nieuwe en gewijzigde functies in versie 2017-05-01.5.0.

Belangrijk

Versie 2017-05-01.5.0 bevat verschillende breaking changes. Bekijk de breaking changes en werk je code bij om versie 2017-05-01.5.0 te kunnen oproepen.

Rekenknopen met lage prioriteit

Azure Batch biedt nu low-priority compute-nodes om de kosten van batch-workloads te verlagen. Low-priority VM's maken nieuwe soorten batchworkloads mogelijk door een grote hoeveelheid rekenkracht te leveren die ook economisch is.

Er zijn verschillende wijzigingen aan de REST API voor nodes met lage prioriteit:

  • (Wisselgeld breekt) De targetDedicated en currentDedicated eigenschappen van een pool of poolspecificatie zijn hernoemd naar targetDedicatedNodes en currentComputeNodes.
  • (Wisselgeld breekt) De resizeError-eigenschap van een pool is nu een verzameling genaamd resizeErrors.
  • Compute-nodes hebben een nieuwe isDegedive-eigenschap . Deze eigenschap geldt voor toegewijde knooppunten, en onjuist voor knooppunten met lage prioriteit.
  • Een taak Job Manager heeft een nieuwe allowPriorityNode-eigenschap . Als deze eigenschap waar is, kan de taak Taakbeheer draaien op een node met lage prioriteit. Als deze onjuist is, draait de taak Taakbeheer op een speciale compute-node.

Benoemde gebruikers op Linux

Azure Batch biedt nu extra ondersteuning voor het aanmaken van benoemde gebruikers op Linux-nodes.

  • De nieuwe linuxUserConfiguration-eigenschap ondersteunt het specificeren van een uid (user ID) en gid (group ID) bij het aanmaken van een Linux-gebruiker.
  • (Wisselgeld breekt) De sshPrivateKey-eigenschap is verplaatst van de userAccount-eigenschap naar de nieuwe linuxUserConfiguration-eigenschap . De eigenschap linuxUserConfiguration is zelf een eigenschap van de eigenschap userAccount .

Voor meer informatie over benoemde gebruikersaccounts, zie Taken uitvoeren onder gebruikersaccounts in batch.

Uitvoerbestanden voor taakgegevens

Je kunt nu outputbestanden specificeren om taakgegevens te uploaden nadat een taak is voltooid.

  • De nieuwe eigenschap outputFiles ondersteunt het specificeren van taakbestanden om naar Azure Storage te uploaden.
  • De nieuwe fileUploadError-eigenschap van de exitConditions-eigenschap ondersteunt het specificeren van acties die moeten worden uitgevoerd op basis van de uploadstatus van een uitvoerbestand.

Taakfoutrapportage

Er zijn verschillende wijzigingen aangebracht om de rapportage van taakfouten te verbeteren.

  • De nieuwe resultaateigenschap van de executieInfo-eigenschap geeft aan of een taak geslaagd of mislukt is.
  • (Wisselgeld breekt) De planningsfouteigenschap van de executieInfo-eigenschap is hernoemd tot failureInfo. De failureInfo-eigenschap wordt teruggegeven telkens wanneer er een taakfout is. Dit omvat alle eerdere planningsfouten, alle gevallen waarin een niet-nul taakafsluitcode wordt teruggegeven, en eventuele fouten bij het uploaden van bestanden.
  • (Wisselgeld breekt) De eigenschap schedulingError van de exitConditions-eigenschap is hernoemd naar preProcessingError om te verduidelijken wanneer de fout plaatsvond in de taaklevenscyclus.
  • (Wisselgeld breekt) De eigenschap schedulingErrorCateogry is hernoemd naar errorCategory.

Applicatielicenties

Je kunt nu verzoeken om applicatielicenties aan je pool te laten toewijzen, via de nieuwe applicationLicenses-eigenschap op een pool of poolspecificatie.

Versie 2017-01-01.4.0

Deze versieversie breidt alle ondersteuning uit van de vorige versie, 2016-07-01.3.1. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Voer een taak uit onder een gespecificeerde gebruikersidentiteit.

    Je kunt nu een taak of taakverzameling uitvoeren onder een van de volgende gebruikersidentiteiten, gespecificeerd via de nieuwe userIdentity-eigenschap op de taakresource:

    • Een gebruikersaccount met een naam die jij definieert.

    • Een gebruikersaccount dat automatisch wordt aangemaakt (een autouser). Een autouser kan als administratief gebruiker of als niet-administratief gebruiker draaien. Standaard draait een autouser als niet-administratieve gebruiker.

      Belangrijk

      De property , met de property, heightionLevel , vervangt de runElevated-eigenschap in verzoeken die een taak of taskcollection toevoegen, en in antwoorden die informatie over een taak opleveren of taken opsommen.

      Als je een verzoek doet dat de runElevated-eigenschap bevat naar versie 2017-01-01.4.0 van de Batch-service, faalt het verzoek.

      Om als administratief gebruiker te draaien, werk je je applicatie bij om de eigenschap userIdentity te gebruiken en zet je de elevationLevel-eigenschap op admin.

      Om als niet-administratieve gebruiker te draaien, werk je je applicatie bij om de propertyUserIdentity te gebruiken en zet je de elevationLevel-eigenschap op nonAdmin. Omdat deze instelling de standaard is, kun je deze instelling ook weglaten.

  • Definieer gebruikersaccounts over alle knooppunten in een pool.

    Je kunt nu een taak of takenverzameling uitvoeren onder een gebruikersaccount dat je definieert op de poolresource. Definieer een gebruikersaccount via de nieuwe userAccounts-eigenschap in verzoeken om Pool toe te voegen. Wanneer je het account definieert, kun je de accountnaam, wachtwoord, elevatieniveau (admin of niet-admin) en SSH privésleutel (voor Linux-pools) opgeven.

    Zodra je het gebruikersaccount hebt gedefinieerd, kun je dat gebruikersaccount opgeven voor de userIdentity-eigenschap in verzoeken die een taak of een taakverzameling toevoegen.

  • Geef een taak een token om zich te authenticeren bij de batchservice wanneer de taak wordt uitgevoerd.

    De Batch-service kan nu een authenticatietoken aan een taak geven wanneer deze wordt uitgevoerd. Het authenticatietoken stelt een taak in staat om verzoeken met betrekking tot de taak aan de Batch-service te sturen, zonder de sleutels van het Batch-account. Het token wordt geleverd via de omgevingsvariabele AZ_BATCH_AUTHENTICATION_TOKEN.

    Momenteel worden authenticatietokens alleen ondersteund voor aanroepoperaties op de taakbron. Het authenticatietoken verleent toegang tot alle bewerkingen op de taak die de taak bevat.

    Om de Batch-service het authenticatietoken te laten leveren, specificeer je de nieuwe authenticatieTokenSettings-eigenschap , samen met de toegangseigenschap daarvan, bij verzoeken om Taak Toe te voegen of Takenverzameling toe te voegen.

  • Specificeer een actie die je moet uitvoeren op de afhankelijkheden van een taak als de taak faalt.

    Je kunt nu specificeren dat afhankelijke taken doorgaan, zelfs als de taak waarop ze afhankelijk zijn faalt. Stel de nieuwe dependencyAction-eigenschap van een taakresource in om te voldoen aan het uitvoeren van afhankelijke taken, zelfs als de oudertaak faalt. Alternatief kun je dependencyAction op blokkeren instellen om het uitvoeren van afhankelijke taken te voorkomen als de oudertaak faalt.

    Specificeer de dependencyAction-eigenschap in verzoeken om Taak toe te voegen of Taakverzameling toe te voegen.

    Voor meer informatie over het gebruik van afhankelijkheidsacties, zie Afhankelijkheidsacties.

  • Gebruik aangepaste OS-diskimages bij het aanmaken van een pool.

    Je kunt nu aangepaste OS-diskimages gebruiken om een pool aan te maken.

    Om dit te doen, moet je bij het aanmaken van je Batch-account aangeven dat pools worden geprovisioneerd in het gebruikersabonnement, in plaats van in een abonnement dat door de Batch-service wordt beheerd. Zet in een aanroep naar Create Account de poolAllocationMode-eigenschap op UserSubscription. Gebruik vervolgens de osDisk-eigenschap om een verwijzing naar een schijfimage te specificeren in een verzoek om Add Pool toe te voegen.

    Belangrijk

    Wanneer je je batchaccount aanmaakt en aangeeft dat pools in het gebruikersabonnement moeten worden geprovisioneerd, moet je voor alle verzoeken via dat account Azure Active Directory-gebaseerde authenticatie gebruiken.

  • Gebruik Azure Active Directory-gebaseerde authenticatie voor verzoeken naar de Batch-service.

    Azure Active Directory (Azure AD) wordt nu ondersteund voor het authenticeren van aanroepen naar de Batch-service.

    Als je Batch-account is ingesteld om pools te provisionen in het gebruikersabonnement, dan is Azure AD-authenticatie vereist.

Versie 2016-07-01.3.1

Deze versie verlengt alle ondersteuning van de vorige versie, 2016-02-01.3.0. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Mogelijkheid om een pool en een autopool aan te maken met netwerkconfiguratie

    • Er is een nieuwe property networkConfiguration toegevoegd aan zowel de pool- als autopool-resources. Deze eigenschap kan worden gebruikt om aan te geven welke compute-nodes van de pools network configuration, such as the subnet in which the poolzijn aangemaakt.

  • Beëindig automatisch een taak wanneer alle taken zijn voltooid.

    • Er is een nieuwe eigenschap op AllTasksComplete toegevoegd aan de taakresource. Je kunt deze eigenschap specificeren wanneer je een job aanmaakt of bijwerkt.

  • Beëindig of schakel automatisch een taak uit wanneer een taak faalt.

    • Er is een nieuwe eigenschap onTaskFailure toegevoegd aan de taakbron, en een nieuwe eigenschap exitConditions is toegevoegd aan de taakbron. De functie onTaskFailure-instelling geeft aan of taakfalen een impact op taakniveau kan hebben, en de eigenschap task exitConditions stelt taken in staat om de impact op taakniveau af te stemmen op de aard van de fout.

  • Koppel applicatiepakketten aan taken en pools.

    • Een nieuwe eigenschap applicationPackageReferences toegevoegd aan de taakbron en aan de job jobManagerTask-instellingen. Deze eigenschap maakt het mogelijk om applicatiepakketten op aanvraag te implementeren wanneer taken dat vereisen, in plaats van dat ze bij poolcreatie worden gespecificeerd. Deze eigenschap is vooral waardevol voor langlopende pools die gedurende hun levensduur verschillende soorten taken of applicatieversies kunnen uitvoeren.

  • Mogelijkheid om een mislukte taak opnieuw te activeren.

    • Er is een nieuwe operatie Een taak opnieuw activeren toegevoegd om de status van een mislukte taak terug te zetten naar actief. Dit maakt het mogelijk om fouten opnieuw te proberen, bijvoorbeeld als de storing tijdelijk was of als je de oorzaak hebt kunnen herstellen zonder de taak opnieuw te maken.

Versie 2016-02-01.3.0

Deze versie verlengt alle ondersteuning van de vorige versie, 2015-12-01.2.2. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Mogelijkheid om een pool en een autopool te maken met IaaS VM-configuratie

    • Bestaande eigendommen osFamily, targetOSVersion en currentOSVersion worden verplaatst van topniveau-eigendommen van pool- en Autopool-bronnen en verplaatst naar een nieuw eigendom genaamd cloudServiceConfiguration.

    • Er wordt een nieuwe eigenschap virtualMachineConfiguration toegevoegd aan zowel de Pool- als Autopool-bronnen. Deze eigenschap kan worden gespecificeerd om een pool/auto pool te configureren met IaaS VM's.

    • Er wordt een nieuwe API toegevoegd om informatie te verkrijgen over alle node agent SKU's die door de Batch-service worden ondersteund. Zie Lijst met ondersteunde node-agent SKU's.

    • Er is een nieuwe API toegevoegd om instellingen voor remote login te verkrijgen die gebruikt kan worden om op afstand in te loggen op een compute node die is gemaakt met de IaaS VM-configuratie. Zie Instellingen voor externe inloggegevens voor een node.

    • Er wordt een nieuwe API toegevoegd om een verzameling taken aan een taak toe te voegen. Zie Voeg een verzameling taken toe aan een taak.

    • Er wordt een nieuwe optionele eigenschap sshPublicKey toegevoegd aan de gebruikersresource die gebruikt kan worden om gebruikers toe te voegen/bijwerken op een Linux-rekenknooppunt.

    • Twee nieuwe eigenschappen totalTasksSucceeded en runningTasksCount worden toegevoegd aan de Node-resource. Deze eigenschappen kunnen worden verkregen via Get Information about a Node of List the compute nodes in een pool.

    • Er wordt een nieuwe eigenschap fileMode toegevoegd aan het ResourceFile complexe type. Deze eigenschap wordt alleen toegepast op Linux-rekenknooppunten en genegeerd voor Windows-rekenknooppunten.

    • Er wordt een nieuwe eigenschap fileMode toegevoegd aan het FileProperties complexe type. Deze eigenschap wordt teruggegeven door de Batch-service voor Linux-compute-nodes als onderdeel van GetFileProperties of ListFileProperties API's. Ook wordt de bestaande eigenschap creationTime onder het FileProperties complexe type veranderd in een optionele eigenschap omdat deze eigenschap niet wordt teruggegeven voor Linux-rekenknopen.

    • Het datatype van de bestaande eigenschap visibility binnen het CertificateReference complexe type wordt aangepast van een string met komma-gescheiden waarden naar een verzameling strings. Ook is een van de bestaande waarden voor zichtbaarheid hernoemd van "rdp" naar "remoteuser".

  • De URL's van de volgende API's worden gewijzigd om "?" te vervangen door de actienaam door "/":

    • Vervang de eigenschappen van een zwembad

    • Schakel automatische schaalverdeling in een pool uit

    • Schakel automatische schaalverdeling in een pool in

    • Evalueer een automatische schaalformule

    • Verander de grootte van een pool

    • Stop met het veranderen van de grootte van een zwembad

    • Upgrade het besturingssysteem van rekenknopen in een pool

    • Verwijder compute-nodes uit een pool

    • Herstart een node

    • Reimage een knoop

    • Schakel taakplanning uit op een node

    • Schakel taakplanning in op een knoop in

    • Schakel een taakschema uit

    • Schakel een werkschema in

    • Beëindig een taakschema

    • Schakel een taak uit

    • Een taak mogelijk maken

    • Beëindig een baan

    • Beëindig een taak

    • Annuleer het verwijderen van een certificaat

Versie 2015-12-01.2.2

Deze versie verlengt alle ondersteuning van de vorige versie, 2015-11-01.2.1. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Applicaties kunnen nu worden uitgerold op rekenknooppunten via applicatiepakketten in plaats van als resourcebestanden.

    • Nieuwe API's worden aangeboden zodat clients de lijst met beschikbare applicaties en versies kunnen doorzoeken, bijvoorbeeld om een selector in een gebruikersinterface weer te geven.

    • Pool-gerelateerde API's worden aangepast zodat een pool applicatiepakketten kan specificeren die naar alle nodes in die pool worden gedownload.

  • Taken kunnen nu afhankelijk worden gemaakt van andere taken. Een afhankelijke taak start pas als alle taken waarop het afhankelijk is, succesvol zijn voltooid.

Deze versie-uitgave bevat de volgende andere wijzigingen:

  • De standaard timeout voor het aanpassen van de pool is veranderd naar 15 minuten.

Versie 2015-11-01.2.1

Deze versierelease breidt alle ondersteuning uit van de vorige versie 2015-06-01.2.0. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Mogelijkheid om multi-instance taken toe te voegen en uit te voeren (bijvoorbeeld MPI)

    • Er wordt een nieuwe optionele eigenschap multiInstanceSettings toegevoegd aan de Taakbron die optioneel kan worden opgenomen in de API's Taak Toevoegen, Taak ophalen, Taken Lijsten.

    • Een nieuwe API-lijst met de subtaken van een taak wordt toegevoegd om informatie over subtaken te verkrijgen.

    • Er wordt een nieuwe optionele eigenschap subtaskId toegevoegd recentTasks voor een Compute Node. Deze eigenschap wordt teruggegeven als onderdeel van Get Compute Node en List Compute Nodes

  • Mogelijkheid om taakplanning op een rekenknooppunt uit te schakelen of in te schakelen

    • Twee nieuwe API's: Task scheduling uitschakelen op een node en Task scheduling op een node inschakelen, worden toegevoegd aan de compute node resource.

    • Er wordt een nieuwe rekenknooptoestand offline toegevoegd. Voor oudere API-versies wordt deze toestand toegewezen aan unusable.

    • Er wordt een nieuwe eigenschap schedulingState toegevoegd aan de resourcewaarde van de rekenknoop. Mogelijke waarden voor enabled en disabled.

  • Mogelijkheid om auto -scale evaluatieinterval op een pool/autopool op te geven

    • Er wordt een nieuw terrein autoScaleEvaluationInterval toegevoegd aan de poolresource. Deze eigenschap kan worden opgenomen in Add Pool, Get Pool, Enable Auto -Scale en List Pools API's.

    • Evenzo wordt bij autopools een nieuw pand autoScaleEvaluationInterval aan autoPoolSpecification het pand toegevoegd. Deze eigenschap kan worden opgenomen in Taken toevoegen, Job ophalen, Taken lijsten, Taken toevoegen toevoegen, Job Schedule ophalen, Job Schedule bijwerken, Job schema's lijsten en Taken lijsten in Job Schedule API's.

  • Verbetering van taak-API's om de rootmap van de taak op de compute-node terug te geven.

    • Twee nieuwe eigenschappen taskRootDirectory worden taskRootDirectoryUrl toegevoegd aan de Taakbron die verkregen kunnen worden als onderdeel van Get Information about a Task, List Tasks API's

    • Er wordt een nieuwe eigenschap taskRootDirectory toegevoegd jobPreparationTaskExecutionInfo en jobReleaseTaskExecutionInfo die kan worden verkregen via List de status van de taken voor taakvoorbereiding en taakvrijgave voor een taak-API.

  • Last updated on