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


Job - Add

Feladat hozzáadása a megadott fiókhoz.
A Batch szolgáltatás két módszert támogat a feladat részeként végzett munka szabályozására. Az első megközelítésben a felhasználó egy Feladatkezelői feladatot határoz meg. A Batch szolgáltatás akkor indítja el ezt a feladatot, ha készen áll a feladat elindítására. A Feladatkezelő tevékenység a Feladat API-k használatával vezérli a feladat alatt futó összes többi tevékenységet. A második megközelítésben a felhasználó közvetlenül szabályozza a feladatok végrehajtását egy aktív feladat alatt a Tevékenység API-k használatával. Vegye figyelembe azt is, hogy a feladatok elnevezésekor kerülje a bizalmas adatok, például a felhasználónevek vagy a titkos projektnevek beiktatását. Ezek az információk megjelenhetnek a Microsoft támogatási szakemberei számára elérhető telemetriai naplókban.

POST {batchUrl}/jobs?api-version=2024-07-01.20.0
POST {batchUrl}/jobs?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.

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.

Kérelem törzse

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

Name Kötelező Típus Description
id True

string

Egy sztring, amely egyedileg azonosítja a feladatot a fiókon belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges 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 érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy fiókon belül, amelyek csak esetenként különböznek).

poolInfo True

PoolInformation

Az a készlet, amelyen a Batch szolgáltatás futtatja a feladat feladatait.

allowTaskPreemption

boolean

Azt jelzi, hogy az ebben a feladatban lévő tevékenységeket más magas prioritású feladatok elő tudják-e előtagként kezelni.
Ha az érték True (Igaz) értékre van állítva, a rendszernek küldött egyéb magas prioritású feladatok elsőbbséget élveznek, és újra le tudják majd állítani a feladat tevékenységeit. A feladat allowTaskPreemption funkcióját a frissítési feladat API-val való létrehozása után frissítheti.

commonEnvironmentSettings

EnvironmentSetting[]

A környezeti változók gyakori beállításainak listája. Ezek a környezeti változók a feladat összes tevékenységéhez (beleértve a feladatkezelőt, a feladat-előkészítést és a feladatkiadási tevékenységeket) vannak beállítva.
Az egyes feladatok felülbírálhatják az itt megadott környezeti beállításokat ugyanazzal a beállításnévvel, egy másik értékkel.

constraints

JobConstraints

A feladatok végrehajtási korlátozásai.
A feladat végrehajtási korlátozásai.

displayName

string

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

jobManagerTask

JobManagerTask

A feladat indításakor elindítandó Feladatkezelői tevékenység részletei.
Ha a feladat nem ad meg feladatkezelői feladatot, a felhasználónak explicit módon fel kell vennie a feladatba a tevékenységeket. Ha a Feladat nem ad meg feladatkezelői tevékenységet, a Batch szolgáltatás a feladat létrehozásakor létrehozza a Feladatkezelő tevékenységet, és a feladat többi tevékenységének ütemezése előtt megpróbálja ütemezni a Feladatkezelő tevékenységet. A Feladatkezelői tevékenység jellemző célja a feladatok végrehajtásának szabályozása és/vagy monitorozása, például a további futtatandó tevékenységek eldöntésével, a munka befejezésének megállapításával stb. (A Feladatkezelői tevékenység azonban nem korlátozódik ezekre a tevékenységekre – teljes értékű feladat a rendszerben, és bármilyen műveletet végrehajt a feladathoz.) Egy Feladatkezelői feladat például letölthet egy paraméterként megadott fájlt, elemezheti a fájl tartalmát, és további feladatokat küldhet be ezek alapján.

jobPreparationTask

JobPreparationTask

A feladat-előkészítési feladat.
Ha egy feladathoz feladat-előkészítési tevékenység tartozik, a Batch szolgáltatás futtatja a feladat-előkészítési feladatot egy csomóponton, mielőtt az adott számítási csomóponton elkezdené a feladat tevékenységeit.

jobReleaseTask

JobReleaseTask

A feladat kiadási feladata.
Feladat-kiadási tevékenység nem adható meg anélkül, hogy a feladathoz feladatelőkészítési feladatot is meg kellene adnia. A Batch szolgáltatás a feladat-előkészítési feladatot futtató csomópontokon futtatja a feladat-kiadási feladatot. A feladatkiadási tevékenység elsődleges célja a feladat-előkészítési tevékenység által végrehajtott számítási csomópontok módosításainak visszavonása. A példatevékenységek közé tartozik a helyi fájlok törlése vagy a feladat-előkészítés részeként elindított szolgáltatások leállítása.

maxParallelTasks

integer

A feladathoz párhuzamosan végrehajtható tevékenységek maximális száma.
A maxParallelTasks értékének -1 vagy 0-nál nagyobbnak kell lennie, ha meg van adva. Ha nincs megadva, az alapértelmezett érték -1, ami azt jelenti, hogy nincs korlátozva az egyszerre futtatható tevékenységek száma. A feladat maxParallelTasks értékeit a feladat frissítési feladat API-val való létrehozása után frissítheti.

metadata

MetadataItem[]

A feladathoz metaadatként társított név-érték párok listája.
A Batch szolgáltatás nem rendel semmilyen jelentést a metaadatokhoz; kizárólag a felhasználói kód használatára szolgál.

networkConfiguration

JobNetworkConfiguration

A feladat hálózati konfigurációja.

onAllTasksComplete

OnAllTasksComplete

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat összes feladata befejeződött állapotban van.
Vegye figyelembe, hogy ha egy feladat nem tartalmaz tevékenységeket, akkor a rendszer az összes tevékenységet befejezettnek tekinti. Ezt a lehetőséget ezért leggyakrabban a Job Manager-tevékenységhez használják; Ha automatikus feladatleállást szeretne használni Feladatkezelő nélkül, először állítsa aAllTasksComplete parancsot noaction értékre, és frissítse a feladattulajdonságokat úgy, hogy azAllTasksComplete-en állítsa be a feladat befejezését, miután befejezte a tevékenységek hozzáadását. Az alapértelmezett beállítás a noaction.

