Megosztás a következőn keresztül:


Pool - Patch

Frissíti a megadott készlet tulajdonságait.
Ez csak a kérelemben megadott készlettulajdonságokat cseréli le. Ha például a készlethez egy StartTask van társítva, és egy kérés nem ad meg StartTask elemet, akkor a készlet megtartja a meglévő StartTask-elemet.

PATCH {batchUrl}/pools/{poolId}?api-version=2024-07-01.20.0
PATCH {batchUrl}/pools/{poolId}?timeout={timeout}&api-version=2024-07-01.20.0

URI-paraméterek

Name In Kötelező Típus Description
batchUrl
path True

string

Az Összes Azure Batch-szolgáltatáskérés alap URL-címe.

poolId
path True

string

A frissíteni kívánt készlet azonosítója.

api-version
query True

string

Ügyfél API-verziója.

timeout
query

integer (int32)

A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor a rendszer az alapértelmezett értéket használja.

Kérelem fejléce

Media Types: "application/json; odata=minimalmetadata"

Name Kötelező Típus Description
client-request-id

string (uuid)

A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.

ocp-date

string (date-time-rfc1123)

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha közvetlenül a REST API-t hívja meg.

If-Match

string

Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban pontosan megegyezik az ügyfél által megadott értékkel.

If-None-Match

string

Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban nem egyezik meg az ügyfél által megadott értékkel.

If-Modified-Since

string (date-time-rfc1123)

Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta módosult.

If-Unmodified-Since

string (date-time-rfc1123)

Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta nem módosult.

Kérelem törzse

Media Types: "application/json; odata=minimalmetadata"

Name Típus Description
applicationPackageReferences

ApplicationPackageReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt csomagok listája.
A Csomaghivatkozások módosítása hatással van a készlethez csatlakozó összes új csomópontra, de a készletben lévő számítási csomópontokat nem érinti, amíg újra nem indítja vagy újra nem alakítja őket. Ha ez az elem jelen van, lecseréli a meglévő csomaghivatkozásokat. Ha üres gyűjteményt ad meg, az összes csomaghivatkozás el lesz távolítva a készletből. Ha nincs megadva, a meglévő csomaghivatkozások változatlanok maradnak.

certificateReferences

CertificateReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt tanúsítványok listája.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő tanúsítványhivatkozásokat. Ha nincs megadva, a meglévő tanúsítványhivatkozások változatlanok maradnak. Windows-csomópontok esetén a Batch szolgáltatás telepíti a tanúsítványokat a megadott tanúsítványtárolóba és helyre. Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárban lévő könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy "tanúsítvány" könyvtárat a felhasználó kezdőkönyvtárában (például /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve.

Figyelmeztetés: Ez a tulajdonság elavult, és 2024 februárja után törlődik. Ehelyett használja az Azure KeyVault-bővítményt.

displayName

string

A készlet megjelenítendő neve.
A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.

Ez a mező csak akkor frissíthető, ha a készlet üres.

enableInterNodeCommunication

boolean

Azt jelzi, hogy a készlet engedélyezi-e a közvetlen kommunikációt a számítási csomópontok között.
A csomópontok közötti kommunikáció engedélyezése korlátozza a készlet maximális méretét a készlet számítási csomópontjaira vonatkozó üzembehelyezési korlátozások miatt. Ez azt eredményezheti, hogy a készlet nem éri el a kívánt méretet. Az alapértelmezett érték hamis.

Ez a mező csak akkor frissíthető, ha a készlet üres.

metadata

MetadataItem[]

A készlethez metaadatként társított név-érték párok listája.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő metaadatokat. Ha üres gyűjteményt ad meg, a rendszer eltávolítja a metaadatokat a készletből. Ha nincs megadva, a meglévő metaadatok változatlanok maradnak.

mountConfiguration

MountConfiguration[]

A tároló csatlakoztatása a megadott fájlrendszerrel a készlet teljes élettartama alatt.
Csatlakoztassa a tárolót azure fileshare, NFS, CIFS vagy Blobfuse alapú fájlrendszer használatával.

Ez a mező csak akkor frissíthető, ha a készlet üres.

networkConfiguration

NetworkConfiguration

A készlet hálózati konfigurációja.
Ez a mező csak akkor frissíthető, ha a készlet üres.

resourceTags

object

A készlethez társított felhasználó által megadott címkék.
Az Azure Batch-készlethez társítandó felhasználó által definiált címkék. Ha meg van adva, a rendszer propagálja ezeket a címkéket a készlethez társított háttérbeli Azure-erőforrásokra. Ez a tulajdonság csak akkor adható meg, ha a Batch-fiókot a poolAllocationMode tulajdonsággal hozták létre a "UserSubscription" értékre állítva.

Ez a mező csak akkor frissíthető, ha a készlet üres.

startTask

StartTask

A készlethez való csatlakozáskor az egyes számítási csomópontokon futtatandó feladat. A feladat akkor fut, amikor a számítási csomópontot hozzáadják a készlethez, vagy amikor a számítási csomópont újraindul.
Ha ez az elem jelen van, felülírja a meglévő StartTaskot. Ha nincs megadva, a meglévő StartTask változatlan marad.

targetNodeCommunicationMode

NodeCommunicationMode

A készlet kívánt csomópontkommunikációs módja.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő célNodeCommunicationMode-t. Ha nincs megadva, a meglévő metaadatok változatlanok maradnak.

taskSchedulingPolicy

TaskSchedulingPolicy

A tevékenységek elosztása a készlet számítási csomópontjai között.
Ha nincs megadva, az alapértelmezett oldalpár.

Ez a mező csak akkor frissíthető, ha a készlet üres.

taskSlotsPerNode

integer (int32)

A készlet egyetlen számítási csomópontján egyidejű feladatok futtatásához használható feladathelyek száma.
Az alapértelmezett érték 1. A maximális érték a készlet VmSize-jének 4-szerese, vagy 256.

Ez a mező csak akkor frissíthető, ha a készlet üres.

upgradePolicy

UpgradePolicy

A készlet frissítési szabályzata.
Egy frissítési szabályzatot ír le – automatikus, manuális vagy működés közben.

Ez a mező csak akkor frissíthető, ha a készlet üres.

userAccounts

UserAccount[]

A készlet egyes számítási csomópontjain létrehozandó felhasználói fiókok listája.
Ez a mező csak akkor frissíthető, ha a készlet üres.

virtualMachineConfiguration

VirtualMachineConfiguration

A készlet virtuálisgép-konfigurációja.
Ezt a tulajdonságot meg kell adni.

Ez a mező csak akkor frissíthető, ha a készlet üres.

vmSize

string

A virtuális gépek mérete a készletben. A készlet összes virtuális gépe azonos méretű.
A készletekben elérhető virtuális gépek méretéről további információt az Azure Batch-készletben (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) található számítási csomópontok virtuálisgép-méretének kiválasztása című témakörben talál.

Ez a mező csak akkor frissíthető, ha a készlet üres.

Válaszok

Name Típus Description
200 OK

A Batch szolgáltatásnak küldött kérés sikeres volt.

Fejlécek

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Típus: apiKey
In: header

Példák

Patch the Pool

Mintakérelem

PATCH account.region.batch.azure.com/pools/poolId?api-version=2024-07-01.20.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  }
}

Mintaválasz

Definíciók

Name Description
ApplicationPackageReference

Hivatkozás a számítási csomópontokon üzembe helyezendő csomagra.

AutomaticOSUpgradePolicy

Az operációs rendszer automatikus frissítéséhez használt konfigurációs paraméterek.

AutoUserScope

Az automatikus felhasználó hatóköre

AutoUserSpecification

Megadja annak az automatikus felhasználónak a paramétereit, aki egy feladatot futtat a Batch szolgáltatásban.

AzureBlobFileSystemConfiguration

Az Azure Storage-tárolóhoz Blobfuse használatával való csatlakozáshoz használt információk.

AzureFileShareConfiguration

Az Azure Fileshare-hoz való csatlakozáshoz használt információk.

BatchError

Az Azure Batch szolgáltatástól kapott hibaválasz.

BatchErrorDetail

Az Azure Batch-hibaválaszban szereplő további információk egy eleme.

CachingType

A lemezen engedélyezendő gyorsítótárazás típusa.

CertificateReference

Hivatkozás egy készlet számítási csomópontjaira telepíteni kívánt tanúsítványra.

CertificateStoreLocation

A tanúsítványtároló helye a számítási csomóponton, ahová telepíteni szeretné a tanúsítványt.

CertificateVisibility

A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz.

CIFSMountConfiguration

A CIFS-fájlrendszerhez való csatlakozáshoz használt információk.

ComputeNodeFillType

A tevékenységek elosztása a készlet számítási csomópontjai között.

ComputeNodeIdentityReference

A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.

ContainerConfiguration

A tárolóbarát készletek konfigurációja.

ContainerHostBatchBindMountEntry

A feladattárolóba csatlakoztatni kívánt elérési út és csatlakoztatási mód bejegyzése.

ContainerHostDataPath

A tárolófeladat tárolójára csatlakoztatni kívánt elérési utak.

ContainerRegistry

Egy privát tárolóregisztrációs adatbázis.

ContainerType

A használandó tárolótechnológia.

ContainerWorkingDirectory

A tároló tevékenység munkakönyvtárának helye.

DataDisk

A készlet számítási csomópontjaihoz társított adatlemezek által használt beállítások. Csatolt adatlemezek használatakor a virtuális gépen belülről kell csatlakoztatnia és formáznia a lemezeket a használatukhoz.

DiffDiskPlacement

A készletben lévő összes számítási csomóponthoz (virtuális géphez) tartozó operációsrendszer-lemez rövid élettartamú lemezelhelyezését adja meg.

DiffDiskSettings

Megadja a számítási csomópont (VM) által használt operációsrendszer-lemez rövid élettartamú lemezbeállításait.

DiskEncryptionConfiguration

A készlet számítási csomópontjaira alkalmazott lemeztitkosítási konfiguráció. A lemeztitkosítás konfigurálása nem támogatott az Azure Compute Gallery rendszerképével létrehozott Linux-készletben.

DiskEncryptionTarget

A Batch Szolgáltatás titkosítja a lemezcélok listáját a számítási csomóponton.

