Delen via

Batch Service REST API-versiebeheer

  • Artikel

Bewerkingen die door de REST API van de Batch-service worden geleverd, kunnen meerdere versies hebben voor compatibiliteit met eerdere versies naarmate de API zich in de loop van de tijd ontwikkelt. U moet opgeven welke versie van een bewerking u wilt gebruiken wanneer deze wordt aangeroepen door de versie op te geven bij uw REST-aanroep. Als uw toepassing een oudere versie van een bewerking aanroept, kunt u ervoor kiezen om door te gaan met het aanroepen van de oudere versie of om uw code aan te passen om een nieuwere versie aan te roepen. Als de versie niet is opgegeven of als er een onjuiste versie is opgegeven, wordt er een fout geretourneerd.

Als u wilt opgeven welke versie van een bewerking moet worden gebruikt, stelt u de queryparameter api-versie in. De versie heeft de indeling Group.Major.Minor, waarbij Group de notatie 'JJJJ-MM-DD' heeft en Major een geheel getal is en Secundair een geheel getal.

Nieuwste versie: 2023-05-01.17.0

  • [Brekend] Api voor statistische gegevens over levensduur van batchtaken/pools is verwijderd: lifetimejobstats en lifetimepoolstats.
  • Booleaanse eigenschap enableAcceleratedNetworking toegevoegd aan NetworkConfiguration.
    • Deze eigenschap bepaalt of deze pool versneld netwerken moet inschakelen, met de standaardwaarde False.
    • Of deze functie kan worden ingeschakeld, is ook gerelateerd aan het feit of een besturingssysteem-/VM-exemplaar wordt ondersteund, wat moet worden afgestemd op versneld netwerkbeleid.
  • Booleaanse eigenschap enableAutomaticUpgrade toegevoegd aan VMExtension.
    • Deze eigenschap bepaalt of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.
  • De eigenschap type van ContainerConfiguration, die nu twee waarden ondersteunt: DockerCompatible en CriCompatible.

Vorige versies

Vorige versies zijn onder andere:

Versie: 2022-10-01.16.0

  • NodeCommunicationMode Nieuwe eigenschap toegevoegd die bepaalt hoe een pool communiceert met de Batch-service
  • Er is een nieuwe currentNodeCommunicationMode eigenschap van het NodeCommunicationMode type toegevoegd aan het CloudPool model om te verwijzen naar de huidige status van de communicatiemodus van de pool.
  • targetNodeCommunicationMode Nieuwe eigenschap van het NodeCommunicationMode type toegevoegd aan de volgende modellen om te verwijzen naar de gewenste knooppuntcommunicatiemodus voor de pool:

Versie: 2022-01-01.15.0

Versie: 2021-06-01.14.0

  • Voeg de mogelijkheid toe om door de gebruiker toegewezen beheerde identiteiten toe te wijzen aan CloudPool. Deze identiteiten worden beschikbaar gesteld op elk knooppunt in de pool en kunnen worden gebruikt voor toegang tot verschillende resources.
  • Eigenschap toegevoegd identityReference aan de volgende modellen ter ondersteuning van toegang tot resources via beheerde identiteit:
  • extensions Nieuwe eigenschap toegevoegd aan VirtualMachineConfiguration om extensies voor virtuele machines voor knooppunten op CloudPool te geven
  • De mogelijkheid toegevoegd om beschikbaarheidszones op te geven met behulp van een nieuwe eigenschap nodePlacementConfiguration in VirtualMachineConfiguration
  • osDisk Nieuwe eigenschap toegevoegd aan VirtualMachineConfiguration, die instellingen bevat voor de besturingssysteemschijf van de virtuele machine.
    • De placement eigenschap aan DiffDiskSettings geeft de tijdelijke schijfplaatsing op voor besturingssysteemschijven voor alle VM's in de groep. Als u dit instelt op CacheDisk, wordt de tijdelijke besturingssysteemschijf opgeslagen in de VM-cache.
  • CloudJob Eigenschap toegevoegd maxParallelTasks aan om het maximum aantal taken te bepalen dat tegelijkertijd per taak kan worden uitgevoerd (de standaardwaarde is -1, wat onbeperkt betekent). Deze eigenschap is momenteel in beperkte preview.
  • ComputeNode Eigenschap toegevoegd virtualMachineInfo die informatie bevat over de huidige status van de virtuele machine, inclusief de exacte versie van de Marketplace-installatiekopieën die de VM gebruikt.
  • Eigenschap toegevoegd recurrenceInterval aan Schedule om het interval tussen de begintijden van twee opeenvolgende taken onder een taakplanning te bepalen.