onTaskFailure

OnTaskFailure

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat egyik feladata meghiúsul.
A feladat meghiúsultnak minősül, ha azInfo hibával rendelkezik. A failureInfo akkor van beállítva, ha a tevékenység nem nulla kilépési kóddal fejeződik be az újrapróbálkozások számának kimerítése után, vagy ha hiba történt a feladat indításakor, például egy erőforrásfájl letöltési hibája miatt. Az alapértelmezett beállítás a noaction.

priority

integer

A feladat prioritása.
A prioritási értékek -1000 és 1000 között mozoghatnak, mivel -1000 a legalacsonyabb prioritás, 1000 pedig a legmagasabb prioritás. Az alapértelmezett érték 0.

usesTaskDependencies

boolean

Azt jelzi, hogy a feladat tevékenységei definiálhatnak-e egymástól függőségeket. Az alapértelmezett érték hamis.

Válaszok

Name Típus Description
201 Created

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

Add a basic job
Add a complex job

Add a basic job

Mintakérelem

POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0



{
  "id": "jobId",
  "priority": 0,
  "poolInfo": {
    "poolId": "poolId"
  }
}

Mintaválasz

Add a complex job

Mintakérelem

POST account.region.batch.azure.com/jobs?api-version=2024-07-01.20.0



{
  "id": "jobId",
  "priority": 100,
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": -1
  },
  "jobManagerTask": {
    "id": "taskId",
    "commandLine": "myprogram.exe",
    "resourceFiles": [
      {
        "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
        "filePath": "myprogram.exe"
      },
      {
        "storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
        "filePath": "datafolder"
      }
    ],
    "environmentSettings": [
      {
        "name": "myvariable",
        "value": "myvalue"
      }
    ],
    "constraints": {
      "maxWallClockTime": "PT1H",
      "maxTaskRetryCount": 0,
      "retentionTime": "PT1H"
    },
    "requiredSlots": 2,
    "killJobOnCompletion": false,
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "admin"
      }
    },
    "runExclusive": true
  },
  "poolInfo": {
    "autoPoolSpecification": {
      "autoPoolIdPrefix": "mypool",
      "poolLifetimeOption": "job",
      "pool": {
        "vmSize": "STANDARD_D2S_V3",
        "virtualMachineConfiguration": {
          "imageReference": {
            "publisher": "MicrosoftWindowsServer",
            "offer": "WindowsServer",
            "sku": "2016-datacenter-smalldisk",
            "version": "latest"
          },
          "nodeAgentSKUId": "batch.node.windows amd64",
          "windowsConfiguration": {
            "enableAutomaticUpdates": false
          },
          "nodePlacementConfiguration": {
            "policy": "zonal"
          }
        },
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 3,
        "targetLowPriorityNodes": 0,
        "taskSlotsPerNode": 2,
        "taskSchedulingPolicy": {
          "nodeFillType": "spread"
        },
        "enableAutoScale": false,
        "enableInterNodeCommunication": true,
        "startTask": {
          "commandLine": "myprogram2.exe",
          "resourceFiles": [
            {
              "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
              "filePath": "myprogram2.exe"
            }
          ],
          "environmentSettings": [
            {
              "name": "myvariable",
              "value": "myvalue"
            }
          ],
          "userIdentity": {
            "autoUser": {
              "scope": "task",
              "elevationLevel": "admin"
            }
          },
          "maxTaskRetryCount": 2,
          "waitForSuccess": true
        },
        "certificateReferences": [
          {
            "thumbprint": "0123456789abcdef0123456789abcdef01234567",
            "thumbprintAlgorithm": "sha1",
            "storeLocation": "localmachine",
            "storeName": "Root",
            "visibility": [
              "task"
            ]
          }
        ],
        "metadata": [
          {
            "name": "myproperty",
            "value": "myvalue"
          }
        ],
        "targetNodeCommunicationMode": "default"
      }
    }
  },
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Mintaválasz

Definíciók

Name Description
AccessScope

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.

ApplicationPackageReference

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

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat.

AutomaticOSUpgradePolicy

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

AutoPoolSpecification

Egy ideiglenes "automatikus készlet" jellemzőit határozza meg. A Batch szolgáltatás a feladat elküldésekor létrehozza ezt az automatikus készletet.

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.

HttpHeader

EGY HTTP-fejléc név-érték párja

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.

JobAddParameter

Hozzáadandó Azure Batch-feladat.

JobConstraints

A feladatok végrehajtási korlátozásai.

JobManagerTask

A Feladatkezelői tevékenység részleteit adja meg.

JobNetworkConfiguration

A feladat hálózati konfigurációja.

JobPreparationTask

Feladat-előkészítési feladat, amelyet a feladat bármely tevékenysége előtt futtatni kell egy adott számítási csomóponton.

JobReleaseTask

Feladat-kiadási tevékenység, amelyet a feladat befejezésekor kell futtatni minden olyan számítási csomóponton, amelyen a feladat fut.

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.

OnAllTasksComplete

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat összes feladata befejeződött állapotban van.

OnTaskFailure

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat egyik feladata meghiúsul.

OSDisk

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

OutputFile

Az Azure Batch számítási csomópontról egy másik helyre való fájlok feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.

OutputFileBlobContainerDestination

Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolón belül.

OutputFileDestination

Az a cél, amelyre a fájlt fel kell tölteni.

OutputFileUploadCondition

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.

OutputFileUploadOptions

A kimeneti fájlfeltöltési művelet részletei, beleértve a feltöltés végrehajtásához szükséges feltételeket is.

PoolEndpointConfiguration

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

PoolInformation

Meghatározza, hogyan kell hozzárendelni egy feladatot egy készlethez.

PoolLifetimeOption