DynamicVNetAssignmentScope

A dinamikus virtuális hálózatok hozzárendelésének hatóköre.

ElevationLevel

A felhasználó szintemelési szintje.

EnvironmentSetting

Egy tevékenységfolyamathoz beállítandó környezeti változó.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

ImageReference

Egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre mutató hivatkozás. Az Azure Marketplace-rendszerképek Azure Batch által ellenőrzött hivatkozásainak listáját a "Támogatott képek listázása" műveletet tekintheti meg.

InboundEndpointProtocol

A végpont protokollja.

InboundNATPool

Bejövő NAT-készlet, amely a Batch-készletben lévő számítási csomópontok adott portjainak külső kezelésére használható.

IPAddressProvisioningType

A készlet nyilvános IP-címeinek kiépítési típusa.

LinuxUserConfiguration

A felhasználói fiók linuxos számítási csomóponton való létrehozásához használt tulajdonságok.

LoginMode

A felhasználó bejelentkezési módja

ManagedDisk
MetadataItem

Egy Batch-szolgáltatáserőforráshoz társított név-érték pár.

MountConfiguration

Az egyes csomópontokra csatlakoztatni kívánt fájlrendszer.

NetworkConfiguration

A készlet hálózati konfigurációja.

NetworkSecurityGroupRule

Egy bejövő végpontra alkalmazandó hálózati biztonsági csoportszabály.

NetworkSecurityGroupRuleAccess

A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet.

NFSMountConfiguration

NFS-fájlrendszerhez való csatlakozáshoz használt információk.

NodeCommunicationMode

Meghatározza, hogy a készlet hogyan kommunikál a Batch szolgáltatással.

NodePlacementConfiguration

Egy készlet csomópontelhelyezési konfigurációja.

NodePlacementPolicyType

A csomópontok készletben való kiosztásának elhelyezési szabályzata.

OSDisk

A számítási csomópont (VM) operációsrendszer-lemezének beállításai.

PoolEndpointConfiguration

A készlet végpontkonfigurációja.

PoolPatchParameter

A készleten végrehajtott módosítások készlete.

PublicIPAddressConfiguration

A készlet hálózati konfigurációjának nyilvános IP-címkonfigurációja.

ResourceFile

Egy vagy több, a számítási csomópontra letöltendő fájl.

RollingUpgradePolicy

A működés közbeni frissítés során használt konfigurációs paraméterek.

SecurityEncryptionTypes

A felügyelt lemez EncryptionType tulajdonságát adja meg. A VMGuestStateOnly értékre van állítva csak a VMGuestState blob titkosításához, és a NemPersistedTPM értékre, ha nem tartja meg a belső vezérlőprogram állapotát a VMGuestState-blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használatakor szükséges.

SecurityProfile

Megadja a virtuális gép vagy a virtuálisgép-méretezési csoport biztonsági profilbeállításait.

SecurityTypes

A virtuális gép SecurityType tulajdonságát adja meg. Az UefiSettings engedélyezéséhez minden megadott értékre be kell állítani.

ServiceArtifactReference

Megadja azt a szolgáltatásösszetevő-referencia-azonosítót, amellyel a méretezési csoport összes virtuális gépe ugyanazt a rendszerképverziót állíthatja be a "legújabb" rendszerképverzió használatakor.

StartTask

Olyan feladat, amely akkor fut, amikor egy csomópont csatlakozik egy készlethez az Azure Batch szolgáltatásban, vagy amikor a számítási csomópont újraindul vagy újraépül.

StorageAccountType

A tárfiók típusa adatlemezek vagy operációsrendszer-lemezek létrehozásához.

TaskContainerSettings

A tevékenység tárolóbeállításai.

TaskSchedulingPolicy

Meghatározza, hogy a feladatok hogyan legyenek elosztva a számítási csomópontok között.

UefiSettings

Megadja a virtuális gép létrehozásakor használt biztonsági beállításokat, például a biztonságos rendszerindítást és a vTPM-et.

UpgradeMode

Megadja a méretezési csoportban lévő virtuális gépekre való frissítés módját.

A lehetséges értékek a következők:

Manuális – A méretezési csoportban lévő virtuális gépek frissítéseinek alkalmazását szabályozhatja. Ezt a manualUpgrade művelet használatával teheti meg.

Automatikus – A méretezési csoportban lévő összes virtuális gép automatikusan frissül.

Gördülő – A méretezési csoport a frissítéseket kötegekben hajtja végre, köztük egy opcionális szünetidővel.

UpgradePolicy

Egy frissítési szabályzatot ír le – automatikus, manuális vagy működés közben.

UserAccount

Az Azure Batch számítási csomópont feladatainak végrehajtásához használt felhasználó létrehozásához használt tulajdonságok.

UserIdentity

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

VirtualMachineConfiguration

A számítási csomópontok konfigurációja egy készletben az Azure Virtual Machines-infrastruktúra alapján.

VMDiskSecurityProfile

Megadja a felügyelt lemez biztonsági profilbeállításait. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használata esetén kötelező.

VMExtension

A virtuálisgép-bővítmények konfigurációja.

WindowsConfiguration

A windowsos operációs rendszer virtuális gépre vonatkozó beállításai.

WindowsUserConfiguration

Felhasználói fiók windowsos számítási csomóponton való létrehozásához használt tulajdonságok.

ApplicationPackageReference

Hivatkozás a számítási csomópontokon üzembe helyezendő csomagra.

Name Típus Description
applicationId

string