Versie: 2020-09-01.12.0

  • [Brekend] De eigenschap is maxTasksPerNodetaskSlotsPerNode vervangen door in de pool. Het gebruik van deze eigenschapstaken in een taak kan een dynamisch aantal sleuven verbruiken, waardoor er meer nauwkeurige controle over het resourceverbruik mogelijk is.
  • [Brekend] Het antwoordtype is GetTaskCounts gewijzigd om te retourneren TaskCountsResult. Dit is een complex object met het vorige TaskCounts object en een nieuw TaskSlotCounts object dat vergelijkbare informatie biedt in de context van de gebruikte sites.
  • requiredSlots Eigenschap toegevoegd aan de taak, zodat de gebruiker kan opgeven hoeveel sleuven op een knooppunt moeten worden gebruikt.

Versie: 2020-03-01.11.0

Versie: 2019-08-01.10.0

  • De mogelijkheid toegevoegd om een verzameling openbare IP-adressen op NetworkConfiguration te geven via de nieuwe publicIPs eigenschap in de pool. Dit garandeert dat knooppunten in de pool een IP-adres hebben uit de lijst met door de gebruiker opgegeven IP-adressen.
  • Mogelijkheid toegevoegd om externe bestandssystemen te koppelen aan elk knooppunt van een pool via de MountConfiguration eigenschap.
  • Shared Image Gallery installatiekopieën kunnen nu worden opgegeven op de virtualMachineImageId eigenschap van ImageReference door te verwijzen naar de installatiekopieën via de Azure Resource Manager-id.
  • [Brekend] Wanneer dit niet is opgegeven, is de standaardwaarde voor waitForSuccess aan StartTask (voorheen was falsetrue dit ).
  • [Brekend] Wanneer dit niet is opgegeven, is de standaardwaarde voor scope aan nu altijd Pool (voorheen op Task Windows-knooppunten en Pool op Linux-knooppuntenAutoUserSpecification).
  • Diverse verwarrende of onvolledige documenten verbeterd.

Versie: 2019-06-01.9.0

  • [Brekend] Vervangen ListNodeAgentSKUs door ListSupportedImages. ListSupportedImages bevat dezelfde informatie die oorspronkelijk beschikbaar was in ListNodeAgentSKUs maar in een duidelijkere indeling. Nieuwe, niet-geverifieerde afbeeldingen worden nu ook geretourneerd. Aanvullende informatie over Capabilities en BatchSupportEndOfLife is toegankelijk via ImageInformation.

  • Ondersteuning voor netwerkbeveiligingsregels die netwerktoegang tot een CloudPool blokkeren op basis van de bronpoort van het verkeer. Dit wordt gerealiseerd via de eigenschap SourcePortRanges in NetworkSecurityGroupRule.

  • Bij het uitvoeren van een container ondersteunt Batch nu uitvoering van de taak in de werkmap van de container of in de werkmap van de Batch-taak. Dit wordt bepaald door de eigenschap WorkingDirectory in TaskContainerSettings.

  • Diverse verwarrende of onvolledige documenten verbeterd.