A létrehozott automatikus készletek minimális élettartama, valamint az ütemezésben szereplő több feladat hozzárendelése a készletekhez.

PoolSpecification

Új készlet létrehozásának specifikációja.

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.

TaskConstraints

A tevékenységre alkalmazandó végrehajtási korlátozások.

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.

AccessScope

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.

Name Típus Description
job

string

Hozzáférést biztosít a feladatot tartalmazó feladat összes műveletének végrehajtásához.

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.

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat.

Name Típus Description
access

AccessScope[]

Azok a Batch-erőforrások, amelyekhez a jogkivonat hozzáférést biztosít.
A hitelesítési jogkivonat korlátozott Számú Batch-szolgáltatásművelethez biztosít hozzáférést. Jelenleg a hozzáférési tulajdonság egyetlen támogatott értéke a "feladat", amely hozzáférést biztosít a feladatot tartalmazó feladathoz kapcsolódó összes művelethez.

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.

AutoPoolSpecification

Egy ideiglenes "automatikus készlet" jellemzőit határozza meg. A Batch szolgáltatás a feladat elküldésekor létrehozza ezt az automatikus készletet.

Name Típus Description
autoPoolIdPrefix

string

A készlet automatikus létrehozásakor hozzáadandó előtag az egyedi azonosítóhoz.
A Batch szolgáltatás minden automatikus készlethez egyedi azonosítót rendel a létrehozáskor. A különböző célokra létrehozott készletek megkülönböztetéséhez megadhatja ezt az elemet, hogy hozzáadjon egy előtagot a hozzárendelt azonosítóhoz. Az előtag legfeljebb 20 karakter hosszú lehet.

keepAlive

boolean

Azt határozza meg, hogy az automatikus készlet életben maradjon-e az élettartam lejárta után.
Ha hamis, a Batch szolgáltatás törli a készletet, miután az élettartama (a poolLifetimeOption beállítás alapján) lejár; vagyis amikor a feladat vagy a feladatütemezés befejeződik. Ha igaz, a Batch szolgáltatás nem törli automatikusan a készletet. A felhasználónak kell törölnie az ezzel a beállítással létrehozott automatikus készleteket.

pool

PoolSpecification

Az automatikus készlet készlet-specifikációja.

poolLifetimeOption

PoolLifetimeOption

A létrehozott automatikus készletek minimális élettartama, valamint az ütemezésben szereplő több feladat hozzárendelése a készletekhez.

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

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.

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

Name Típus Description
currentuser

string

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

localmachine

string

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.

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

string

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.

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óponthoz lesznek rendelve.

spread

string

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.

Name Típus Description
Applications

string

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

JobPrep

string

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

Shared

string

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

Startup

string

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

Task

string

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

VfsMounts

string

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.

Name Típus Description
criCompatible

string

A tárolók elindí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ó tevékenység 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 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

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

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

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

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

HttpHeader

EGY HTTP-fejléc név-érték párja

Name Típus Description
name

string

A kimeneti fájlok feltöltése során használandó fejléc kis- és nagybetűs neve

value

string

A kimeneti fájlok feltöltése során használandó fejléc értéke

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.

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

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

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.

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

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

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 használva.

JobAddParameter

Hozzáadandó Azure Batch-feladat.

Name Típus Alapértelmezett érték Description
allowTaskPreemption

boolean

Azt jelzi, hogy az ebben a feladatban lévő tevékenységeket más magas prioritású feladatok elő tudják-e előtagként kezelni.
Ha az érték True (Igaz) értékre van állítva, a rendszernek küldött egyéb magas prioritású feladatok elsőbbséget élveznek, és újra le tudják majd állítani a feladat tevékenységeit. A feladat allowTaskPreemption funkcióját a frissítési feladat API-val való létrehozása után frissítheti.

commonEnvironmentSettings

EnvironmentSetting[]

A környezeti változók gyakori beállításainak listája. Ezek a környezeti változók a feladat összes tevékenységéhez (beleértve a feladatkezelőt, a feladat-előkészítést és a feladatkiadási tevékenységeket) vannak beállítva.
Az egyes feladatok felülbírálhatják az itt megadott környezeti beállításokat ugyanazzal a beállításnévvel, egy másik értékkel.

constraints

JobConstraints

A feladatok végrehajtási korlátozásai.
A feladat végrehajtási korlátozásai.

displayName

string

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

id

string

Egy sztring, amely egyedileg azonosítja a feladatot a fiókon belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges 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 érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy fiókon belül, amelyek csak esetenként különböznek).

jobManagerTask

JobManagerTask

A feladat indításakor elindítandó Feladatkezelői tevékenység részletei.
Ha a feladat nem ad meg feladatkezelői feladatot, a felhasználónak explicit módon fel kell vennie a feladatba a tevékenységeket. Ha a Feladat nem ad meg feladatkezelői tevékenységet, a Batch szolgáltatás a feladat létrehozásakor létrehozza a Feladatkezelő tevékenységet, és a feladat többi tevékenységének ütemezése előtt megpróbálja ütemezni a Feladatkezelő tevékenységet. A Feladatkezelői tevékenység jellemző célja a feladatok végrehajtásának szabályozása és/vagy monitorozása, például a további futtatandó tevékenységek eldöntésével, a munka befejezésének megállapításával stb. (A Feladatkezelői tevékenység azonban nem korlátozódik ezekre a tevékenységekre – teljes értékű feladat a rendszerben, és bármilyen műveletet végrehajt a feladathoz.) Egy Feladatkezelői feladat például letölthet egy paraméterként megadott fájlt, elemezheti a fájl tartalmát, és további feladatokat küldhet be ezek alapján.

jobPreparationTask

JobPreparationTask

A feladat-előkészítési feladat.
Ha egy feladathoz feladat-előkészítési tevékenység tartozik, a Batch szolgáltatás futtatja a feladat-előkészítési feladatot egy csomóponton, mielőtt az adott számítási csomóponton elkezdené a feladat tevékenységeit.