Az üzembe helyezendő alkalmazás azonosítója.
Készlet létrehozásakor a csomag alkalmazásazonosítójának teljes mértékben minősítettnek kell lennie (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Az üzembe helyezendő alkalmazás verziója. Ha nincs megadva, az alapértelmezett verzió lesz üzembe helyezve.
Ha ez nincs megadva egy készleten, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés az InvalidApplicationPackageReferences hibakóddal és a 409-es HTTP-állapotkóddal hiúsul meg. Ha ez nincs megadva egy tevékenységen, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a feladat előfeldolgozási hibával meghiúsul.

AutomaticOSUpgradePolicy

Az operációs rendszer automatikus frissítéséhez használt konfigurációs paraméterek.

Name Típus Description
disableAutomaticRollback

boolean

Le kell-e tiltani az operációs rendszer lemezkép-visszaállítási funkcióját.

enableAutomaticOSUpgrade

boolean

Azt jelzi, hogy az operációsrendszer-frissítéseket automatikusan alkalmazni kell-e a méretezési csoportok példányaira, amikor elérhetővé válik az operációsrendszer-rendszerkép egy újabb verziója.

Ha ez igaz értékre van állítva a Windows-alapú készletek esetében, WindowsConfiguration.enableAutomaticUpdates nem állítható be igaz értékre.

osRollingUpgradeDeferral

boolean

Ha feladatokat futtat, elhalasztja az operációsrendszer-frissítéseket a TVM-eken.

useRollingUpgradePolicy

boolean

Azt jelzi, hogy az automatikus operációsrendszer-frissítés során használni kell-e a működés közbeni frissítési szabályzatot. Az automatikus operációsrendszer-frissítés az alapértelmezett szabályzatra fog visszaállni, ha nincs meghatározva szabályzat a VMSS-en.

AutoUserScope

Az automatikus felhasználó hatóköre

Érték Description
pool

Megadja, hogy a feladat a készlet minden számítási csomópontján létrehozott közös automatikus felhasználói fiókként fusson.

task

Megadja, hogy a szolgáltatásnak létre kell hoznia egy új felhasználót a feladathoz.

AutoUserSpecification

Megadja annak az automatikus felhasználónak a paramétereit, aki egy feladatot futtat a Batch szolgáltatásban.

Name Típus Description
elevationLevel

ElevationLevel

Az automatikus felhasználó jogosultságszintje.
Az alapértelmezett érték nem Admin.

scope

AutoUserScope

Az automatikus felhasználó hatóköre
Az alapértelmezett érték a készlet. Ha a készlet Windows rendszert futtat, a Tevékenység értéket kell megadni, ha szigorúbb elkülönítésre van szükség a tevékenységek között. Ha például a tevékenység úgy mutálja a beállításjegyzéket, hogy az hatással lehet más tevékenységekre, vagy olyan tanúsítványokat adott meg a készleten, amelyek nem lehetnek elérhetők a normál tevékenységek által, de a StartTasks számára hozzáférhetőnek kell lenniük.

AzureBlobFileSystemConfiguration

Az Azure Storage-tárolóhoz Blobfuse használatával való csatlakozáshoz használt információk.

Name Típus Description
accountKey

string

Az Azure Storage-fiók kulcsa.
Ez a tulajdonság kölcsönösen kizárja mind a sasKey, mind az identitás; pontosan egyet kell megadni.

accountName

string

Az Azure Storage-fiók neve.

blobfuseOptions

string

További parancssori beállítások a csatlakoztatási parancsnak való továbbításhoz.
Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban.

containerName

string

Az Azure Blob Storage-tároló neve.

identityReference

ComputeNodeIdentityReference

A containerName eléréséhez használandó felhasználó által hozzárendelt identitásra mutató hivatkozás
Ez a tulajdonság kölcsönösen kizárja az accountKey és a sasKey tulajdonságot; pontosan egyet kell megadni.

relativeMountPath

string

A relatív elérési út azon a számítási csomóponton, amelyen a fájlrendszer csatlakoztatva lesz
Minden fájlrendszer a Batch csatlakoztatási könyvtárához képest van csatlakoztatva, amely a AZ_BATCH_NODE_MOUNTS_DIR környezeti változón keresztül érhető el.

sasKey

string

Az Azure Storage SAS-jogkivonata.
Ez a tulajdonság kölcsönösen kizárható mind az accountKey, mind az identitás tekintetében; pontosan egyet kell megadni.

AzureFileShareConfiguration

Az Azure Fileshare-hoz való csatlakozáshoz használt információk.

Name Típus Description
accountKey

string

Az Azure Storage-fiókkulcs.

accountName

string

Az Azure Storage-fiók neve.

azureFileUrl

string

Az Azure Files URL-címe.
Ez "https://{account}.file.core.windows.net/" formátumú.

mountOptions

string

További parancssori beállítások a csatlakoztatási parancsnak való továbbításhoz.
Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban.

relativeMountPath

string

A relatív elérési út azon a számítási csomóponton, amelyen a fájlrendszer csatlakoztatva lesz
Minden fájlrendszer a Batch csatlakoztatási könyvtárához képest van csatlakoztatva, amely a AZ_BATCH_NODE_MOUNTS_DIR környezeti változón keresztül érhető el.

BatchError

Az Azure Batch szolgáltatástól kapott hibaválasz.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

message

ErrorMessage

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

values

BatchErrorDetail[]

Kulcs-érték párok gyűjteménye, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Az Azure Batch-hibaválaszban szereplő további információk egy eleme.

Name Típus Description
key

string

Az Érték tulajdonság jelentését meghatározó azonosító.

value

string

A hibaválasz további információi.

CachingType

A lemezen engedélyezendő gyorsítótárazás típusa.

Érték Description
none

A lemez gyorsítótárazási módja nincs engedélyezve.

readonly

A lemez gyorsítótárazási módja csak olvasható.

readwrite

A lemez gyorsítótárazási módja olvasás és írás.

CertificateReference

Hivatkozás egy készlet számítási csomópontjaira telepíteni kívánt tanúsítványra.

Name Típus Description
storeLocation

CertificateStoreLocation

A tanúsítványtároló helye a számítási csomóponton, ahová telepíteni szeretné a tanúsítványt.
Az alapértelmezett érték a currentuser. Ez a tulajdonság csak a Windows számítási csomópontokkal konfigurált készletekre vonatkozik. Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárban lévő könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy "tanúsítvány" könyvtárat a felhasználó kezdőkönyvtárában (például /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve.

storeName

string

Annak a számítási csomópontnak a tanúsítványtárolója, amelybe telepíteni szeretné a tanúsítványt.
Ez a tulajdonság csak a Windows számítási csomópontokkal konfigurált készletekre vonatkozik. Az áruházak gyakori nevei a következők: Saját, Gyökér, HITELESÍTÉSSZOLGÁLTATÓ, Megbízhatóság, Letiltás, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, de bármilyen egyéni tárolónév is használható. Az alapértelmezett érték a Saját.

thumbprint

string

A tanúsítvány ujjlenyomata.

thumbprintAlgorithm

string

Az az algoritmus, amelyhez az ujjlenyomat társítva van. Ennek sha1-nek kell lennie.

visibility

CertificateVisibility[]

A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz.
Ebben a gyűjteményben több láthatóságot is megadhat. Az alapértelmezett érték az összes fiók.

CertificateStoreLocation

A tanúsítványtároló helye a számítási csomóponton, ahová telepíteni szeretné a tanúsítványt.

Érték Description
currentuser

A tanúsítványokat telepíteni kell a CurrentUser tanúsítványtárolóba.

localmachine

A tanúsítványokat telepíteni kell a LocalMachine tanúsítványtárolóba.

CertificateVisibility

A számítási csomóponton található felhasználói fiókoknak hozzáféréssel kell rendelkezniük a tanúsítvány személyes adataihoz.

Érték Description
remoteuser

A tanúsítványnak láthatónak kell lennie azon felhasználói fiókok számára, amelyek alatt a felhasználók távolról hozzáférnek a számítási csomóponthoz.

starttask

A tanúsítványnak láthatónak kell lennie annak a felhasználói fióknak, amely alatt a StartTask fut. Vegye figyelembe, hogy ha az AutoUser-hatókör a StartTask és a Tevékenység készlete is, akkor ez a tanúsítvány a tevékenység számára is látható lesz.

task

A tanúsítványnak láthatónak kell lennie azon felhasználói fiókok számára, amelyek alatt a feladatfeladatok futnak.

CIFSMountConfiguration

A CIFS-fájlrendszerhez való csatlakozáshoz használt információk.

Name Típus Description
mountOptions

string

További parancssori beállítások a csatlakoztatási parancsnak való továbbításhoz.
Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban.

password

string

A CIFS fájlrendszeren való hitelesítéshez használandó jelszó.

relativeMountPath

string

A relatív elérési út azon a számítási csomóponton, amelyen a fájlrendszer csatlakoztatva lesz
Minden fájlrendszer a Batch csatlakoztatási könyvtárához képest van csatlakoztatva, amely a AZ_BATCH_NODE_MOUNTS_DIR környezeti változón keresztül érhető el.

source

string

A csatlakoztatni kívánt fájlrendszer URI-ja.

username

string

A CIFS fájlrendszeren való hitelesítéshez használni kívánt felhasználó.

ComputeNodeFillType

A tevékenységek elosztása a készlet számítási csomópontjai között.

Érték Description
pack

A készletben lévő összes számítási csomóponthoz a lehető legtöbb tevékenységet (taskSlotsPerNode) hozzá kell rendelni, mielőtt a tevékenységek a készlet következő számítási csomóponthoz lesznek rendelve.

spread

A tevékenységeket egyenletesen kell hozzárendelni a készlet összes számítási csomópontja számára.

ComputeNodeIdentityReference

A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.

Name Típus Description
resourceId

string

A felhasználó által hozzárendelt identitás ARM-erőforrás-azonosítója.

ContainerConfiguration

A tárolóbarát készletek konfigurációja.

Name Típus Description
containerImageNames

string[]

A tárolórendszerképek neveinek gyűjteménye.
Ez a teljes képhivatkozás, ahogy a "docker pull" kifejezés is meg van adva. A rendszerképek az alapértelmezett Docker-beállításjegyzékből lesznek származtatva, kivéve, ha a rendszerkép teljes mértékben egy alternatív beállításjegyzékkel van minősítve.

containerRegistries

ContainerRegistry[]

További magánregisztrációs adatbázisok, amelyekből tárolók húzhatók le.
Ha a rendszerképeket egy olyan privát beállításjegyzékből kell letölteni, amely hitelesítő adatokat igényel, akkor ezeket a hitelesítő adatokat itt kell megadni.

type

ContainerType

A használandó tárolótechnológia.

ContainerHostBatchBindMountEntry

A feladattárolóba csatlakoztatni kívánt elérési út és csatlakoztatási mód bejegyzése.

Name Típus Description
isReadOnly

boolean

Csatlakoztassa ezt a forrásútvonalat írásvédett módként vagy sem. Az alapértelmezett érték hamis (olvasási/írási mód).
Linux esetén, ha ezt az elérési utat írási/olvasási módként csatlakoztatja, az nem jelenti azt, hogy a tároló összes felhasználója rendelkezik olvasási/írási hozzáféréssel az elérési úthoz, az a gazdagép virtuális gépének hozzáférésétől függ. Ha ez az elérési út írásvédett, a tárolóban lévő összes felhasználó nem fogja tudni módosítani az elérési utat.

source

ContainerHostDataPath

A tároló-ügyfélhez csatlakoztatni kívánt elérési út kiválasztható.

ContainerHostDataPath

A tárolófeladat tárolójára csatlakoztatni kívánt elérési utak.

Érték Description
Applications

Az alkalmazások elérési útja.

JobPrep

A feladat-előkészítési tevékenység elérési útja.

Shared

A többpéldányos feladat elérési útja a fájlok megosztásához.

Startup

A tevékenység kezdési útvonala.

Task

A tevékenység elérési útja.

VfsMounts

Az elérési út az összes virtuális fájlrendszert tartalmazza ezen a csomóponton.

ContainerRegistry

Egy privát tárolóregisztrációs adatbázis.

Name Típus Description
identityReference

ComputeNodeIdentityReference

A felhasználó által hozzárendelt identitásra mutató hivatkozás, a felhasználónév és a jelszó helyett az Azure Container Registry eléréséhez.
A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.

password

string

A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó.

registryServer

string

A beállításjegyzék URL-címe.
Ha nincs megadva, az alapértelmezett érték a "docker.io".

username

string

A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges felhasználónév.

ContainerType

A használandó tárolótechnológia.

Érték Description
criCompatible

A tárolók elindításához CRI-alapú technológiát használunk.

dockerCompatible

A tárolók elindításához Docker-kompatibilis tárolótechnológiát használunk.

ContainerWorkingDirectory

A tároló tevékenység munkakönyvtárának helye.

Érték Description
containerImageDefault

Használja a tároló lemezképében definiált munkakönyvtárat. Ne feledje, hogy ez a könyvtár nem tartalmazza a Batch által letöltött erőforrásfájlokat.

taskWorkingDirectory

Használja a Batch szolgáltatás szokásos tevékenység munkakönyvtárát, amely tartalmazza a Batch által kitöltött tevékenységerőforrás-fájlokat.

DataDisk

A készlet számítási csomópontjaihoz társított adatlemezek által használt beállítások. Csatolt adatlemezek használatakor a virtuális gépen belülről kell csatlakoztatnia és formáznia a lemezeket a használatukhoz.

Name Típus Description
caching

CachingType

Az adatlemezekhez engedélyezni kívánt gyorsítótárazás típusa.
A gyorsítótárazás alapértelmezett értéke az írásvédett. A gyorsítótárazási lehetőségekről a következő témakörben talál további információt: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer (int32)

A kezdeti lemezméret gigabájtban.

lun

integer (int32)

A logikai egység száma.
A lun az egyes adatlemezek egyedi azonosítására szolgál. Ha több lemezt csatol, mindegyiknek külön lun-nak kell lennie. Az értéknek 0 és 63 közöttinek kell lennie, beleértve az értéket is.

storageAccountType

StorageAccountType

Az adatlemezhez használandó tárfiók típusa.
Ha nincs megadva, az alapértelmezett érték a "standard_lrs".

DiffDiskPlacement

A készletben lévő összes számítási csomóponthoz (virtuális géphez) tartozó operációsrendszer-lemez rövid élettartamú lemezelhelyezését adja meg.

Érték Description
CacheDisk

A rövid élettartamú operációsrendszer-lemez a virtuálisgép-gyorsítótárban van tárolva.

DiffDiskSettings

Megadja a számítási csomópont (VM) által használt operációsrendszer-lemez rövid élettartamú lemezbeállításait.

Name Típus Description
placement

DiffDiskPlacement

Megadja az operációsrendszer-lemez rövid élettartamú lemezelhelyezését a készletben lévő összes virtuális géphez.
Ezt a tulajdonságot a felhasználó használhatja a kérésben a hely kiválasztásához, például gyorsítótárazza a lemezterületet a rövid élettartamú operációsrendszer-lemezek kiépítéséhez. A rövid élettartamú operációsrendszer-lemez méretére vonatkozó követelményekről további információt a Windows rendszerű virtuális gépek rövid élettartamú operációsrendszer-lemezméreti követelményeit https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements és Linux rendszerű virtuális gépekre vonatkozó rövid útmutatóban talál a https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

A készlet számítási csomópontjaira alkalmazott lemeztitkosítási konfiguráció. A lemeztitkosítás konfigurálása nem támogatott az Azure Compute Gallery rendszerképével létrehozott Linux-készletben.

Name Típus Description
targets

DiskEncryptionTarget[]

A Batch Szolgáltatás titkosítja a lemezcélok listáját a számítási csomóponton.
A Batch Szolgáltatás titkosítja a lemezcélok listáját a számítási csomóponton.

DiskEncryptionTarget

A Batch Szolgáltatás titkosítja a lemezcélok listáját a számítási csomóponton.

Érték Description
osdisk

A számítási csomópont operációsrendszer-lemeze titkosítva van.

temporarydisk

A számítási csomópont ideiglenes lemeze titkosítva van. Linux rendszeren ez a titkosítás más partíciókra (például csatlakoztatott adatlemezekre) vonatkozik, amikor a titkosítás a rendszerindításkor történik.

DynamicVNetAssignmentScope

A dinamikus virtuális hálózatok hozzárendelésének hatóköre.

Érték Description
job

A dinamikus virtuális hálózatok hozzárendelése feladatonként történik.

none

Nincs engedélyezve dinamikus virtuális hálózat-hozzárendelés.

ElevationLevel

A felhasználó szintemelési szintje.

Érték Description
admin

A felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik.

nonadmin

A felhasználó egy általános jogú felhasználó, aki nem rendelkezik emelt szintű hozzáféréssel.

EnvironmentSetting

Egy tevékenységfolyamathoz beállítandó környezeti változó.

Name Típus Description
name

string

A környezeti változó neve.

value

string

A környezeti változó értéke.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

Name Típus Description
lang

string

A hibaüzenet nyelvi kódja

value

string

Az üzenet szövege.

ImageReference

Egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre mutató hivatkozás. Az Azure Marketplace-rendszerképek Azure Batch által ellenőrzött hivatkozásainak listáját a "Támogatott képek listázása" műveletet tekintheti meg.

Name Típus Description
communityGalleryImageId

string

A közösségi galéria képének egyedi azonosítója
Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot, és lekérhető a közösségi katalógus képének GET hívásából.

exactVersion

string

A csomópont létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép adott verziója. Ez az írásvédett mező csak akkor különbözik a "verziótól", ha a készlet létrehozásakor a "verzió" érték a "legújabb" volt.

offer

string

Az Azure Virtual Machines Marketplace-rendszerkép ajánlattípusa.
Például: UbuntuServer vagy WindowsServer.

publisher

string

Az Azure Virtual Machines Marketplace-rendszerkép közzétevője.
Például a Canonical vagy a MicrosoftWindowsServer.

sharedGalleryImageId

string

A megosztott katalógus képének egyedi azonosítója
Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot, és lekérhető a megosztott katalógus képének GET hívásából.

sku

string

Az Azure Virtual Machines Marketplace-rendszerkép termékváltozata.
Például: 18.04-LTS vagy 2019-Datacenter.

version

string

Az Azure Virtual Machines Marketplace-rendszerképének verziója.
A rendszerkép legújabb verziójának kiválasztásához megadhat egy "legújabb" értéket. Ha nincs megadva, az alapértelmezett érték a "legújabb".

virtualMachineImageId

string

Az Azure Compute Gallery rendszerképének ARM-erőforrás-azonosítója. A készlet számítási csomópontjai ezzel a képazonosítóval jönnek létre. Ez az űrlap /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} vagy /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} formában jelenik meg, mindig a legújabb képverzióra alapértelmezettként.
Ez a tulajdonság kölcsönösen kizárja a többi ImageReference tulajdonságot. Az Azure Compute Gallery rendszerképének replikákkal kell rendelkeznie ugyanabban a régióban, és ugyanabban az előfizetésben kell lennie, mint az Azure Batch-fiók. Ha a rendszerkép verziója nincs megadva az imageId azonosítóban, a rendszer a legújabb verziót használja. A Batch számítási csomópont ügynökének a Batch szolgáltatással való kommunikációhoz szükséges tűzfalbeállításairól további információt a https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configurationcímű témakörben talál.

