Jobs - Create Job
Maakt een job aan voor het opgegeven account.
De Batch-service ondersteunt twee manieren om het werk dat als onderdeel van een Job wordt uitgevoerd te controleren.
In de eerste benadering specificeert de gebruiker een Taakbeheertaak. De Batch-service start deze taak wanneer hij klaar is om de taak te starten. De Taakbeheer-taak beheert alle andere taken die onder deze taak draaien, door gebruik te maken van de Taak-API's. In de tweede benadering bestuurt de gebruiker direct de uitvoering van taken onder een actieve taak, door gebruik te maken van de Taak-API's. Let ook op: bij het benoemen van banen moet je gevoelige informatie vermijden zoals gebruikersnamen of geheime projectnamen.
Deze informatie kan worden weergegeven in telemetrielogboeken die toegankelijk zijn voor Microsoft Ondersteuningstechnici.
POST {endpoint}/jobs?api-version=2025-06-01
POST {endpoint}/jobs?api-version=2025-06-01&timeOut={timeOut}
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com). |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
|
time
|
query |
integer (int32) |
De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt." |
Aanvraagkoptekst
Media Types: "application/json; odata=minimalmetadata"
| Name | Vereist | Type | Description |
|---|---|---|---|
| client-request-id |
string |
De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
| return-client-request-id |
boolean |
Of de server de clientaanvraag-id in het antwoord moet retourneren. |
|
| ocp-date |
string (date-time-rfc7231) |
Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept. |
Aanvraagbody
Media Types: "application/json; odata=minimalmetadata"
| Name | Vereist | Type | Description |
|---|---|---|---|
| id | True |
string |
Een tekenreeks waarmee de taak in het account uniek wordt geïdentificeerd. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is niet hoofdlettergevoelig en niet hoofdlettergevoelig (u hebt mogelijk geen twee id's binnen een account die alleen per geval verschillen). |
| poolInfo | True |
De pool waarop de Batch-service de taken van de taak uitvoert. |
|
| allowTaskPreemption |
boolean |
Of taken in deze taak kunnen worden verschoven door andere taken met hoge prioriteit. (Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) Als de waarde is ingesteld op True, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden, voorrang en kunnen taken van deze taak opnieuw in de wachtrij worden geplaatst. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. |
|
| commonEnvironmentSettings |
De lijst met algemene omgevingsvariabeleinstellingen. Deze omgevingsvariabelen worden ingesteld voor alle taken in de taak (inclusief jobbeheer, jobvoorbereiding en jobreleasetaken). Afzonderlijke taken kunnen een omgevingsinstelling die hier is opgegeven overschrijven door dezelfde instellingsnaam met een andere waarde op te geven. |
||
| constraints |
De uitvoeringsbeperkingen voor de taak. |
||
| displayName |
string |
De weergavenaam voor de taak. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. |
|
| jobManagerTask |
Details van een Job Manager-taak die moet worden gestart wanneer de taak wordt gestart. Als de taak geen Job Manager-taak opgeeft, moet de gebruiker expliciet taken toevoegen aan de taak. Als de taak wel een Job Manager-taak opgeeft, maakt de Batch-service de Job Manager-taak wanneer de taak wordt gemaakt en probeert de Job Manager-taak te plannen voordat andere taken in de taak worden gepland. Het typische doel van de Job Manager-taak is het beheren en/of bewaken van taakuitvoering, bijvoorbeeld door te bepalen welke extra taken moeten worden uitgevoerd, te bepalen wanneer het werk is voltooid, enzovoort. (Een Job Manager-taak is echter niet beperkt tot deze activiteiten- het is een volwaardige taak in het systeem en het uitvoeren van de acties die nodig zijn voor de taak.) Een Job Manager-taak kan bijvoorbeeld een bestand downloaden dat is opgegeven als parameter, de inhoud van dat bestand analyseren en aanvullende taken verzenden op basis van die inhoud. |
||
| jobPreparationTask |
De jobvoorbereidingstaak. Als een taak een taakvoorbereidingstaak heeft, voert de Batch-service de jobvoorbereidingstaak uit op een knooppunt voordat u taken van die taak op dat rekenknooppunt start. |
||
| jobReleaseTask |
De taak voor het vrijgeven van de taak. Een jobreleasetaak kan niet worden opgegeven zonder ook een taakvoorbereidingstaak voor de taak op te geven. De Batch-service voert de jobreleasetaak uit op de knooppunten waarop de jobvoorbereidingstaak is uitgevoerd. Het primaire doel van de jobreleasetaak is het ongedaan maken van wijzigingen in rekenknooppunten die door de jobvoorbereidingstaak zijn aangebracht. Voorbeelden van activiteiten zijn het verwijderen van lokale bestanden of het afsluiten van services die zijn gestart als onderdeel van jobvoorbereiding. |
||
| maxParallelTasks |
integer (int32) |
Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. (Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De waarde van maxParallelTasks moet -1 of groter zijn dan 0, indien opgegeven. Als dit niet is opgegeven, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat tegelijk kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. |
|
| metadata |
Een lijst met naam-waardeparen die zijn gekoppeld aan de taak als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. |
||
| networkConfiguration |
(Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De netwerkconfiguratie voor de taak. |
||
| onAllTasksComplete |
De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. Houd er rekening mee dat als een taak geen taken bevat, alle taken als voltooid worden beschouwd. Deze optie wordt daarom meestal gebruikt met een Job Manager-taak; Als u automatische beëindiging van taken zonder Job Manager wilt gebruiken, moet u in eerste instantie opAllTasksComplete instellen op noaction en de eigenschappen van de taak bijwerken zodat deze opAllTasksComplete zijn ingesteld om de taak te beëindigen zodra u klaar bent met het toevoegen van taken. De standaardwaarde is noaction. |
||
| onTaskFailure |
De actie die de Batch-service moet uitvoeren wanneer een taak in de taak mislukt. Een taak wordt beschouwd als mislukt als er een failureInfo is. Er wordt een failureInfo ingesteld als de taak is voltooid met een afsluitcode die niet nul is voltooid nadat het aantal nieuwe pogingen is uitgeput of als er een fout is opgetreden bij het starten van de taak, bijvoorbeeld vanwege een fout bij het downloaden van een resourcebestand. De standaardwaarde is noaction. |
||
| priority |
integer (int32) |
De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit is. De standaardwaarde is 0. |
|
| usesTaskDependencies |
boolean |
Of taken in de taak afhankelijkheden op elkaar kunnen definiëren. De standaardwaarde is onwaar. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 201 Created |
De aanvraag is geslaagd en er is een nieuwe resource gemaakt. Kopteksten
|
|
| Other Status Codes |
Een onverwachte foutreactie. |
Beveiliging
OAuth2Auth
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Bereiken
| Name | Description |
|---|---|
| https://batch.core.windows.net//.default |
Voorbeelden
| Creates a basic job |
| Creates a complex job |
Creates a basic job
Voorbeeldaanvraag
POST {endpoint}/jobs?api-version=2025-06-01
{
"id": "jobId",
"priority": 0,
"poolInfo": {
"poolId": "poolId"
}
}
Voorbeeldrespons
Creates a complex job
Voorbeeldaanvraag
POST {endpoint}/jobs?api-version=2025-06-01
{
"id": "jobId",
"priority": 100,
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": -1
},
"jobManagerTask": {
"id": "taskId",
"commandLine": "myprogram.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
"filePath": "myprogram.exe"
},
{
"storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
"filePath": "datafolder"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"constraints": {
"maxWallClockTime": "PT1H",
"maxTaskRetryCount": 0,
"retentionTime": "PT1H"
},
"requiredSlots": 2,
"killJobOnCompletion": false,
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"runExclusive": true
},
"poolInfo": {
"autoPoolSpecification": {
"autoPoolIdPrefix": "mypool",
"poolLifetimeOption": "job",
"pool": {
"vmSize": "Standard_D2ds_v5",
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2025-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"nodePlacementConfiguration": {
"policy": "zonal"
}
},
"resizeTimeout": "PT15M",
"targetDedicatedNodes": 3,
"targetLowPriorityNodes": 0,
"taskSlotsPerNode": 2,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"enableAutoScale": false,
"enableInterNodeCommunication": true,
"startTask": {
"commandLine": "myprogram2.exe",
"resourceFiles": [
{
"httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
"filePath": "myprogram2.exe"
}
],
"environmentSettings": [
{
"name": "myvariable",
"value": "myvalue"
}
],
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "admin"
}
},
"maxTaskRetryCount": 2,
"waitForSuccess": true
},
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
}
},
"metadata": [
{
"name": "myproperty",
"value": "myvalue"
}
]
}
Voorbeeldrespons
Definities
| Name | Description |
|---|---|
|
Authentication |
De instellingen voor een verificatietoken dat de taak kan gebruiken om Batch-servicebewerkingen uit te voeren. |
|
Automatic |
De configuratieparameters die worden gebruikt voor het uitvoeren van automatische upgrade van het besturingssysteem. |
|
Auto |
AutoUserScope enums |
|
Auto |
Hiermee geeft u de opties voor de automatische gebruiker die een Azure Batch-taak uitvoert. |
|
Azure |
Informatie die wordt gebruikt om verbinding te maken met een Azure Storage-container met behulp van Blobfuse. |
|
Azure |
Informatie die wordt gebruikt om verbinding te maken met een Azure Fileshare. |
|
Batch |
BatchAccessScope-enums |
|
Batch |
De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. |
|
Batch |
Een verwijzing naar een pakket dat moet worden geïmplementeerd op rekenknooppunten. |
|
Batch |
Hiermee geeft u kenmerken voor een tijdelijke 'automatische pool'. De Batch-service maakt deze automatische pool wanneer de taak wordt verzonden. |
|
Batch |
De configuratie voor pools waarvoor containers zijn ingeschakeld. |
|
Batch |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die wordt gebruikt door het rekenknooppunt (VM). |
|
Batch |
Er is een foutbericht ontvangen van de Azure Batch-service. |
|
Batch |
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie. |
|
Batch |
Een foutbericht dat is ontvangen in een Azure Batch-foutreactie. |
|
Batch |
Een binnenkomende NAT-pool die kan worden gebruikt om specifieke poorten op rekenknooppunten in een batchgroep extern aan te pakken. |
|
Batch |
De uitvoeringsbeperkingen voor een taak. |
|
Batch |
Parameters voor het maken van een Azure Batch-taak. |
|
Batch |
BatchJobDefaultOrder-enums |
|
Batch |
Hiermee geeft u details van een Job Manager-taak. De Job Manager-taak wordt automatisch gestart wanneer de taak wordt gemaakt. De Batch-service probeert de Job Manager-taak te plannen vóór andere taken in de taak. Wanneer u een pool verkleint, probeert de Batch-service knooppunten te behouden waarop Job Manager-taken zo lang mogelijk worden uitgevoerd (rekenknooppunten waarop normale taken worden uitgevoerd, worden verwijderd voordat rekenknooppunten jobbeheertaken worden uitgevoerd). Wanneer een Job Manager-taak mislukt en opnieuw moet worden opgestart, probeert het systeem deze op de hoogste prioriteit te plannen. Als er geen niet-actieve rekenknooppunten beschikbaar zijn, kan het systeem een van de actieve taken in de pool beëindigen en terugkeren naar de wachtrij om ruimte te maken voor de Taakbeheertaak om opnieuw te starten. Houd er rekening mee dat een Job Manager-taak in de ene taak geen prioriteit heeft ten opzichte van taken in andere taken. In alle taken worden alleen prioriteiten op taakniveau waargenomen. Als een Job Manager in een taak met prioriteit 0 bijvoorbeeld opnieuw moet worden gestart, worden taken van een taak met prioriteit 1 niet verplaatst. Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. |
|
Batch |
(Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De netwerkconfiguratie voor de taak. |
|
Batch |
Een taakvoorbereidingstaak die moet worden uitgevoerd voordat taken van de taak op een bepaald rekenknooppunt worden uitgevoerd. U kunt jobvoorbereiding gebruiken om een knooppunt voor te bereiden om taken voor de taak uit te voeren. Activiteiten die vaak worden uitgevoerd in taakvoorbereiding zijn onder andere: algemene resourcebestanden downloaden die door alle taken in de taak worden gebruikt. De taakvoorbereidingstaak kan deze algemene resourcebestanden downloaden naar de gedeelde locatie op het knooppunt. (AZ_BATCH_NODE_ROOT_DIR\shared) of start een lokale service op het knooppunt, zodat alle taken van die taak ermee kunnen communiceren. Als de taakvoorbereidingstaak mislukt (dat wil gezegd, wordt het aantal nieuwe pogingen uitgeput voordat u afsluit met afsluitcode 0), voert Batch taken van deze taak niet uit op het knooppunt. Het rekenknooppunt blijft niet in aanmerking om taken van deze taak uit te voeren totdat deze opnieuw wordt geinstallatiekopie gemaakt. Het rekenknooppunt blijft actief en kan worden gebruikt voor andere taken. De taakvoorbereidingstaak kan meerdere keren worden uitgevoerd op hetzelfde knooppunt. Daarom moet u de jobvoorbereidingstaak schrijven om de heruitvoering af te handelen. Als het knooppunt opnieuw wordt opgestart, wordt de jobvoorbereidingstaak opnieuw uitgevoerd op het rekenknooppunt voordat u een andere taak van de taak plant, als opnieuw uitvoerenOnNodeRebootAfterSuccess waar is of als de taakvoorbereidingstaak nog niet eerder is voltooid. Als het knooppunt opnieuw wordt gemaakt, wordt de taakvoorbereidingstaak opnieuw uitgevoerd voordat u een taak van de taak plant. Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. |
|
Batch |
Een jobreleasetaak die moet worden uitgevoerd op taakvoltooiing op elk rekenknooppunt waarop de taak is uitgevoerd. De jobreleasetaak wordt uitgevoerd wanneer de taak eindigt, vanwege een van de volgende: De gebruiker roept de Taak-API beëindigen aan of de Taak-API verwijderen terwijl de taak nog actief is, de maximale tijdslimiet voor de klok van de taak is bereikt en de taak nog steeds actief is, of de Job Manager-taak is voltooid en de taak is geconfigureerd om te beëindigen wanneer jobbeheer is voltooid. De jobreleasetaak wordt uitgevoerd op elk knooppunt waarop taken van de taak zijn uitgevoerd en de taakvoorbereidingstaak is uitgevoerd en voltooid. Als u een knooppunt opnieuw installeert nadat het de taakvoorbereidingstaak heeft uitgevoerd en de taak eindigt zonder verdere taken van de taak die op dat knooppunt wordt uitgevoerd (en dus de taakvoorbereidingstaak niet opnieuw wordt uitgevoerd), wordt de jobreleasetaak niet uitgevoerd op dat rekenknooppunt. Als een knooppunt opnieuw wordt opgestart terwijl de jobreleasetaak nog steeds wordt uitgevoerd, wordt de taak voor taakrelease opnieuw uitgevoerd wanneer het rekenknooppunt wordt gestart. De taak is pas gemarkeerd als voltooid als alle jobreleasetaken zijn voltooid. De jobreleasetaak wordt op de achtergrond uitgevoerd. Het neemt geen planningssite in beslag; Dat wil gezegd, het telt niet mee voor de limiet van taskSlotsPerNode die is opgegeven voor de pool. |
|
Batch |
De Batch-service wijst geen betekenis toe aan deze metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. |
|
Batch |
BatchNodeFillType enums |
|
Batch |
De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. |
|
Batch |
Voor regionale plaatsing worden knooppunten in de pool toegewezen in dezelfde regio. Voor zonegebonden plaatsing worden knooppunten in de pool verdeeld over verschillende zones met optimale taakverdeling. |
|
Batch |
BatchNodePlacementPolicyType enums |
|
Batch |
Instellingen voor de besturingssysteemschijf van het rekenknooppunt (VM). |
|
Batch |
De eindpuntconfiguratie voor een pool. |
|
Batch |
De verwijzing van een van de poolidentiteiten om Disk te versleutelen. Deze identiteit wordt gebruikt om toegang te krijgen tot de sleutelkluis. |
|
Batch |
Hiermee geeft u op hoe een taak moet worden toegewezen aan een pool. |
|
Batch |
BatchPoolLifetimeOption enums |
|
Batch |
Specificatie voor het maken van een nieuwe pool. |
|
Batch |
De configuratie van het openbare IP-adres van de netwerkconfiguratie van een pool. |
|
Batch |
Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. In sommige gevallen kan de StartTask opnieuw worden uitgevoerd, ook al is het rekenknooppunt niet opnieuw opgestart. Er moet speciale aandacht worden besteed aan het voorkomen van StartTasks die een breakaway-proces maken of services installeren/starten vanuit de werkmap StartTask, omdat hierdoor Batch niet meer in staat is om de StartTask opnieuw uit te voeren. |
|
Batch |
Uitvoeringsbeperkingen die van toepassing zijn op een taak. |
|
Batch |
De containerinstellingen voor een taak. |
|
Batch |
TaskFailure-enums |
|
Batch |
Hiermee geeft u op hoe taken moeten worden verdeeld over rekenknooppunten. |
|
Batch |
Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. |
|
Batch |
Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Het kan alleen worden ingesteld voor vertrouwelijke VM's en is vereist bij het gebruik van vertrouwelijke VM's. |
|
Batch |
Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een Azure Compute Gallery-installatiekopieën. Zie de bewerking 'Lijst met ondersteunde installatiekopieën' voor alle Azure Marketplace-installatiekopieën die zijn geverifieerd door Azure Batch. |
|
Caching |
CachingType enums |
|
Cifs |
Informatie die wordt gebruikt om verbinding te maken met een CIFS-bestandssysteem. |
|
Container |
De vermelding van het pad en de koppelingsmodus die u wilt koppelen aan de taakcontainer. |
|
Container |
De paden die worden gekoppeld aan de container van de containertaak. |
|
Container |
Een privécontainerregister. |
|
Container |
ContainerType enums |
|
Container |
ContainerWorkingDirectory-enums |
|
Data |
Instellingen die worden gebruikt door de gegevensschijven die zijn gekoppeld aan rekenknooppunten in de pool. Wanneer u gekoppelde gegevensschijven gebruikt, moet u de schijven vanuit een virtuele machine koppelen en formatteren om ze te kunnen gebruiken. |
|
Diff |
Specificeert de plaatsing van de tijdelijke schijf voor de besturingssysteemschijf voor alle rekenknooppunten (VM's) in de pool. Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om te kiezen op welke locatie het besturingssysteem zich moet bevinden. Bijvoorbeeld: cacheschijfruimte voor kortstondige besturingssysteemschijfinrichting. Voor meer informatie over de vereisten voor schijfgrootte van Ephemeral OS, zie Ephemeral OS schijfgroottevereisten voor Windows-VM's en https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linux-VM's bij https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements |
|
Disk |
De door de klant beheerde sleutelreferentie om de schijf te versleutelen. |
|
Disk |
De schijfversleutelingsconfiguratie die is toegepast op rekenknooppunten in de pool. Schijfversleutelingsconfiguratie wordt niet ondersteund in een Linux-pool die is gemaakt met de installatiekopie van de Azure Compute Gallery. |
|
Disk |
De ARM-bron-id van de set schijfversleuteling. |
|
Disk |
DiskEncryptionTarget-enums |
|
Dynamic |
DynamicVNetAssignmentScope enums |
|
Elevation |
ElevationLevel-enums |
|
Environment |
Een omgevingsvariabele die moet worden ingesteld voor een taakproces. |
|
Host |
Hiermee geeft u bepaalde instellingen voor hosteindpunten op. |
|
Host |
HostEndpointSettingsModeTypes enums |
|
Inbound |
InboundEndpointProtocol enums |
|
Ip |
IPAddressProvisioningType enums |
| IPFamily |
De IP-families die worden gebruikt om IP-versies op te geven die beschikbaar zijn voor de pool. |
| IPTag |
Bevat de IP-tag die is gekoppeld aan het openbare IP-adres. |
|
Linux |
Eigenschappen die worden gebruikt voor het maken van een gebruikersaccount op een Linux-rekenknooppunt. |
|
Login |
LoginMode-enums |
|
Managed |
De parameters van de beheerde schijf. |
|
Mount |
Het bestandssysteem dat op elk knooppunt moet worden gekoppeld. |
|
Network |
De netwerkconfiguratie voor een pool. |
|
Network |
Een regel voor een netwerkbeveiligingsgroep die moet worden toegepast op een binnenkomend eindpunt. |
|
Network |
NetworkSecurityGroupRuleAccess-enums |
|
Nfs |
Informatie die wordt gebruikt om verbinding te maken met een NFS-bestandssysteem. |
|
Output |
Bij elke bestandsupload schrijft de Batch-service twee logboekbestanden naar het rekenknooppunt, 'fileuploadout.txt' en 'fileuploaderr.txt'. Deze logboekbestanden worden gebruikt voor meer informatie over een specifieke fout. |
|
Output |
Hiermee geeft u een doel voor het uploaden van bestanden in een Azure Blob Storage-container op. |
|
Output |
Het doel waarnaar een bestand moet worden geüpload. |
|
Output |
OutputFileUploadCondition-enums |
|
Output |
Opties voor het uploaden van een uitvoerbestand, waaronder onder welke voorwaarden de upload moet worden uitgevoerd. |
|
Output |
Een http-headernaam-waardepaar |
|
Proxy |
Hiermee geeft u ProxyAgent-instellingen op tijdens het maken van de virtuele machine. |
|
Resource |
Eén bestand of meerdere bestanden die moeten worden gedownload naar een rekenknooppunt. |
|
Rolling |
De configuratieparameters die worden gebruikt tijdens het uitvoeren van een rolling upgrade. |
|
Security |
SecurityEncryptionTypes enums |
|
Security |
Hiermee geeft u de beveiligingsprofielinstellingen voor de virtuele machine of virtuele-machineschaalset op. |
|
Security |
Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. |
|
Service |
Hiermee geeft u de referentie-id voor serviceartefacten op die wordt gebruikt voor het instellen van dezelfde installatiekopieënversie voor alle virtuele machines in de schaalset wanneer u de meest recente installatiekopieënversie gebruikt. |
|
Storage |
StorageAccountType enums |
|
Upgrade |
UpgradeMode-enums |
|
Upgrade |
Beschrijft een upgradebeleid: automatisch, handmatig of rolling. |
|
User |
Eigenschappen die worden gebruikt om een gebruiker te maken die wordt gebruikt om taken uit te voeren op een Azure Batch Compute-knooppunt. |
|
User |
De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. Geef de eigenschap userName of autoUser op, maar niet beide. |
|
Virtual |
De configuratie voor rekenknooppunten in een pool op basis van de Azure Virtual Machines-infrastructuur. |
| VMExtension |
De configuratie voor extensies van virtuele machines. |
|
Windows |
Windows-besturingssysteeminstellingen die van toepassing zijn op de virtuele machine. |
|
Windows |
Eigenschappen die worden gebruikt voor het maken van een gebruikersaccount op een Windows-rekenknooppunt. |
AuthenticationTokenSettings
De instellingen voor een verificatietoken dat de taak kan gebruiken om Batch-servicebewerkingen uit te voeren.
| Name | Type | Description |
|---|---|---|
| access |
De batchbronnen waartoe de token toegang verleent. Het authenticatietoken geeft toegang tot een beperkte set batchservice-operaties. Momenteel is de enige ondersteunde waarde voor de toegangseigenschap 'job', die toegang geeft tot alle behandelingen die verband houden met de taak die de taak bevat. |
AutomaticOsUpgradePolicy
De configuratieparameters die worden gebruikt voor het uitvoeren van automatische upgrade van het besturingssysteem.
| Name | Type | Description |
|---|---|---|
| disableAutomaticRollback |
boolean |
Of de functie voor terugdraaien van installatiekopieën van het besturingssysteem moet worden uitgeschakeld. |
| enableAutomaticOSUpgrade |
boolean |
Hiermee wordt aangegeven of upgrades van het besturingssysteem automatisch moeten worden toegepast op exemplaren van schaalsets wanneer een nieuwere versie van de installatiekopie van het besturingssysteem beschikbaar wordt. |
| osRollingUpgradeDeferral |
boolean |
Stel upgrades van het besturingssysteem uit op de TVM's als ze taken uitvoeren. |
| useRollingUpgradePolicy |
boolean |
Hiermee wordt aangegeven of beleid voor rolling upgrades moet worden gebruikt tijdens de automatische upgrade van het besturingssysteem. Automatische upgrade van het besturingssysteem valt terug op het standaardbeleid als er geen beleid is gedefinieerd op de VMSS. |
AutoUserScope
AutoUserScope enums
| Waarde | Description |
|---|---|
| task |
Geeft aan dat de dienst een nieuwe gebruiker voor de Taak moet aanmaken. |
| pool |
Specificeert dat de Taak draait als het gemeenschappelijke automatische gebruikersaccount dat op elke rekenknoop in een pool wordt aangemaakt. |
AutoUserSpecification
Hiermee geeft u de opties voor de automatische gebruiker die een Azure Batch-taak uitvoert.
| Name | Type | Description |
|---|---|---|
| elevationLevel |
Het hoogteniveau van de automatische gebruiker. De standaardwaarde is nietAdmin. |
|
| scope |
Het bereik voor de automatische gebruiker. De standaardwaarde is pool. Als de pool Windows uitvoert, moet een waarde van Taak worden opgegeven als strengere isolatie tussen taken vereist is. Bijvoorbeeld als de taak het register muteert op een manier die van invloed kan zijn op andere taken. |
AzureBlobFileSystemConfiguration
Informatie die wordt gebruikt om verbinding te maken met een Azure Storage-container met behulp van Blobfuse.
| Name | Type | Description |
|---|---|---|
| accountKey |
string (password) |
De sleutel van het Azure Storage-account. Deze eigenschap is wederzijds exclusief met zowel sasKey als identiteit; er moet precies één worden opgegeven. |
| accountName |
string |
De naam van het Azure Storage-account. |
| blobfuseOptions |
string |
Aanvullende opdrachtregelopties om door te geven aan de koppelingsopdracht. Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. |
| containerName |
string |
De naam van de Azure Blob Storage-container. |
| identityReference |
De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot containerName. Deze eigenschap is wederzijds exclusief met zowel accountKey als sasKey; er moet precies één worden opgegeven. |
|
| relativeMountPath |
string |
Het relatieve pad op de rekenknoop waar het bestandssysteem wordt gemount. Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. |
| sasKey |
string (password) |
Het SAS-token van Azure Storage. Deze eigenschap is wederzijds exclusief met zowel accountKey als identiteit; er moet precies één worden opgegeven. |
AzureFileShareConfiguration
Informatie die wordt gebruikt om verbinding te maken met een Azure Fileshare.
| Name | Type | Description |
|---|---|---|
| accountKey |
string (password) |
De sleutel van het Azure Storage-account. |
| accountName |
string |
De naam van het Azure Storage-account. |
| azureFileUrl |
string (uri) |
De URL van Azure Files. Dit is de vorm 'https://{account}.file.core.windows.net/'. |
| mountOptions |
string |
Aanvullende opdrachtregelopties om door te geven aan de koppelingsopdracht. Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. |
| relativeMountPath |
string |
Het relatieve pad op de rekenknoop waar het bestandssysteem wordt gemount. Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. |
BatchAccessScope
BatchAccessScope-enums
| Waarde | Description |
|---|---|
| job |
Verleent toegang om alle bewerkingen uit te voeren op de taak die de taak bevat. |
BatchAllTasksCompleteMode
De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben.
| Waarde | Description |
|---|---|
| noaction |
Niets doen. De baan blijft actief tenzij deze wordt beëindigd of op een andere manier wordt uitgeschakeld. |
| terminatejob |
Beëindig de klus. De beëindigingsreden van de baan is ingesteld op 'AllTakenVoltooid'. |
BatchApplicationPackageReference
Een verwijzing naar een pakket dat moet worden geïmplementeerd op rekenknooppunten.
| Name | Type | Description |
|---|---|---|
| applicationId |
string |
De ID van de applicatie om uit te rollen. Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). |
| version |
string |
De versie van de toepassing die moet worden geïmplementeerd. Als u dit weglaat, wordt de standaardversie geïmplementeerd. Als dit wordt weggelaten in een Pool en er is geen standaardversie gespecificeerd voor deze applicatie, faalt het verzoek met de foutcode InvalidApplicationPackageReferences en HTTP-statuscode 409. Als dit wordt weggelaten op een Task en er geen standaardversie voor deze applicatie is opgegeven, faalt de Task met een pre-processing error. |
BatchAutoPoolSpecification
Hiermee geeft u kenmerken voor een tijdelijke 'automatische pool'. De Batch-service maakt deze automatische pool wanneer de taak wordt verzonden.
| Name | Type | Description |
|---|---|---|
| autoPoolIdPrefix |
string |
Een prefix dat aan de unieke identificatie wordt toegevoegd wanneer er automatisch een Pool wordt aangemaakt. De Batch-service wijst elke auto Pool bij aanmaak een unieke identificatie toe. Om onderscheid te maken tussen Pools die voor verschillende doeleinden zijn gemaakt, kun je dit element specificeren om een prefix toe te voegen aan de toegewezen ID. Het voorvoegsel kan tot 20 tekens lang zijn. |
| keepAlive |
boolean |
Of je een autopool in leven moet houden nadat de levensduur is verlopen. Als het niet klopt, verwijdert de Batch-service de Pool zodra de levensduur (zoals bepaald door de poolLifetimeOption-instelling) verloopt; dat wil zeggen, wanneer de Job of Job Schedule voltooid is. Als dat zo is, verwijdert de Batch-service de Pool niet automatisch. Het is aan de gebruiker om automatische Pools die met deze optie zijn aangemaakt te verwijderen. |
| pool |
De Pool-specificatie voor de auto Pool. |
|
| poolLifetimeOption |
De minimale levensduur van aangemaakte auto Pools, en hoe meerdere Jobs op een schema aan Pools worden toegewezen. |
BatchContainerConfiguration
De configuratie voor pools waarvoor containers zijn ingeschakeld.
| Name | Type | Description |
|---|---|---|
| containerImageNames |
string[] |
De verzameling van containerafbeeldingen namen. Dit is de volledige afbeeldingsreferentie, zoals gespecificeerd bij "docker pull". Een Image wordt afkomstig uit het standaard Docker-register, tenzij de Image volledig gekwalificeerd is met een alternatief register. |
| containerRegistries |
Aanvullende privéregisters waaruit containers kunnen worden opgehaald. Als afbeeldingen gedownload moeten worden uit een privéregister dat inloggegevens vereist, dan moeten die gegevens hier worden verstrekt. |
|
| type |
De containertechnologie die moet worden gebruikt. |
BatchDiffDiskSettings
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die wordt gebruikt door het rekenknooppunt (VM).
| Name | Type | Description |
|---|---|---|
| placement |
Hiermee geeft u de tijdelijke schijfplaatsing voor besturingssysteemschijf voor alle VM's in de groep. Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om de locatie te kiezen, bijvoorbeeld de cacheschijfruimte voor tijdelijke inrichting van besturingssysteemschijven. Raadpleeg voor meer informatie over tijdelijke vereisten voor besturingssysteemschijfgrootte de vereisten voor tijdelijke besturingssysteemschijfgrootte voor Windows-VM's op https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements en Linux-VM's op https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. |
BatchError
Er is een foutbericht ontvangen van de Azure Batch-service.
| Name | Type | Description |
|---|---|---|
| code |
string |
Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt. |
| message |
Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface. |
|
| values |
Een verzameling sleutel-waardeparen met aanvullende informatie over de fout. |
BatchErrorDetail
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
| Name | Type | Description |
|---|---|---|
| key |
string |
Een id die de betekenis van de eigenschap Waarde aangeeft. |
| value |
string |
De aanvullende informatie die is opgenomen in het foutbericht. |
BatchErrorMessage
Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
| Name | Type | Description |
|---|---|---|
| lang |
string |
De taalcode van het foutbericht. |
| value |
string |
De tekst van het bericht. |
BatchInboundNatPool
Een binnenkomende NAT-pool die kan worden gebruikt om specifieke poorten op rekenknooppunten in een batchgroep extern aan te pakken.
| Name | Type | Description |
|---|---|---|
| backendPort |
integer (int32) |
Het poortnummer op de Compute Node. Dit moet uniek zijn binnen een Batch Pool. Acceptabele waarden liggen tussen 1 en 65535, met uitzondering van 29876 en 29877, aangezien deze zijn gereserveerd. Als er gereserveerde waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| frontendPortRangeEnd |
integer (int32) |
Het laatste poortnummer in het bereik van externe poorten dat wordt gebruikt om inkomende toegang tot de backendPort te bieden op individuele rekenknooppunten. Acceptabele waarden variëren tussen 1 en 65534, behalve poorten van 50000 tot 55000, die zijn gereserveerd door de Batch-service. Alle bereiken binnen een Pool moeten verschillend zijn en mogen niet overlappen. Elke range moet minstens 40 poorten bevatten. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| frontendPortRangeStart |
integer (int32) |
Het eerste poortnummer in het bereik van externe poorten dat wordt gebruikt om inkomende toegang te bieden tot de backendPort op individuele rekenknooppunten. Acceptabele waarden variëren tussen 1 en 65534, met uitzondering van poorten van 50000 tot 55000 die zijn gereserveerd. Alle bereiken binnen een Pool moeten verschillend zijn en mogen niet overlappen. Elke range moet minstens 40 poorten bevatten. Als er gereserveerde of overlappende waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| name |
string |
De naam van het eindpunt. De naam moet uniek zijn binnen een Batch Pool, kan letters, cijfers, onderstreepjes, punten en koppeltekens bevatten. Namen moeten beginnen met een letter of cijfer, moeten eindigen op een letter, cijfer of onderstrepingsteken en mogen niet langer zijn dan 77 tekens. Als er ongeldige waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| networkSecurityGroupRules |
Een lijst met regels voor netwerkbeveiligingsgroepen die worden toegepast op het eindpunt. Het maximale aantal regels dat over alle eindpunten in een Batch Pool kan worden gespecificeerd, is 25. Als er geen regels voor netwerkbeveiligingsgroepen zijn opgegeven, wordt er een standaardregel gemaakt om binnenkomende toegang tot de opgegeven backendPort toe te staan. Als het maximum aantal regels voor netwerkbeveiligingsgroepen wordt overschreden, mislukt de aanvraag met HTTP-statuscode 400. |
|
| protocol |
Het protocol van het eindpunt. |
BatchJobConstraints
De uitvoeringsbeperkingen voor een taak.
| Name | Type | Description |
|---|---|---|
| maxTaskRetryCount |
integer (int32) |
Het maximale aantal keren dat elke taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De batchservice probeert elke taak één keer en kan het dan tot deze limiet opnieuw proberen. Als het maximale aantal herpogingen bijvoorbeeld 3 is, probeert Batch een taak tot 4 keer (één eerste poging en 3 herpogingen). Als het maximale aantal herpogingen 0 is, probeert de batchservice taken niet opnieuw. Als het maximale aantal herpogingen -1 is, probeert de batchservice taken zonder limiet opnieuw. De standaardwaarde is 0 (geen nieuwe pogingen). |
| maxWallClockTime |
string (duration) |
De maximale verstreken tijd die de Job kan draaien, gemeten vanaf het moment dat de Job wordt aangemaakt. Als de taak niet binnen de tijdslimiet wordt voltooid, beëindigt de batchservice deze en alle taken die nog draaien. In dit geval zal de reden voor beëindiging MaxWallClockTimeExpiry zijn. Als deze eigenschap niet is gespecificeerd, is er geen tijdslimiet op hoe lang de klus mag duren. |
BatchJobCreateOptions
Parameters voor het maken van een Azure Batch-taak.
| Name | Type | Default value | Description |
|---|---|---|---|
| allowTaskPreemption |
boolean |
Of taken in deze taak kunnen worden verschoven door andere taken met hoge prioriteit. (Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) Als de waarde is ingesteld op True, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden, voorrang en kunnen taken van deze taak opnieuw in de wachtrij worden geplaatst. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. |
|
| commonEnvironmentSettings |
De lijst met algemene omgevingsvariabeleinstellingen. Deze omgevingsvariabelen worden ingesteld voor alle taken in de taak (inclusief jobbeheer, jobvoorbereiding en jobreleasetaken). Afzonderlijke taken kunnen een omgevingsinstelling die hier is opgegeven overschrijven door dezelfde instellingsnaam met een andere waarde op te geven. |
||
| constraints |
De uitvoeringsbeperkingen voor de taak. |
||
| displayName |
string |
De weergavenaam voor de taak. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. |
|
| id |
string |
Een tekenreeks waarmee de taak in het account uniek wordt geïdentificeerd. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is niet hoofdlettergevoelig en niet hoofdlettergevoelig (u hebt mogelijk geen twee id's binnen een account die alleen per geval verschillen). |
|
| jobManagerTask |
Details van een Job Manager-taak die moet worden gestart wanneer de taak wordt gestart. Als de taak geen Job Manager-taak opgeeft, moet de gebruiker expliciet taken toevoegen aan de taak. Als de taak wel een Job Manager-taak opgeeft, maakt de Batch-service de Job Manager-taak wanneer de taak wordt gemaakt en probeert de Job Manager-taak te plannen voordat andere taken in de taak worden gepland. Het typische doel van de Job Manager-taak is het beheren en/of bewaken van taakuitvoering, bijvoorbeeld door te bepalen welke extra taken moeten worden uitgevoerd, te bepalen wanneer het werk is voltooid, enzovoort. (Een Job Manager-taak is echter niet beperkt tot deze activiteiten- het is een volwaardige taak in het systeem en het uitvoeren van de acties die nodig zijn voor de taak.) Een Job Manager-taak kan bijvoorbeeld een bestand downloaden dat is opgegeven als parameter, de inhoud van dat bestand analyseren en aanvullende taken verzenden op basis van die inhoud. |
||
| jobPreparationTask |
De jobvoorbereidingstaak. Als een taak een taakvoorbereidingstaak heeft, voert de Batch-service de jobvoorbereidingstaak uit op een knooppunt voordat u taken van die taak op dat rekenknooppunt start. |
||
| jobReleaseTask |
De taak voor het vrijgeven van de taak. Een jobreleasetaak kan niet worden opgegeven zonder ook een taakvoorbereidingstaak voor de taak op te geven. De Batch-service voert de jobreleasetaak uit op de knooppunten waarop de jobvoorbereidingstaak is uitgevoerd. Het primaire doel van de jobreleasetaak is het ongedaan maken van wijzigingen in rekenknooppunten die door de jobvoorbereidingstaak zijn aangebracht. Voorbeelden van activiteiten zijn het verwijderen van lokale bestanden of het afsluiten van services die zijn gestart als onderdeel van jobvoorbereiding. |
||
| maxParallelTasks |
integer (int32) |
-1 |
Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. (Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De waarde van maxParallelTasks moet -1 of groter zijn dan 0, indien opgegeven. Als dit niet is opgegeven, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat tegelijk kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. |
| metadata |
Een lijst met naam-waardeparen die zijn gekoppeld aan de taak als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. |
||
| networkConfiguration |
(Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De netwerkconfiguratie voor de taak. |
||
| onAllTasksComplete |
De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. Houd er rekening mee dat als een taak geen taken bevat, alle taken als voltooid worden beschouwd. Deze optie wordt daarom meestal gebruikt met een Job Manager-taak; Als u automatische beëindiging van taken zonder Job Manager wilt gebruiken, moet u in eerste instantie opAllTasksComplete instellen op noaction en de eigenschappen van de taak bijwerken zodat deze opAllTasksComplete zijn ingesteld om de taak te beëindigen zodra u klaar bent met het toevoegen van taken. De standaardwaarde is noaction. |
||
| onTaskFailure |
De actie die de Batch-service moet uitvoeren wanneer een taak in de taak mislukt. Een taak wordt beschouwd als mislukt als er een failureInfo is. Er wordt een failureInfo ingesteld als de taak is voltooid met een afsluitcode die niet nul is voltooid nadat het aantal nieuwe pogingen is uitgeput of als er een fout is opgetreden bij het starten van de taak, bijvoorbeeld vanwege een fout bij het downloaden van een resourcebestand. De standaardwaarde is noaction. |
||
| poolInfo |
De pool waarop de Batch-service de taken van de taak uitvoert. |
||
| priority |
integer (int32) |
De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit is. De standaardwaarde is 0. |
|
| usesTaskDependencies |
boolean |
Of taken in de taak afhankelijkheden op elkaar kunnen definiëren. De standaardwaarde is onwaar. |
BatchJobDefaultOrder
BatchJobDefaultOrder-enums
| Waarde | Description |
|---|---|
| none |
Taken moeten uniform worden ingepland vanuit alle taken met gelijke prioriteit voor de pool. |
| creationtime |
Als taken gelijke prioriteit hebben, moeten taken van eerder aangemaakte taken eerst worden ingepland. |
BatchJobManagerTask
Hiermee geeft u details van een Job Manager-taak. De Job Manager-taak wordt automatisch gestart wanneer de taak wordt gemaakt. De Batch-service probeert de Job Manager-taak te plannen vóór andere taken in de taak. Wanneer u een pool verkleint, probeert de Batch-service knooppunten te behouden waarop Job Manager-taken zo lang mogelijk worden uitgevoerd (rekenknooppunten waarop normale taken worden uitgevoerd, worden verwijderd voordat rekenknooppunten jobbeheertaken worden uitgevoerd). Wanneer een Job Manager-taak mislukt en opnieuw moet worden opgestart, probeert het systeem deze op de hoogste prioriteit te plannen. Als er geen niet-actieve rekenknooppunten beschikbaar zijn, kan het systeem een van de actieve taken in de pool beëindigen en terugkeren naar de wachtrij om ruimte te maken voor de Taakbeheertaak om opnieuw te starten. Houd er rekening mee dat een Job Manager-taak in de ene taak geen prioriteit heeft ten opzichte van taken in andere taken. In alle taken worden alleen prioriteiten op taakniveau waargenomen. Als een Job Manager in een taak met prioriteit 0 bijvoorbeeld opnieuw moet worden gestart, worden taken van een taak met prioriteit 1 niet verplaatst. Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken.
| Name | Type | Description |
|---|---|---|
| allowLowPriorityNode |
boolean |
Of de Taakbeheer-taak kan draaien op een Spot/Low-priority Compute Node. De standaardwaarde is waar. |
| applicationPackageReferences |
Een lijst van applicatiepakketten die de Batch-service zal uitrollen naar de Compute Node voordat de commandoregel wordt uitgevoerd. Application Packages worden gedownload en geïrriteerd in een gedeelde map, niet in de Task-werkmap. Daarom, als een referentie Application Package al op de Compute Node staat en up-to-date is, wordt het niet opnieuw gedownload; de bestaande kopie op de Compute Node wordt gebruikt. Als een verwezen applicatiepakket niet kan worden geïnstalleerd, bijvoorbeeld omdat het pakket is verwijderd of omdat de download mislukte, faalt de taak. |
|
| authenticationTokenSettings |
De instellingen voor een verificatietoken dat de taak kan gebruiken om Batch-servicebewerkingen uit te voeren. Als deze eigenschap is ingesteld, voorziet de Batch-service de Task van een authenticatietoken dat kan worden gebruikt om Batch-service-operaties te authenticeren zonder dat er een toegangssleutel voor het account nodig is. Het token wordt geleverd via de omgevingsvariabele AZ_BATCH_AUTHENTICATION_TOKEN. De bewerkingen die de Task met het token kan uitvoeren, hangen af van de instellingen. Een taak kan bijvoorbeeld taakrechten aanvragen om andere taken aan de taak toe te voegen, of de status van de taak of andere taken onder de taak controleren. |
|
| commandLine |
string |
De commandoregel van de Taakbeheerder Taak. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| constraints |
Beperkingen die van toepassing zijn op de Taakbeheertaak. |
|
| containerSettings |
De instellingen voor de container waaronder de Taakbeheer-taak draait. Als de Pool die deze taak uitvoert containerConfiguration heeft ingesteld, moet dit ook worden ingesteld. Als de pool die deze taak uitvoert geen containerConfiguration heeft ingesteld, mag dit niet worden ingesteld. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch-directories op de node) in de container toegewezen, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-opdrachtregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben. |
|
| displayName |
string |
De weergavenaam van de Taakbeheertaak. Het hoeft niet uniek te zijn en kan elk Unicode-teken bevatten tot een maximale lengte van 1024. |
| environmentSettings |
Een lijst met instellingen voor omgevingsvariabelen voor de Taakbeheertaak. |
|
| id |
string |
Een string die de Taakbeheer-taak binnen de Taak uniek identificeert. De ID kan elke combinatie van alfanumerieke tekens bevatten, inclusief koppeltekens en onderstreepjes, en mag niet meer dan 64 tekens bevatten. |
| killJobOnCompletion |
boolean |
Of het voltooien van de Taakbeheertaak betekent dat de hele Taak is voltooid. Als dat zo is, markeert de Batchservice de taak als voltooid wanneer de Taakbeheer-taak is voltooid. Als er op dit moment nog taken draaien (behalve Job Release), worden die taken beëindigd. Als het niet klopt, beïnvloedt het voltooien van de Taakbeheer-taak de Taakstatus niet. In dat geval moet je ofwel het attribuut onAllTasksComplete gebruiken om de taak te beëindigen, of een client of gebruiker de taak expliciet laten beëindigen. Een voorbeeld hiervan is als de Taakmanager een set taken aanmaakt, maar vervolgens geen verdere rol speelt in de uitvoering ervan. De standaardwaarde is waar. Als je de attributen onAllTasksComplete en onTaskFailure gebruikt om de levensduur van de taak te beheren, en de Taakbeheer-taak alleen gebruikt om de taken voor de taak aan te maken (niet om de voortgang te monitoren), dan is het belangrijk om killJobOnCompletion op false te zetten. |
| outputFiles |
Een lijst van bestanden die de Batch-service zal uploaden vanaf de Compute Node nadat de opdrachtregel is uitgevoerd. Voor multi-instance taken worden de bestanden alleen geüpload vanaf de Compute Node waarop de primaire Task wordt uitgevoerd. |
|
| requiredSlots |
integer (int32) |
Het aantal planningsslots dat de Taak nodig heeft om uit te voeren. De standaardwaarde is 1. Een Task kan alleen worden gepland om op een compute-node te draaien als de node genoeg vrije planningsslots beschikbaar heeft. Voor multi-instance taken wordt deze eigenschap niet ondersteund en mag niet worden gespecificeerd. |
| resourceFiles |
Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. |
|
| runExclusive |
boolean |
Of de Taakbeheer-taak exclusief gebruik vereist van de Compute Node waar deze draait. Als dat zo is, zullen geen andere taken op dezelfde Node draaien zolang de Taakmanager draait. Als het niet klopt, kunnen andere taken gelijktijdig met de Taakbeheer op een rekenknooppunt draaien. De Taakbeheer-taak telt normaal mee tegen de gelijktijdige taaklimiet van de Rekenknoop, dus dit is alleen relevant als de Rekenknoop meerdere gelijktijdige taken toestaat. De standaardwaarde is waar. |
| userIdentity |
De gebruikersidentiteit waaronder de Taakbeheer-taak draait. Als deze wordt weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak. |
BatchJobNetworkConfiguration
(Deze eigenschap is niet standaard beschikbaar. Neem contact op met de ondersteuning voor meer informatie) De netwerkconfiguratie voor de taak.
| Name | Type | Description |
|---|---|---|
| skipWithdrawFromVNet |
boolean |
Of u rekenknooppunten wilt intrekken van het virtuele netwerk naar DNC wanneer de taak wordt beëindigd of verwijderd. Indien waar, blijven knooppunten gekoppeld aan het virtuele netwerk aan DNC. Als dit onwaar is, worden knooppunten automatisch ingetrokken wanneer de taak wordt beëindigd. Standaard ingesteld op onwaar. |
| subnetId |
string |
De ARM-resource-id van het subnet van het virtuele netwerk waaraan rekenknooppunten waarop taken van de taak worden uitgevoerd, worden toegevoegd voor de duur van de taak. Het virtuele netwerk moet zich in dezelfde regio en hetzelfde abonnement bevinden als het Azure Batch-account. Het opgegeven subnet moet voldoende vrije IP-adressen hebben om tegemoet te komen aan het aantal rekenknooppunten dat taken van de taak uitvoert. Dit kan maximaal het aantal rekenknooppunten in de pool zijn. De service-principal MicrosoftAzureBatch moet de rol 'Inzender voor klassieke virtuele machines' hebben Role-Based RBAC-rol (Access Control) voor het opgegeven VNet, zodat de Azure Batch-service taken op de knooppunten kan plannen. Dit kan worden gecontroleerd door te controleren of het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG' heeft). Als communicatie met de knooppunten in het opgegeven subnet wordt geweigerd door een NSG, stelt de Batch-service de status van de rekenknooppunten in op onbruikbaar. Dit is van het formulier /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnetten/{subnet}. Als het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG) heeft, moeten enkele gereserveerde systeempoorten zijn ingeschakeld voor binnenkomende communicatie vanuit de Azure Batch-service. Voor pools die zijn gemaakt met een configuratie van een virtuele machine, schakelt u poorten 29876 en 29877, evenals poort 22 voor Linux en poort 3389 voor Windows in. Poort 443 moet ook open zijn voor uitgaande verbindingen voor communicatie met Azure Storage. Zie voor meer informatie: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. |
BatchJobPreparationTask
Een taakvoorbereidingstaak die moet worden uitgevoerd voordat taken van de taak op een bepaald rekenknooppunt worden uitgevoerd. U kunt jobvoorbereiding gebruiken om een knooppunt voor te bereiden om taken voor de taak uit te voeren. Activiteiten die vaak worden uitgevoerd in taakvoorbereiding zijn onder andere: algemene resourcebestanden downloaden die door alle taken in de taak worden gebruikt. De taakvoorbereidingstaak kan deze algemene resourcebestanden downloaden naar de gedeelde locatie op het knooppunt. (AZ_BATCH_NODE_ROOT_DIR\shared) of start een lokale service op het knooppunt, zodat alle taken van die taak ermee kunnen communiceren. Als de taakvoorbereidingstaak mislukt (dat wil gezegd, wordt het aantal nieuwe pogingen uitgeput voordat u afsluit met afsluitcode 0), voert Batch taken van deze taak niet uit op het knooppunt. Het rekenknooppunt blijft niet in aanmerking om taken van deze taak uit te voeren totdat deze opnieuw wordt geinstallatiekopie gemaakt. Het rekenknooppunt blijft actief en kan worden gebruikt voor andere taken. De taakvoorbereidingstaak kan meerdere keren worden uitgevoerd op hetzelfde knooppunt. Daarom moet u de jobvoorbereidingstaak schrijven om de heruitvoering af te handelen. Als het knooppunt opnieuw wordt opgestart, wordt de jobvoorbereidingstaak opnieuw uitgevoerd op het rekenknooppunt voordat u een andere taak van de taak plant, als opnieuw uitvoerenOnNodeRebootAfterSuccess waar is of als de taakvoorbereidingstaak nog niet eerder is voltooid. Als het knooppunt opnieuw wordt gemaakt, wordt de taakvoorbereidingstaak opnieuw uitgevoerd voordat u een taak van de taak plant. Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken.
| Name | Type | Description |
|---|---|---|
| commandLine |
string |
De commandoregel van de Job Preparation Task. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| constraints |
Beperkingen die van toepassing zijn op de Job Preparation Task. |
|
| containerSettings |
De instellingen voor de container waaronder de taak Job Preparation Task draait. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch-directories op de node) in de container toegewezen, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-opdrachtregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben. |
|
| environmentSettings |
Een lijst met instellingen voor omgevingsvariabelen voor de taak Jobvoorbereiding. |
|
| id |
string |
Een string die de Job Preparation Task uniek binnen de Job identificeert. De ID kan elke combinatie van alfanumerieke tekens bevatten, inclusief koppeltekens en onderstreepjes, en mag niet meer dan 64 tekens bevatten. Als je deze eigenschap niet specificeert, kent de Batch-service een standaardwaarde toe van 'jobpreparation'. Geen enkele andere taak in de functie kan dezelfde ID hebben als de taakvoorbereidingstaak. Als je probeert een Task met hetzelfde id in te dienen, wijst de Batch-service het verzoek met de foutcode TaskIdSameAsJobPreparationTask af; als je de REST API direct aanroept, is de HTTP-statuscode 409 (Conflict). |
| rerunOnNodeRebootAfterSuccess |
boolean |
Of de Batch-service de Job Preparation Task opnieuw moet uitvoeren nadat een Compute Node is herstart. De taak voorbereiding wordt altijd opnieuw uitgevoerd als een rekenknoop opnieuw wordt geimaged, of als de taak voorbereiding niet is voltooid (bijvoorbeeld omdat de herstart plaatsvond terwijl de taak draaide). Daarom moet je altijd een Job Preparation Task schrijven om idempotent te zijn en correct te functioneren als je deze meerdere keren uitvoert. De standaardwaarde is waar. |
| resourceFiles |
Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. |
|
| userIdentity |
De gebruikersidentiteit waaronder de Job Preparation Task wordt uitgevoerd. Indien weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak op Windows Compute Nodes, of als een niet-administratieve gebruiker die uniek is voor de Pool op Linux Compute Nodes. |
|
| waitForSuccess |
boolean |
Of de batchservice moet wachten tot de taak voorbereidingstaak succesvol is afgerond voordat andere taken van de taak op de rekenknoop worden gepland. Een Job Preparation Task is succesvol voltooid als deze afsluit met exitcode 0. Als het waar is en de Job Preparation Task faalt op een Node, probeert de Batch-service de Job Preparation Task opnieuw tot het maximale aantal retrys (zoals gespecificeerd in het constraints-element). Als de taak na alle herpogingen nog steeds niet succesvol is voltooid, zal de batchservice de taken van de taak niet naar de Node plannen. De Node blijft actief en komt in aanmerking om taken van andere taken uit te voeren. Als het niet klopt, wacht de batchservice niet tot de taak Job Preparation is voltooid. In dat geval kunnen andere taken van de taak beginnen met uitvoeren op de Compute Node terwijl de Job Preparation Task nog draait; en zelfs als de taak voor taakvoorbereiding faalt, blijven nieuwe taken worden gepland op de rekenknoop. De standaardwaarde is waar. |
BatchJobReleaseTask
Een jobreleasetaak die moet worden uitgevoerd op taakvoltooiing op elk rekenknooppunt waarop de taak is uitgevoerd. De jobreleasetaak wordt uitgevoerd wanneer de taak eindigt, vanwege een van de volgende: De gebruiker roept de Taak-API beëindigen aan of de Taak-API verwijderen terwijl de taak nog actief is, de maximale tijdslimiet voor de klok van de taak is bereikt en de taak nog steeds actief is, of de Job Manager-taak is voltooid en de taak is geconfigureerd om te beëindigen wanneer jobbeheer is voltooid. De jobreleasetaak wordt uitgevoerd op elk knooppunt waarop taken van de taak zijn uitgevoerd en de taakvoorbereidingstaak is uitgevoerd en voltooid. Als u een knooppunt opnieuw installeert nadat het de taakvoorbereidingstaak heeft uitgevoerd en de taak eindigt zonder verdere taken van de taak die op dat knooppunt wordt uitgevoerd (en dus de taakvoorbereidingstaak niet opnieuw wordt uitgevoerd), wordt de jobreleasetaak niet uitgevoerd op dat rekenknooppunt. Als een knooppunt opnieuw wordt opgestart terwijl de jobreleasetaak nog steeds wordt uitgevoerd, wordt de taak voor taakrelease opnieuw uitgevoerd wanneer het rekenknooppunt wordt gestart. De taak is pas gemarkeerd als voltooid als alle jobreleasetaken zijn voltooid. De jobreleasetaak wordt op de achtergrond uitgevoerd. Het neemt geen planningssite in beslag; Dat wil gezegd, het telt niet mee voor de limiet van taskSlotsPerNode die is opgegeven voor de pool.
| Name | Type | Description |
|---|---|---|
| commandLine |
string |
De commandoregel van de Job Release Task. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| containerSettings |
De instellingen voor de container waaronder de Job Release Task draait. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch-directories op de node) in de container toegewezen, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-opdrachtregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben. |
|
| environmentSettings |
Een lijst met instellingen voor omgevingsvariabelen voor de Job Release Task. |
|
| id |
string |
Een string die de Job Release Task uniek binnen de Job identificeert. De ID kan elke combinatie van alfanumerieke tekens bevatten, inclusief koppeltekens en onderstreepjes, en mag niet meer dan 64 tekens bevatten. Als je deze eigenschap niet specificeert, wijst de Batch-service een standaardwaarde toe van 'jobrelease'. Geen enkele andere taak in de functie kan dezelfde ID hebben als de taak vrijgeven van de taak. Als je probeert een Task met hetzelfde id in te dienen, wijst de Batch-service het verzoek met foutcode TaskIdSameAsJobReleaseTask af; als je de REST API direct aanroept, is de HTTP-statuscode 409 (Conflict). |
| maxWallClockTime |
string (duration) |
De maximale verstreken tijd die de Job Release Task op een gegeven rekenknoop kan draaien, gemeten vanaf het moment dat de taak begint. Als de taak niet binnen de tijdslimiet wordt voltooid, beëindigt de batchservice deze uitvoering. De standaardwaarde is 15 minuten. Je mag geen time-out van langer dan 15 minuten specificeren. Als je dat doet, wijst de Batch-service het af met een foutmelding; als je de REST API direct aanroept, is de HTTP-statuscode 400 (Bad Request). |
| resourceFiles |
Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. |
|
| retentionTime |
string (duration) |
De minimale tijd om de Taakmap voor de Taakvrijgave-taak op de Compute Node te bewaren. Na deze tijd kan de Batch-service de Taakmap en alle inhoud verwijderen. De standaard is 7 dagen, dat wil zeggen dat de Taakmap 7 dagen wordt behouden tenzij de Compute Node wordt verwijderd of de Job wordt verwijderd. |
| userIdentity |
De gebruikersidentiteit waaronder de Job Release Task draait. Als deze wordt weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak. |
BatchMetadataItem
De Batch-service wijst geen betekenis toe aan deze metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode.
| Name | Type | Description |
|---|---|---|
| name |
string |
De naam van het metagegevensitem. |
| value |
string |
De waarde van het metagegevensitem. |
BatchNodeFillType
BatchNodeFillType enums
| Waarde | Description |
|---|---|
| spread |
Taken moeten gelijkmatig worden toegewezen aan alle Compute Nodes in de Pool. |
| pack |
Zoveel mogelijk taken (taskSlotsPerNode) moeten aan elke rekenknoop in de pool worden toegewezen voordat taken worden toegewezen aan de volgende rekenknoop in de pool. |
BatchNodeIdentityReference
De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt.
| Name | Type | Description |
|---|---|---|
| resourceId |
string (arm-id) |
De ARM-resource-id van de door de gebruiker toegewezen identiteit. |
BatchNodePlacementConfiguration
Voor regionale plaatsing worden knooppunten in de pool toegewezen in dezelfde regio. Voor zonegebonden plaatsing worden knooppunten in de pool verdeeld over verschillende zones met optimale taakverdeling.
| Name | Type | Description |
|---|---|---|
| policy |
Type plaatsingsbeleid voor knooppunten in Batch-pools. Toewijzingsbeleid dat door Batch Service wordt gebruikt om de knooppunten in te richten. Als dit niet is opgegeven, gebruikt Batch het regionale beleid. |
BatchNodePlacementPolicyType
BatchNodePlacementPolicyType enums
| Waarde | Description |
|---|---|
| regional |
Alle knooppunten in de pool worden in dezelfde regio toegewezen. |
| zonal |
Nodes in de pool worden verspreid over verschillende beschikbaarheidszones met best effort balancering. |
BatchOsDisk
Instellingen voor de besturingssysteemschijf van het rekenknooppunt (VM).
| Name | Type | Description |
|---|---|---|
| caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: Geen, ReadOnly, ReadWrite. De standaardwaarden zijn: Geen voor Standard-opslag. ReadOnly voor Premium-opslag. |
|
| diskSizeGB |
integer (int32) |
De oorspronkelijke schijfgrootte in GB bij het maken van een nieuwe besturingssysteemschijf. |
| ephemeralOSDiskSettings |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die wordt gebruikt door het rekenknooppunt (VM). |
|
| managedDisk |
De parameters van de beheerde schijf. |
|
| writeAcceleratorEnabled |
boolean |
Hiermee geeft u op of writeAccelerator moet worden ingeschakeld of uitgeschakeld op de schijf. |
BatchPoolEndpointConfiguration
De eindpuntconfiguratie voor een pool.
| Name | Type | Description |
|---|---|---|
| inboundNATPools |
Een lijst van inkomende NAT Pools die gebruikt kunnen worden om specifieke poorten op een individuele Compute Node extern aan te spreken. Het maximale aantal inkomende NAT-pools per batchpool is 5. Als het maximale aantal inkomende NAT Pools wordt overschreden, faalt het verzoek met HTTP-statuscode 400. Dit kan niet worden opgegeven als het IPAddressProvisioningType NoPublicIPAddresses is. |
BatchPoolIdentityReference
De verwijzing van een van de poolidentiteiten om Disk te versleutelen. Deze identiteit wordt gebruikt om toegang te krijgen tot de sleutelkluis.
| Name | Type | Description |
|---|---|---|
| resourceId |
string (arm-id) |
De ARM-resource-id van de door de gebruiker toegewezen identiteit. Deze verwijzing moet worden opgenomen in de poolidentiteiten. |
BatchPoolInfo
Hiermee geeft u op hoe een taak moet worden toegewezen aan een pool.
| Name | Type | Description |
|---|---|---|
| autoPoolSpecification |
Kenmerken van een tijdelijke 'autopool'. De Batch-service maakt deze automatische pool wanneer de taak wordt verzonden. Als automatische poolcreatie faalt, verplaatst de batchservice de taak naar een voltooide staat en wordt de poolcreatiefout ingesteld in de planningsfouteigenschap van de job. De Batch-service beheert de levensduur (zowel het aanmaken als, tenzij keepAlive wordt gespecificeerd, verwijdering) van de auto Pool. Elke gebruikersactie die de levensduur van de auto pool beïnvloedt terwijl de taak actief is, zal leiden tot onverwacht gedrag. Je moet ofwel de Pool ID of de auto Pool-specificatie opgeven, maar niet beide. |
|
| poolId |
string |
De ID van een bestaande Pool. Alle taken van de taak draaien op de opgegeven pool. Je moet ervoor zorgen dat de pool waar deze woning naar verwijst bestaat. Als de Pool niet bestaat op het moment dat de Batch-service probeert een Job te plannen, zullen er geen taken voor de Job draaien totdat je een Pool met die id aanmaakt. Let op: de Batch-service zal het Job-verzoek niet weigeren; het zal simpelweg geen taken uitvoeren totdat de pool bestaat. Je moet ofwel de Pool ID of de auto Pool-specificatie opgeven, maar niet beide. |
BatchPoolLifetimeOption
BatchPoolLifetimeOption enums
| Waarde | Description |
|---|---|
| jobschedule |
De Pool bestaat gedurende de levensduur van het Job Schedule. De Batchservice maakt de pool aan wanneer hij de eerste taak op het schema aanmaakt. Je kunt deze optie alleen toepassen op Jobroosters, niet op Jobs. |
| job |
De Pool bestaat voor de levensduur van de functie waaraan hij is gewijd. De Batch-service maakt de Pool aan wanneer hij de Job aanmaakt. Als de optie 'taak' wordt toegepast op een taakschema, maakt de batchservice een nieuwe automatische pool aan voor elke taak die op het schema is aangemaakt. |
BatchPoolSpecification
Specificatie voor het maken van een nieuwe pool.
| Name | Type | Description |
|---|---|---|
| applicationPackageReferences |
De lijst met pakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Er zijn maximaal 10 pakketverwijzingen voor een bepaalde groep. |
|
| autoScaleEvaluationInterval |
string (duration) |
Het tijdsinterval waarmee de poolgrootte automatisch moet worden aangepast volgens de formule voor automatische schaalaanpassing. De standaardwaarde is 15 minuten. De minimum- en maximumwaarde zijn respectievelijk 5 minuten en 168 uur. Als u een waarde opgeeft die minder dan 5 minuten of langer is dan 168 uur, weigert de Batch-service de aanvraag met een ongeldige eigenschapswaardefout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). |
| autoScaleFormula |
string |
De formule voor het gewenste aantal rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op false. Dit is vereist als enableAutoScale is ingesteld op true. De formule wordt gecontroleerd op geldigheid voordat de pool wordt gemaakt. Als de formule niet geldig is, weigert de Batch-service de aanvraag met gedetailleerde foutinformatie. |
| displayName |
string |
De weergavenaam voor de pool. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. |
| enableAutoScale |
boolean |
Of de grootte van de pool na verloop van tijd automatisch moet worden aangepast. Als dit onwaar is, moeten ten minste één van targetDedicatedNodes en targetLowPriorityNodes worden opgegeven. Indien waar, is het element autoScaleFormula vereist. De grootte van de pool wordt automatisch aangepast aan de formule. De standaardwaarde is onwaar. |
| enableInterNodeCommunication |
boolean |
Of de pool directe communicatie tussen rekenknooppunten toestaat. Als u communicatie tussen knooppunten inschakelt, wordt de maximale grootte van de pool beperkt vanwege implementatiebeperkingen op de rekenknooppunten van de pool. Dit kan ertoe leiden dat de pool de gewenste grootte niet bereikt. De standaardwaarde is onwaar. |
| metadata |
Een lijst met naam-waardeparen die zijn gekoppeld aan de pool als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. |
|
| mountConfiguration |
Een lijst met bestandssystemen die op elk knooppunt in de pool moeten worden gekoppeld. Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse. |
|
| networkConfiguration |
De netwerkconfiguratie voor de pool. |
|
| resizeTimeout |
string (duration) |
De time-out voor de toewijzing van rekenknooppunten aan de pool. Deze time-out is alleen van toepassing op handmatig schalen; dit heeft geen effect wanneer enableAutoScale is ingesteld op true. De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). |
| startTask |
Een taak die moet worden uitgevoerd op elk rekenknooppunt terwijl deze lid wordt van de pool. De taak wordt uitgevoerd wanneer het rekenknooppunt wordt toegevoegd aan de pool of wanneer het rekenknooppunt opnieuw wordt opgestart. |
|
| targetDedicatedNodes |
integer (int32) |
Het gewenste aantal toegewezen rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen. |
| targetLowPriorityNodes |
integer (int32) |
Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen. |
| taskSchedulingPolicy |
Hoe taken worden verdeeld over rekenknooppunten in een pool. Als dit niet is opgegeven, wordt de standaardwaarde verspreid. |
|
| taskSlotsPerNode |
integer (int32) |
Het aantal taaksites dat kan worden gebruikt om gelijktijdige taken uit te voeren op één rekenknooppunt in de pool. De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256. |
| upgradePolicy |
Het upgradebeleid voor de pool. Beschrijft een upgradebeleid: automatisch, handmatig of rolling. |
|
| userAccounts |
De lijst met gebruikersaccounts die moeten worden gemaakt op elk rekenknooppunt in de pool. |
|
| virtualMachineConfiguration |
De configuratie van de virtuele machine voor de pool. Deze eigenschap moet worden opgegeven. |
|
| vmSize |
string |
De grootte van de virtuele machines in de pool. Alle virtuele machines in een pool hebben dezelfde grootte. Zie Een VM-grootte kiezen voor rekenknooppunten in een Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) voor informatie over de beschikbare grootten van virtuele machines in pools. |
BatchPublicIpAddressConfiguration
De configuratie van het openbare IP-adres van de netwerkconfiguratie van een pool.
| Name | Type | Description |
|---|---|---|
| ipAddressIds |
string[] (arm-id) |
De lijst met openbare IP-adressen die door de Batch-service worden gebruikt bij het inrichten van rekenknooppunten. Het aantal IP-adressen dat hier is opgegeven, beperkt de maximale grootte van de pool - 100 toegewezen knooppunten of 100 spot-/lage prioriteitsknooppunten kunnen worden toegewezen voor elk openbaar IP-adres. Een pool die bijvoorbeeld 250 toegewezen VM's nodig heeft, heeft ten minste 3 openbare IP-adressen nodig. Elk element van deze verzameling heeft de volgende vorm: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. |
| ipFamilies |
IPFamily[] |
De IP-families die worden gebruikt om IP-versies op te geven die beschikbaar zijn voor de pool. IP-families worden gebruikt om single-stack of dual-stack pools te bepalen. Voor één stack is de verwachte waarde IPv4. Voor dual-stack zijn de verwachte waarden IPv4 en IPv6. |
| ipTags |
IPTag[] |
Een lijst met IP-tags die zijn gekoppeld aan de openbare IP-adressen van de pool. IP-tags worden gebruikt om openbare IP-adressen te categoriseren en te filteren voor facturerings- en beheerdoeleinden. |
| provision |
Het inrichtingstype voor openbare IP-adressen voor de groep. De standaardwaarde is BatchManaged. |
BatchStartTask
Batch voert taken opnieuw uit wanneer een herstelbewerking wordt geactiveerd op een knooppunt. Voorbeelden van herstelbewerkingen zijn (maar zijn niet beperkt tot) wanneer een beschadigd knooppunt opnieuw wordt opgestart of een rekenknooppunt is verdwenen vanwege een hostfout. Nieuwe pogingen vanwege herstelbewerkingen zijn onafhankelijk van en worden niet meegeteld voor maxTaskRetryCount. Zelfs als maxTaskRetryCount 0 is, kan er een interne nieuwe poging worden uitgevoerd vanwege een herstelbewerking. Daarom moeten alle taken idempotent zijn. Dit betekent dat taken moeten worden onderbroken en opnieuw moeten worden gestart zonder beschadiging of dubbele gegevens te veroorzaken. De aanbevolen procedure voor langlopende taken is om een vorm van controlepunten te gebruiken. In sommige gevallen kan de StartTask opnieuw worden uitgevoerd, ook al is het rekenknooppunt niet opnieuw opgestart. Er moet speciale aandacht worden besteed aan het voorkomen van StartTasks die een breakaway-proces maken of services installeren/starten vanuit de werkmap StartTask, omdat hierdoor Batch niet meer in staat is om de StartTask opnieuw uit te voeren.
| Name | Type | Description |
|---|---|---|
| commandLine |
string |
De opdrachtregel van de StartTask. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| containerSettings |
De instellingen voor de container waaronder de StartTask draait. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch-directories op de node) in de container toegewezen, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-opdrachtregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben. |
|
| environmentSettings |
Een lijst met omgevingsvariabele-instellingen voor de StartTask. |
|
| maxTaskRetryCount |
integer (int32) |
Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service de taak niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een andere taak. De standaardwaarde is 0 (geen nieuwe pogingen). |
| resourceFiles |
Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. |
|
| userIdentity |
De gebruikersidentiteit waaronder de StartTask draait. Als deze wordt weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak. |
|
| waitForSuccess |
boolean |
Of de Batch-service moet wachten tot de StartTask is voltooid (dat wil gezegd: afsluiten met afsluitcode 0) voordat taken op het rekenknooppunt worden gepland. Indien waar en starttask mislukt op een knooppunt, probeert de Batch-service de StartTask opnieuw uit te voeren tot het maximumaantal nieuwe pogingen (maxTaskRetryCount). Als de taak na alle nieuwe pogingen nog steeds niet is voltooid, markeert de Batch-service het knooppunt onbruikbaar en plant deze niet. Deze voorwaarde kan worden gedetecteerd via de details van de status en foutgegevens van het rekenknooppunt. Als dit onwaar is, wacht de Batch-service niet tot de StartTask is voltooid. In dit geval kunnen andere taken worden uitgevoerd op het rekenknooppunt terwijl de StartTask nog steeds wordt uitgevoerd; en zelfs als de StartTask mislukt, worden nieuwe taken nog steeds gepland op het rekenknooppunt. De standaardwaarde is waar. |
BatchTaskConstraints
Uitvoeringsbeperkingen die van toepassing zijn op een taak.
| Name | Type | Description |
|---|---|---|
| maxTaskRetryCount |
integer (int32) |
Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Let op dat deze waarde specifiek het aantal herpogingen voor het uitvoerbare taakbestand regelt vanwege een niet-nul exitcode. De Batch-service probeert de taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximale aantal herpogingen 0 is, probeert de batchservice de taak niet opnieuw na de eerste poging. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service de taak opnieuw zonder limiet, maar dit wordt niet aanbevolen voor een begintaak of een andere taak. De standaardwaarde is 0 (geen nieuwe pogingen). |
| maxWallClockTime |
string (duration) |
De maximale verstreken tijd die de Taak kan draaien, gemeten vanaf het moment dat de Taak begint. Als de taak niet binnen de tijdslimiet wordt voltooid, beëindigt de batchservice deze uitvoering. Als dit niet wordt gespecificeerd, is er geen tijdslimiet op hoe lang de taak mag duren. |
| retentionTime |
string (duration) |
De minimale tijd om de Taakmap te bewaren op de Compute Node waar het draaide, vanaf het moment dat de uitvoering is voltooid. Na deze tijd kan de Batch-service de Taakmap en alle inhoud verwijderen. De standaard is 7 dagen, dat wil zeggen dat de Taakmap 7 dagen wordt behouden tenzij de Compute Node wordt verwijderd of de Job wordt verwijderd. |
BatchTaskContainerSettings
De containerinstellingen voor een taak.
| Name | Type | Description |
|---|---|---|
| containerHostBatchBindMounts |
De paden die u aan de containertaak wilt koppelen. Als deze matrix null is of niet aanwezig is, koppelt de containertaak een volledig tijdelijk schijfstation in Windows (of AZ_BATCH_NODE_ROOT_DIR in Linux). Er worden geen gegevenspaden in de container geplaatst als deze matrix is ingesteld als leeg. |
|
| containerRunOptions |
string |
Aanvullende opties voor de opdracht container maken. Deze extra opties worden geleverd als argumenten voor de opdracht Docker create, naast de opties die worden beheerd door de Batch-service. |
| imageName |
string |
De image die gebruikt moet worden om de container te maken waarin de taak zal draaien. Dit is de volledige afbeeldingsreferentie, zoals gespecificeerd bij "docker pull". Als er geen tag in de afbeeldingsnaam wordt vermeld, wordt de tag ":latest" standaard gebruikt. |
| registry |
Het privéregister dat de containerafbeelding bevat. Deze instelling kan worden weggelaten als deze al bij het aanmaken van het zwembad was aangegeven. |
|
| workingDirectory |
De locatie van de container Task werkdirectory. De standaardwaarde is taskWorkingDirectory. |
BatchTaskFailureMode
TaskFailure-enums
| Waarde | Description |
|---|---|
| noaction |
Niets doen. De baan blijft actief tenzij deze wordt beëindigd of op een andere manier wordt uitgeschakeld. |
| performexitoptionsjobaction |
Beëindig de klus. De beëindigingsreden van de baan is ingesteld op 'AllTakenVoltooid'. |
BatchTaskSchedulingPolicy
Hiermee geeft u op hoe taken moeten worden verdeeld over rekenknooppunten.
| Name | Type | Default value | Description |
|---|---|---|---|
| jobDefaultOrder | none |
De volgorde voor het plannen van taken van verschillende taken met dezelfde prioriteit. Als dit niet is opgegeven, is de standaardinstelling geen. |
|
| nodeFillType |
Hoe taken worden verdeeld over rekenknooppunten in een pool. Als dit niet is opgegeven, wordt de standaardwaarde verspreid. |
BatchUefiSettings
Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine.
| Name | Type | Description |
|---|---|---|
| secureBootEnabled |
boolean |
Hiermee geeft u op of beveiligd opstarten moet worden ingeschakeld op de virtuele machine. |
| vTpmEnabled |
boolean |
Hiermee geeft u op of vTPM moet worden ingeschakeld op de virtuele machine. |
BatchVmDiskSecurityProfile
Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Het kan alleen worden ingesteld voor vertrouwelijke VM's en is vereist bij het gebruik van vertrouwelijke VM's.
| Name | Type | Description |
|---|---|---|
| securityEncryptionType |
Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob. Opmerking: Het kan alleen worden ingesteld voor vertrouwelijke VM's en is vereist bij het gebruik van vertrouwelijke VM's. |
BatchVmImageReference
Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een Azure Compute Gallery-installatiekopieën. Zie de bewerking 'Lijst met ondersteunde installatiekopieën' voor alle Azure Marketplace-installatiekopieën die zijn geverifieerd door Azure Batch.
| Name | Type | Description |
|---|---|---|
| communityGalleryImageId |
string |
De unieke identificatie van de afbeelding in de communitygalerij. Deze eigenschap is wederzijds exclusief met andere eigenschappen en kan worden opgehaald uit de get-aanroep van de communitygalerieafbeelding. |
| exactVersion |
string |
De specifieke versie van het platformimage of marktplaats image die is gebruikt om de node te maken. Dit alleen-lezen veld verschilt van 'versie' alleen als de waarde die voor 'versie' werd gespecificeerd toen de pool werd aangemaakt 'laatste' was. |
| offer |
string |
Het aanbiedingstype van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld UbuntuServer of WindowsServer. |
| publisher |
string |
De uitgever van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld Canonical of MicrosoftWindowsServer. |
| sharedGalleryImageId |
string |
De unieke identificatie van de gedeelde galerijafbeelding. Deze eigenschap is wederzijds exclusief met andere eigenschappen en kan worden opgehaald uit de get-aanroep van de installatiekopieën in de gedeelde galerie. |
| sku |
string |
De SKU van de Azure Virtual Machines Marketplace Image. Bijvoorbeeld 18.04-LTS of 2019-Datacenter. |
| version |
string |
De versie van de Azure Virtual Machines Marketplace Image. Een waarde van 'laatste' kan worden opgegeven om de nieuwste versie van een Image te selecteren. Als u dit weglaat, is de standaardwaarde 'nieuwste'. |
| virtualMachineImageId |
string (arm-id) |
De ARM-resource-id van de installatiekopieën van de Azure Compute Gallery. Compute Nodes in de pool worden aangemaakt met deze Image Id. Dit is de vorm /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} of /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} om altijd standaard te kiezen voor de nieuwste afbeeldingsversie. Deze eigenschap sluit elkaar uit met andere ImageReference-eigenschappen. De Azure Compute Gallery Image moet replica's in dezelfde regio hebben en moet in hetzelfde abonnement zitten als het Azure Batch-account. Als de afbeeldingsversie niet is gespecificeerd in de imageId, wordt de nieuwste versie gebruikt. Voor informatie over de firewallinstellingen voor de Batch Compute Node-agent om met de Batch-service te communiceren, zie https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration. |
CachingType
CachingType enums
| Waarde | Description |
|---|---|
| none |
De cachemodus voor de schijf is niet ingeschakeld. |
| readonly |
De cachemodus voor de schijf is alleen-lezen. |
| readwrite |
De cachemodus voor de schijf is lezen en schrijven. |
CifsMountConfiguration
Informatie die wordt gebruikt om verbinding te maken met een CIFS-bestandssysteem.
| Name | Type | Description |
|---|---|---|
| mountOptions |
string |
Aanvullende opdrachtregelopties om door te geven aan de koppelingsopdracht. Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. |
| password |
string (password) |
Het wachtwoord dat moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. |
| relativeMountPath |
string |
Het relatieve pad op de rekenknoop waar het bestandssysteem wordt gemount. Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. |
| source |
string |
De URI van het bestandssysteem die moet worden gekoppeld. |
| username |
string |
De gebruiker die moet worden gebruikt voor verificatie op basis van het CIFS-bestandssysteem. |
ContainerHostBatchBindMountEntry
De vermelding van het pad en de koppelingsmodus die u wilt koppelen aan de taakcontainer.
| Name | Type | Description |
|---|---|---|
| isReadOnly |
boolean |
Koppel dit bronpad als alleen-lezenmodus of niet. De standaardwaarde is onwaar (lees-/schrijfmodus). Als u voor Linux dit pad koppelt als een lees-/schrijfmodus, betekent dit niet dat alle gebruikers in de container de lees-/schrijftoegang voor het pad hebben, afhankelijk van de toegang in de host-VM. Als dit pad is gekoppeld met het kenmerk Alleen-lezen, kunnen alle gebruikers in de container het pad niet wijzigen. |
| source |
Het pad dat aan de containerklant wordt gekoppeld, kan worden geselecteerd. |
ContainerHostDataPath
De paden die worden gekoppeld aan de container van de containertaak.
| Waarde | Description |
|---|---|
| Shared |
Het pad voor de taak met meerdere exemplaren om hun bestanden te delen. |
| Startup |
Het pad voor de begintaak. |
| VfsMounts |
Het pad bevat alle virtuele bestandssystemen die op dit knooppunt zijn gekoppeld. |
| Task |
Het taakpad. |
| JobPrep |
Het taakpad voor de taakvoorbereiding. |
| Applications |
Het pad naar toepassingen. |
ContainerRegistryReference
Een privécontainerregister.
| Name | Type | Description |
|---|---|---|
| identityReference |
De verwijzing naar de door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot een Azure Container Registry in plaats van een gebruikersnaam en wachtwoord. |
|
| password |
string (password) |
Het wachtwoord om u aan te melden bij de registerserver. |
| registryServer |
string (uri) |
De register-URL. Als u dit weglaat, is de standaardwaarde 'docker.io'. |
| username |
string |
De gebruikersnaam om u aan te melden bij de registerserver. |
ContainerType
ContainerType enums
| Waarde | Description |
|---|---|
| dockerCompatible |
Er wordt een docker-compatibele containertechnologie gebruikt om de containers te starten. |
| criCompatible |
Een op CRI gebaseerde technologie wordt gebruikt om de containers te starten. |
ContainerWorkingDirectory
ContainerWorkingDirectory-enums
| Waarde | Description |
|---|---|
| taskWorkingDirectory |
Gebruik de standaard Batch-service Taakwerkmap, die de Taakresourcebestanden bevat die door Batch worden ingevuld met Batch. |
| containerImageDefault |
Gebruik de werkmap die is gedefinieerd in de container Image. Let op: deze map bevat niet de door batch gedownloade Resource Files. |
DataDisk
Instellingen die worden gebruikt door de gegevensschijven die zijn gekoppeld aan rekenknooppunten in de pool. Wanneer u gekoppelde gegevensschijven gebruikt, moet u de schijven vanuit een virtuele machine koppelen en formatteren om ze te kunnen gebruiken.
| Name | Type | Description |
|---|---|---|
| caching |
Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
|
| diskSizeGB |
integer (int32) |
De initiële schijfgrootte in gigabytes. |
| lun |
integer (int32) |
Het nummer van de logische eenheid. Het logicalUnitNumber wordt gebruikt om elke gegevensschijf uniek te identificeren. Als u meerdere schijven koppelt, moet elk een uniek logicalUnitNumber hebben. De waarde moet tussen 0 en 63 liggen, inclusief. |
| managedDisk |
De parameters van de beheerde schijf. |
|
| storageAccountType |
Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. |
DiffDiskPlacement
Specificeert de plaatsing van de tijdelijke schijf voor de besturingssysteemschijf voor alle rekenknooppunten (VM's) in de pool. Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om te kiezen op welke locatie het besturingssysteem zich moet bevinden. Bijvoorbeeld: cacheschijfruimte voor kortstondige besturingssysteemschijfinrichting. Voor meer informatie over de vereisten voor schijfgrootte van Ephemeral OS, zie Ephemeral OS schijfgroottevereisten voor Windows-VM's en https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linux-VM's bij https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
| Waarde | Description |
|---|---|
| cachedisk |
De tijdelijke besturingssysteemschijf wordt opgeslagen in de VM-cache. |
DiskCustomerManagedKey
De door de klant beheerde sleutelreferentie om de schijf te versleutelen.
| Name | Type | Description |
|---|---|---|
| identityReference |
De verwijzing van een van de poolidentiteiten om Disk te versleutelen. Deze identiteit wordt gebruikt om toegang te krijgen tot de KeyVault. |
|
| keyUrl |
string |
Volledige versie van de sleutel-URL die verwijst naar een sleutel in KeyVault. Versiesegment van de URL is vereist, ongeacht de waarde rotationToLatestKeyVersionEnabled. |
| rotationToLatestKeyVersionEnabled |
boolean |
Stel deze vlag in op true om het automatisch bijwerken van de schijfversleuteling naar de nieuwste sleutelversie mogelijk te maken. De standaardwaarde is vals. |
DiskEncryptionConfiguration
De schijfversleutelingsconfiguratie die is toegepast op rekenknooppunten in de pool. Schijfversleutelingsconfiguratie wordt niet ondersteund in een Linux-pool die is gemaakt met de installatiekopie van de Azure Compute Gallery.
| Name | Type | Description |
|---|---|---|
| customerManagedKey |
De door de klant beheerde sleutelreferentie om de schijf van het besturingssysteem te versleutelen. De door de klant beheerde sleutel versleutelt de OS-schijf door middel van EncryptionAtRest en standaard versleutelen we ook de gegevensschijf. Het kan alleen worden gebruikt wanneer de pool is geconfigureerd met een identiteit en OsDisk is ingesteld als een van de doelen van DiskEncryption. |
|
| targets |
De lijst met schijfdoelen voor Batch Service wordt versleuteld op het rekenknooppunt. De lijst met schijfdoelen voor Batch Service wordt versleuteld op het rekenknooppunt. |
DiskEncryptionSetParameters
De ARM-bron-id van de set schijfversleuteling.
| Name | Type | Description |
|---|---|---|
| id |
string (arm-id) |
De ARM-bron-id van de set schijfversleuteling. De resource moet deel uitmaken van hetzelfde abonnement als het Batch-account. |
DiskEncryptionTarget
DiskEncryptionTarget-enums
| Waarde | Description |
|---|---|
| osdisk |
De besturingssysteemschijf op het rekenknooppunt is versleuteld. |
| temporarydisk |
De tijdelijke schijf op het rekenknooppunt is versleuteld. Op Linux is deze versleuteling van toepassing op andere partities (zoals partities op gekoppelde gegevensschijven) wanneer versleuteling plaatsvindt tijdens het opstarten. |
DynamicVNetAssignmentScope
DynamicVNetAssignmentScope enums
| Waarde | Description |
|---|---|
| none |
Er is geen dynamische VNet-toewijzing ingeschakeld. |
| job |
Dynamische VNet-toewijzing wordt per taak uitgevoerd. |
ElevationLevel
ElevationLevel-enums
| Waarde | Description |
|---|---|
| nonadmin |
De gebruiker is een standaardgebruiker zonder verhoogde toegang. |
| admin |
De gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. |
EnvironmentSetting
Een omgevingsvariabele die moet worden ingesteld voor een taakproces.
| Name | Type | Description |
|---|---|---|
| name |
string |
De naam van de omgevingsvariabele. |
| value |
string |
De waarde van de omgevingsvariabele. |
HostEndpointSettings
Hiermee geeft u bepaalde instellingen voor hosteindpunten op.
| Name | Type | Description |
|---|---|---|
| inVMAccessControlProfileReferenceId |
string |
Hiermee geeft u de verwijzing naar de resource-id InVMAccessControlProfileVersion op in de vorm van /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}. |
| mode |
Hiermee geeft u de uitvoeringsmodus van het toegangsbeheerbeleid op. |
HostEndpointSettingsModeTypes
HostEndpointSettingsModeTypes enums
| Waarde | Description |
|---|---|
| Audit |
In de controlemodus fungeert het systeem alsof het het toegangsbeheerbeleid afdwingt, inclusief het verzenden van toegangsontkenningsvermeldingen in de logboeken, maar het weigert geen aanvragen voor hosteindpunten. |
| Enforce |
Enforce-modus is de aanbevolen werkwijze en het systeem zal het toegangscontrolebeleid handhaven. Deze eigenschap kan niet worden gebruikt samen met 'inVMAccessControlProfileReferenceId'. |
InboundEndpointProtocol
InboundEndpointProtocol enums
| Waarde | Description |
|---|---|
| tcp |
Gebruik TCP voor het eindpunt. |
| udp |
Gebruik UDP voor het eindpunt. |
IpAddressProvisioningType
IPAddressProvisioningType enums
| Waarde | Description |
|---|---|
| batchmanaged |
Er wordt een openbaar IP-adres gemaakt en beheerd door Batch. Er kunnen meerdere openbare IP-adressen zijn, afhankelijk van de grootte van de pool. |
| usermanaged |
Openbare IP-adressen worden geleverd door de gebruiker en worden gebruikt om de rekenknooppunten in te richten. |
| nopublicipaddresses |
Er wordt geen openbaar IP-adres aangemaakt. |
IPFamily
De IP-families die worden gebruikt om IP-versies op te geven die beschikbaar zijn voor de pool.
| Waarde | Description |
|---|---|
| IPv4 |
IPv4 is beschikbaar voor de pool. |
| IPv6 |
IPv6 is beschikbaar voor de pool. |
IPTag
Bevat de IP-tag die is gekoppeld aan het openbare IP-adres.
| Name | Type | Description |
|---|---|---|
| ipTagType |
string |
Het type IP-tag. Voorbeeld: FirstPartyUsage. |
| tag |
string |
De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: SQL. |
LinuxUserConfiguration
Eigenschappen die worden gebruikt voor het maken van een gebruikersaccount op een Linux-rekenknooppunt.
| Name | Type | Description |
|---|---|---|
| gid |
integer (int32) |
De groeps-ID voor het gebruikersaccount. De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, kiest u de gid. |
| sshPrivateKey |
string (password) |
De SSH privésleutel voor het gebruikersaccount. De persoonlijke sleutel mag niet met een wachtwoord zijn beveiligd. De privésleutel wordt gebruikt om automatisch asymmetrische-sleutelgebaseerde authenticatie voor SSH tussen Compute Nodes in een Linux Pool te configureren wanneer de enableInterNodeCommunication-eigenschap van de pool waar is (deze wordt genegeerd als enableInterNodeCommunication onwaar is). Dit doet u door het sleutelpaar in de map .ssh van de gebruiker te plaatsen. Indien niet gespecificeerd, wordt wachtwoordloze SSH niet geconfigureerd tussen Compute Nodes (er wordt geen wijziging gedaan aan de .ssh-directory van de gebruiker). |
| uid |
integer (int32) |
De gebruikers-ID van het gebruikersaccount. De uid- en gid-eigenschappen moeten samen worden opgegeven of helemaal niet. Als het onderliggende besturingssysteem niet is opgegeven, wordt de uid gekozen. |
LoginMode
LoginMode-enums
| Waarde | Description |
|---|---|
| batch |
De LOGON32_LOGON_BATCH Win32-aanmeldingsmodus. De batchaanmeldingsmodus wordt aanbevolen voor langdurige parallelle processen. |
| interactive |
De LOGON32_LOGON_INTERACTIVE Win32-aanmeldingsmodus. UAC is ingeschakeld op Windows VirtualMachineConfiguration Pools. Als deze optie wordt gebruikt met een verhoogde gebruikersidentiteit in een Windows VirtualMachineConfiguration Pool, wordt de gebruikerssessie niet verhoogd tenzij de applicatie die via de Task-opdrachtregel wordt uitgevoerd is geconfigureerd om altijd beheerdersrechten of altijd maximale rechten te vereisen. |
ManagedDisk
De parameters van de beheerde schijf.
| Name | Type | Description |
|---|---|---|
| diskEncryptionSet |
Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op. Het kan alleen worden ingesteld in de UserSubscription-modus. |
|
| securityProfile |
Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. |
|
| storageAccountType |
Het type opslagaccount voor beheerde schijf. |
MountConfiguration
Het bestandssysteem dat op elk knooppunt moet worden gekoppeld.
| Name | Type | Description |
|---|---|---|
| azureBlobFileSystemConfiguration |
De Azure Storage-container die moet worden gekoppeld met blob FUSE op elk knooppunt. Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. |
|
| azureFileShareConfiguration |
De Azure-bestandsshare die op elk knooppunt moet worden gekoppeld. Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. |
|
| cifsMountConfiguration |
Het CIFS-/SMB-bestandssysteem dat op elk knooppunt moet worden gekoppeld. Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. |
|
| nfsMountConfiguration |
Het NFS-bestandssysteem dat op elk knooppunt moet worden gekoppeld. Deze eigenschap is wederzijds exclusief met alle andere eigenschappen. |
NetworkConfiguration
De netwerkconfiguratie voor een pool.
| Name | Type | Description |
|---|---|---|
| dynamicVNetAssignmentScope |
Het bereik van dynamische vnet-toewijzing. |
|
| enableAcceleratedNetworking |
boolean |
Of deze pool versneld netwerken moet inschakelen. Versneld netwerken maken I/O-virtualisatie met één hoofdmap (SR-IOV) mogelijk voor een VIRTUELE machine, wat kan leiden tot verbeterde netwerkprestaties. Zie voor meer informatie: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview. |
| endpointConfiguration |
De configuratie voor eindpunten op rekenknooppunten in de batchpool. |
|
| publicIPAddressConfiguration |
De openbare IPAddress-configuratie voor rekenknooppunten in de Batch-pool. |
|
| subnetId |
string |
De ARM-resource-identificatie van het virtuele netwerksubnet waar de rekenknooppunten van de pool zich bij zullen voegen. Dit is van het formulier /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnetten/{subnet}. Het virtuele netwerk moet zich in dezelfde regio en hetzelfde abonnement bevinden als het Azure Batch-account. Het opgegeven subnet moet genoeg vrije IP-adressen hebben om het aantal Compute Nodes in de pool te accommoderen. Als het subnet niet genoeg vrije IP-adressen heeft, zal de Pool de Nodes gedeeltelijk toewijzen en zal er een resize-fout optreden. De service-principal 'MicrosoftAzureBatch' moet de rol 'Inzender voor klassieke virtuele machines' hebben Role-Based RBAC-rol (Access Control) voor het opgegeven VNet. Het gespecificeerde subnet moet communicatie vanuit de Azure Batch-service mogelijk maken om taken op de knooppunten te kunnen inplannen. Dit kan worden gecontroleerd door te controleren of het opgegeven VNet gekoppelde netwerkbeveiligingsgroepen (NSG' heeft). Als communicatie met de knooppunten in het opgegeven subnet wordt geweigerd door een NSG, stelt de Batch-service de status van de rekenknooppunten in op onbruikbaar. Alleen ARM-virtuele netwerken ('Microsoft.Network/virtualNetworks') worden ondersteund. Als de gespecificeerde VNet geassocieerde Network Security Groups (NSG) heeft, moeten enkele gereserveerde systeempoorten worden ingeschakeld voor inkomende communicatie, waaronder poorten 29876 en 29877. Schakel ook uitgaande verbindingen met Azure Storage in op poort 443. Zie voor meer informatie: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration |
NetworkSecurityGroupRule
Een regel voor een netwerkbeveiligingsgroep die moet worden toegepast op een binnenkomend eindpunt.
| Name | Type | Description |
|---|---|---|
| access |
De actie die moet worden uitgevoerd voor een opgegeven IP-adres, subnetbereik of tag. |
|
| priority |
integer (int32) |
De prioriteit voor deze regel. Prioriteiten binnen een Pool moeten uniek zijn en worden beoordeeld op volgorde van prioriteit. Hoe lager het getal hoe hoger de prioriteit. Regels kunnen bijvoorbeeld worden opgegeven met ordernummers van 150, 250 en 350. De regel met het volgordenummer 150 heeft voorrang op de regel met een volgorde van 250. Toegestane prioriteiten zijn 150 tot 4096. Als er gereserveerde of dubbele waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| sourceAddressPrefix |
string |
Het bronadresvoorvoegsel of het label dat overeenkomt met de regel. Geldige waarden zijn één IP-adres (bijvoorbeeld 10.10.10.10), IP-subnet (bijvoorbeeld 192.168.1.0/24), standaardtag of * (voor alle adressen). Als er andere waarden worden opgegeven, mislukt de aanvraag met HTTP-statuscode 400. |
| sourcePortRanges |
string[] |
De bronpoortbereiken die overeenkomen met de regel. Geldige waarden zijn '' (voor alle poorten 0 - 65535), een specifieke poort (d.w.z. 22), of een poortbereik (d.w.z. 100-200). De poorten moeten in het bereik van 0 tot 65535 liggen. Elke vermelding in deze collectie mag geen andere vermelding overlappen (noch een bereik noch een individuele poort). Als er andere waarden worden gegeven, faalt het verzoek met HTTP-statuscode 400. De standaardwaarde is ''. |
NetworkSecurityGroupRuleAccess
NetworkSecurityGroupRuleAccess-enums
| Waarde | Description |
|---|---|
| allow |
Toegang toestaan. |
| deny |
Toegang weigeren. |
NfsMountConfiguration
Informatie die wordt gebruikt om verbinding te maken met een NFS-bestandssysteem.
| Name | Type | Description |
|---|---|---|
| mountOptions |
string |
Aanvullende opdrachtregelopties om door te geven aan de koppelingsopdracht. Dit zijn opties voor 'net use' in Windows en opties voor koppelen in Linux. |
| relativeMountPath |
string |
Het relatieve pad op de rekenknoop waar het bestandssysteem wordt gemount. Alle bestandssystemen worden gekoppeld ten opzichte van de map batchkoppelingen, die toegankelijk zijn via de omgevingsvariabele AZ_BATCH_NODE_MOUNTS_DIR. |
| source |
string |
De URI van het bestandssysteem die moet worden gekoppeld. |
OutputFile
Bij elke bestandsupload schrijft de Batch-service twee logboekbestanden naar het rekenknooppunt, 'fileuploadout.txt' en 'fileuploaderr.txt'. Deze logboekbestanden worden gebruikt voor meer informatie over een specifieke fout.
| Name | Type | Description |
|---|---|---|
| destination |
De bestemming voor het uitvoerbestand(en). |
|
| filePattern |
string |
Een patroon dat aangeeft welke bestand(en) geüpload moeten worden. Zowel relatieve als absolute paden worden ondersteund. Relatieve paden zijn relatief aan de Task-werkdirectory. De volgende wildcards worden ondersteund: * komt overeen met 0 of meer tekens (bijvoorbeeld patroon abc* zou overeenkomen met abc of abcdef), ** komt overeen met elke map, ? komt overeen met elk enkel teken, [ABC] komt overeen met één teken tussen haakjes, en [A-C] komt overeen met één teken in het bereik. Haakjes kunnen een negatie bevatten om overeen te komen met elk teken dat niet is gespecificeerd (bijvoorbeeld [!abc] komt overeen met elk teken behalve a, b of c). Als een bestandsnaam begint met "." wordt deze standaard genegeerd, maar kan deze worden gematcht door deze expliciet te specificeren (bijvoorbeeld .gif niet overeenkomt met .a.gif, maar ..gif wel). Een eenvoudig voorbeeld: ***.txt komt overeen met elk bestand dat niet begint met '.' en eindigt met .txt in de Task-werkmap of een submap. Als de bestandsnaam een jokerteken bevat, kan deze worden ontsnapt met haakjes (bijvoorbeeld abc[] zou overeenkomen met een bestand genaamd abc). Let op dat zowel \ als / op Windows als directoryseparators worden behandeld, maar alleen / op Linux. Omgevingsvariabelen (%var% op Windows of $var op Linux) worden uitgewerkt voordat het patroon wordt toegepast. |
| uploadOptions |
Extra opties voor de uploadoperatie, inclusief onder welke voorwaarden de upload moet worden uitgevoerd. |
OutputFileBlobContainerDestination
Hiermee geeft u een doel voor het uploaden van bestanden in een Azure Blob Storage-container op.
| Name | Type | Description |
|---|---|---|
| containerUrl |
string (uri) |
De URL van de container binnen Azure Blob Storage waar het bestand naartoe wordt geüpload. Als er geen beheerde identiteit wordt gebruikt, moet de URL een Shared Access Signature (SAS) bevatten die schrijfrechten aan de container verleent. |
| identityReference |
De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage is gespecificeerd door containerUrl. De identiteit moet schrijftoegang hebben tot de Azure Blob Storage container. |
|
| path |
string |
De bestemmingsblob of virtuele directory binnen de Azure Storage-container. Als filePattern verwijst naar een specifiek bestand (dus geen wildcards bevat), dan is path de naam van de blob waarheen dat bestand wordt geüpload. Als filePattern één of meer jokers bevat (en dus meerdere bestanden kunnen matchen), dan is path de naam van de virtuele directory van de blob (die aan elke blobnaam wordt voorafgezet) waaraan het bestand of de bestanden worden geüpload. Als deze wordt weggelaten, worden bestand(en) geüpload naar de wortel van de container met een blobnaam die overeenkomt met hun bestandsnaam. |
| uploadHeaders |
Een lijst van naam-waarde-paren voor headers die gebruikt kunnen worden bij het uploaden van uitvoerbestanden. Deze headers worden gespecificeerd bij het uploaden van bestanden naar Azure Storage. Officieel document over toegestane headers bij het uploaden van blobs: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types. |
OutputFileDestination
Het doel waarnaar een bestand moet worden geüpload.
| Name | Type | Description |
|---|---|---|
| container |
Een locatie in Azure blob storage waar bestanden naartoe worden geüpload. |
OutputFileUploadCondition
OutputFileUploadCondition-enums
| Waarde | Description |
|---|---|
| tasksuccess |
Upload het bestand(en) pas nadat het Taakproces is afgesloten met een exitcode van 0. |
| taskfailure |
Upload het bestand(en) pas nadat het Taakproces is afgesloten met een niet-nul exitcode. |
| taskcompletion |
Upload het bestand(en) nadat het Taakproces is afgesloten, ongeacht de exitcode. |
OutputFileUploadConfig
Opties voor het uploaden van een uitvoerbestand, waaronder onder welke voorwaarden de upload moet worden uitgevoerd.
| Name | Type | Description |
|---|---|---|
| uploadCondition |
De voorwaarden waaronder het Task-uitvoerbestand of de set bestanden geüpload moet worden. De standaard is taakvoltooiing. |
OutputFileUploadHeader
Een http-headernaam-waardepaar
| Name | Type | Description |
|---|---|---|
| name |
string |
De naamloze naam, die niet in hoofdletters wordt gebruikt bij het uploaden van uitvoerbestanden. |
| value |
string |
De waarde van de header die gebruikt moet worden bij het uploaden van uitvoerbestanden. |
ProxyAgentSettings
Hiermee geeft u ProxyAgent-instellingen op tijdens het maken van de virtuele machine.
| Name | Type | Description |
|---|---|---|
| enabled |
boolean |
Hiermee geeft u op of de functie Metagegevensbeveiligingsprotocol moet worden ingeschakeld op de virtuele-machine of de virtuele-machineschaalset. Standaard is onwaar. |
| imds |
Instellingen voor het IMDS-eindpunt. |
|
| wireServer |
Instellingen voor het WireServer-eindpunt. |
ResourceFile
Eén bestand of meerdere bestanden die moeten worden gedownload naar een rekenknooppunt.
| Name | Type | Description |
|---|---|---|
| autoStorageContainerName |
string |
De naam van de opslagcontainer in het automatische opslagaccount. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. |
| blobPrefix |
string |
Het blobvoorvoegsel dat moet worden gebruikt bij het downloaden van blobs uit een Azure Storage-container. Alleen de blobs waarvan de namen beginnen met het opgegeven voorvoegsel, worden gedownload. De eigenschap is alleen geldig wanneer autoStorageContainerName of storageContainerUrl wordt gebruikt. Dit voorvoegsel kan een gedeeltelijke bestandsnaam of een submap zijn. Als er geen voorvoegsel is opgegeven, worden alle bestanden in de container gedownload. |
| fileMode |
string |
Het kenmerk bestandsmachtigingsmodus in octale indeling. Deze eigenschap geldt alleen voor bestanden die worden gedownload naar Linux Compute Nodes. Het wordt genegeerd als het wordt gespecificeerd voor een resourceFile dat wordt gedownload naar een Windows Compute Node. Als deze eigenschap niet is gespecificeerd voor een Linux Compute Node, wordt een standaardwaarde van 0770 op het bestand toegepast. |
| filePath |
string |
De locatie op de Compute Node waar het bestand(en) naartoe gedownload moet worden, ten opzichte van de werkmap van de Taak. Als de eigenschap httpUrl is opgegeven, is het filePath vereist en wordt het pad beschreven waarnaar het bestand wordt gedownload, inclusief de bestandsnaam. Als anders de eigenschap autoStorageContainerName of storageContainerUrl is opgegeven, is filePath optioneel en is het de map waarin de bestanden moeten worden gedownload. In het geval dat filePath wordt gebruikt als map, wordt elke mapstructuur die al aan de invoergegevens is gekoppeld, volledig bewaard en toegevoegd aan de opgegeven filePath-map. Het opgegeven relatieve pad kan niet uit de werkmap van de Taak ontsnappen (bijvoorbeeld door '..' te gebruiken). |
| httpUrl |
string (uri) |
De URL van het bestand dat u wilt downloaden. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Als de URL verwijst naar Azure Blob Storage, moet deze leesbaar zijn vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een blob in Azure Storage: neem een SAS (Shared Access Signature) die leesmachtigingen voor de blob verleent, gebruik een beheerde identiteit met leesmachtigingen of stel de ACL voor de blob of de container in om openbare toegang toe te staan. |
| identityReference |
De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage, gespecificeerd door storageContainerUrl of httpUrl. |
|
| storageContainerUrl |
string (uri) |
De URL van de blobcontainer in Azure Blob Storage. De eigenschappen autoStorageContainerName, storageContainerUrl en httpUrl sluiten elkaar wederzijds uit en een van deze moet worden opgegeven. Deze URL moet kunnen worden gelezen en vermeld vanuit rekenknooppunten. Er zijn drie manieren om een dergelijke URL op te halen voor een container in Azure Storage: neem een SAS (Shared Access Signature) op die lees- en lijstmachtigingen voor de container verleent, gebruik een beheerde identiteit met lees- en lijstmachtigingen of stel de ACL voor de container in om openbare toegang toe te staan. |
RollingUpgradePolicy
De configuratieparameters die worden gebruikt tijdens het uitvoeren van een rolling upgrade.
| Name | Type | Description |
|---|---|---|
| enableCrossZoneUpgrade |
boolean |
Toestaan dat VMSS AZ-grenzen negeert bij het maken van upgradebatches. Neem rekening met het updatedomein en maxBatchInstancePercent om de batchgrootte te bepalen. Dit veld kan alleen worden ingesteld op waar of onwaar wanneer u NodePlacementConfiguration als zonegebonden gebruikt. |
| maxBatchInstancePercent |
integer (int32) |
Het maximumpercentage van het totale aantal exemplaren van virtuele machines dat tegelijkertijd wordt geüpgraded door de rolling upgrade in één batch. Omdat dit een maximum is, kunnen beschadigde exemplaren in eerdere of toekomstige batches ervoor zorgen dat het percentage exemplaren in een batch afneemt om een hogere betrouwbaarheid te garanderen. De waarde van dit veld moet tussen 5 en 100 liggen, inclusief. Als zowel maxBatchInstancePercent als maxUnhealthyInstancePercent aan waarde zijn toegewezen, mag de waarde van maxBatchInstancePercent niet meer zijn dan maxUnhealthyInstancePercent. |
| maxUnhealthyInstancePercent |
integer (int32) |
Het maximumpercentage van het totale aantal exemplaren van virtuele machines in de schaalset dat tegelijkertijd beschadigd kan zijn, hetzij als gevolg van een upgrade of door de statuscontroles van de virtuele machine te worden aangetroffen voordat de rolling upgrade wordt afgebroken. Deze beperking wordt gecontroleerd voordat u een batch start. De waarde van dit veld moet tussen 5 en 100 liggen, inclusief. Als zowel maxBatchInstancePercent als maxUnhealthyInstancePercent aan waarde zijn toegewezen, mag de waarde van maxBatchInstancePercent niet meer zijn dan maxUnhealthyInstancePercent. |
| maxUnhealthyUpgradedInstancePercent |
integer (int32) |
Het maximumpercentage van bijgewerkte exemplaren van virtuele machines die kunnen worden gevonden, hebben een slechte status. Deze controle vindt plaats nadat elke batch is bijgewerkt. Als dit percentage ooit wordt overschreden, wordt de rolling update afgebroken. De waarde van dit veld moet tussen 0 en 100, inclusief zijn. |
| pauseTimeBetweenBatches |
string (duration) |
De wachttijd tussen het voltooien van de update voor alle virtuele machines in één batch en het starten van de volgende batch. De tijdsduur moet worden opgegeven in ISO 8601-indeling.. |
| prioritizeUnhealthyInstances |
boolean |
Werk alle beschadigde exemplaren in een schaalset bij voordat alle exemplaren in orde zijn. |
| rollbackFailedInstancesOnPolicyBreach |
boolean |
Het terugdraaien van mislukte exemplaren naar het vorige model als het beleid voor rolling upgrades wordt geschonden. |
SecurityEncryptionTypes
SecurityEncryptionTypes enums
| Waarde | Description |
|---|---|
| DiskWithVMGuestState |
EncryptionType van de beheerde schijf is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf samen met VMGuestState-blob. Het wordt niet ondersteund in datadisks. |
| NonPersistedTPM |
EncryptionType van de beheerde schijf is ingesteld op NonPersistedTPM voor het niet persistent zijn van de firmwarestatus in de VMGuestState-blob. |
| VMGuestStateOnly |
Het versleutelingstype van de beheerde schijf is ingesteld op VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob. |
SecurityProfile
Hiermee geeft u de beveiligingsprofielinstellingen voor de virtuele machine of virtuele-machineschaalset op.
| Name | Type | Description |
|---|---|---|
| encryptionAtHost |
boolean |
Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om hostversleuteling voor de virtuele machine of virtuele-machineschaalset in of uit te schakelen. Hierdoor wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource-/tijdelijke schijf op de host zelf. Raadpleeg https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizesvoor meer informatie over versleuteling bij hostvereisten. |
| proxyAgentSettings |
Hiermee geeft u ProxyAgent-instellingen op tijdens het maken van de virtuele machine. |
|
| securityType |
Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. |
|
| uefiSettings |
Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. |
SecurityTypes
Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen.
| Waarde | Description |
|---|---|
| trustedLaunch |
Vertrouwde lancering beschermt tegen geavanceerde en permanente aanvalstechnieken. |
| confidentialvm |
Azure Confidential Computing biedt vertrouwelijke VM's voor tenants met hoge vereisten voor beveiliging en vertrouwelijkheid. Deze VM's bieden een sterke, hardware-afgedwongen grens om te voldoen aan uw beveiligingsbehoeften. U kunt vertrouwelijke VM's gebruiken voor migraties zonder wijzigingen aan te brengen in uw code, waarbij het platform dat de status van uw VIRTUELE machine beveiligt, niet kan worden gelezen of gewijzigd. |
ServiceArtifactReference
Hiermee geeft u de referentie-id voor serviceartefacten op die wordt gebruikt voor het instellen van dezelfde installatiekopieënversie voor alle virtuele machines in de schaalset wanneer u de meest recente installatiekopieënversie gebruikt.
| Name | Type | Description |
|---|---|---|
| id |
string |
De referentie-ID van ServiceArtifactReference van het serviceartefact. De referentie-id van het serviceartefact in de vorm van /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} |
StorageAccountType
StorageAccountType enums
| Waarde | Description |
|---|---|
| standard_lrs |
De gegevensschijf moet gebruikmaken van standaard lokaal redundante opslag. |
| premium_lrs |
De gegevensschijf moet gebruikmaken van premium lokaal redundante opslag. |
| standardssd_lrs |
De gegevensschijf/besturingssysteemschijf moet lokaal redundante standaard-SSD-opslag gebruiken. |
UpgradeMode
UpgradeMode-enums
| Waarde | Description |
|---|---|
| automatic |
Alle virtuele machines in de schaalset worden automatisch tegelijkertijd bijgewerkt. |
| manual |
U bepaalt de toepassing van updates voor virtuele machines in de schaalset. U doet dit met behulp van de manualUpgrade-actie. |
| rolling |
De bestaande exemplaren in een schaalset worden neergezet in batches die moeten worden bijgewerkt. Zodra de bijgewerkte batch is voltooid, beginnen de exemplaren opnieuw met verkeer en wordt de volgende batch gestart. Dit gaat door totdat alle exemplaren up-to-date zijn gebracht. |
UpgradePolicy
Beschrijft een upgradebeleid: automatisch, handmatig of rolling.
| Name | Type | Description |
|---|---|---|
| automaticOSUpgradePolicy |
Configuratieparameters die worden gebruikt voor het uitvoeren van automatische upgrade van het besturingssysteem. De configuratieparameters die worden gebruikt voor het uitvoeren van automatische upgrade van het besturingssysteem. |
|
| mode |
Hiermee geeft u de modus van een upgrade naar virtuele machines in de schaalset. |
|
| rollingUpgradePolicy |
De configuratieparameters die worden gebruikt tijdens het uitvoeren van een rolling upgrade. |
UserAccount
Eigenschappen die worden gebruikt om een gebruiker te maken die wordt gebruikt om taken uit te voeren op een Azure Batch Compute-knooppunt.
| Name | Type | Description |
|---|---|---|
| elevationLevel |
Het hoogteniveau van het gebruikersaccount. De standaardwaarde is nietAdmin. |
|
| linuxUserConfiguration |
De Linux-specifieke gebruikersconfiguratie voor het gebruikersaccount. Deze eigenschap wordt genegeerd als deze is gespecificeerd op een Windows Pool. Als dit niet is opgegeven, wordt de gebruiker gemaakt met de standaardopties. |
|
| name |
string |
De naam van het gebruikersaccount. Namen kunnen Unicode-tekens bevatten tot een maximale lengte van 20. |
| password |
string (password) |
Het wachtwoord voor het gebruikersaccount. |
| windowsUserConfiguration |
De Windows-specifieke gebruikersconfiguratie voor het gebruikersaccount. Deze eigenschap kan alleen worden gespecificeerd als de gebruiker zich op een Windows Pool bevindt. Als dit niet is gespecificeerd en op een Windows Pool zit, wordt de gebruiker aangemaakt met de standaardopties. |
UserIdentity
De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. Geef de eigenschap userName of autoUser op, maar niet beide.
| Name | Type | Description |
|---|---|---|
| autoUser |
De automatische gebruiker waaronder de taak wordt uitgevoerd. De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. |
|
| username |
string |
De naam van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven. |
VirtualMachineConfiguration
De configuratie voor rekenknooppunten in een pool op basis van de Azure Virtual Machines-infrastructuur.
| Name | Type | Description |
|---|---|---|
| containerConfiguration |
De containerconfiguratie voor de Pool. Indien gespecificeerd, wordt de setup uitgevoerd op elke rekenknoop in de pool om taken in containers te laten draaien. Alle reguliere taken en taakmanagertaken die op deze pool draaien, moeten de containerSettings-eigenschap specificeren, en alle andere taken kunnen dit specificeren. |
|
| dataDisks |
Data |
De configuratie voor datadisks die zijn aangesloten op de Compute Nodes in de pool. Deze eigenschap moet worden gespecificeerd als de rekenknooppunten in de pool lege datadisks aan zich moeten koppelen. Dit kan niet worden bijgewerkt. Elke Compute Node krijgt zijn eigen schijf (de schijf is geen bestandsdeling). Bestaande schijven kunnen niet worden aangesloten, elke aangesloten schijf is leeg. Wanneer de Compute Node uit de pool wordt verwijderd, worden de schijf en alle bijbehorende gegevens ook verwijderd. De schijf wordt niet geformatteerd nadat hij is aangesloten, hij moet voor gebruik worden geformatteerd - voor meer informatie zie https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux en https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine. |
| diskEncryptionConfiguration |
De schijfversleutelingsconfiguratie voor de pool. Indien opgegeven, wordt versleuteling uitgevoerd op elk knooppunt in de pool tijdens het inrichten van knooppunten. |
|
| extensions |
De extensie van de virtuele machine voor de pool. Indien opgegeven, worden de extensies die in deze configuratie worden genoemd, op elk knooppunt geïnstalleerd. |
|
| imageReference |
Een verwijzing naar de Marketplace-installatiekopieën van Azure Virtual Machines of de aangepaste vm-installatiekopieën die u wilt gebruiken. |
|
| licenseType |
string |
Dit geldt alleen voor images die het Windows-besturingssysteem bevatten, en mogen alleen worden gebruikt als je geldige on-premises licenties hebt voor de Compute Nodes die worden uitgerold. Als u dit weglaat, wordt er geen korting op on-premises licenties toegepast. Waarden zijn: Windows_Server: de on-premises licentie is voor Windows Server. Windows_Client: de on-premises licentie is voor Windows Client. |
| nodeAgentSKUId |
string |
De SKU van de Batch Compute Node-agent die moet worden ingericht op rekenknooppunten in de pool. De Batch Compute Node-agent is een programma dat wordt uitgevoerd op elk rekenknooppunt in de pool en biedt de opdracht-en-beheerinterface tussen het rekenknooppunt en de Batch-service. Er zijn verschillende implementaties van de Compute Node-agent, ook wel SKU's genoemd, voor verschillende besturingssystemen. U moet een rekenknooppuntagent-SKU opgeven die overeenkomt met de geselecteerde afbeeldingsreferentie. Zie de bewerking Ondersteunde SKU's voor compute-knooppuntagenten samen met de lijst met geverifieerde afbeeldingsverwijzingen voor de lijst met ondersteunde SKU's voor compute-knooppuntagenten. |
| nodePlacementConfiguration |
De configuratie van de plaatsing van knooppunten voor de pool. Met deze configuratie worden regels opgegeven voor de manier waarop knooppunten in de pool fysiek worden toegewezen. |
|
| osDisk |
Instellingen voor de besturingssysteemschijf van de virtuele machine. |
|
| securityProfile |
Hiermee geeft u de beveiligingsprofielinstellingen voor de virtuele machine of virtuele-machineschaalset op. |
|
| serviceArtifactReference |
Hiermee geeft u de referentie-id voor serviceartefacten op die wordt gebruikt voor het instellen van dezelfde installatiekopieënversie voor alle virtuele machines in de schaalset wanneer u de meest recente installatiekopieënversie gebruikt. De referentie-id van het serviceartefact in de vorm van /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} |
|
| windowsConfiguration |
Windows-besturingssysteeminstellingen op de virtuele machine. Deze eigenschap mag niet worden gespecificeerd als de imageReference-eigenschap een Linux OS-image specificeert. |
VMExtension
De configuratie voor extensies van virtuele machines.
| Name | Type | Description |
|---|---|---|
| autoUpgradeMinorVersion |
boolean |
Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true. |
| enableAutomaticUpgrade |
boolean |
Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is. |
| name |
string |
De naam van de extensie van de virtuele machine. |
| protectedSettings |
object |
De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten. |
| provisionAfterExtensions |
string[] |
De verzameling extensienamen. Verzameling extensienamen waarna deze extensie moet worden ingericht. |
| publisher |
string |
De naam van de uitgever van de extensie-handler. |
| settings |
object |
Openbare instellingen met JSON-indeling voor de extensie. |
| type |
string |
Het type verlenging. |
| typeHandlerVersion |
string |
De versie van de scripthandler. |
WindowsConfiguration
Windows-besturingssysteeminstellingen die van toepassing zijn op de virtuele machine.
| Name | Type | Description |
|---|---|---|
| enableAutomaticUpdates |
boolean |
Of automatische updates zijn ingeschakeld op de virtuele machine. Als u dit weglaat, is de standaardwaarde waar. |
WindowsUserConfiguration
Eigenschappen die worden gebruikt voor het maken van een gebruikersaccount op een Windows-rekenknooppunt.
| Name | Type | Description |
|---|---|---|
| loginMode |
De inlogmodus voor de gebruiker. De standaard is 'batch'. |