Pool - List

A megadott fiók összes készletét felsorolja.

GET {batchUrl}/pools?api-version=2023-11-01.18.0
GET {batchUrl}/pools?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.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.

api-version
query True

string

Ügyfél API-verziója.

$expand
query

string

OData $expand záradék.

$filter
query

string

OData $filter záradék. A szűrő felépítésével kapcsolatos további információkért lásd: https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

$select
query

string

OData $select záradék.

maxresults
query

integer

int32

A válaszban visszaadandó elemek maximális száma. Legfeljebb 1000 készlet adható vissza.

timeout
query

integer

int32

A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

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 a REST API-t közvetlenül hívja meg.

Válaszok

Name Típus Description
200 OK

CloudPoolListResult

A készletek listáját tartalmazó válasz.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: 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ódfolyamata

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Authorization

Type: apiKey
In: header

Példák

Pool list

Sample Request

GET account.region.batch.azure.com/pools?api-version=2023-11-01.18.0


Sample Response

{
  "value": [
    {
      "id": "testPool",
      "url": "https://accountname.region.batch.azure.com/pools/testPool",
      "eTag": "0x8D4123BEF87D233",
      "lastModified": "2016-11-21T18:26:39.7108787Z",
      "creationTime": "2016-11-21T18:26:39.7108787Z",
      "state": "active",
      "stateTransitionTime": "2016-11-21T18:26:39.7108787Z",
      "allocationState": "steady",
      "allocationStateTransitionTime": "2016-11-21T18:27:40.287803Z",
      "vmSize": "small",
      "resizeTimeout": "PT15M",
      "currentDedicatedNodes": 3,
      "currentLowPriorityNodes": 0,
      "targetDedicatedNodes": 3,
      "targetLowPriorityNodes": 0,
      "enableAutoScale": false,
      "enableInterNodeCommunication": false,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "taskSlotsPerNode": 1,
      "taskSchedulingPolicy": {
        "nodeFillType": "spread"
      },
      "cloudServiceConfiguration": {
        "osFamily": "4",
        "osVersion": "*"
      }
    }
  ]
}

Definíciók

Name Description
AllocationState

Azt jelzi, hogy a készlet átméretez-e.

ApplicationPackageReference

A számítási csomópontokon üzembe helyezendő csomagra mutató hivatkozás.

AutoScaleRun

A készlet automatikus skálázási képletének végrehajtásából származó eredmények és hibák.

AutoScaleRunError

Hiba történt egy készlet automatikus skálázási képletének végrehajtásakor vagy kiértékelésekor.

AutoUserScope

Az automatikus felhasználó hatóköre

AutoUserSpecification

A Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit adja meg.

AzureBlobFileSystemConfiguration

Az Azure Storage-tárolók blobfuse használatával való csatlakoztatásához használt információk.

AzureFileShareConfiguration

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

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

BatchErrorDetail

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

BatchPoolIdentity

A Batch-készlet identitása, ha konfigurálva van.

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á a tanúsítványt telepíteni szeretné.

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.

CloudPool

Egy készlet a Azure Batch szolgáltatásban.

CloudPoolListResult

A készletek fiókban való listázásának eredménye.

CloudServiceConfiguration

A készlet számítási csomópontjainak konfigurációja az Azure Cloud Services platformon alapul.

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.

ContainerRegistry

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

ContainerType

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

ContainerWorkingDirectory

A tároló Feladat 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ációja nem támogatott az Azure Compute Gallery Image szolgáltatással 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

Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre. A Azure Batch által ellenőrzött Azure Marketplace képhivatkozások listájának lekéréséhez tekintse meg a "Támogatott képek listázása" műveletet.

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 csatlakoztatandó fájlrendszer.

NameValuePair

Név-érték párokat jelöl.

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ímhez, alhálózati tartományhoz vagy címkéhez végrehajtandó művelet.

NFSMountConfiguration

Az 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 készletben lévő csomópontok lefoglalására vonatkozó elhelyezési szabályzat.

OSDisk

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

PoolEndpointConfiguration

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

PoolIdentityType

A Batch-készlet identitása, ha konfigurálva van.

PoolState

A készlet aktuális állapota.

PoolStatistics

A készlet élettartamára vonatkozó kihasználtsági és erőforrás-használati statisztikákat tartalmazza.

PublicIPAddressConfiguration

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

ResizeError

Hiba történt egy készlet átméretezésekor.

ResourceFile

Egy vagy több fájl, amely egy számítási csomópontra tölthető le.

ResourceStatistics

A készlet számítási csomópontjai által történő erőforrás-használattal kapcsolatos statisztikák.

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épéhez ugyanazt a rendszerképverziót állíthatja be a "legújabb" rendszerképverzió használatakor.

StartTask

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

StorageAccountType

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

TaskContainerSettings

A feladat 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.

UsageStatistics

A készlet használati adataival kapcsolatos statisztikák.

UserAccount

A feladatok Azure Batch számítási csomóponton való végrehajtásához használt felhasználó létrehozásához használt tulajdonságok.

UserAssignedIdentity

A felhasználó által hozzárendelt identitás

UserIdentity

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

VirtualMachineConfiguration