InboundEndpointProtocol

A végpont protokollja.

Érték Description
tcp

Használja a TCP-t a végponthoz.

udp

Használja az UDP-t a végponthoz.

InboundNATPool

Bejövő NAT-készlet, amely a Batch-készletben lévő számítási csomópontok adott portjainak külső kezelésére használható.

Name Típus Description
backendPort

integer (int32)

A számítási csomópont portszáma.
Ennek egyedinek kell lennie egy Batch-készleten belül. Az elfogadható értékek 1 és 65535 között vannak, kivéve a 29876-ot és a 29877-et, mivel ezek fenntartottak. Ha a rendszer fenntartott értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

frontendPortRangeEnd

integer (int32)

A külső portok tartományának utolsó portszáma, amely az egyes számítási csomópontok háttérportjához való bejövő hozzáférés biztosítására szolgál.
Az elfogadható értékek 1 és 65534 között mozognak, kivéve a Batch szolgáltatás által fenntartott 50000 és 55000 közötti portokat. A készleten belüli összes tartománynak eltérőnek kell lennie, és nem lehet átfedésben. Minden tartománynak legalább 40 portot kell tartalmaznia. Ha a rendszer fenntartott vagy átfedésben lévő értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

frontendPortRangeStart

integer (int32)

A külső portok tartományának első portszáma, amely az egyes számítási csomópontok háttérportjához való bejövő hozzáférés biztosítására szolgál.
Az elfogadható értékek 1 és 65534 között mozognak, kivéve az 50000 és 55000 közötti, fenntartott portokat. A készleten belüli összes tartománynak eltérőnek kell lennie, és nem lehet átfedésben. Minden tartománynak legalább 40 portot kell tartalmaznia. Ha a rendszer fenntartott vagy átfedésben lévő értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

name

string

A végpont neve.
A névnek egyedinek kell lennie a Batch-készletben, tartalmazhat betűket, számokat, aláhúzásjeleket, pontokat és kötőjeleket. A neveknek betűvel vagy számmal kell kezdődniük, betűvel, számmal vagy aláhúzásjellel kell végződniük, és nem haladhatja meg a 77 karaktert. Ha érvénytelen értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

A végpontra alkalmazott hálózati biztonsági csoportszabályok listája.
A Batch-készlet összes végpontján megadható szabályok maximális száma 25. Ha nincs megadva hálózati biztonsági csoportra vonatkozó szabály, a rendszer létrehoz egy alapértelmezett szabályt, amely engedélyezi a bejövő hozzáférést a megadott háttérporthoz. Ha túllépi a hálózati biztonsági csoport szabályainak maximális számát, a kérés a 400-es HTTP-állapotkóddal meghiúsul.

protocol

InboundEndpointProtocol

A végpont protokollja.

IPAddressProvisioningType

A készlet nyilvános IP-címeinek kiépítési típusa.

Érték Description
batchmanaged

A Batch létrehoz és felügyel egy nyilvános IP-címet. A készlet méretétől függően több nyilvános IP-cím is lehet.

nopublicipaddresses

A rendszer nem hoz létre nyilvános IP-címet.

usermanaged

A nyilvános IP-címeket a felhasználó biztosítja, és a számítási csomópontok kiépítésére lesznek használva.

LinuxUserConfiguration

A felhasználói fiók linuxos számítási csomóponton való létrehozásához használt tulajdonságok.

Name Típus Description
gid

integer (int32)

A felhasználói fiók csoportazonosítója.
Az uid és a gid tulajdonságokat együtt kell megadni, vagy egyáltalán nem. Ha nincs megadva, a mögöttes operációs rendszer kiválasztja a gidet.

sshPrivateKey

string

A felhasználói fiók SSH titkos kulcsa.
A titkos kulcs nem lehet jelszóval védett. A titkos kulcs használatával automatikusan konfigurálható az aszimmetrikus kulcsalapú hitelesítés a Linux-készlet számítási csomópontjai között, ha a készlet enableInterNodeCommunication tulajdonsága igaz (a rendszer figyelmen kívül hagyja, ha az enableInterNodeCommunication értéke hamis). Ezt úgy teszi, hogy a kulcspárt a felhasználó .ssh könyvtárába helyezi. Ha nincs megadva, a jelszó nélküli SSH nincs konfigurálva a számítási csomópontok között (a felhasználó .ssh könyvtárának módosítása nem történik meg).

uid

integer (int32)

A felhasználói fiók felhasználói azonosítója.
Az uid és a gid tulajdonságokat együtt kell megadni, vagy egyáltalán nem. Ha nincs megadva, a mögöttes operációs rendszer választja ki a uid azonosítót.

LoginMode

A felhasználó bejelentkezési módja

Érték Description
batch

A LOGON32_LOGON_BATCH Win32 bejelentkezési mód. A kötegelt bejelentkezési mód hosszú ideig futó párhuzamos folyamatokhoz ajánlott.

interactive

A LOGON32_LOGON_INTERACTIVE Win32 bejelentkezési mód. A UAC engedélyezve van a Windows-készletekben. Ha ezt a beállítást emelt szintű felhasználói identitással használja egy Windows-készletben, a felhasználói munkamenet nem lesz emelt szintű, kivéve, ha a Feladat parancssor által végrehajtott alkalmazás úgy van konfigurálva, hogy mindig rendszergazdai jogosultságot igényeljen, vagy mindig maximális jogosultságot követeljen meg.

ManagedDisk

Name Típus Description
securityProfile

VMDiskSecurityProfile

Megadja a felügyelt lemez biztonsági profilbeállításait.
Megadja a felügyelt lemez biztonsági profilbeállításait. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használata esetén kötelező.

storageAccountType

StorageAccountType