jobReleaseTask

JobReleaseTask

A feladat kiadási feladata.
Feladat-kiadási tevékenység nem adható meg anélkül, hogy a feladathoz feladatelőkészítési feladatot is meg kellene adnia. A Batch szolgáltatás a feladat-előkészítési feladatot futtató csomópontokon futtatja a feladat-kiadási feladatot. A feladatkiadási tevékenység elsődleges célja a feladat-előkészítési tevékenység által végrehajtott számítási csomópontok módosításainak visszavonása. A példatevékenységek közé tartozik a helyi fájlok törlése vagy a feladat-előkészítés részeként elindított szolgáltatások leállítása.

maxParallelTasks

integer

-1

A feladathoz párhuzamosan végrehajtható tevékenységek maximális száma.
A maxParallelTasks értékének -1 vagy 0-nál nagyobbnak kell lennie, ha meg van adva. Ha nincs megadva, az alapértelmezett érték -1, ami azt jelenti, hogy nincs korlátozva az egyszerre futtatható tevékenységek száma. A feladat maxParallelTasks értékeit a feladat frissítési feladat API-val való létrehozása után frissítheti.

metadata

MetadataItem[]

A feladathoz metaadatként társított név-érték párok listája.
A Batch szolgáltatás nem rendel semmilyen jelentést a metaadatokhoz; kizárólag a felhasználói kód használatára szolgál.

networkConfiguration

JobNetworkConfiguration

A feladat hálózati konfigurációja.

onAllTasksComplete

OnAllTasksComplete

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat összes feladata befejeződött állapotban van.
Vegye figyelembe, hogy ha egy feladat nem tartalmaz tevékenységeket, akkor a rendszer az összes tevékenységet befejezettnek tekinti. Ezt a lehetőséget ezért leggyakrabban a Job Manager-tevékenységhez használják; Ha automatikus feladatleállást szeretne használni Feladatkezelő nélkül, először állítsa aAllTasksComplete parancsot noaction értékre, és frissítse a feladattulajdonságokat úgy, hogy azAllTasksComplete-en állítsa be a feladat befejezését, miután befejezte a tevékenységek hozzáadását. Az alapértelmezett beállítás a noaction.

onTaskFailure

OnTaskFailure

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat egyik feladata meghiúsul.
A feladat meghiúsultnak minősül, ha azInfo hibával rendelkezik. A failureInfo akkor van beállítva, ha a tevékenység nem nulla kilépési kóddal fejeződik be az újrapróbálkozások számának kimerítése után, vagy ha hiba történt a feladat indításakor, például egy erőforrásfájl letöltési hibája miatt. Az alapértelmezett beállítás a noaction.

poolInfo

PoolInformation

Az a készlet, amelyen a Batch szolgáltatás futtatja a feladat feladatait.

priority

integer

A feladat prioritása.
A prioritási értékek -1000 és 1000 között mozoghatnak, mivel -1000 a legalacsonyabb prioritás, 1000 pedig a legmagasabb prioritás. Az alapértelmezett érték 0.

usesTaskDependencies

boolean

Azt jelzi, hogy a feladat tevékenységei definiálhatnak-e egymástól függőségeket. Az alapértelmezett érték hamis.

JobConstraints

A feladatok végrehajtási korlátozásai.

Name Típus Description
maxTaskRetryCount

integer

Az egyes tevékenységek ú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 az egyes feladatokat, majd újra próbálkozhat a korlátig. Ha például a maximális újrapróbálkozás száma 3, a Batch legfeljebb 4 alkalommal próbál meg egy 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 Feladatokkal. 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 feladatokat. Az alapértelmezett érték 0 (nincs újrapróbálkozás).

maxWallClockTime

string

A feladat futtatásának maximális időtartama a feladat létrehozásának időpontjától számítva.
Ha a feladat nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja azt, és minden olyan feladatot, amely még fut. Ebben az esetben a felmondás oka a MaxWallClockTimeExpiry lesz. Ha ez a tulajdonság nincs megadva, nincs időkorlát a feladat futtatásának időtartamára.

JobManagerTask

A Feladatkezelői tevékenység részleteit adja meg.

Name Típus Description
allowLowPriorityNode

boolean

Azt jelzi, hogy a Feladatkezelői feladat futtatható-e egy kihasználatlan/alacsony prioritású számítási csomóponton.
Az alapértelmezett érték igaz.

applicationPackageReferences

ApplicationPackageReference[]

Azon alkalmazáscsomagok listája, amelyeket a Batch szolgáltatás a parancssor futtatása előtt üzembe helyez a számítási csomóponton.
Az alkalmazáscsomagok egy megosztott könyvtárba vannak letöltve és üzembe helyezve, nem pedig a feladat munkakönyvtárában. Ezért ha egy hivatkozott alkalmazáscsomag már megtalálható a számítási csomóponton, és naprakész, akkor az nem lesz újra letöltve; a számítási csomópont meglévő példánya lesz használatban. Ha egy hivatkozott alkalmazáscsomag nem telepíthető, például azért, mert a csomagot törölték, vagy a letöltés sikertelen volt, a feladat meghiúsul.

authenticationTokenSettings

AuthenticationTokenSettings

Egy hitelesítési jogkivonat beállításai, amelyeket a feladat a Batch szolgáltatásműveletek végrehajtásához használhat.
Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítéséhez használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A tevékenység által a jogkivonat használatával végrehajtható műveletek a beállításoktól függenek. Egy tevékenység például kérhet feladatengedélyeket, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.

commandLine

string

A Feladatkezelői feladat 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).

constraints

TaskConstraints

A Feladatkezelői tevékenységre vonatkozó korlátozások.

containerSettings

TaskContainerSettings

Annak a tárolónak a beállításai, amelyek alatt a Feladatkezelő feladat fut.
Ha a feladatot futtató készlet tárolókonfigurációs készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókonfigurációval, ezt nem szabad beállítani. 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.

