Pools - Replace Pool Properties

Er is geen inhoud die voor deze aanvraag kan worden verzonden, maar de headers kunnen nuttig zijn.

Kopteksten

• DataServiceId: string
• ETag: string
• Last-Modified: string
• client-request-id: string
• request-id: string

BatchError

Een onverwachte foutreactie.

ElevationLevel

Het hoogteniveau van de automatische gebruiker. De standaardwaarde is nietAdmin.

AutoUserScope

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.

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}).

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.

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

BatchErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

string

Een id die de betekenis van de eigenschap Waarde aangeeft.

string

De aanvullende informatie die is opgenomen in het foutbericht.

string

De taalcode van het foutbericht.

string

De tekst van het bericht.

string

De naam van het metagegevensitem.

string

De waarde van het metagegevensitem.

string (arm-id)

De ARM-resource-id van de door de gebruiker toegewezen identiteit.

BatchApplicationPackageReference[]

De lijst met toepassingspakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. De lijst vervangt alle bestaande verwijzingen naar toepassingspakketten in de groep. Wijzigingen in toepassingspakketverwijzingen zijn van invloed op alle nieuwe rekenknooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die al in de pool staan totdat ze opnieuw worden opgestart of opnieuw worden gemaakt. Er zijn maximaal 10 toepassingspakketverwijzingen voor een bepaalde groep. Als u dit weglaat of als u een lege verzameling opgeeft, worden bestaande verwijzingen naar toepassingspakketten uit de groep verwijderd. Er kunnen maximaal 10 verwijzingen worden opgegeven voor een bepaalde groep.

BatchMetadataItem[]

Een lijst met naam-waardeparen die zijn gekoppeld aan de pool als metagegevens. Deze lijst vervangt alle bestaande metagegevens die zijn geconfigureerd voor de pool. Als u dit weglaat of als u een lege verzameling opgeeft, worden bestaande metagegevens uit de pool verwijderd.

BatchStartTask

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. Als dit element aanwezig is, overschrijft het alle bestaande StartTask. Als u dit weglaat, wordt een bestaande StartTask verwijderd uit de pool.

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).

BatchTaskContainerSettings

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.

EnvironmentSetting[]

Een lijst met omgevingsvariabele-instellingen voor de StartTask.

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).

ResourceFile[]

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.

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.

ContainerHostBatchBindMountEntry[]

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.

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.

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.

ContainerRegistryReference

Het privéregister dat de containerafbeelding bevat. Deze instelling kan worden weggelaten als deze al bij het aanmaken van het zwembad was aangegeven.

ContainerWorkingDirectory

De locatie van de container Task werkdirectory. De standaardwaarde is taskWorkingDirectory.

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.

ContainerHostDataPath

Het pad dat aan de containerklant wordt gekoppeld, kan worden geselecteerd.

BatchNodeIdentityReference

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.

string (password)

Het wachtwoord om u aan te melden bij de registerserver.

string (uri)

De register-URL. Als u dit weglaat, is de standaardwaarde 'docker.io'.

string

De gebruikersnaam om u aan te melden bij de registerserver.

string

De naam van de omgevingsvariabele.

string

De waarde van de omgevingsvariabele.

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.

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.

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.

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).

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.

BatchNodeIdentityReference

De verwijzing naar de door de gebruiker toegewezen identiteit om toegang te krijgen tot Azure Blob Storage, gespecificeerd door storageContainerUrl of httpUrl.

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.

AutoUserSpecification

De automatische gebruiker waaronder de taak wordt uitgevoerd. De eigenschappen userName en autoUser sluiten elkaar wederzijds uit; u moet één, maar niet beide opgeven.

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.