A felügyelt lemez tárfióktípusa.

MetadataItem

Egy Batch-szolgáltatáserőforráshoz társított név-érték pár.

Name Típus Description
name

string

A metaadatelem neve.

value

string

A metaadatelem értéke.

MountConfiguration

Az egyes csomópontokra csatlakoztatni kívánt fájlrendszer.

Name Típus Description
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Az Egyes csomópontokon blob FUSE használatával csatlakoztatandó Azure Storage-tároló.
Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot.

azureFileShareConfiguration

AzureFileShareConfiguration

Az egyes csomópontokra csatlakoztatni kívánt Azure-fájlmegosztás.
Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot.

cifsMountConfiguration

CIFSMountConfiguration

Az egyes csomópontokra csatlakoztatni kívánt CIFS/SMB fájlrendszer.
Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot.

nfsMountConfiguration

NFSMountConfiguration

Az egyes csomópontokra csatlakoztatni kívánt NFS-fájlrendszer.
Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot.

NetworkConfiguration

A készlet hálózati konfigurációja.

Name Típus Description
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

A dinamikus virtuális hálózatok hozzárendelésének hatóköre.

enableAcceleratedNetworking

boolean

A készletnek engedélyeznie kell-e a gyorsított hálózatkezelést.
A gyorsított hálózatkezelés lehetővé teszi a virtuális gépek egyetlen gyökérszintű I/O-virtualizálását (SR-IOV), ami jobb hálózati teljesítményt eredményezhet. További részletekért lásd: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

A Batch-készlet számítási csomópontjaihoz tartozó végpontok konfigurációja.

publicIPAddressConfiguration

PublicIPAddressConfiguration

A Batch-készlet számítási csomópontjaihoz tartozó nyilvános IPAddress-konfiguráció.
A készlet hálózati konfigurációjának nyilvános IP-címkonfigurációja.

subnetId

string

Annak a virtuális hálózati alhálózatnak az ARM-erőforrás-azonosítója, amelyhez a készlet számítási csomópontjai csatlakoznak. Ez az űrlap /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/alhálózatok/{alhálózat}.
A virtuális hálózatnak ugyanabban a régióban és előfizetésben kell lennie, mint az Azure Batch-fiók. A megadott alhálózatnak elegendő ingyenes IP-címmel kell rendelkeznie a készlet számítási csomópontjainak számához. Ha az alhálózat nem rendelkezik elegendő ingyenes IP-címmel, a készlet részlegesen lefoglalja a csomópontokat, és átméretezi a hibát. A "MicrosoftAzureBatch" szolgáltatásnévnek rendelkeznie kell a megadott virtuális hálózat "klasszikus virtuálisgép-közreműködő" Role-Based hozzáférés-vezérlési (RBAC) szerepkörével. A megadott alhálózatnak lehetővé kell tennie, hogy az Azure Batch szolgáltatásból érkező kommunikáció képes legyen feladatokat ütemezni a csomópontokon. Ezt úgy ellenőrizheti, hogy a megadott virtuális hálózat rendelkezik-e társított hálózati biztonsági csoportokkal (NSG). Ha a megadott alhálózat csomópontjaival való kommunikációt egy NSG megtagadja, akkor a Batch szolgáltatás használhatatlanná állítja a számítási csomópontok állapotát. Csak az ARM-alapú virtuális hálózatok (a "Microsoft.Network/virtualNetworks") támogatottak. Ha a megadott virtuális hálózat rendelkezik hálózati biztonsági csoportokkal (NSG), akkor néhány fenntartott rendszerportot engedélyezni kell a bejövő kommunikációhoz, beleértve a 29876-os és a 29877-as portot is. Engedélyezze a kimenő kapcsolatokat az Azure Storage-hoz a 443-as porton. További részletekért lásd: https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Egy bejövő végpontra alkalmazandó hálózati biztonsági csoportszabály.

Name Típus Description
access

NetworkSecurityGroupRuleAccess

A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet.

priority

integer (int32)

A szabály prioritása.
A készleten belüli prioritásoknak egyedinek kell lenniük, és prioritás szerinti sorrendben kell kiértékelniük. Minél alacsonyabb a szám, annál magasabb a prioritás. A szabályokat például 150, 250 és 350 sorszámmal lehet megadni. A 150-es sorszámú szabály elsőbbséget élvez a 250-es sorrendű szabállyal szemben. Az engedélyezett prioritások 150 és 4096 között vannak. Ha a rendszer fenntartott vagy duplikált értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

sourceAddressPrefix

string

A szabálynak megfelelő forráscímelőtag vagy címke.
Az érvényes értékek egyetlen IP-cím (azaz 10.10.10.10.10), IP-alhálózat (azaz 192.168.1.0/24), alapértelmezett címke vagy * (minden cím esetén). Ha bármilyen más érték is meg van adva, a kérés a 400-ás HTTP-állapotkóddal meghiúsul.

sourcePortRanges

string[]

A szabálynak megfelelő forrásporttartományok.
Az érvényes értékek a következők: "" (minden 0- 65535-ös portra), egy adott portra (pl. 22) vagy egy porttartományra (pl. 100-200). A portnak 0 és 65535 közötti tartományban kell lennie. A gyűjtemény minden bejegyzése nem fedheti át a többi bejegyzést (tartományt vagy portot). Ha bármilyen más érték is meg van adva, a kérés a 400-ás HTTP-állapotkóddal meghiúsul. Az alapértelmezett érték a "".

NetworkSecurityGroupRuleAccess

A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet.

Érték Description
allow

Hozzáférés engedélyezése.

deny

Hozzáférés megtagadása.

NFSMountConfiguration

NFS-fájlrendszerhez való csatlakozáshoz használt információk.

Name Típus Description
mountOptions

string

További parancssori beállítások a csatlakoztatási parancsnak való továbbításhoz.
Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban.

relativeMountPath

string

A relatív elérési út azon a számítási csomóponton, amelyen a fájlrendszer csatlakoztatva lesz
Minden fájlrendszer a Batch csatlakoztatási könyvtárához képest van csatlakoztatva, amely a AZ_BATCH_NODE_MOUNTS_DIR környezeti változón keresztül érhető el.

source

string

A csatlakoztatni kívánt fájlrendszer URI-ja.

NodeCommunicationMode

Meghatározza, hogy a készlet hogyan kommunikál a Batch szolgáltatással.

Érték Description
classic

A klasszikus kommunikációs módot használó csomópontok bejövő TCP-kommunikációt igényelnek a 29876-os és a 29877-ös porton a "BatchNodeManagement" portról. {region}" szolgáltatáscímke és kimenő TCP-kommunikáció a 443-as porton a "Storage.region" és a "BatchNodeManagement" felé. {region}" szolgáltatáscímkék.

default

A csomópont-kommunikációs módot a Batch szolgáltatás automatikusan beállítja.

simplified

Az egyszerűsített kommunikációs módot használó csomópontok kimenő TCP-kommunikációt igényelnek a 443-as porton a "BatchNodeManagement" felé. {region}" szolgáltatáscímke. Nincs szükség nyitott bejövő portra.

NodePlacementConfiguration

Egy készlet csomópontelhelyezési konfigurációja.

Name Típus Description
policy

NodePlacementPolicyType

Csomópontelhelyezési szabályzat típusa a Batch-készletekben.
A Batch Service által a csomópontok kiépítéséhez használt foglalási szabályzat. Ha nincs megadva, a Batch a regionális szabályzatot fogja használni.

NodePlacementPolicyType

A csomópontok készletben való kiosztásának elhelyezési szabályzata.

Érték Description
regional

A készlet összes csomópontja ugyanabban a régióban lesz lefoglalva.

zonal

A készlet csomópontjai különböző rendelkezésre állási zónákban lesznek elosztva a legjobb erőfeszítéssel.

OSDisk

A számítási csomópont (VM) operációsrendszer-lemezének beállításai.

Name Típus Description
caching

CachingType

Megadja a gyorsítótárazási követelményeket. Lehetséges értékek: None, ReadOnly, ReadWrite. Az alapértelmezett értékek a következők: Standard storage esetén nincs. ReadOnly for Premium Storage.
A gyorsítótárazás alapértelmezett értéke nincs. A gyorsítótárazási lehetőségekről a következő témakörben talál további információt: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer (int32)

A kezdeti lemezméret GB-ban az új operációsrendszer-lemez létrehozásakor.

ephemeralOSDiskSettings

DiffDiskSettings

Megadja a számítási csomópont (VM) által használt operációsrendszer-lemez rövid élettartamú lemezbeállításait.

managedDisk

ManagedDisk

A felügyelt lemez paraméterei.

writeAcceleratorEnabled

boolean

Megadja, hogy a writeAccelerator engedélyezve legyen vagy le legyen tiltva a lemezen.

PoolEndpointConfiguration

A készlet végpontkonfigurációja.

Name Típus Description
inboundNATPools

InboundNATPool[]

Az egyes számítási csomópontok adott portjainak külső kezelésére használható bejövő NAT-készletek listája.
Kötegkészletenként a bejövő NAT-készletek maximális száma 5. Ha túllépi a bejövő NAT-készletek maximális számát, a kérés a 400-es HTTP-állapotkóddal meghiúsul. Ez nem adható meg, ha az IPAddressProvisioningType noPublicIPAddresses.

PoolPatchParameter

A készleten végrehajtott módosítások készlete.

Name Típus Description
applicationPackageReferences

ApplicationPackageReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt csomagok listája.
A Csomaghivatkozások módosítása hatással van a készlethez csatlakozó összes új csomópontra, de a készletben lévő számítási csomópontokat nem érinti, amíg újra nem indítja vagy újra nem alakítja őket. Ha ez az elem jelen van, lecseréli a meglévő csomaghivatkozásokat. Ha üres gyűjteményt ad meg, az összes csomaghivatkozás el lesz távolítva a készletből. Ha nincs megadva, a meglévő csomaghivatkozások változatlanok maradnak.

certificateReferences

CertificateReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt tanúsítványok listája.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő tanúsítványhivatkozásokat. Ha nincs megadva, a meglévő tanúsítványhivatkozások változatlanok maradnak. Windows-csomópontok esetén a Batch szolgáltatás telepíti a tanúsítványokat a megadott tanúsítványtárolóba és helyre. Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárban lévő könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy "tanúsítvány" könyvtárat a felhasználó kezdőkönyvtárában (például /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve.

Figyelmeztetés: Ez a tulajdonság elavult, és 2024 februárja után törlődik. Ehelyett használja az Azure KeyVault-bővítményt.

displayName

string

A készlet megjelenítendő neve.
A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.

Ez a mező csak akkor frissíthető, ha a készlet üres.

enableInterNodeCommunication

boolean

Azt jelzi, hogy a készlet engedélyezi-e a közvetlen kommunikációt a számítási csomópontok között.
A csomópontok közötti kommunikáció engedélyezése korlátozza a készlet maximális méretét a készlet számítási csomópontjaira vonatkozó üzembehelyezési korlátozások miatt. Ez azt eredményezheti, hogy a készlet nem éri el a kívánt méretet. Az alapértelmezett érték hamis.

Ez a mező csak akkor frissíthető, ha a készlet üres.

metadata

MetadataItem[]

A készlethez metaadatként társított név-érték párok listája.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő metaadatokat. Ha üres gyűjteményt ad meg, a rendszer eltávolítja a metaadatokat a készletből. Ha nincs megadva, a meglévő metaadatok változatlanok maradnak.

mountConfiguration

MountConfiguration[]

A tároló csatlakoztatása a megadott fájlrendszerrel a készlet teljes élettartama alatt.
Csatlakoztassa a tárolót azure fileshare, NFS, CIFS vagy Blobfuse alapú fájlrendszer használatával.

Ez a mező csak akkor frissíthető, ha a készlet üres.

networkConfiguration

NetworkConfiguration

A készlet hálózati konfigurációja.
Ez a mező csak akkor frissíthető, ha a készlet üres.

resourceTags

object

A készlethez társított felhasználó által megadott címkék.
Az Azure Batch-készlethez társítandó felhasználó által definiált címkék. Ha meg van adva, a rendszer propagálja ezeket a címkéket a készlethez társított háttérbeli Azure-erőforrásokra. Ez a tulajdonság csak akkor adható meg, ha a Batch-fiókot a poolAllocationMode tulajdonsággal hozták létre a "UserSubscription" értékre állítva.

Ez a mező csak akkor frissíthető, ha a készlet üres.

startTask

StartTask

A készlethez való csatlakozáskor az egyes számítási csomópontokon futtatandó feladat. A feladat akkor fut, amikor a számítási csomópontot hozzáadják a készlethez, vagy amikor a számítási csomópont újraindul.
Ha ez az elem jelen van, felülírja a meglévő StartTaskot. Ha nincs megadva, a meglévő StartTask változatlan marad.

targetNodeCommunicationMode

NodeCommunicationMode

A készlet kívánt csomópontkommunikációs módja.
Ha ez az elem jelen van, lecseréli a készleten konfigurált meglévő célNodeCommunicationMode-t. Ha nincs megadva, a meglévő metaadatok változatlanok maradnak.

taskSchedulingPolicy

TaskSchedulingPolicy

A tevékenységek elosztása a készlet számítási csomópontjai között.
Ha nincs megadva, az alapértelmezett oldalpár.

Ez a mező csak akkor frissíthető, ha a készlet üres.

taskSlotsPerNode

integer (int32)

A készlet egyetlen számítási csomópontján egyidejű feladatok futtatásához használható feladathelyek száma.
Az alapértelmezett érték 1. A maximális érték a készlet VmSize-jének 4-szerese, vagy 256.

Ez a mező csak akkor frissíthető, ha a készlet üres.

upgradePolicy

UpgradePolicy

A készlet frissítési szabályzata.
Egy frissítési szabályzatot ír le – automatikus, manuális vagy működés közben.

Ez a mező csak akkor frissíthető, ha a készlet üres.

userAccounts

UserAccount[]

A készlet egyes számítási csomópontjain létrehozandó felhasználói fiókok listája.
Ez a mező csak akkor frissíthető, ha a készlet üres.

virtualMachineConfiguration

VirtualMachineConfiguration

A készlet virtuálisgép-konfigurációja.
Ezt a tulajdonságot meg kell adni.

Ez a mező csak akkor frissíthető, ha a készlet üres.

vmSize

string

A virtuális gépek mérete a készletben. A készlet összes virtuális gépe azonos méretű.
A készletekben elérhető virtuális gépek méretéről további információt az Azure Batch-készletben (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) található számítási csomópontok virtuálisgép-méretének kiválasztása című témakörben talál.

Ez a mező csak akkor frissíthető, ha a készlet üres.

PublicIPAddressConfiguration

A készlet hálózati konfigurációjának nyilvános IP-címkonfigurációja.

Name Típus Description
ipAddressIds

string[]

Azon nyilvános IP-címek listája, amelyeket a Batch szolgáltatás használni fog a számítási csomópontok kiépítésekor.
Az itt megadott IP-címek száma korlátozza a készlet maximális méretét – 100 dedikált csomópont vagy 100 kihasználatlan/alacsony prioritású csomópont foglalható le minden nyilvános IP-címhez. Egy 250 dedikált virtuális gépet igénylő készletnek például legalább 3 nyilvános IP-címet kell megadnia. A gyűjtemény minden eleme a következő formában jelenik meg: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

A készlet nyilvános IP-címeinek kiépítési típusa.
Az alapértelmezett érték a BatchManaged.

ResourceFile

Egy vagy több, a számítási csomópontra letöltendő fájl.

Name Típus Description
autoStorageContainerName

string

A tároló neve az automatikus tárfiókban.
Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket.

blobPrefix

string

A blobok Azure Storage-tárolóból való letöltésekor használandó blobelőtag. Csak azok a blobok töltődnek le, amelyeknek a neve a megadott előtaggal kezdődik.
A tulajdonság csak az autoStorageContainerName vagy storageContainerUrl használatakor érvényes. Ez az előtag lehet részleges fájlnév vagy alkönyvtár. Ha nincs megadva előtag, a tárolóban lévő összes fájl le lesz töltve.

fileMode

string

A fájlengedélyezési mód attribútum oktális formátumban.
Ez a tulajdonság csak a Linux számítási csomópontokra letöltött fájlokra vonatkozik. A rendszer figyelmen kívül hagyja, ha egy resourceFile-fájlhoz van megadva, amely egy Windows számítási csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva Linux számítási csomóponthoz, akkor a rendszer egy alapértelmezett 0770-et alkalmaz a fájlra.

filePath

string

A számítási csomópont azon helye, ahová le szeretné tölteni a fájlt a tevékenység munkakönyvtárához viszonyítva.
Ha a httpUrl tulajdonság meg van adva, a filePath szükséges, és leírja a fájl letöltési útvonalát, beleértve a fájlnevet is. Ellenkező esetben, ha az autoStorageContainerName vagy storageContainerUrl tulajdonság meg van adva, a filePath nem kötelező, és az a könyvtár, amelybe letölti a fájlokat. Abban az esetben, ha a filePath könyvtárként van használva, a bemeneti adatokhoz már társított címtárstruktúra teljes egészében megmarad, és hozzá lesz fűzve a megadott filePath könyvtárhoz. A megadott relatív elérési út nem bontható ki a tevékenység munkakönyvtárából (például a ".." használatával).

httpUrl

string

A letölteni kívánt fájl URL-címe.
Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. Ha az URL-cím az Azure Blob Storage-ra mutat, akkor a számítási csomópontokról olvashatónak kell lennie. Az Azure Storage-beli blobok URL-címének lekérése három módon lehetséges: tartalmazzon egy megosztott hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, használjon olvasási engedéllyel rendelkező felügyelt identitást, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez.

identityReference

ComputeNodeIdentityReference

A storageContainerUrl vagy a httpUrl által megadott Azure Blob Storage eléréséhez használt felhasználó által hozzárendelt identitásra mutató hivatkozás
A számítási csomópont által használt Batch-készlethez társított felhasználó által hozzárendelt identitásra mutató hivatkozás.

storageContainerUrl

string

A blobtároló URL-címe az Azure Blob Storage-ban.
Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Az Azure Storage-tárolókhoz háromféleképpen lehet ilyen URL-címet lekérni: tartalmazzon egy olyan közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listaengedélyeket ad a tárolóhoz, használjon egy felügyelt identitást olvasási és listaengedélyekkel, vagy állítsa be a tároló ACL-ét a nyilvános hozzáférés engedélyezéséhez.

RollingUpgradePolicy

A működés közbeni frissítés során használt konfigurációs paraméterek.

Name Típus Description
enableCrossZoneUpgrade

boolean

A frissítési kötegek létrehozásakor engedélyezze a VMSS számára, hogy figyelmen kívül hagyja az AZ-határokat. A köteg méretének meghatározásához vegye figyelembe az Update Domain és a maxBatchInstancePercent tartományt. Ez a mező csak akkor állítható be igaz vagy hamis értékre, ha a NodePlacementConfigurationt Zonalként használja.

maxBatchInstancePercent

integer (int32)

minimum: 5
maximum: 100

Az összes virtuálisgép-példány maximális százalékos aránya, amelyet a rendszer egyszerre frissít egy kötegben futó frissítéssel. Mivel ez a maximális, nem kifogástalan példányok az előző vagy jövőbeli kötegekben, a nagyobb megbízhatóság érdekében a köteg példányainak százalékos aránya csökkenhet. A mező értékének 5 és 100 közöttinek kell lennie, beleértve az értéket is. Ha a maxBatchInstancePercent és a maxUnhealthyInstancePercent is értékhez van rendelve, a maxBatchInstancePercent értéke nem lehet nagyobb, mint maxUnhealthyInstancePercent.

maxUnhealthyInstancePercent

integer (int32)

minimum: 5
maximum: 100

A méretezési csoportban lévő összes virtuálisgép-példány maximális százalékos aránya, amely egyidejűleg nem kifogástalan lehet a frissítés eredményeként, vagy ha a virtuális gép állapota nem megfelelő állapotban található a működés közbeni frissítés megszakítása előtt. A köteg indítása előtt a rendszer ellenőrzi ezt a korlátozást. A mező értékének 5 és 100 közöttinek kell lennie, beleértve az értéket is. Ha a maxBatchInstancePercent és a maxUnhealthyInstancePercent is értékhez van rendelve, a maxBatchInstancePercent értéke nem lehet nagyobb, mint maxUnhealthyInstancePercent.

maxUnhealthyUpgradedInstancePercent

integer (int32)

minimum: 0
maximum: 100

A frissített virtuálisgép-példányok maximális százalékos aránya, amely nem kifogástalan állapotban található. Ez az ellenőrzés az egyes kötegek frissítése után történik. Ha ezt a százalékos értéket valaha is túllépi, a működés közbeni frissítés leáll. A mező értékének 0 és 100 közöttinek kell lennie, beleértve az értéket is.

pauseTimeBetweenBatches

string (duration)

Az egy kötegben lévő összes virtuális gép frissítésének befejezése és a következő köteg indítása közötti várakozási idő. Az időtartamot ISO 8601 formátumban kell megadni.

prioritizeUnhealthyInstances

boolean

Frissítse a méretezési csoportban lévő összes nem kifogástalan példányt az kifogástalan állapotú példányok előtt.

rollbackFailedInstancesOnPolicyBreach

boolean

Sikertelen példányok visszaállítása az előző modellre, ha a működés közbeni frissítési szabályzatot megsértették.

SecurityEncryptionTypes

A felügyelt lemez EncryptionType tulajdonságát adja meg. A VMGuestStateOnly értékre van állítva csak a VMGuestState blob titkosításához, és a NemPersistedTPM értékre, ha nem tartja meg a belső vezérlőprogram állapotát a VMGuestState-blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használatakor szükséges.

Érték Description
NonPersistedTPM
VMGuestStateOnly

SecurityProfile

Megadja a virtuális gép vagy a virtuálisgép-méretezési csoport biztonsági profilbeállításait.

Name Típus Description
encryptionAtHost

boolean

Ezt a tulajdonságot a felhasználó használhatja a kérelemben a virtuális gép vagy virtuálisgép-méretezési csoport gazdagéptitkosításának engedélyezésére vagy letiltására. Ez lehetővé teszi az összes lemez titkosítását, beleértve magát a gazdagépen található Resource/Temp lemezt is. A gazdagépekre vonatkozó titkosítással kapcsolatos további információkért tekintse meg a https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.

securityType

SecurityTypes

A virtuális gép SecurityType tulajdonságát adja meg. Az UefiSettings engedélyezéséhez minden megadott értékre be kell állítani.

uefiSettings

UefiSettings

Megadja a virtuális gép létrehozásakor használt biztonsági beállításokat, például a biztonságos rendszerindítást és a vTPM-et.
Megadja a virtuális gép létrehozásakor használt biztonsági beállításokat, például a biztonságos rendszerindítást és a vTPM-et.

SecurityTypes

A virtuális gép SecurityType tulajdonságát adja meg. Az UefiSettings engedélyezéséhez minden megadott értékre be kell állítani.

Érték Description
confidentialVM

Az Azure bizalmas számítástechnikai ajánlatai bizalmas virtuális gépeket kínálnak a magas biztonsági és bizalmassági követelményekkel rendelkező bérlők számára. Ezek a virtuális gépek erős, hardverre kényszerített határt biztosítanak a biztonsági igények kielégítése érdekében. A kód módosítása nélkül használhat bizalmas virtuális gépeket a migrálásokhoz, a platform pedig védi a virtuális gép állapotát az olvasástól vagy a módosítástól.

trustedLaunch

A megbízható indítás védelmet nyújt a fejlett és állandó támadási technikák ellen.

ServiceArtifactReference

Megadja azt a szolgáltatásösszetevő-referencia-azonosítót, amellyel a méretezési csoport összes virtuális gépe ugyanazt a rendszerképverziót állíthatja be a "legújabb" rendszerképverzió használatakor.

Name Típus Description
id

string

A ServiceArtifactReference szolgáltatásösszetevő-referenciaazonosítója
A szolgáltatásösszetevő referencia-azonosítója /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StartTask

Olyan feladat, amely akkor fut, amikor egy csomópont csatlakozik egy készlethez az Azure Batch szolgáltatásban, vagy amikor a számítási csomópont újraindul vagy újraépül.

Name Típus Description
commandLine

string

A StartTask parancssora.
A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj funkcióit, például a környezeti változók bővítését. Ha ki szeretné használni az ilyen funkciókat, a parancssorban meg kell hívnia a rendszerhéjat, például a Windowsban a "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, akkor relatív elérési utat kell használnia (a Feladat munkakönyvtárához képest), vagy a Batch által megadott környezeti változót (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Annak a tárolónak a beállításai, amelyek alatt a StartTask fut.
Ha ez meg van adva, a AZ_BATCH_NODE_ROOT_DIR (a csomóponton található Azure Batch-címtárak gyökere) alatt lévő összes könyvtár rekurzív módon lesz leképezve a tárolóba, a tevékenységkörnyezet összes változója a tárolóba van leképezve, és a feladat parancssora a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban AZ_BATCH_NODE_ROOT_DIR kívül létrehozott fájlok nem jelennek meg a gazdalemezen, ami azt jelenti, hogy a Batch-fájl API-k nem férnek hozzá ezekhez a fájlokhoz.

environmentSettings

EnvironmentSetting[]

A StartTask környezeti változóbeállításainak listája.

maxTaskRetryCount

integer (int32)

A tevékenység újrapróbálásának maximális száma.
A Batch szolgáltatás újrapróbálkoz egy feladatot, ha a kilépési kódja nem érvényes. Vegye figyelembe, hogy ez az érték kifejezetten az újrapróbálkozések számát szabályozza. A Batch szolgáltatás egyszer kipróbálja a feladatot, majd megpróbálkozhat ezzel a korláttal. Ha például a maximális újrapróbálkozás száma 3, a Batch legfeljebb 4 alkalommal próbálja meg a feladatot (egy kezdeti próbálkozás és 3 újrapróbálkozás). Ha az újrapróbálkozás maximális száma 0, a Batch szolgáltatás nem próbálkozik újra a feladattal. Ha a maximális újrapróbálkozási szám -1, a Batch szolgáltatás korlátozás nélkül újrapróbálkozza a feladatot, de ez nem ajánlott kezdő tevékenységhez vagy tevékenységhez. Az alapértelmezett érték 0 (nincs újrapróbálkozás).

resourceFiles

ResourceFile[]

Azon fájlok listája, amelyeket a Batch szolgáltatás a parancssor futtatása előtt letölt a számítási csomópontra. Az erőforrásfájlok listájának maximális mérete van. A maximális méret túllépésekor a kérés sikertelen lesz, a válasz hibakódja pedig RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét csökkenteni kell. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
Az elem alatt felsorolt fájlok a tevékenység munkakönyvtárában találhatók.

userIdentity

UserIdentity

Az a felhasználói identitás, amely alatt a StartTask fut.
Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a tevékenységhez.

waitForSuccess

boolean

Várjon-e a Batch szolgáltatás, amíg a StartTask sikeresen befejeződik (azaz a 0-s kilépési kóddal lépjen ki) a számítási csomóponton lévő feladatok ütemezése előtt.
Ha igaz, és a StartTask meghiúsul egy csomóponton, a Batch szolgáltatás a StartTaskot a maximális újrapróbálkozások számának (maxTaskRetryCount) értékére újrapróbálja. Ha a tevékenység az összes újrapróbálkozás után sem fejeződött be sikeresen, akkor a Batch szolgáltatás használhatatlanná teszi a csomópontot, és nem ütemezi a feladatokat. Ez a feltétel a számítási csomópont állapotán és a hibainformációkon keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg a StartTask befejezését. Ebben az esetben más feladatok is elkezdhetik a végrehajtást a számítási csomóponton, amíg a StartTask még fut; És még ha a StartTask meghiúsul is, az új feladatok továbbra is ütemezve lesznek a számítási csomóponton. Az alapértelmezett érték igaz.

StorageAccountType

A tárfiók típusa adatlemezek vagy operációsrendszer-lemezek létrehozásához.

Érték Description
premium_lrs

Az adatlemeznek/operációsrendszer-lemeznek prémium helyileg redundáns tárolást kell használnia.

standard_lrs

Az adatlemeznek/operációsrendszer-lemeznek szabványos helyileg redundáns tárolót kell használnia.

standardssd_lrs

Az adatlemeznek/operációsrendszer-lemeznek szabványos, helyileg redundáns SSD-tárolót kell használnia.

TaskContainerSettings

A tevékenység tárolóbeállításai.

Name Típus Description
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

A tárolófeladathoz csatlakoztatni kívánt elérési utak.
Ha ez a tömb null értékű, vagy nincs jelen, a tárolófeladat a teljes ideiglenes lemezmeghajtót csatlakoztatja a Windowsban (vagy linuxos AZ_BATCH_NODE_ROOT_DIR). Ha ez a tömb üresként van beállítva, nem fog adatelérési utakat csatlakoztatni a tárolóhoz.

containerRunOptions

string

A tároló létrehozási parancsának további beállításai.
Ezeket a további lehetőségeket argumentumként adja meg a "docker create" parancs, a Batch szolgáltatás által szabályozottakon kívül.

imageName

string

A tároló létrehozásához használni kívánt rendszerkép, amelyben a feladat futni fog.
Ez a teljes képhivatkozás, ahogy a "docker pull" kifejezés is meg van adva. Ha a rendszer nem ad meg címkét a képnév részeként, a rendszer alapértelmezés szerint a "latest" címkét használja.

registry

ContainerRegistry

A tároló lemezképét tartalmazó privát beállításjegyzék.
Ez a beállítás kihagyható, ha már meg van adva a készlet létrehozásakor.

workingDirectory

ContainerWorkingDirectory

A tároló tevékenység munkakönyvtárának helye.
Az alapértelmezett érték a "taskWorkingDirectory".

TaskSchedulingPolicy

Meghatározza, hogy a feladatok hogyan legyenek elosztva a számítási csomópontok között.

Name Típus Description
nodeFillType

ComputeNodeFillType

A tevékenységek elosztása a készlet számítási csomópontjai között.
Ha nincs megadva, az alapértelmezett oldalpár.

UefiSettings

Megadja a virtuális gép létrehozásakor használt biztonsági beállításokat, például a biztonságos rendszerindítást és a vTPM-et.

Name Típus Description
secureBootEnabled

boolean

Megadja, hogy engedélyezni kell-e a biztonságos rendszerindítást a virtuális gépen.

vTpmEnabled

boolean

Megadja, hogy a virtuális gépen engedélyezve legyen-e a vTPM.

UpgradeMode

Megadja a méretezési csoportban lévő virtuális gépekre való frissítés módját.

A lehetséges értékek a következők:

Manuális – A méretezési csoportban lévő virtuális gépek frissítéseinek alkalmazását szabályozhatja. Ezt a manualUpgrade művelet használatával teheti meg.

Automatikus – A méretezési csoportban lévő összes virtuális gép automatikusan frissül.

Gördülő – A méretezési csoport a frissítéseket kötegekben hajtja végre, köztük egy opcionális szünetidővel.

Érték Description
automatic

A méretezési csoportban lévő összes virtuális gép automatikusan frissül egyszerre.

manual

Ön szabályozza a méretezési csoportban lévő virtuális gépek frissítéseinek alkalmazását. Ezt a manualUpgrade művelet használatával teheti meg.

rolling

A méretezési csoport meglévő példányai a frissítendő kötegekben lesznek leállítva. A frissített köteg befejezése után a példányok újra megkezdik a forgalom felvételét, és megkezdődik a következő köteg. Ez mindaddig folytatódik, amíg az összes példány up-to-date értékre nem kerül.

UpgradePolicy

Egy frissítési szabályzatot ír le – automatikus, manuális vagy működés közben.

Name Típus Description
automaticOSUpgradePolicy

AutomaticOSUpgradePolicy

Az operációs rendszer automatikus frissítéséhez használt konfigurációs paraméterek.
Az operációs rendszer automatikus frissítéséhez használt konfigurációs paraméterek.

mode

UpgradeMode

Megadja a méretezési csoportban lévő virtuális gépekre való frissítés módját.

A lehetséges értékek a következők:

Manuális – A méretezési csoportban lévő virtuális gépek frissítéseinek alkalmazását szabályozhatja. Ezt a manualUpgrade művelet használatával teheti meg.

Automatikus – A méretezési csoportban lévő összes virtuális gép automatikusan frissül.

Gördülő – A méretezési csoport a frissítéseket kötegekben hajtja végre, köztük egy opcionális szünetidővel.

rollingUpgradePolicy

RollingUpgradePolicy

A működés közbeni frissítés során használt konfigurációs paraméterek.
A működés közbeni frissítés során használt konfigurációs paraméterek.

UserAccount

Az Azure Batch számítási csomópont feladatainak végrehajtásához használt felhasználó létrehozásához használt tulajdonságok.

Name Típus Description
elevationLevel

ElevationLevel

A felhasználói fiók emelési szintje.
Az alapértelmezett érték nem Admin.

linuxUserConfiguration

LinuxUserConfiguration

A felhasználói fiók Linux-specifikus felhasználói konfigurációja.
Ezt a tulajdonságot a rendszer figyelmen kívül hagyja, ha egy Windows-készletben van megadva. Ha nincs megadva, a felhasználó az alapértelmezett beállításokkal jön létre.

name

string

A felhasználói fiók neve. A nevek legfeljebb 20 Unicode-karaktert tartalmazhatnak.

password

string

A felhasználói fiók jelszava.

windowsUserConfiguration

WindowsUserConfiguration

A felhasználói fiók Windows-specifikus felhasználói konfigurációja.
Ez a tulajdonság csak akkor adható meg, ha a felhasználó Windows-készletben van. Ha nincs megadva, és Windows-készleten, a rendszer az alapértelmezett beállításokkal hozza létre a felhasználót.

UserIdentity

Annak a felhasználói identitásnak a definíciója, amely alatt a feladat fut.

Name Típus Description
autoUser

AutoUserSpecification

Az az automatikus felhasználó, amely alatt a feladat fut.
A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem.

username

string

Annak a felhasználói identitásnak a neve, amely alatt a feladat fut.
A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem.

VirtualMachineConfiguration

A számítási csomópontok konfigurációja egy készletben az Azure Virtual Machines-infrastruktúra alapján.

Name Típus Description
containerConfiguration

ContainerConfiguration

A készlet tárolókonfigurációja.
Ha meg van adva, a rendszer a készlet minden számítási csomópontján elvégzi a telepítést, hogy a feladatok tárolókban fussanak. A készleten futó összes normál tevékenységnek és feladatkezelői tevékenységnek meg kell adnia a containerSettings tulajdonságot, és az összes többi tevékenység megadhatja azt.

dataDisks

DataDisk[]

A készlet számítási csomópontjaihoz csatolt adatlemezek konfigurációja.
Ezt a tulajdonságot akkor kell megadni, ha a készlet számítási csomópontjaihoz üres adatlemezeket kell csatolni. Ez nem frissíthető. Minden számítási csomópont saját lemezt kap (a lemez nem fájlmegosztás). A meglévő lemezek nem csatolhatók, minden csatolt lemez üres. Amikor a számítási csomópontot eltávolítja a készletből, a lemez és a hozzá társított összes adat is törlődik. A lemezt a csatolás után nem formázza, használat előtt formázni kell – további információ: https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux és https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

DiskEncryptionConfiguration

A készlet lemeztitkosítási konfigurációja.
Ha meg van adva, a rendszer titkosítást végez a készlet minden csomópontján a csomópontok kiépítése során.

extensions

VMExtension[]

A készlet virtuálisgép-bővítménye.
Ha meg van adva, az ebben a konfigurációban említett bővítmények minden csomóponton telepítve lesznek.

imageReference

ImageReference

Hivatkozás az Azure Virtual Machines Marketplace-rendszerképére vagy a használni kívánt egyéni virtuálisgép-rendszerképre.

licenseType

string

Az operációs rendszer telepítésekor használandó helyszíni licenc típusa.
Ez csak a Windows operációs rendszert tartalmazó rendszerképekre vonatkozik, és csak akkor használható, ha érvényes helyszíni licencekkel rendelkezik az üzembe helyezett számítási csomópontokhoz. Ha nincs megadva, a rendszer nem alkalmaz helyszíni licencelési kedvezményt. Az értékek a következők:

Windows_Server – A helyszíni licenc a Windows Serverhez készült. Windows_Client – A helyszíni licenc Windows-ügyfélhez készült.

nodeAgentSKUId

string

A készlet számítási csomópontjaihoz kiépíteni kívánt Batch számítási csomópont ügynök termékváltozata.
A Batch Számítási csomópont ügynök egy olyan program, amely a készlet minden számítási csomópontján fut, és biztosítja a parancs- és vezérlő felületet a számítási csomópont és a Batch szolgáltatás között. A számítási csomópont ügynökének különböző implementációi vannak, más néven termékváltozatok a különböző operációs rendszerekhez. Meg kell adnia egy számítási csomópont ügynök termékváltozatát, amely megfelel a kiválasztott képhivatkozásnak. A támogatott számítási csomópont-ügynök termékváltozatainak és az ellenőrzött képhivatkozások listájának lekéréséhez tekintse meg a támogatott számítási csomópont-ügynök termékváltozatainak listáját.

nodePlacementConfiguration

NodePlacementConfiguration

A készlet csomópontelhelyezési konfigurációja.
Ez a konfiguráció határozza meg a készlet csomópontjai fizikai lefoglalásának módját.

osDisk

OSDisk

A virtuális gép operációsrendszer-lemezének beállításai.

securityProfile

SecurityProfile

Megadja a virtuális gép vagy a virtuálisgép-méretezési csoport biztonsági profilbeállításait.
Megadja a virtuális gép vagy a virtuálisgép-méretezési csoport biztonsági profilbeállításait.

serviceArtifactReference

ServiceArtifactReference

Megadja azt a szolgáltatásösszetevő-referencia-azonosítót, amellyel a méretezési csoport összes virtuális gépe ugyanazt a rendszerképverziót állíthatja be a "legújabb" rendszerképverzió használatakor.
A szolgáltatásösszetevő referencia-azonosítója /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Windows operációs rendszer beállításai a virtuális gépen.
Ezt a tulajdonságot nem szabad megadni, ha az imageReference tulajdonság linuxos operációsrendszer-lemezképet ad meg.

VMDiskSecurityProfile

Megadja a felügyelt lemez biztonsági profilbeállításait. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használata esetén kötelező.

Name Típus Description
securityEncryptionType

SecurityEncryptionTypes

A felügyelt lemez EncryptionType tulajdonságát adja meg. A VMGuestStateOnly értékre van állítva csak a VMGuestState blob titkosításához, és a NemPersistedTPM értékre, ha nem tartja meg a belső vezérlőprogram állapotát a VMGuestState-blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be, és bizalmas virtuális gépek használatakor szükséges.

VMExtension

A virtuálisgép-bővítmények konfigurációja.

Name Típus Description
autoUpgradeMinorVersion

boolean

Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.

enableAutomaticUpgrade

boolean

Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.

name

string

A virtuálisgép-bővítmény neve.

protectedSettings

object

A bővítmény tartalmazhat védettSettings vagy protectedSettingsFromKeyVault beállítást, vagy egyáltalán nem tartalmaz védett beállításokat.

provisionAfterExtensions

string[]

A bővítménynevek gyűjteménye.
Olyan bővítménynevek gyűjteménye, amelyek után ezt a bővítményt ki kell építeni.

publisher

string

A bővítménykezelő közzétevőjének neve.

settings

object

A bővítmény JSON formátumú nyilvános beállításai.

type

string

A bővítmény típusa.

typeHandlerVersion

string

A szkriptkezelő verziója.

WindowsConfiguration

A windowsos operációs rendszer virtuális gépre vonatkozó beállításai.

Name Típus Description
enableAutomaticUpdates

boolean

Azt jelzi, hogy engedélyezve vannak-e az automatikus frissítések a virtuális gépen.
Ha nincs megadva, az alapértelmezett érték igaz.

WindowsUserConfiguration

Felhasználói fiók windowsos számítási csomóponton való létrehozásához használt tulajdonságok.

Name Típus Description
loginMode

LoginMode

A felhasználó bejelentkezési módja
Az alapértelmezett érték a "batch".