displayName

string

A Feladatkezelői feladat megjelenítendő neve.
Nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat.

environmentSettings

EnvironmentSetting[]

A Feladatkezelői feladat környezeti változóbeállításainak listája.

id

string

Egy sztring, amely egyedileg azonosítja a Feladatkezelő feladatát a feladaton belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat.

killJobOnCompletion

boolean

Azt jelzi, hogy a Feladatkezelői tevékenység befejezése a teljes feladat befejezését jelzi-e.
Ha igaz, a Feladatkezelői tevékenység befejeződésekor a Batch szolgáltatás befejezettként jelöli meg a feladatot. Ha egy tevékenység jelenleg is fut (a feladat kiadásán kívül), a feladatok leállnak. Ha hamis, a Feladatkezelői tevékenység befejezése nem befolyásolja a Feladat állapotát. Ebben az esetben vagy az onAllTasksComplete attribútumot kell használnia a feladat leállításához, vagy egy ügyfélnek vagy felhasználónak kifejezetten le kell mondania a feladatot. Ilyen például, ha a Feladatkezelő létrehoz egy feladatkészletet, de a végrehajtásban nem vállal további szerepet. Az alapértelmezett érték igaz. Ha az onAllTasksComplete és az onTaskFailure attribútumokat használja a feladat élettartamának szabályozásához, és a Feladatkezelő feladattal csak a feladathoz tartozó tevékenységeket hozza létre (a folyamat figyeléséhez nem), akkor fontos, hogy a killJobOnCompletion értéke hamis legyen.

outputFiles

OutputFile[]

Azon fájlok listája, amelyeket a Batch szolgáltatás feltölt a számítási csomópontról a parancssor futtatása után.
Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.

requiredSlots

integer

Azon ütemezési pontok száma, amelyeket a tevékenységnek futtatnia kell.
Az alapértelmezett érték 1. A tevékenységek csak akkor ütemezhetők számítási csomóponton való futtatásra, ha a csomópont elegendő szabad ütemezési pont áll rendelkezésre. Többpéldányos feladatok esetén ez a tulajdonság nem támogatott, és nem adható meg.

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 elem alatt felsorolt fájlok a tevékenység munkakönyvtárában találhatók. 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.

runExclusive

boolean

Azt jelzi, hogy a Feladatkezelő tevékenységhez a számítási csomópont kizárólagos használata szükséges-e, ahol fut.
Ha igaz, egyetlen más tevékenység sem fut ugyanazon a csomóponton mindaddig, amíg a Feladatkezelő fut. Ha hamis, a számítási csomóponton a Feladatkezelővel egyidejűleg más feladatok is futtathatók. A Feladatkezelő tevékenység általában a számítási csomópont egyidejű tevékenységkorlátjával számol, ezért ez csak akkor releváns, ha a számítási csomópont több egyidejű tevékenységet engedélyez. Az alapértelmezett érték igaz.

userIdentity

UserIdentity

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

JobNetworkConfiguration

A feladat hálózati konfigurációja.

Name Típus Description
skipWithdrawFromVNet

boolean

A számítási csomópontok kivonása a virtuális hálózatról a DNC-be a feladat leállítása vagy törlésekor.
Ha igaz, a csomópontok továbbra is csatlakoznak a virtuális hálózathoz a DNC-hez. Ha hamis, a csomópontok automatikusan visszavonódnak a feladat befejezésekor. Alapértelmezés szerint hamis.

subnetId

string

Annak a virtuális hálózati alhálózatnak az ARM-erőforrás-azonosítója, amelyhez a feladatból tevékenységeket futtató számítási csomópontok csatlakoznak a tevékenység időtartamára.
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 ahhoz, hogy elférjen azon számítási csomópontok száma, amelyek feladatból futtatják a feladat tevékenységeit. Ez a készlet számítási csomópontjainak számától is megadhatja. A "MicrosoftAzureBatch" szolgáltatásnévnek rendelkeznie kell a klasszikus virtuálisgép-közreműködői Role-Based hozzáférés-vezérlési (RBAC) szerepkörével a megadott virtuális hálózathoz, hogy az Azure Batch szolgáltatás ütemezhesse a feladatokat 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. Ez az űrlap /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/alhálózatok/{alhálózat}. 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 az Azure Batch szolgáltatásból érkező 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-as portot, valamint a 22-s portot Linuxhoz és a 3389-as portot a Windowshoz. A 443-as portnak nyitva kell lennie az Azure Storage felé irányuló kommunikáció kimenő kapcsolataihoz is. További részletekért lásd: https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

Feladat-előkészítési feladat, amelyet a feladat bármely tevékenysége előtt futtatni kell egy adott számítási csomóponton.

Name Típus Description
commandLine

string

A feladat-előkészítési feladat 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).

constraints

TaskConstraints

A feladat-előkészítési tevékenységre vonatkozó korlátozások.

containerSettings

TaskContainerSettings

Annak a tárolónak a beállításai, amelyek alatt a feladat-előkészítési feladat 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 feladat-előkészítési feladat környezeti változóbeállításainak listája.

id

string

A feladaton belüli feladat-előkészítési tevékenységet egyedileg azonosító sztring.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Ha nem adja meg ezt a tulajdonságot, a Batch szolgáltatás a "jobpreparation" alapértelmezett értékét rendeli hozzá. A feladatban egyetlen tevékenység sem rendelkezhet ugyanazzal az azonosítóval, mint a feladat-előkészítési tevékenység. Ha egy azonos azonosítójú feladatot próbál elküldeni, a Batch szolgáltatás a TaskIdSameAsJobPreparationTask hibakóddal elutasítja a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 409 (Ütközés).

rerunOnNodeRebootAfterSuccess

boolean