Versie: 2018-12-01.8.0

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

    • Verwijderd upgradeos.
    • De naam is gewijzigd targetOSVersion in osVersion en verwijderd currentOSVersion op CloudPool.
    • upgrading is verwijderd uit PoolState.

  • [Brekend]dataIngressGiB En verwijderd dataEgressGiB uit poolusagemetrics. Deze eigenschappen worden niet meer ondersteund.

  • [Brekend]ResourceFile Verbeteringen

    • De mogelijkheid is toegevoegd om een hele Azure Storage-container op te geven in ResourceFile. Er zijn nu drie ondersteunde modi voor ResourceFile:
      • httpUrl maakt een ResourceFile verwijzing naar één HTTP-URL.
      • storageContainerUrlhiermee maakt u een ResourceFile verwijzing naar een Azure Blob Storage container.
      • autoStorageContainerNamehiermee maakt u een ResourceFile verwijzing naar een Azure Blob Storage container in het door Batch geregistreerde automatische opslagaccount.
    • URL's die via de httpUrl methode worden opgegevenResourceFile, kunnen nu elke HTTP-URL zijn. Voorheen moest dit een Azure Blob Storage URL zijn.
    • blobPrefix kan worden gebruikt om downloads van een opslagcontainer te filteren op alleen downloads die overeenkomen met het voorvoegsel.

  • [Fouten] De eigenschap is verwijderd osDisk uit VirtualMachineConfiguration. Deze eigenschap wordt niet meer ondersteund.

  • Pools die de dynamicVNetAssignmentScope op NetworkConfiguration instellen, kunnen nu dynamisch een Virtual Network toewijzen aan elk knooppunt waarop de taken van de taak worden job uitgevoerd. De specifieke Virtual Network om de knooppunten aan toe te voegen, wordt opgegeven in de nieuwe JobNetworkConfiguration eigenschap op CloudJob en JobSpecification.

    Notitie

    Deze functie is beschikbaar voor openbare preview. Het is uitgeschakeld voor alle Batch-accounts, met uitzondering van degenen die contact met ons hebben opgenomen en hebben gevraagd om mee te doen aan de pilot.

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

  • Ondersteuning toegevoegd voor Windows-pools voor het maken van gebruikers met een specifieke aanmeldingsmodus (of batchinteractive) via LoginMode.

  • De standaardretentietijd voor alle taken is nu 7 dagen, voorheen was deze 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 eigenschap NodeAgentInfo op ComputeNode.
  • De mogelijkheid toegevoegd om een Filter op te geven op de Result van een taak. Klik hier voor meer informatie.
    • Dit maakt het vaak aangevraagde scenario van het uitvoeren van een query aan de serverzijde mogelijk om alle mislukte taken te vinden.
  • [Fouten]ValidationStatus De eigenschap is verwijderd uit TaskCounts.
  • [Fouten] Het standaardcachetype voor DataDisk en OSDisk is nu ReadWrite in plaats van None.
  • [Fouten] De naam van de enige waarde van ContainerType is gewijzigd in dockerdockerCompatible.

Versie 2018-03-01.6.1

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

  • Aantal poolknooppunten per status: met deze versie wordt de mogelijkheid toegevoegd om het aantal poolknooppunten op te vragen per status, via de nieuwe bewerking ListPoolNodeCounts . Met deze bewerking kunt u query's uitvoeren op alle pools in een Batch-account voor knooppuntstatussen, waaronder het maken, niet-actief, offline, vooraf gekozen, opnieuw opstarten, opnieuw instellen, starten en andere.
  • Agentlogboeken voor knooppunten: deze versie voegt de mogelijkheid toe om Azure Batch knooppuntagentlogboeken van een bepaald knooppunt te uploaden via de bewerking UploadBatchServiceLogs. Dit is bedoeld voor gebruik bij foutopsporing door Microsoft Ondersteuning als er problemen optreden op een knooppunt.