A készlet számítási csomópontjainak konfigurációja az Azure Virtual Machines-infrastruktúrán alapul.

VMExtension

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

WindowsConfiguration

A Windows 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.

AllocationState

Azt jelzi, hogy a készlet átméretez-e.

Name Típus Description
resizing

string

A készlet átméretezésen van; vagyis a számítási csomópontok hozzáadása vagy eltávolítása a készlethez történik.

steady

string

A készlet átméretezése nem történik meg. A készletben lévő számítási csomópontok száma nem változik. A készlet ezt az állapotot adja meg a létrehozáskor, és amikor nem hajtanak végre műveleteket a készleten a számítási csomópontok számának módosításához.

stopping

string

A készlet átméretezése megtörtént, de a felhasználó kérte az átméretezés leállítását, de a leállítási kérés még nem fejeződött be.

ApplicationPackageReference

A számítási csomópontokon üzembe helyezendő csomagra mutató hivatkozás.

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észletben, é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.

AutoScaleRun

A készlet automatikus skálázási képletének végrehajtásából származó eredmények és hibák.

Name Típus Description
error

AutoScaleRunError

A készlet automatikus skálázási képletének kiértékelésekor észlelt hiba részletei, ha a kiértékelés sikertelen volt.

results

string

Az automatikus skálázási képlet kiértékelése során használt összes változó végső értékei.
A rendszer minden változóértéket $variable=érték formában ad vissza, a változókat pedig pontosvesszővel választja el egymástól.

timestamp

string

Az automatikus skálázási képlet utolsó kiértékelésének időpontja.

AutoScaleRunError

Hiba történt egy készlet automatikus skálázási képletének végrehajtásakor vagy kiértékelésekor.

Name Típus Description
code

string

Az automatikus skálázási hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

message

string

Az automatikus skálázási hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

values

NameValuePair[]

Az automatikus skálázási hibával kapcsolatos további hibaadatok listája.

AutoUserScope

Az automatikus felhasználó hatóköre

Name Típus Description
pool

string

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

string

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

AutoUserSpecification

A Batch szolgáltatásban feladatot futtató automatikus felhasználó paramétereit adja meg.

Name Típus Description
elevationLevel

ElevationLevel

Az automatikus felhasználó jogosultságszintje.
Az alapértelmezett érték a nonAdmin.

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 feladat ú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észletben, amelyeknek nem lehetnek elérhetők a normál tevékenységek, de a StartTasksnak elérhetővé kell tenniük.

AzureBlobFileSystemConfiguration

Az Azure Storage-tárolók blobfuse használatával való csatlakoztatásához 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áró 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ó átadáshoz.
Ezek a windowsos "net use" és a "csatlakoztatási" lehetőségek Linuxon.

containerName

string

A 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 csatlakoztatva van a Batch csatlakoztatási könyvtárához képest, 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árja az accountKey és az identitás értékét; 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ók kulcsa.

accountName

string

Az Azure Storage-fiók neve.

azureFileUrl

string

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

mountOptions

string

További parancssori beállítások a csatlakoztatási parancsnak való átadáshoz.
Ezek a windowsos "net use" és a "csatlakoztatási" lehetőségek Linuxon.

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 csatlakoztatva van a Batch csatlakoztatási könyvtárához képest, amely a AZ_BATCH_NODE_MOUNTS_DIR környezeti változón keresztül érhető el.

BatchError

Hibaválasz érkezett a Azure Batch szolgáltatástól.

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, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

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

Name Típus Description
key

string

Egy azonosító, amely az Érték tulajdonság jelentését adja meg.

value

string

A hibaválaszban szereplő további információk.

BatchPoolIdentity

A Batch-készlet identitása, ha konfigurálva van.

Name Típus Description
type

PoolIdentityType

A Batch-készlet identitása, ha konfigurálva van.
A Batch-készlethez társított felhasználói identitások listája. A felhasználói identitás szótárának kulcshivatkozásai a következő űrlapon található ARM-erőforrás-azonosítók: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

userAssignedIdentities

UserAssignedIdentity[]

A Batch-fiókhoz társított felhasználói identitások listája.
A felhasználói identitás szótárának kulcshivatkozásai a következő űrlapon található ARM-erőforrás-azonosítók: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

CachingType

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

Name Típus Description
none

string

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

readonly

string

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

readwrite