Azt jelzi, hogy a Batch szolgáltatásnak újra kell-e futtatnia a feladat-előkészítési feladatot a számítási csomópont újraindítása után.
A feladat-előkészítési feladat mindig újrafut, ha egy számítási csomópont újra van építve, vagy ha a feladat-előkészítési tevékenység nem fejeződött be (például azért, mert az újraindítás a tevékenység futtatása közben történt). Ezért mindig meg kell írnia egy feladat-előkészítési feladatot, hogy idempotens legyen, és helyesen viselkedjen, ha többször fut. Az alapértelmezett érték igaz.

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 elem alatt felsorolt fájlok a tevékenység munkakönyvtárában találhatók. 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.

userIdentity

UserIdentity

Az a felhasználói identitás, amely alatt a feladat-előkészítési feladat fut.
Ha nincs megadva, a feladat nem rendszergazdai felhasználóként fut, amely egyedi a Windows számítási csomópontokon lévő feladathoz, vagy egy nem rendszergazda felhasználóként, amely a Linux számítási csomópontokon található készletre jellemző.

waitForSuccess

boolean

Várjon-e a Batch szolgáltatás, amíg a feladat-előkészítési feladat sikeresen befejeződik, mielőtt ütemezni szeretné a feladat egyéb feladatait a számítási csomóponton. A feladat-előkészítési feladat sikeresen befejeződött, ha a 0-s kilépési kóddal lép ki.
Ha igaz, és a feladat-előkészítési tevékenység meghiúsul egy csomóponton, a Batch szolgáltatás újrapróbálkozásokat végez a feladat-előkészítési tevékenységnél a maximális újrapróbálkozások számának megfelelően (a kényszerelemben megadottak szerint). 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 nem ütemezi a feladat tevékenységeit a csomópontra. A csomópont aktív marad, és jogosult más feladatok feladatainak futtatására. Ha hamis, a Batch szolgáltatás nem várja meg a feladat-előkészítési feladat befejezését. Ebben az esetben a feladat más tevékenységei elkezdhetik a végrehajtást a számítási csomóponton, miközben a feladat-előkészítési tevékenység még fut; és még ha a feladat-előkészítési feladat meghiúsul is, az új tevékenységek továbbra is ütemezve lesznek a számítási csomóponton. Az alapértelmezett érték igaz.

JobReleaseTask

Feladat-kiadási tevékenység, amelyet a feladat befejezésekor kell futtatni minden olyan számítási csomóponton, amelyen a feladat fut.

Name Típus Description
commandLine

string

A feladat kiadási feladatának 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 feladat-kiadási feladat 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 feladatkiadási tevékenység környezeti változóbeállításainak listája.

id

string

Egy sztring, amely egyedileg azonosítja a feladat kiadási feladatát a feladaton belül.
Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Ha nem adja meg ezt a tulajdonságot, a Batch szolgáltatás a "jobrelease" alapértelmezett értékét rendeli hozzá. A feladat egyik más tevékenységének sem lehet ugyanaz az azonosítója, mint a feladat kiadási tevékenységének. Ha ugyanazzal az azonosítóval próbál elküldeni egy feladatot, a Batch szolgáltatás elutasítja a Kérést a TaskIdSameAsJobReleaseTask hibakóddal; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 409 (Ütközés).

maxWallClockTime

string

Az a maximális eltelt idő, amelyet a feladat kiadási tevékenysége futtathat egy adott számítási csomóponton, a tevékenység indításának időpontjától mérve. Ha a tevékenység nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja. Az alapértelmezett érték 15 perc. 15 percnél hosszabb időtúllépést nem adhat meg. Ha igen, a Batch szolgáltatás egy hibával elutasítja; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kéré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.

retentionTime

string

A számítási csomópont feladatkiadási tevékenység tevékenységkönyvtárának megőrzéséhez szükséges minimális idő. Ezt követően a Batch szolgáltatás törölheti a Tevékenység könyvtárat és annak tartalmát.
Az alapértelmezett érték 7 nap, azaz a feladatkönyvtár 7 napig marad meg, kivéve, ha a számítási csomópont el lett távolítva, vagy a feladat törlődik.

userIdentity

UserIdentity

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

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

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

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

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.

Name Típus Description
allow

string

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

deny

string

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.

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

string

A csomópont-kommunikációs módot 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-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.

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éssel.

OnAllTasksComplete

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat összes feladata befejeződött állapotban van.

Name Típus Description
noaction

string

Nem tehet semmit. A feladat aktív marad, hacsak más módon nem szünteti meg vagy tiltja le.

terminatejob

string

Állítsa le a feladatot. A feladat terminateReason értéke "AllTasksComplete".

OnTaskFailure

A Batch szolgáltatásnak akkor kell végrehajtania a műveletet, ha a feladat egyik feladata meghiúsul.

Name Típus Description
noaction

string

Nem tehet semmit. A feladat aktív marad, hacsak más módon nem szünteti meg vagy tiltja le.

performexitoptionsjobaction

string

A Tevékenység kilépési feltételéhez társított művelet végrehajtása a tevékenység exitConditions gyűjteményében. (Ez továbbra is azt eredményezheti, hogy nem történik művelet, ha a tevékenység ezt határozza meg.)

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

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.

OutputFile

Az Azure Batch számítási csomópontról egy másik helyre való fájlok feltöltésének specifikációja, miután a Batch szolgáltatás befejezte a feladatfolyamat végrehajtását.

Name Típus Description
destination

OutputFileDestination

A kimeneti fájl(ok) célhelye.

filePattern

string