Versie 2017-09-01.6.0

  • Azure Hybrid Use Benefit: u kunt nu Batch Windows VM-pools maken die aangeven dat Azure Hybrid Use Benefit-licenties moeten worden gebruikt. Wanneer deze licentie wordt gebruikt, wordt er korting toegepast op de vm-prijs. Gebruik de nieuwe eigenschap LicenseType in VirtualMachineConfiguration.

  • Vm-gegevensschijven groeperen: u kunt een of meer lege gegevensschijven koppelen aan VM-pools met behulp van de nieuwe gegevensschijfconfiguratie die deel uitmaakt van de configuratie van de virtuele machine. Gebruik de eigenschap DataDisks in VirtualMachineConfiguration.

  • (Wijziging die fouten veroorzaakt) Aangepaste installatiekopieën worden nu gemaakt en geïmplementeerd met behulp van Azure Resource Manager-installatiekopieresources in plaats van blob-VHD-bestanden. Batch maakt nu gebruik van beheerde schijven om de vm's van de groep te maken en maakt daarom gebruik van een installatiekopieënresource. Er is nu geen limiet voor het aantal VM's in een pool die is gemaakt met behulp van een aangepaste installatiekopieën; Ook zijn meerdere kopieën van de VHD-blob voor grote pools niet meer vereist. Aangepaste installatiekopieën zijn daarom veel eenvoudiger te maken en te schalen. Zie Een aangepaste installatiekopieën gebruiken om een groep virtuele machines te maken voor meer informatie.

  • (Wijziging die fouten veroorzaakt) Taken met meerdere exemplaren (gemaakt met MultiInstanceSettings) moeten nu CoordinationCommandLine opgeven en NumberOfInstances is nu optioneel en is standaard ingesteld op 1.

  • Ondersteuning toegevoegd voor taken die worden uitgevoerd met Behulp van Docker-containers. Als u een taak wilt uitvoeren met een Docker-container, moet u een ContainerConfiguration opgeven in de VirtualMachineConfiguration voor een pool en vervolgens TaskContainerSettings toevoegen aan de taak.

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, indien mogelijk.

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

  • Ondersteuning voor efficiënte taaktellingen via de nieuwe bewerking Get Task Counts . Door de bewerking Get Task Counts (Get Task Counts) aan te roepen, kunt u het aantal actieve, actieve en voltooide taken en de taken die zijn geslaagd of mislukt, ophalen. Zie Taken voor een taak tellen op status (preview) voor meer informatie.
  • Ondersteuning voor het opgeven van binnenkomende eindpunten op rekenknooppunten van de pool, via de nieuwe eigenschap poolEndpointConfiguration . Door deze eigenschap in te stellen, kunt u specifieke poorten op het knooppunt extern adresseren.

Versie 2017-05-01.5.0

De volgende secties bevatten een overzicht van nieuwe en gewijzigde functies in versie 2017-05-01.5.0.

Belangrijk

Versie 2017-05-01.5.0 bevat verschillende wijzigingen die fouten veroorzaken. Bekijk de onderstaande wijzigingen die fouten veroorzaken en werk uw code bij om versie 2017-05-01.5.0 aan te roepen.

Rekenknooppunten met lage prioriteit

Azure Batch biedt nu rekenknooppunten met lage prioriteit om de kosten van Batch-workloads te verlagen. Vm's met lage prioriteit maken nieuwe typen Batch-workloads mogelijk door een grote hoeveelheid rekenkracht te bieden die ook voordelig is.

Er zijn verschillende wijzigingen in de REST API voor knooppunten met lage prioriteit:

  • (Wijziging die fouten veroorzaakt) De eigenschappen targetDedicated en currentDedicated van een pool of poolspecificatie zijn gewijzigd in targetDedicatedNodes en currentComputeNodes.
  • (Wijziging die fouten veroorzaakt) De eigenschap resizeError van een pool is nu een verzameling met de naam resizeErrors.
  • Rekenknooppunten hebben een nieuwe eigenschap isDedicated . Deze eigenschap is waar voor toegewezen knooppunten en onwaar voor knooppunten met lage prioriteit.
  • Een Taakbeheerder heeft een nieuwe eigenschap allowLowPriorityNode . Als deze eigenschap waar is, kan de taak Taakbeheer worden uitgevoerd op een knooppunt met lage prioriteit. Als deze onwaar is, wordt de taak Taakbeheer uitgevoerd op een toegewezen rekenknooppunt.

Benoemde gebruikers in Linux

Azure Batch biedt nu extra ondersteuning voor het maken van benoemde gebruikers op Linux-knooppunten.

  • De nieuwe eigenschap linuxUserConfiguration ondersteunt het opgeven van een uid (gebruikers-id) en gid (groeps-id) bij het maken van een Linux-gebruiker.
  • (Wijziging die fouten veroorzaakt) De eigenschap sshPrivateKey is verplaatst van de eigenschap userAccount naar de nieuwe eigenschap linuxUserConfiguration . De eigenschap linuxUserConfiguration is zelf een eigenschap van de eigenschap userAccount .

Zie Taken uitvoeren onder gebruikersaccounts in Batch voor meer informatie over benoemde gebruikersaccounts.

Uitvoerbestanden voor taakgegevens

U kunt nu uitvoerbestanden opgeven om taakgegevens te uploaden nadat een taak is voltooid.

  • De nieuwe eigenschap outputFiles ondersteunt het opgeven van taakbestanden die moeten worden geüpload naar Azure Storage.
  • De nieuwe eigenschap fileUploadError van de eigenschap exitConditions ondersteunt het opgeven van acties die moeten worden uitgevoerd op basis van de uploadstatus van een uitvoerbestand.

