Pool - Update Properties
Updates de eigenschappen van de opgegeven pool.
Hiermee worden alle bijwerkbare eigenschappen van de pool volledig vervangen. Als er bijvoorbeeld aan de pool een StartTask is gekoppeld en als StartTask niet is opgegeven met deze aanvraag, verwijdert de Batch-service de bestaande StartTask.
POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2023-11-01.18.0
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
batch
|
path | True |
string |
De basis-URL voor alle Azure Batch serviceaanvragen. |
pool
|
path | True |
string |
De id van de pool die moet worden bijgewerkt. |
api-version
|
query | True |
string |
Client-API-versie. |
timeout
|
query |
integer int32 |
De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. |
Aanvraagkoptekst
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
client-request-id |
string uuid |
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 client-request-id in het antwoord moet retourneren. |
|
ocp-date |
string date-time-rfc1123 |
Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige systeemkloktijd; stel dit expliciet in als u de REST API rechtstreeks aanroept. |
Aanvraagbody
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
applicationPackageReferences | True |
De lijst met toepassingspakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. |
|
certificateReferences | True |
Een lijst met certificaten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie . |
|
metadata | True |
Een lijst met naam-waardeparen die als metagegevens zijn gekoppeld aan de pool. |
|
startTask |
Een taak die moet worden uitgevoerd op elk rekenknooppunt wanneer het lid wordt van de pool. De taak wordt uitgevoerd wanneer het rekenknooppunt wordt toegevoegd aan de pool of wanneer het rekenknooppunt opnieuw wordt gestart. |
||
targetNodeCommunicationMode |
De gewenste knooppuntcommunicatiemodus voor de pool. |
Antwoorden
Name | Type | Description |
---|---|---|
204 No Content |
De aanvraag voor de Batch-service is geslaagd. Headers
|
|
Other Status Codes |
De fout van de Batch-service. |
Beveiliging
azure_auth
Microsoft Entra OAuth 2.0-verificatiecodestroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Authorization
Type:
apiKey
In:
header
Voorbeelden
Pool update
Sample Request
POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2023-11-01.18.0
{
"startTask": {
"commandLine": "/bin/bash -c 'echo start task'"
},
"certificateReferences": [],
"applicationPackageReferences": [],
"metadata": []
}
Sample Response
Definities
Name | Description |
---|---|
Application |
Een verwijzing naar een pakket dat moet worden geïmplementeerd op rekenknooppunten. |
Auto |
Het bereik voor de automatische gebruiker |
Auto |
Hiermee geeft u de parameters voor de automatische gebruiker die een taak uitvoert op de Batch-service. |
Batch |
Een foutbericht ontvangen van de Azure Batch-service. |
Batch |
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie. |
Certificate |
Een verwijzing naar een certificaat dat moet worden geïnstalleerd op rekenknooppunten in een pool. |
Certificate |
De locatie van het certificaatarchief op het rekenknooppunt waarin het certificaat moet worden geïnstalleerd. |
Certificate |
Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat. |
Compute |
De verwijzing naar een door de gebruiker toegewezen identiteit die is gekoppeld aan de Batch-pool die door een rekenknooppunt wordt gebruikt. |
Container |
Een privécontainerregister. |
Container |
De locatie van de werkmap van de containertaak. |
Elevation |
Het hoogteniveau van de gebruiker. |
Environment |
Een omgevingsvariabele die moet worden ingesteld voor een taakproces. |
Error |
Een foutbericht ontvangen in een Azure Batch antwoord. |
Metadata |
Een naam-waardepaar dat is gekoppeld aan een Batch-serviceresource. |
Node |
Bepaalt hoe een pool communiceert met de Batch-service. |
Pool |
De set wijzigingen die moeten worden aangebracht in een pool. |
Resource |
Eén bestand of meerdere bestanden die moeten worden gedownload naar een rekenknooppunt. |
Start |
Een taak die wordt uitgevoerd wanneer een knooppunt lid wordt van een pool in de Azure Batch-service of wanneer het rekenknooppunt opnieuw wordt opgestart of opnieuw wordt geïnstalleerd. |
Task |
De containerinstellingen voor een taak. |
User |
De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. |
ApplicationPackageReference
Een verwijzing naar een pakket dat moet worden geïmplementeerd op rekenknooppunten.
Name | Type | Description |
---|---|---|
applicationId |
string |
De id van de toepassing die moet worden geïmplementeerd. |
version |
string |
De versie van de toepassing die moet worden geïmplementeerd. Als u dit weglaat, wordt de standaardversie geïmplementeerd. |
AutoUserScope
Het bereik voor de automatische gebruiker
Name | Type | Description |
---|---|---|
pool |
string |
Hiermee geeft u op dat de taak wordt uitgevoerd als het algemene automatische gebruikersaccount dat wordt gemaakt op elk rekenknooppunt in een pool. |
task |
string |
Hiermee geeft u op dat de service een nieuwe gebruiker voor de taak moet maken. |
AutoUserSpecification
Hiermee geeft u de parameters voor de automatische gebruiker die een taak uitvoert op de Batch-service.
Name | Type | Description |
---|---|---|
elevationLevel |
Het hoogteniveau van de automatische gebruiker. |
|
scope |
Het bereik voor de automatische gebruiker |
BatchError
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 Value aangeeft. |
value |
string |
De aanvullende informatie die is opgenomen in de foutreactie. |
CertificateReference
Een verwijzing naar een certificaat dat moet worden geïnstalleerd op rekenknooppunten in een pool.
Name | Type | Description |
---|---|---|
storeLocation |
De locatie van het certificaatarchief op het rekenknooppunt waarin het certificaat moet worden geïnstalleerd. |
|
storeName |
string |
De naam van het certificaatarchief op het rekenknooppunt waarin het certificaat moet worden geïnstalleerd. |
thumbprint |
string |
De vingerafdruk van het certificaat. |
thumbprintAlgorithm |
string |
Het algoritme waaraan de vingerafdruk is gekoppeld. Dit moet sha1 zijn. |
visibility |
Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat. |
CertificateStoreLocation
De locatie van het certificaatarchief op het rekenknooppunt waarin het certificaat moet worden geïnstalleerd.
Name | Type | Description |
---|---|---|
currentuser |
string |
Certificaten moeten worden geïnstalleerd in het certificaatarchief CurrentUser. |
localmachine |
string |
Certificaten moeten worden geïnstalleerd in het LocalMachine-certificaatarchief. |
CertificateVisibility
Welke gebruikersaccounts op het rekenknooppunt moeten toegang hebben tot de persoonlijke gegevens van het certificaat.
Name | Type | Description |
---|---|---|
remoteuser |
string |
Het certificaat moet zichtbaar zijn voor de gebruikersaccounts waaronder gebruikers extern toegang hebben tot het rekenknooppunt. |
starttask |
string |
Het certificaat moet zichtbaar zijn voor het gebruikersaccount waaronder de StartTask wordt uitgevoerd. Houd er rekening mee dat als AutoUser-bereik pool is voor zowel de StartTask als een taak, dit certificaat ook zichtbaar is voor de taak. |
task |
string |
Het certificaat moet zichtbaar zijn voor de gebruikersaccounts waaronder taaktaken worden uitgevoerd. |
ComputeNodeIdentityReference
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 |
De ARM-resource-id van de door de gebruiker toegewezen identiteit. |
ContainerRegistry
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 gebruikersnaam en wachtwoord. |
|
password |
string |
Het wachtwoord om u aan te melden bij de registerserver. |
registryServer |
string |
De register-URL. |
username |
string |
De gebruikersnaam om u aan te melden bij de registerserver. |
ContainerWorkingDirectory
De locatie van de werkmap van de containertaak.
Name | Type | Description |
---|---|---|
containerImageDefault |
string |
Gebruik de werkmap die is gedefinieerd in de containerinstallatiekopieën. Deze map bevat niet de bronbestanden die door Batch zijn gedownload. |
taskWorkingDirectory |
string |
Gebruik de standaardwerkmap taak van de Batch-service, die de taakbronbestanden bevat die door Batch worden gevuld. |
ElevationLevel
Het hoogteniveau van de gebruiker.
Name | Type | Description |
---|---|---|
admin |
string |
De gebruiker is een gebruiker met verhoogde toegang en werkt met volledige beheerdersmachtigingen. |
nonadmin |
string |
De gebruiker is een standaardgebruiker zonder verhoogde toegang. |
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. |
ErrorMessage
Een foutbericht ontvangen in een Azure Batch antwoord.
Name | Type | Description |
---|---|---|
lang |
string |
De taalcode van het foutbericht |
value |
string |
De tekst van het bericht. |
MetadataItem
Een naam-waardepaar dat is gekoppeld aan een Batch-serviceresource.
Name | Type | Description |
---|---|---|
name |
string |
De naam van het metagegevensitem. |
value |
string |
De waarde van het metagegevensitem. |
NodeCommunicationMode
Bepaalt hoe een pool communiceert met de Batch-service.
Name | Type | Description |
---|---|---|
classic |
string |
Voor knooppunten die de klassieke communicatiemodus gebruiken, is binnenkomende TCP-communicatie vereist op poorten 29876 en 29877 van batchnodemanagement. Servicetag {region} en uitgaande TCP-communicatie op poort 443 naar storage.region en BatchNodeManagement. {region}'-servicetags. |
default |
string |
De communicatiemodus voor het knooppunt wordt automatisch ingesteld door de Batch-service. |
simplified |
string |
Knooppunten die de vereenvoudigde communicatiemodus gebruiken, vereisen uitgaande TCP-communicatie op poort 443 naar batchnodemanagement. Servicetag {region}. Er zijn geen open binnenkomende poorten vereist. |
PoolUpdatePropertiesParameter
De set wijzigingen die moeten worden aangebracht in een pool.
Name | Type | Description |
---|---|---|
applicationPackageReferences |
De lijst met toepassingspakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. |
|
certificateReferences |
Een lijst met certificaten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. Waarschuwing: deze eigenschap is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie . |
|
metadata |
Een lijst met naam-waardeparen die zijn gekoppeld aan de pool als metagegevens. |
|
startTask |
Een taak die moet worden uitgevoerd op elk rekenknooppunt wanneer het lid wordt van de pool. De taak wordt uitgevoerd wanneer het rekenknooppunt wordt toegevoegd aan de pool of wanneer het rekenknooppunt opnieuw wordt opgestart. |
|
targetNodeCommunicationMode |
De gewenste knooppuntcommunicatiemodus voor de pool. |
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. |
blobPrefix |
string |
Het blobvoorvoegsel dat moet worden gebruikt bij het downloaden van blobs uit een Azure Storage-container. Alleen de blobs waarvan de naam begint met het opgegeven voorvoegsel, worden gedownload. |
fileMode |
string |
Het kenmerk bestandsmachtigingsmodus in octale indeling. |
filePath |
string |
De locatie op het rekenknooppunt waarnaar het bestand(en) moet worden gedownload, ten opzichte van de werkmap van de taak. |
httpUrl |
string |
De URL van het bestand dat u wilt downloaden. |
identityReference |
De verwijzing naar de door de gebruiker toegewezen identiteit die moet worden gebruikt voor toegang tot Azure Blob Storage opgegeven door storageContainerUrl of httpUrl |
|
storageContainerUrl |
string |
De URL van de blobcontainer in Azure Blob Storage. |
StartTask
Een taak die wordt uitgevoerd wanneer een knooppunt lid wordt van een pool in de Azure Batch-service of wanneer het rekenknooppunt opnieuw wordt opgestart of opnieuw wordt geïnstalleerd.
Name | Type | Description |
---|---|---|
commandLine |
string |
De opdrachtregel van de StartTask. |
containerSettings |
De instellingen voor de container waaronder StartTask wordt uitgevoerd. |
|
environmentSettings |
Een lijst met omgevingsvariabeleinstellingen voor de StartTask. |
|
maxTaskRetryCount |
integer |
Het maximum aantal keren dat de taak opnieuw kan worden geprobeerd. |
resourceFiles |
Een lijst met bestanden die door de Batch-service worden gedownload naar het rekenknooppunt voordat de opdrachtregel wordt uitgevoerd. 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 gebeurt, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip-bestanden, toepassingspakketten of Docker-containers. |
|
userIdentity |
De gebruikersidentiteit waaronder de StartTask wordt uitgevoerd. |
|
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. |
TaskContainerSettings
De containerinstellingen voor een taak.
Name | Type | Description |
---|---|---|
containerRunOptions |
string |
Aanvullende opties voor de opdracht container maken. |
imageName |
string |
De installatiekopieën die moeten worden gebruikt om de container te maken waarin de taak wordt uitgevoerd. |
registry |
Het persoonlijke register dat de containerinstallatiekopieën bevat. |
|
workingDirectory |
De locatie van de werkmap van de containertaak. |
UserIdentity
De definitie van de gebruikersidentiteit waaronder de taak wordt uitgevoerd.
Name | Type | Description |
---|---|---|
autoUser |
De automatische gebruiker waaronder de taak wordt uitgevoerd. |
|
username |
string |
De naam van de gebruikersidentiteit waaronder de taak wordt uitgevoerd. |