Egy minta, amely jelzi, hogy mely fájl(ok)t kell feltölteni.
A relatív és az abszolút elérési utak is támogatottak. A relatív elérési utak a Tevékenység munkakönyvtárhoz vannak viszonyítva. A következő helyettesítő karakterek támogatottak: * egyezik 0 vagy több karakterrel (például az abc* minta az abc-vel vagy az abcdef-vel egyezik), ** bármilyen könyvtárnak megfelel, ? egyetlen karaktert, a [abc] a zárójelek egyik karakterét, a [a-c] pedig a tartomány egy karakterét. A szögletes zárójelek olyan negációt tartalmazhatnak, amely nem megadott karaktereknek felel meg (például a [!abc] egyezik az a, b vagy c karakterekkel). Ha egy fájlnév "." betűvel kezdődik, alapértelmezés szerint figyelmen kívül hagyja, de explicit megadásával egyeztethető (például .gif nem egyezik .a.gif, de ..gif lesz). Egy egyszerű példa: ***.txt megegyezik minden olyan fájllal, amely nem a "." fájlban kezdődik, és .txt végződik a Feladat munkakönyvtárban vagy bármely alkönyvtárban. Ha a fájlnév helyettesítő karaktert tartalmaz, szögletes zárójelekkel (például az abc[] egyezik az abcnevű fájllal). Vegye figyelembe, hogy a \ és a / is címtárelválasztóként van kezelve a Windowson, de csak a / linuxos. A környezeti változók (windowsos%var% vagy Linuxon $var) a minta alkalmazása előtt ki vannak bontva.

uploadOptions

OutputFileUploadOptions

További lehetőségek a feltöltési művelethez, beleértve a feltöltés végrehajtásának feltételeit is.

OutputFileBlobContainerDestination

Egy Fájlfeltöltési célhelyet határoz meg egy Azure Blob Storage-tárolón belül.

Name Típus Description
containerUrl

string

Annak a tárolónak az URL-címe az Azure Blob Storage-ban, ahová fel szeretné tölteni a fájlt(ok).
Ha nem használ felügyelt identitást, az URL-címnek tartalmaznia kell egy közös hozzáférésű jogosultságkódot (SAS), amely írási engedélyeket ad a tárolónak.

identityReference

ComputeNodeIdentityReference

A containerUrl által megadott Azure Blob Storage eléréséhez használt felhasználó által hozzárendelt identitásra mutató hivatkozás
Az identitásnak írási hozzáféréssel kell rendelkeznie az Azure Blob Storage-tárolóhoz

path

string

A cél blob vagy virtuális könyvtár az Azure Storage-tárolóban.
Ha a filePattern egy adott fájlra hivatkozik (azaz nem tartalmaz helyettesítő karaktereket), akkor az elérési út annak a blobnak a neve, amelybe a fájlt fel szeretné tölteni. Ha a filePattern egy vagy több helyettesítő karaktert tartalmaz (és így több fájlnak is megfelelhet), akkor az elérési út annak a blob virtuális könyvtárnak a neve (amely minden blobnévre elő van állítva), amelyre a fájl(ok) feltölthetők. Ha nincs megadva, a rendszer feltölti a fájl(oka)t a tároló gyökerére a fájlnévnek megfelelő blobnévvel.

uploadHeaders

HttpHeader[]

A kimeneti fájlok feltöltéséhez használandó fejlécek név-érték párjainak listája
Ezek a fejlécek akkor lesznek megadva, amikor fájlokat tölt fel az Azure Storage-ba. Hivatalos dokumentum az engedélyezett fejlécekről blobok feltöltésekor: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Az a cél, amelyre a fájlt fel kell tölteni.

Name Típus Description
container

OutputFileBlobContainerDestination

Egy hely az Azure Blob Storage-ban, ahová a fájlokat feltöltik.

OutputFileUploadCondition

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.

Name Típus Description
taskcompletion

string

Töltse fel a fájlt a feladatfolyamat kilépése után, függetlenül attól, hogy mi volt a kilépési kód.

taskfailure

string

A fájl(ok) feltöltése csak akkor történik meg, ha a tevékenységfolyamat kilép egy nemzero kilépési kóddal.

tasksuccess

string

A fájl(ok) feltöltése csak a feladatfolyamat 0-s kilépési kóddal való kilépése után történik.

OutputFileUploadOptions

A kimeneti fájlfeltöltési művelet részletei, beleértve a feltöltés végrehajtásához szükséges feltételeket is.

Name Típus Description
uploadCondition

OutputFileUploadCondition

A feladat kimeneti fájljának vagy fájlkészletének feltöltésének feltételei.
Az alapértelmezett feladatkiegészítés.

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.

PoolInformation

Meghatározza, hogyan kell hozzárendelni egy feladatot egy készlethez.

Name Típus Description
autoPoolSpecification

AutoPoolSpecification

Az ideiglenes "automatikus készlet" jellemzői. A Batch szolgáltatás a feladat elküldésekor létrehozza ezt az automatikus készletet.
Ha az automatikus készletlétrehozás sikertelen, a Batch szolgáltatás befejezett állapotba helyezi a feladatot, és a készletlétrehozás hibája a feladat ütemezési hibatulajdonságában van beállítva. A Batch szolgáltatás kezeli az automatikus készlet élettartamát (mind a létrehozás, mind a keepAlive megadása esetén a törlést). Minden olyan felhasználói művelet, amely befolyásolja az automatikus készlet élettartamát, amíg a feladat aktív, váratlan viselkedést eredményez. Meg kell adnia a készlet azonosítóját vagy az automatikus készlet specifikációját, de mindkettőt nem.

poolId

string

Egy meglévő készlet azonosítója. A feladat összes feladata a megadott készleten fog futni.
Győződjön meg arról, hogy a tulajdonság által hivatkozott készlet létezik. Ha a készlet nem létezik abban az időpontban, amikor a Batch szolgáltatás megpróbál feladatokat ütemezni, a feladathoz tartozó feladatok nem futnak, amíg létre nem hoz egy készletet ezzel az azonosítóval. Vegye figyelembe, hogy a Batch szolgáltatás nem utasítja el a feladatkérést; egyszerűen nem futtatja a feladatokat, amíg a készlet nem létezik. Meg kell adnia a készlet azonosítóját vagy az automatikus készlet specifikációját, de mindkettőt nem.

PoolLifetimeOption

A létrehozott automatikus készletek minimális élettartama, valamint az ütemezésben szereplő több feladat hozzárendelése a készletekhez.