Rapportage van taakfouten

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

  • De nieuwe resultaateigenschap van de eigenschap executionInfo geeft aan of een taak is geslaagd of mislukt.
  • (Wijziging die fouten veroorzaakt) De eigenschap schedulingError van de eigenschap executionInfo is hernoemd naar failureInfo. De eigenschap failureInfo wordt geretourneerd wanneer er een taakfout optreedt. Dit omvat alle eerdere planningsfouten, alle gevallen waarin een afsluitcode voor een niet-nultaak wordt geretourneerd en eventuele fouten bij het uploaden van bestanden.
  • (Wijziging die fouten veroorzaakt) De eigenschap schedulingError van de eigenschap exitConditions is hernoemd in preProcessingError om te verduidelijken wanneer de fout is opgetreden in de levenscyclus van de taak.
  • (Wijziging die fouten veroorzaakt) De naam van de eigenschap schedulingErrorCateogry is gewijzigd in errorCategory.

Toepassingslicenties

U kunt nu aanvragen dat toepassingslicenties worden ingericht voor uw groep, via de nieuwe eigenschap applicationLicenses voor 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 opgegeven gebruikersidentiteit.

    U kunt nu een taak of taakverzameling uitvoeren onder een van de volgende gebruikersidentiteiten, die zijn opgegeven via de nieuwe eigenschap userIdentity in de taakresource:

    • Een gebruikersaccount met een naam die u definieert.

    • Een gebruikersaccount dat automatisch wordt gemaakt (een automatische gebruiker). Een automatische gebruiker kan worden uitgevoerd als een gebruiker met beheerdersrechten of als een niet-gebruiker met beheerdersrechten. Een automatische gebruiker wordt standaard uitgevoerd als een gebruiker zonder beheerdersrechten.

      Belangrijk

      De eigenschap userIdentity , met de eigenschap elevationLevel , vervangt de eigenschap runElevated in aanvragen die een taak of een taakverzameling toevoegen, en in antwoorden die informatie ophalen over een taak of een lijst met taken.

      Als u een aanvraag indient die de eigenschap runElevated naar versie 2017-01-01.4.0 van de Batch-service bevat, mislukt de aanvraag.

      Als u wilt uitvoeren als gebruiker met beheerdersrechten, werkt u de toepassing bij om de eigenschap userIdentity te gebruiken en stelt u de eigenschap elevationLevel in op admin.

      Als u wilt uitvoeren als een gebruiker zonder beheerdersrechten, werkt u de toepassing bij om de eigenschap userIdentity te gebruiken en stelt u de eigenschap elevationLevel in op nonAdmin. Omdat dit de standaardinstelling is, kunt u de instelling ook weglaten.

  • Gebruikersaccounts definiëren op alle knooppunten in een pool.

    U kunt nu een taak of taakverzameling uitvoeren onder een gebruikersaccount dat u definieert voor de poolresource. Definieer een gebruikersaccount via de nieuwe eigenschap userAccounts in aanvragen om pool toe te voegen. Wanneer u het account definieert, kunt u de accountnaam, het wachtwoord, het uitbreidingsniveau (beheerder of niet-beheerder) en de persoonlijke SSH-sleutel (voor Linux-pools) opgeven.

    Zodra u het gebruikersaccount hebt gedefinieerd, kunt u dat gebruikersaccount opgeven voor de eigenschap userIdentity in aanvragen die een taak of een taakverzameling toevoegen.

  • Geef een taak op met een token om te verifiëren bij de Batch-service wanneer de taak wordt uitgevoerd.

    De Batch-service kan nu een verificatietoken leveren aan een taak wanneer deze wordt uitgevoerd. Met het verificatietoken kan een taak aanvragen met betrekking tot de taak verzenden naar de Batch-service, zonder de Batch-accountsleutels. Het token wordt geleverd via de omgevingsvariabele AZ_BATCH_AUTHENTICATION_TOKEN.

    Momenteel worden verificatietokens alleen ondersteund voor aanroepbewerkingen op de taakresource. Het verificatietoken verleent toegang tot alle bewerkingen op de taak die de taak bevat.

    Als u wilt dat de Batch-service het verificatietoken levert, geeft u de nieuwe eigenschap authenticationTokenSettings op, samen met de bijbehorende toegangseigenschap , in aanvragen voor Taak toevoegen of Taakverzameling toevoegen.

  • Geef een actie op die moet worden uitgevoerd op de afhankelijkheden van een taak als de taak mislukt.

    U kunt nu opgeven dat afhankelijke taken worden uitgevoerd, zelfs als de taak die ze afhankelijk zijn, mislukt. Stel de nieuwe dependencyAction-eigenschap van een taakresource in om afhankelijke taken uit te voeren, zelfs als de bovenliggende taak mislukt. U kunt ook dependencyAction instellen op blokkeren om te voorkomen dat afhankelijke taken worden uitgevoerd als de bovenliggende taak mislukt.

    Geef de eigenschap dependencyAction op in aanvragen voor Taak toevoegen of Taakverzameling toevoegen.

    Zie Afhankelijkheidsacties voor meer informatie over het gebruik van afhankelijkheidsacties.

  • Gebruik aangepaste installatiekopieën van besturingssysteemschijven bij het maken van een groep.

    U kunt nu aangepaste installatiekopieën van besturingssysteemschijven gebruiken om een groep te maken.

    Hiervoor moet u bij het maken van uw Batch-account opgeven dat pools moeten worden ingericht in het gebruikersabonnement, in plaats van in een abonnement dat wordt beheerd door de Batch-service. Stel in een aanroep van Account maken de eigenschap poolAllocationMode in op UserSubscription. Gebruik vervolgens de eigenschap osDisk om een verwijzing naar een schijfinstallatiekopieën op te geven in een aanvraag om groep toe te voegen.

    Belangrijk

    Wanneer u uw Batch-account maakt en opgeeft dat pools moeten worden ingericht in het gebruikersabonnement, moet u verificatie op basis van Azure Active Directory gebruiken voor alle aanvragen die via dat account worden gedaan.

  • Gebruik verificatie op basis van Azure Active Directory voor aanvragen voor de Batch-service.

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

    Als uw Batch-account is ingesteld voor het inrichten van groepen in het gebruikersabonnement, is het gebruik van Azure AD verificatie vereist.