string

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

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á a tanúsítványt telepíteni szeretné.
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 (azaz a cloudServiceConfiguration használatával vagy a virtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárában található 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 (pl. /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 (azaz a cloudServiceConfiguration használatával vagy a virtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Az áruházak gyakori nevei a következők: My, Root, CA, Trust, Disallowed, 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á a tanúsítványt telepíteni szeretné.

Name Típus Description
currentuser

string

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

localmachine

string

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

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.

Name Típus Description
remoteuser

string

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

string

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 Automatikusfelhasználó hatóköre a StartTask és a Tevékenység készlete, akkor ez a tanúsítvány a tevékenység számára is látható lesz.

task

string

A tanúsítványnak láthatónak kell lennie azokhoz a felhasználói fiókokhoz, amelyeken 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ó átadáshoz.
Ezek a windowsos "net use" és a "csatlakoztatási" lehetőségek Linuxon.

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 csatlakoztatva van a Batch csatlakoztatási könyvtárához képest, 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ó.

CloudPool

Egy készlet a Azure Batch szolgáltatásban.

Name Típus Description
allocationState

AllocationState

Azt jelzi, hogy a készlet átméretez-e.

allocationStateTransitionTime

string

Az az időpont, amikor a készlet elérte a jelenlegi foglalási állapotát.

applicationLicenses

string[]

A Batch szolgáltatás által elérhetővé tenni kívánt alkalmazáslicencek listája a készlet minden számítási csomópontján.
Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek részhalmazának kell lennie. Ha olyan licencet kérnek, amely nem támogatott, a készlet létrehozása sikertelen lesz.

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 nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítja vagy újra nem alakítja őket. Egy adott készleten legfeljebb 10 csomaghivatkozás lehet.

autoScaleEvaluationInterval

string

Az az időintervallum, amikor a készlet mérete automatikusan módosítható az automatikus skálázási képletnek megfelelően.
Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

autoScaleFormula

string

A készletben lévő számítási csomópontok kívánt számának képlete.
Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

autoScaleRun

AutoScaleRun

Az automatikus skálázási képlet legutóbbi végrehajtásának eredményei és hibái.
Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

certificateReferences

CertificateReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt tanúsítványok listája.
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 Tevékenység munkakönyvtárban található 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ánykö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 el lesz távolítva. Használja helyette az Azure KeyVault bővítményt .

cloudServiceConfiguration

CloudServiceConfiguration

A készlet felhőszolgáltatás-konfigurációja.
Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizáróak, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiókot a poolAllocationMode tulajdonsággal hozták létre, és "UserSubscription" értékre van állítva.

creationTime

string

A készlet létrehozási ideje.

currentDedicatedNodes

integer

A készletben jelenleg található dedikált számítási csomópontok száma.

currentLowPriorityNodes

integer

A készletben jelenleg található kihasználatlan/alacsony prioritású számítási csomópontok száma.
A kihasználatlan/alacsony prioritású számítási csomópontok, amelyek már ki vannak állítva, ebben a számban szerepelnek.

currentNodeCommunicationMode

NodeCommunicationMode

A készlet kommunikációs módjának aktuális állapota.

displayName

string

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

eTag

string

A készlet ETagje.
Ez egy átlátszatlan sztring. Segítségével megállapíthatja, hogy a készlet megváltozott-e a kérések között. A készlet frissítésekor átadhatja az ETaget, így megadhatja, hogy a módosítások csak akkor lépnek érvénybe, ha időközben senki más nem módosította a készletet.

enableAutoScale

boolean

Azt határozza meg, hogy a készlet mérete idővel automatikusan módosuljon-e.
Ha hamis, meg kell adni legalább egy targetDedicatedNodes és targetLowPriorityNodes paramétert. Ha igaz, az autoScaleFormula tulajdonság megadása kötelező, és a készlet a képletnek megfelelően automatikusan átméreteződik. Az alapértelmezett érték a hamis.

enableInterNodeCommunication

boolean

Lehetővé teszi-e a készlet a számítási csomópontok közötti közvetlen kommunikációt.
Ez korlátozza, hogy mely számítási csomópontok rendelhetők hozzá a készlethez. Ennek az értéknek a megadása csökkentheti a készletben lefoglalandó számítási csomópontok kért számának esélyét.

id

string

Egy sztring, amely egyedileg azonosítja a készletet a fiókon belül.
Az azonosító tartalmazhat alfanumerikus karakterek bármilyen kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem különböztet meg (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy fiókon belül, amelyek csak esetenként különböznek).

identity

BatchPoolIdentity

A Batch-készlet identitása, ha konfigurálva van.
A Batch-készlethez társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai ARM-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

lastModified

string

A készlet utolsó módosításának időpontja.
Ez az utolsó alkalom, amikor a készletszintű adatok, például a targetDedicatedNodes vagy az enableAutoscale beállítások módosultak. Nem befolyásolja a csomópontszintű változásokat, például a számítási csomópontok változó állapotát.

metadata

MetadataItem[]

A készlethez metaadatként társított név-érték párok listája.

mountConfiguration

MountConfiguration[]

A készlet egyes csomópontjaihoz csatlakoztatandó fájlrendszerek listája.
Ez támogatja a Azure Files, az NFS, a CIFS/SMB és a Blobfuse használatát.

networkConfiguration

NetworkConfiguration

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

resizeErrors

ResizeError[]

A készlet utolsó átméretezése során előforduló hibák listája.
Ez a tulajdonság csak akkor van beállítva, ha egy vagy több hiba történt a készlet legutóbbi átméretezése során, és csak akkor, ha a készlet foglalási állapota Állandó.

resizeTimeout

string

A számítási csomópontok készlethez való lefoglalásának időtúllépése.
Ez a legutóbbi átméretezési művelet időtúllépése. (A készlet létrehozásakor a kezdeti méretezés átméretezésnek számít.) Az alapértelmezett érték 15 perc.

resourceTags

object

A készlethez társított felhasználó által megadott címkék.
A 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 "UserSubscription" értékre állította.

startTask

StartTask

Az egyes számítási csomópontokon a készlethez való csatlakozáskor futtatandó feladat.
A Batch újra megkísérli a Feladatokat, amikor egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem kifogástalan állapotú csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a függvényétől, és nem számítanak bele a maxTaskRetryCount értékbe. Még ha a maxTaskRetryCount is 0, egy helyreállítási művelet miatt belső újrapróbálkozhat. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a feladatoknak tűrni kell a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok esetében az ajánlott eljárás az ellenőrzőpontok valamilyen formájának használata. Bizonyos esetekben előfordulhat, hogy a StartTask újra fut, annak ellenére, hogy a számítási csomópont nem lett újraindítva. Különös figyelmet kell fordítani arra, hogy elkerülje azokat a StartTask-okat, amelyek megszakító folyamatot hoznak létre, vagy szolgáltatásokat telepítenek/indítanak el a StartTask munkakönyvtárából, mivel ez megakadályozza, hogy a Batch újra tudja futtatni a StartTaskot.

state

PoolState

A készlet aktuális állapota.

stateTransitionTime

string

Az az időpont, amikor a készlet elérte a jelenlegi állapotát.

stats

PoolStatistics

A készlet teljes élettartama kihasználtsági és erőforrás-használati statisztikái.
Ez a tulajdonság csak akkor lesz feltöltve, ha a CloudPool kibontási záradékkal lett beolvasva, beleértve a "stats" attribútumot; ellenkező esetben null értékű. Előfordulhat, hogy a statisztikák nem érhetők el azonnal. A Batch szolgáltatás rendszeres időközönként összesít statisztikákat. A késés általában körülbelül 30 perc.

targetDedicatedNodes

integer

A készletben található dedikált számítási csomópontok kívánt száma.

targetLowPriorityNodes

integer

A készletben lévő kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma.

targetNodeCommunicationMode

NodeCommunicationMode

A készlet kívánt csomópontkommunikációs módja.
Ha nincs megadva, az alapértelmezett érték az Alapértelmezett.

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.

taskSlotsPerNode

integer

Azon feladathelyek száma, amelyek a készlet egyetlen számítási csomópontján egyidejű feladatok futtatására használhatók.
Az alapértelmezett érték az 1. A maximális érték a készlet vmSize magjainak számának 4-szerese vagy 256-nak a kisebb.

url

string

A készlet URL-címe.

userAccounts

UserAccount[]

A készlet minden számítási csomópontján létrehozandó felhasználói fiókok listája.

virtualMachineConfiguration

VirtualMachineConfiguration

A készlet virtuálisgép-konfigurációja.
Ez a tulajdonság és a cloudServiceConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot.

vmSize

string

A készletben lévő virtuális gépek mérete. A készlet összes virtuális gépe azonos méretű.
A készletekben elérhető virtuális gépek méretével kapcsolatos információkért lásd: Virtuálisgép-méret kiválasztása számítási csomópontokhoz egy Azure Batch készletben (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

CloudPoolListResult

A készletek fiókban való listázásának eredménye.

Name Típus Description
odata.nextLink

string

A következő találatkészlet lekéréséhez tartozó URL-cím.

value

CloudPool[]

A készletek listája.

CloudServiceConfiguration

A készlet számítási csomópontjainak konfigurációja az Azure Cloud Services platformon alapul.

Name Típus Description
osFamily

string

A készletben lévő virtuális gépekre telepíteni kívánt Azure-vendég operációsrendszer-család.
A lehetséges értékek a következők: 2 – Os Family 2, egyenértékű a Windows Server 2008 R2 SP1 rendszerrel. 3 – Operációsrendszer-család 3, egyenértékű a Windows Server 2012. 4 – Os Family 4, egyenértékű az Windows Server 2012 R2-zel. 5 – Operációsrendszer-család 5, egyenértékű a Windows Server 2016. 6 – Os Family 6, egyenértékű a Windows Server 2019-zel. További információ: Azure-vendég operációs rendszer kiadásai (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion

string

A készlet virtuális gépein telepíteni kívánt Azure-vendég operációs rendszer verziója.
Az alapértelmezett érték * , amely a megadott operációsrendszer-család legújabb operációsrendszer-verzióját adja meg.

ComputeNodeFillType

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

Name Típus Description
pack

string

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ópontjára kerülnek.

spread

string

A tevékenységeket egyenletesen kell hozzárendelni a készlet összes számítási csomópontjá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 származnak, kivéve, ha a rendszerkép teljes mértékben egy alternatív beállításjegyzékkel rendelkezik.

containerRegistries

ContainerRegistry[]

További magánregisztrációs adatbázisok, amelyekből a tárolók lekérthetők.
Ha a rendszerképeket egy olyan privát beállításjegyzékből kell letölteni, amelyhez hitelesítő adatok szükségesek, akkor ezeket a hitelesítő adatokat itt kell megadni.

type

ContainerType

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

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 való hivatkozás, a felhasználónév és a jelszó helyett egy 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 megadott 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 megadott felhasználónév.

ContainerType

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

Name Típus Description
criCompatible

string

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

dockerCompatible

string

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

ContainerWorkingDirectory

A tároló Feladat munkakönyvtárának helye.

Name Típus Description
containerImageDefault

string

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

string

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 adatlemezeken engedélyezendő gyorsítótárazás típusa.
A gyorsítótárazás alapértelmezett értéke az írási cím. A gyorsítótárazási lehetőségekről a következő témakörben olvashat bővebben: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

A kezdeti lemezméret gigabájtban.

lun

integer

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ött kell lennie, beleértve a é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.

Name Típus Description
CacheDisk

string

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ép esetében.
Ezt a tulajdonságot a felhasználó használhatja a kérésben, hogy kiválassza a helyet, például gyorsítótárazza a lemezterületet az operációs rendszer rövid élettartamú lemezkiosztásához. A rövid élettartamú operációsrendszer-lemez méretére vonatkozó követelményekkel kapcsolatos további információkért tekintse meg a windowsos és Linux rendszerű virtuális gépek rövid élettartamú lemezméretére vonatkozó követelményeket https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements itt https://docs.microsoft.com/en-us/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ációja nem támogatott az Azure Compute Gallery Image szolgáltatással 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.
Ha nincs megadva, a készlet számítási csomópontjaiban lévő lemezek nem lesznek titkosítva. Linux-készleten csak az "Ideiglenesdisk" támogatott; a Windows-készletben meg kell adni az "OsDisk" és az "TemporaryDisk" értéket.

DiskEncryptionTarget

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

Name Típus Description
osdisk

string

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

temporarydisk

string

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 a csatlakoztatott adatlemezeken lévőkre) vonatkozik, ha 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.

Name Típus Description
job

string

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

none

string

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

ElevationLevel

A felhasználó szintemelési szintje.

Name Típus Description
admin

string

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

nonadmin

string

A felhasználó egy emelt szintű hozzáféréssel nem rendelkező standard felhasználó.

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 nyelvkódja

value

string

Az üzenet szövege.

ImageReference

Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy Azure Compute Gallery-rendszerképre. A Azure Batch által ellenőrzött Azure Marketplace képhivatkozások listájának lekéréséhez tekintse meg a "Támogatott képek listázása" műveletet.

Name Típus Description
exactVersion

string

A csomópont létrehozásához használt platformrendszerkép vagy piactéri rendszerkép adott verziója. Ez a csak olvasható mező csak akkor tér el 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.

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 verziója.
A rendszerkép legújabb verziójának kiválasztásához megadható a "legújabb" érték. 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.
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 a Azure Batch-fióknak. Ha a kép verziója nincs megadva az imageId-ben, 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ásaival kapcsolatos információkért lásd: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

A végpont protokollja.

Name Típus Description
tcp

string

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

udp

string

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

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 22, 3389, 29876 és 29877 értéket, 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

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 az 50000 és 55000 közötti portokat, amelyeket a Batch szolgáltatás foglal le. 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 van fenntartott vagy átfedésben lévő érték, a kérés 400-ás HTTP-állapotkóddal meghiúsul.

frontendPortRangeStart

integer

A külső portok tartományának első portszáma, amely az egyes számítási csomópontok háttérjelentéséhez 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 egy Batch-készleten belül, betűket, számokat, aláhúzásjeleket, pontokat és kötőjeleket tartalmazhat. 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 alkalmazandó 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érjelentéshez. Ha túllépi a hálózati biztonsági csoport szabályainak maximális számát, a kérés 400-as 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.

Name Típus Description
batchmanaged

string

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

string

Nem jön létre nyilvános IP-cím.

usermanaged

string

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 felhaszná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

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 választja ki a gid-t.

sshPrivateKey

string

A felhasználói fiók SSH titkos kulcsa.
A titkos kulcs nem védhető jelszóval. A titkos kulcs használatával automatikusan konfigurálható az aszimmetrikus kulcson alapuló hitelesítés az SSH-hoz 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

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 az uid azonosítót.

LoginMode

A felhasználó bejelentkezési módja

Name Típus Description
batch

string

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

string

A LOGON32_LOGON_INTERACTIVE Win32 bejelentkezési mód. Az UAC engedélyezve van a Windows VirtualMachineConfiguration-készletekben. Ha ezt a beállítást emelt szintű felhasználói identitással használja egy Windows VirtualMachineConfiguration-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 igényeljen.

ManagedDisk

Name Típus Description
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 csatlakoztatandó 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.

NameValuePair

Név-érték párokat jelöl.

Name Típus Description
name

string

A név-érték párban lévő név.

value

string

A név-érték párban lévő érték.

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 az egyszeri gyökérszintű I/O-virtualizálást (SR-IOV) egy virtuális gépre, ami jobb hálózati teljesítményt eredményezhet. További információ: 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.
A készletvégpont konfigurációja csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott.

publicIPAddressConfiguration

PublicIPAddressConfiguration

A Batch-készlet számítási csomópontjaihoz tartozó nyilvános IPAddress-konfiguráció.
A nyilvános IP-konfigurációs tulajdonság csak a virtualMachineConfiguration tulajdonsággal rendelkező készletekben támogatott.

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}/subnets/{subnet}.
A virtuális hálózatnak ugyanabban a régióban és előfizetésben kell lennie, mint a Azure Batch-fióknak. A megadott alhálózatnak elegendő szabad IP-címmel kell rendelkeznie a készletben lévő számítási csomópontok számának kezeléséhez. 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 "Klasszikus virtuálisgép-közreműködő" Role-Based Access Control (RBAC) szerepkörrel a megadott virtuális hálózathoz. A megadott alhálózatnak engedélyeznie kell a Azure Batch szolgáltatástól érkező kommunikációt, hogy képes legyen feladatokat ütemezni a csomópontokon. Ennek ellenőrzéséhez ellenőrizze, 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álhatatlanra állítja a számítási csomópontok állapotát. A virtualMachineConfiguration szolgáltatással létrehozott készletek esetében csak az ARM-alapú virtuális hálózatok (Microsoft.Network/virtualNetworks) támogatottak, de a cloudServiceConfiguration szolgáltatással létrehozott készletek esetében az ARM és a klasszikus virtuális hálózatok is támogatottak. Ha a megadott virtuális hálózathoz társított hálózati biztonsági csoportok (NSG) találhatók, néhány fenntartott portot engedélyezni kell a bejövő kommunikációhoz. A virtuálisgép-konfigurációval létrehozott készletek esetében engedélyezze a 29876-os és a 29877-es portot, valamint a 22-es portot Linuxon és a 3389-es portot a Windowshoz. A felhőszolgáltatás-konfigurációval létrehozott készletek esetében engedélyezze a 10100-at, a 20100-at és a 30100-at. Emellett engedélyezze a kimenő kapcsolatokat az Azure Storage-hoz a 443-as porton. További részletekért lásd: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#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ímhez, alhálózati tartományhoz vagy címkéhez végrehajtandó művelet.

priority

integer

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. 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 sorszámú szabállyal szemben. Az engedélyezett prioritások: 150–4096. Ha a rendszer fenntartott vagy duplikált értékeket ad meg, a kérés 400-ás HTTP-állapotkóddal meghiúsul.

sourceAddressPrefix

string

A szabálynak megfelelő forráscím-előtag vagy címke.
Az érvényes értékek egyetlen IP-cím (például 10.10.10.10.10), IP-alhálózat (azaz 192.168.1.0/24), alapértelmezett címke vagy * (minden cím esetében). Ha más értékeket is megad, a kérés 400-ás HTTP-állapotkóddal meghiúsul.

sourcePortRanges

string[]

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

NetworkSecurityGroupRuleAccess

A megadott IP-címhez, alhálózati tartományhoz vagy címkéhez végrehajtandó művelet.

Name Típus Description
allow

string

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

deny

string

Hozzáférés megtagadása.

NFSMountConfiguration

Az 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ó átadáshoz.
Ezek a windowsos "net use" és a "csatlakoztatási" lehetőségek Linuxon.

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 csatlakoztatva van a Batch csatlakoztatási könyvtárához képest, 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.

Name Típus Description
classic

string

A klasszikus kommunikációs módot használó csomópontok bejövő TCP-kommunikációt igényelnek a "BatchNodeManagement" 29876-os és 29877-es porton. {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

string

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

simplified

string

Az egyszerűsített kommunikációs módot használó csomópontok kimenő TCP-kommunikációt igényelnek a 443-es 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 készletben lévő csomópontok lefoglalására vonatkozó elhelyezési szabályzat.

Name Típus Description
regional

string

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

zonal

string

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

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: Nincs, ReadOnly, ReadWrite. Az alapértelmezett értékek a következők: Standard tároló 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 olvashat bővebben: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

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

Egy 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-as HTTP-állapotkóddal meghiúsul. Ez nem adható meg, ha az IPAddressProvisioningType noPublicIPAddresses.

PoolIdentityType

A Batch-készlet identitása, ha konfigurálva van.

Name Típus Description
None

string

A Batch-készlethez nincs identitás társítva. A None frissítési készlet beállítása eltávolítja a meglévő identitásokat.

UserAssigned

string

A Batch-készlethez felhasználó által hozzárendelt identitások tartoznak.

PoolState

A készlet aktuális állapota.

Name Típus Description
active

string

A készlet a számítási csomópontok rendelkezésre állásától függő feladatok futtatásához érhető el.

deleting

string

A felhasználó kérte a készlet törlését, de a törlési művelet még nem fejeződött be.

PoolStatistics

A készlet élettartamára vonatkozó kihasználtsági és erőforrás-használati statisztikákat tartalmazza.

Name Típus Description
lastUpdateTime

string

A statisztikák utolsó frissítésének időpontja. Minden statisztika a startTime és a lastUpdateTime közötti tartományra korlátozódik.

resourceStats

ResourceStatistics

A készletben található számítási csomópontok erőforrás-felhasználásával kapcsolatos statisztikák.

startTime

string

A statisztikák által lefedett időtartomány kezdő időpontja.

url

string

A statisztika URL-címe.

usageStats

UsageStatistics

A készlethasználattal kapcsolatos statisztikák, például a felhasznált magidő mennyisége.

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ímre van szüksége. 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.

ResizeError

Hiba történt egy készlet átméretezésekor.

Name Típus Description
code

string

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

message

string

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

values

NameValuePair[]

A készlet átméretezése hibával kapcsolatos további hibaadatok listája.

ResourceFile

Egy vagy több fájl, amely egy számítási csomópontra tölthető le.

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 az egyiket meg kell adni.

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 rendszer letölti a tárolóban lévő összes fájlt.

fileMode

string

A fájlengedélyezési mód attribútuma 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 erőforráshoz van megadvaFile, amelyet a rendszer letölt egy Windows számítási csomópontra. Ha ez a tulajdonság nincs megadva linuxos számítási csomóponthoz, akkor a rendszer egy alapértelmezett 0770-es értéket alkalmaz a fájlra.

filePath

string

A számítási csomópont azon helye, amelyre a fájlt le szeretné tölteni a tevékenység munkakönyvtárához képest.
Ha a httpUrl tulajdonság meg van adva, a filePath megadása kötelező, és ismerteti 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 megadása nem kötelező, és az a könyvtár, amelyre a fájlokat le szeretné tölteni. Abban az esetben, ha a filePath könyvtárként van használatban, a bemeneti adatokhoz már társított könyvtárstruktúrák teljes mértékben megmaradnak, és hozzá lesznek 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 az egyiket meg kell adni. Ha az URL-cím Azure Blob Storage 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 közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, használjon egy 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ére.

identityReference

ComputeNodeIdentityReference

A storageContainerUrl vagy a httpUrl által megadott Azure Blob Storage eléréséhez használni kívánt 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 a Azure Blob Storage belül.
Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és az egyiket meg kell adni. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Az Ilyen URL-címeket háromféleképpen lehet lekérni az Azure Storage-tárolókhoz: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedé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.

ResourceStatistics

A készlet számítási csomópontjai által történő erőforrás-használattal kapcsolatos statisztikák.

Name Típus Description
avgCPUPercentage

number

A készlet összes számítási csomópontjának átlagos processzorhasználata (csomópontonkénti százalékos arány).

avgDiskGiB

number

A GiB átlagos kihasznált lemezterülete a készlet összes számítási csomópontjában.

avgMemoryGiB

number

A GiB átlagos memóriahasználata a készlet összes számítási csomópontjában.

diskReadGiB

number

A GiB-ben a lemezolvasások teljes mennyisége a készlet összes számítási csomópontjában.

diskReadIOps

integer

A készlet összes számítási csomópontjának lemezolvasási műveleteinek teljes száma.

diskWriteGiB

number

A GiB-ben a lemezírások teljes mennyisége a készlet összes számítási csomópontjában.

diskWriteIOps

integer

A készlet összes számítási csomópontjának lemezírási műveleteinek teljes száma.

lastUpdateTime

string

A statisztikák utolsó frissítésének időpontja. Minden statisztika a startTime és a lastUpdateTime közötti tartományra korlátozódik.

networkReadGiB

number

A GiB-ben a hálózat teljes adatmennyisége beolvasható a készlet összes számítási csomópontjára.

networkWriteGiB

number

A GiB-ben a hálózati írások teljes mennyisége a készlet összes számítási csomópontjára vonatkozóan.

peakDiskGiB

number

A GiB-ben a kihasznált lemezterület csúcsa a készlet összes számítási csomópontjában.

peakMemoryGiB

number

A GiB memóriahasználatának csúcsértéke a készlet összes számítási csomópontjában.

startTime

string

A statisztikák által lefedett időtartomány kezdő időpontja.

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ó a kérelemben használhatja 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.

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.

Name Típus Description
trustedLaunch

string

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épéhez 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ő referenciaazonosítója /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} formában

StartTask

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

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, hívja meg a parancssorban a rendszerhéjat, például a windowsos "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, 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://docs.microsoft.com/en-us/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 alatti összes címtárat (a csomóponton lévő Azure Batch címtárak gyökerét) a rendszer a tárolóba rendeli, a tevékenységkörnyezet összes változója a tárolóba van leképezve, a Feladat parancssor pedig a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban a AZ_BATCH_NODE_ROOT_DIR kívül előállított fájlok nem jelennek meg a gazdalemezen, ami azt jelenti, hogy a Batch-fájl API-k nem fognak tudni hozzáférni ezekhez a fájlokhoz.

environmentSettings

EnvironmentSetting[]

A StartTask környezeti változóinak listája.

maxTaskRetryCount

integer

A tevékenység újrapróbálkozásának maximális száma.
A Batch szolgáltatás újrapróbál egy feladatot, ha a kilépési kódja nem ero. Vegye figyelembe, hogy ez az érték határozza meg az újrapróbálkozások számát. A Batch szolgáltatás egyszer próbálja ki a feladatot, majd megpróbálkozhat ezzel a korláttal. Ha például a maximális újrapróbálkozásszám 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 az újrapróbálkozás maximális száma -1, a Batch szolgáltatás korlátozás nélkül újrapróbálkozott a tevékenységtel, de ez nem ajánlott kezdő tevékenységekhez vagy tevékenységekhez. Az alapértelmezett érték a 0 (nincs újrapróbálkozás).

resourceFiles

ResourceFile[]

Azon fájlok listája, amelyeket a Batch szolgáltatás letölt a számítási csomópontra a parancssor futtatása előtt. 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ének méreté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

Azt, hogy a Batch szolgáltatásnak meg kell-e várnia a StartTask sikeres befejezését (azaz a 0-s kilépési kóddal való kilépést) 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 újrapróbálja a maximális újrapróbálkozások számához (maxTaskRetryCount). Ha a tevékenység az újrapróbálkozások után sem fejeződött be sikeresen, a Batch szolgáltatás nem használhatóként jelöli meg 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, amíg a StartTask befejeződik. Ebben az esetben más feladatok is megkezdhetik 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.

Name Típus Description
premium_lrs

string

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

standard_lrs

string

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

standardssd_lrs

string

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

TaskContainerSettings

A feladat tárolóbeállításai.

Name Típus Description
containerRunOptions

string

További lehetőségek a tároló létrehozása parancshoz.
Ezeket a további beállításokat a "docker create" parancs argumentumaként adja meg a Batch szolgáltatás által szabályozottak mellett.

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 Rendszerkép neve nem tartalmaz címkét, a rendszer alapértelmezés szerint a "latest" címkét használja.

registry

ContainerRegistry

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

workingDirectory

ContainerWorkingDirectory

A tároló Feladat 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

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

vTpmEnabled

boolean

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

UsageStatistics

A készlet használati adataival kapcsolatos statisztikák.

Name Típus Description
dedicatedCoreTime

string

A készlet részét képező dedikált számítási csomópontmagok összesített falióra-ideje.

lastUpdateTime

string

A statisztikák utolsó frissítésének időpontja. Minden statisztika a startTime és a lastUpdateTime közötti tartományra korlátozódik.

startTime

string

A statisztikák által lefedett időtartomány kezdő időpontja.

UserAccount

A feladatok Azure Batch számítási csomóponton való 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 a nonAdmin.

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észleten van. Ha nincs megadva, és windowsos készleten, a felhasználó az alapértelmezett beállításokkal jön létre.

UserAssignedIdentity

A felhasználó által hozzárendelt identitás

Name Típus Description
clientId

string

A felhasználó által hozzárendelt identitás ügyfél-azonosítója.

principalId

string

A felhasználó által hozzárendelt identitás egyszerű azonosítója.

resourceId

string

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

UserIdentity

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

Name Típus Description
autoUser

AutoUserSpecification

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; meg kell adnia egyet, de nem mindkettőt.

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; meg kell adnia egyet, de nem mindkettőt.

VirtualMachineConfiguration

A készlet számítási csomópontjainak konfigurációja az Azure Virtual Machines-infrastruktúrán alapul.

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 beállítást, hogy a feladatok tárolókban fussanak. A készleten futtatott összes normál Tevékenység és Feladatkezelő feladatnak meg kell adnia a containerSettings tulajdonságot, és az összes többi tevékenység is megadható.

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 eltávolítja a számítási csomópontot a készletből, a lemez és a hozzá társított összes adat is törlődik. A lemez nincs formázva a csatolás után, használat előtt formázni kell – további információt a és https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machinea című témakörben találhttps://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux.

diskEncryptionConfiguration

DiskEncryptionConfiguration

A készlet lemeztitkosítási konfigurációja.
Ha meg van adva, a rendszer a készlet minden csomópontján elvégzi a titkosítást 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ópontra települnek.

imageReference

ImageReference

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

licenseType

string

Az operációs rendszer üzembe helyezésekor használandó helyszíni licenc típusa.
Ez csak a Windows operációs rendszert tartalmazó lemezképekre vonatkozik, és csak akkor használható, ha érvényes helyszíni licencekkel rendelkezik az üzembe helyezendő 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 a Windows-ügyfélhez tartozik.

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öke egy olyan program, amely a készlet minden számítási csomópontján fut, és biztosítja a parancs- és vezérlési 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ásicsomópont-ügynök termékváltozatát, amely megfelel a kiválasztott rendszerkép-hivatkozásnak. A támogatott számításicsomópont-ügynök termékváltozatainak és az ellenőrzött rendszerkép-hivatkozá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ázása" műveletet.

nodePlacementConfiguration

NodePlacementConfiguration

A készlet csomópontelhelyezési konfigurációja.
Ez a konfiguráció szabja 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épéhez 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} formában

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-rendszerképet ad meg.

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 a platformnak automatikusan frissítenie kell-e, ha elérhető a bővítmény újabb verziója.

name

string

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

protectedSettings

object

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

provisionAfterExtensions

string[]

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

publisher

string

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

settings

object

JSON formátumú nyilvános beállítások a bővítményhez.

type

string

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

typeHandlerVersion

string

A szkriptkezelő verziója.

WindowsConfiguration

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

Name Típus Description
enableAutomaticUpdates

boolean

Azt jelzi, hogy az automatikus frissítések engedélyezve vannak-e 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
A VirtualMachineConfiguration-készletek alapértelmezett értéke "batch", a CloudServiceConfiguration-készletek esetében pedig "interaktív".