Name Típus Description
job

string

A készlet annak a feladatnak az élettartama alatt létezik, amelyhez dedikált. A Batch szolgáltatás a feladat létrehozásakor létrehozza a készletet. Ha a "feladat" beállítás egy feladatütemezésre van alkalmazva, a Batch szolgáltatás új automatikus készletet hoz létre az ütemezésben létrehozott összes feladathoz.

jobschedule

string

A készlet a feladatütemezés teljes élettartama alatt létezik. A Batch szolgáltatás akkor hozza létre a készletet, amikor létrehozza az ütemezés első feladatát. Ezt a beállítást csak a feladatütemezésekre alkalmazhatja, a Feladatokra nem.

PoolSpecification

Új készlet létrehozásának specifikációja.

Name Típus Description
applicationPackageReferences

ApplicationPackageReference[]

A készlet egyes számítási csomópontjaira telepíteni kívánt csomagok listá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}). 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. Egy adott készleten legfeljebb 10 csomaghivatkozás található.

autoScaleEvaluationInterval

string

Az az időintervallum, amellyel automatikusan módosíthatja a készlet méretét az automatikus skálázási képletnek megfelelően.
Az alapértelmezett érték 15 perc. A minimális és a maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás érvénytelen tulajdonságérték-hibával utasítja el a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).

autoScaleFormula

string

A készletben lévő számítási csomópontok kívánt számának képlete.
Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke hamis. Ez akkor szükséges, ha az enableAutoScale értéke igaz. A rendszer a készlet létrehozása előtt ellenőrzi a képlet érvényességét. Ha a képlet érvénytelen, a Batch szolgáltatás elutasítja a kérelmet részletes hibainformációkkal.

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

enableAutoScale

boolean

Azt határozza meg, hogy a készlet méretének idővel automatikusan kell-e módosulnia.
Ha hamis, meg kell adni legalább egy targetDedicatedNodes és targetLowPriorityNodes értéket. Ha igaz, az automatikusScaleFormula elemre van szükség. A készlet a képletnek megfelelően automatikusan átméreteződik. Az alapértelmezett érték hamis.

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.

metadata

MetadataItem[]

A készlethez metaadatként társított név-érték párok listája.
A Batch szolgáltatás nem rendel semmilyen jelentést a metaadatokhoz; kizárólag a felhasználói kód használatára szolgál.

mountConfiguration

MountConfiguration[]

A készlet minden csomópontjára csatlakoztatni kívánt fájlrendszerek listája.
Ez támogatja az Azure Filest, az NFS-t, a CIFS-t/SMB-t és a Blobfuse-t.

networkConfiguration

NetworkConfiguration

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

resizeTimeout

string

A számítási csomópontok készlethez való lefoglalásának időtúllépése.
Ez az időtúllépés csak a manuális skálázásra vonatkozik; nincs hatása, ha az enableAutoScale értéke igaz. Az alapértelmezett érték 15 perc. A minimális érték 5 perc. Ha 5 percnél rövidebb értéket ad meg, a Batch szolgáltatás hibaüzenettel utasítja el a kérést; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).

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.

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.
A Batch újrapróbálkozza a feladatokat, ha 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 megfelelő 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 maxTaskRetryCount értékétől, és nem számítanak bele. Még ha a maxTaskRetryCount száma 0 is, belső újrapróbálkozhat egy helyreállítási művelet miatt. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a tevékenységeknek el kell viselnie 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 ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata. Bizonyos esetekben előfordulhat, hogy a StartTask újrafut, még akkor is, ha a számítási csomópont nem lett újraindítva. Különös figyelmet kell fordítva arra, hogy elkerülje azokat a StartTaskokat, 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 futtathassa a StartTaskot.

targetDedicatedNodes

integer

A készletben található dedikált számítási csomópontok kívánt száma.
Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke igaz. Ha az enableAutoScale értéke hamis, akkor a targetDedicatedNodes, a targetLowPriorityNodes vagy mindkettőt be kell állítania.

targetLowPriorityNodes

integer

A készletben található kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma.
Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke igaz. Ha az enableAutoScale értéke hamis, akkor a targetDedicatedNodes, a targetLowPriorityNodes vagy mindkettőt be kell állítania.

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 érték.

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

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.

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.

userAccounts

UserAccount[]

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

virtualMachineConfiguration

VirtualMachineConfiguration

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

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

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

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

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

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

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.

Name Típus Description
NonPersistedTPM

string

VMGuestStateOnly

string

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.

Name Típus Description
confidentialVM

string

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

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é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

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.

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ót kell használnia.

standardssd_lrs

string

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

TaskConstraints

A tevékenységre alkalmazandó végrehajtási korlátozások.

Name Típus Description
maxTaskRetryCount

integer

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 szabályozza a nem kilépési kód miatt végrehajtható feladat újrapróbálkozásának számát. 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 a maximális újrapróbálkozási szám 0, a Batch szolgáltatás az első kísérlet után nem próbálja újra a feladatot. 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).

maxWallClockTime

string

A tevékenység futásának maximális időtartama a tevékenység indításának időpontjától mérve. Ha a tevékenység nem fejeződik be az időkorláton belül, a Batch szolgáltatás leállítja.
Ha ez nincs megadva, nincs időkorlát arra vonatkozóan, hogy a tevékenység mennyi ideig futhat.

retentionTime

string

A tevékenységkönyvtár azon a számítási csomóponton való megőrzésének minimális ideje, amely a végrehajtás befejezésétől kezdve fut. Ezt követően a Batch szolgáltatás törölheti a Tevékenység könyvtárat és annak tartalmát.
Az alapértelmezett érték 7 nap, azaz a feladatkönyvtár 7 napig marad meg, kivéve, ha a számítási csomópont el lett távolítva, vagy a feladat törlődik.

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.

Name Típus Description
automatic

string

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

manual

string

Ö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

string

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