Versie 2016-07-01.3.1

Deze versieversie breidt alle ondersteuning uit van eerdere versie, 2016-02-01.3.0. Daarnaast ondersteunt het de volgende mogelijkheden:

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

    • Er is een nieuwe eigenschapsnetwerkConfiguratie toegevoegd aan zowel de pool- als autopoolresources. Deze eigenschap kan worden gebruikt om de netwerkconfiguratie van de pool op te geven, zoals het subnet waarin de rekenknooppunten van de pool worden gemaakt.

  • Een taak automatisch beëindigen wanneer alle taken zijn voltooid.

    • Er is een nieuwe eigenschap onAllTasksComplete toegevoegd aan de taakresource. U kunt dit opgeven wanneer u een taak maakt of bijwerkt.

  • Een taak automatisch beëindigen of uitschakelen wanneer een taak mislukt.

    • Er is een nieuwe eigenschap onTaskFailure toegevoegd aan de taakresource en er is een nieuwe eigenschap exitConditions toegevoegd aan de taakresource. De instelling taak onTaskFailure geeft aan of taakfouten gevolgen op taakniveau kunnen hebben en met de eigenschap exitConditions kunnen taken de impact op taakniveau aanpassen aan de aard van de fout.

  • Koppel toepassingspakketten aan taken en pools.

    • Er is een nieuwe eigenschap applicationPackageReferences toegevoegd aan de taakresource en aan de job jobManagerTask-instellingen. Hierdoor kunnen toepassingspakketten op aanvraag worden geïmplementeerd als ze voor taken nodig zijn in plaats van dat ze moeten worden opgegeven tijdens het maken van de pool. Dit is met name nuttig voor pools met een lange levensduur die kunnen worden aangeroepen om verschillende soorten taken of verschillende toepassingsversies uit te voeren gedurende hun levensduur, of als u een groot toepassingspakket hebt dat niet voor alle taken vereist is.

  • Mogelijkheid om een mislukte taak opnieuw te activeren.

    • Er is een nieuwe bewerking Een taak opnieuw activeren toegevoegd om de status van een mislukte taak terug te zetten op actief. Hierdoor kunnen fouten opnieuw worden geprobeerd, bijvoorbeeld als de fout tijdelijk was of als u de oorzaak van de fout hebt kunnen oplossen zonder de taak opnieuw te maken.

Versie 2016-02-01.3.0

Deze versieversie breidt alle ondersteuning uit van eerdere versie, 2015-12-01.2.2. Daarnaast ondersteunt het de volgende mogelijkheden:

Versie 2015-12-01.2.2

Deze versierelease breidt alle ondersteuning uit van eerdere versie, 2015-11-01.2.1. Daarnaast ondersteunt het de volgende mogelijkheden:

  • Toepassingen kunnen nu worden geïmplementeerd op rekenknooppunten met behulp van toepassingspakketten in plaats van als resourcebestanden.

    • Er zijn nieuwe API's beschikbaar voor clients om door de lijst met beschikbare toepassingen en versies te bladeren, bijvoorbeeld om een selector weer te geven in een gebruikersinterface.

    • Pool-gerelateerde API's worden gewijzigd zodat een groep toepassingspakketten kan opgeven die moeten worden gedownload naar alle knooppunten in die pool.

  • Taken kunnen nu afhankelijk worden gemaakt van andere taken. Een afhankelijke taak wordt pas gestart als alle taken die afhankelijk zijn, zijn voltooid.

Deze versierelease bevat de volgende andere wijzigingen:

  • De standaard time-out voor het wijzigen van het formaat van de groep is gewijzigd in 15 minuten.

Versie 2015-11-01.2.1

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

  • Mogelijkheid om een taak met meerdere exemplaren toe te voegen en uit te voeren (bijvoorbeeld MPI)

    • Er wordt een nieuwe optionele eigenschap 'multiInstanceSettings' toegevoegd aan de taakresource die optioneel kan worden opgenomen in DE API's Taak toevoegen, Taak ophalen en Taken weergeven.

    • 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 aan 'recentTasks' voor een rekenknooppunt. Deze eigenschap wordt geretourneerd als onderdeel van Rekenknooppunt ophalen en Rekenknooppunten weergeven

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

    • Twee nieuwe API's Taakplanning uitschakelen op een knooppunt en Taakplanning inschakelen voor een knooppunt worden toegevoegd aan de resource van het rekenknooppunt.

    • Er wordt een nieuwe status van het rekenknooppunt 'offline' toegevoegd. Voor oudere API-versies is deze status toegewezen aan 'onbruikbaar'.

    • Er wordt een nieuwe eigenschap 'schedulingState' toegevoegd aan de resource van het rekenknooppunt. Mogelijke waarden voor 'ingeschakeld' en 'uitgeschakeld'.

  • Mogelijkheid om evaluatie-interval voor automatisch schalen op te geven in een pool/autopool

    • Er wordt een nieuwe eigenschap 'autoScaleEvaluationInterval' toegevoegd aan de poolresource. Deze eigenschap kan worden opgenomen in de API's Pool toevoegen, Groep ophalen, Automatisch schalen inschakelen en Pools weergeven.

    • Op dezelfde manier wordt voor automatische pools een nieuwe eigenschap 'autoScaleEvaluationInterval' toegevoegd aan de eigenschap 'autoPoolSpecification'. Deze eigenschap kan worden opgenomen in Taak toevoegen, Taak ophalen, Taken weergeven, Taakplanning toevoegen, Taakplanning ophalen, Taakplanning bijwerken, Taakschema's weergeven en Taken vermelden in taakplanning API's.

  • Uitbreiding van taak-API's om de hoofdmap van de taak op het rekenknooppunt te retourneren.

    • Er zijn twee nieuwe eigenschappen 'taskRootDirectory' en 'taskRootDirectoryUrl' toegevoegd aan de taakresource die kunnen worden verkregen als onderdeel van Informatie over een taak ophalen, TAKEN-API's weergeven

    • Er wordt een nieuwe eigenschap 'taskRootDirectory' toegevoegd aan 'jobPreparationTaskExecutionInfo' en 'jobReleaseTaskExecutionInfo' die kan worden verkregen via De status van de taakvoorbereidings- en jobreleasetaken voor een taak-API weergeven.