Microsoft.Batch batchAccounts/pools 2020-09-01
Bicep-erőforrásdefiníció
A batchAccounts/készletek erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következőkre irányulnak:
- Erőforráscsoportok – Lásd erőforráscsoport üzembe helyezési parancsaival
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.
Erőforrás formátuma
Microsoft.Batch/batchAccounts/pool erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.
resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2020-09-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
applicationLicenses: [
'string'
]
applicationPackages: [
{
id: 'string'
version: 'string'
}
]
certificates: [
{
id: 'string'
storeLocation: 'string'
storeName: 'string'
visibility: [
'string'
]
}
]
deploymentConfiguration: {
cloudServiceConfiguration: {
osFamily: 'string'
osVersion: 'string'
}
virtualMachineConfiguration: {
containerConfiguration: {
containerImageNames: [
'string'
]
containerRegistries: [
{
password: 'string'
registryServer: 'string'
username: 'string'
}
]
type: 'DockerCompatible'
}
dataDisks: [
{
caching: 'string'
diskSizeGB: int
lun: int
storageAccountType: 'string'
}
]
diskEncryptionConfiguration: {
targets: [
'string'
]
}
imageReference: {
id: 'string'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
}
licenseType: 'string'
nodeAgentSkuId: 'string'
windowsConfiguration: {
enableAutomaticUpdates: bool
}
}
}
displayName: 'string'
interNodeCommunication: 'string'
metadata: [
{
name: 'string'
value: 'string'
}
]
mountConfiguration: [
{
azureBlobFileSystemConfiguration: {
accountKey: 'string'
accountName: 'string'
blobfuseOptions: 'string'
containerName: 'string'
relativeMountPath: 'string'
sasKey: 'string'
}
azureFileShareConfiguration: {
accountKey: 'string'
accountName: 'string'
azureFileUrl: 'string'
mountOptions: 'string'
relativeMountPath: 'string'
}
cifsMountConfiguration: {
mountOptions: 'string'
password: 'string'
relativeMountPath: 'string'
source: 'string'
username: 'string'
}
nfsMountConfiguration: {
mountOptions: 'string'
relativeMountPath: 'string'
source: 'string'
}
}
]
networkConfiguration: {
endpointConfiguration: {
inboundNatPools: [
{
backendPort: int
frontendPortRangeEnd: int
frontendPortRangeStart: int
name: 'string'
networkSecurityGroupRules: [
{
access: 'string'
priority: int
sourceAddressPrefix: 'string'
sourcePortRanges: [
'string'
]
}
]
protocol: 'string'
}
]
}
publicIPAddressConfiguration: {
ipAddressIds: [
'string'
]
provision: 'string'
}
subnetId: 'string'
}
scaleSettings: {
autoScale: {
evaluationInterval: 'string'
formula: 'string'
}
fixedScale: {
nodeDeallocationOption: 'string'
resizeTimeout: 'string'
targetDedicatedNodes: int
targetLowPriorityNodes: int
}
}
startTask: {
commandLine: 'string'
containerSettings: {
containerRunOptions: 'string'
imageName: 'string'
registry: {
password: 'string'
registryServer: 'string'
username: 'string'
}
workingDirectory: 'string'
}
environmentSettings: [
{
name: 'string'
value: 'string'
}
]
maxTaskRetryCount: int
resourceFiles: [
{
autoStorageContainerName: 'string'
blobPrefix: 'string'
fileMode: 'string'
filePath: 'string'
httpUrl: 'string'
storageContainerUrl: 'string'
}
]
userIdentity: {
autoUser: {
elevationLevel: 'string'
scope: 'string'
}
userName: 'string'
}
waitForSuccess: bool
}
taskSchedulingPolicy: {
nodeFillType: 'string'
}
taskSlotsPerNode: int
userAccounts: [
{
elevationLevel: 'string'
linuxUserConfiguration: {
gid: int
sshPrivateKey: 'string'
uid: int
}
name: 'string'
password: 'string'
windowsUserConfiguration: {
loginMode: 'string'
}
}
]
vmSize: 'string'
}
}
Tulajdonságértékek
batchAccounts/készletek
| Név | Leírás | Érték |
|---|---|---|
| név | Az erőforrás neve Megtudhatja, hogyan állíthat be neveket és típusokat a gyermekerőforrásokhoz Bicep. |
sztring (kötelező) Karakterkorlát: 1-64 Érvényes karakterek: Alfanumerikák, aláhúzásjelek és kötőjelek. |
| szülő | A Bicepben megadhatja a gyermekerőforrás szülőerőforrását. Ezt a tulajdonságot csak akkor kell hozzáadnia, ha a gyermekerőforrás a szülőerőforráson kívül van deklarálva. További információ: szülőerőforráson kívüli gyermekerőforrás. |
A típus erőforrásának szimbolikus neve: batchAccounts |
| kellékek | A készlethez társított tulajdonságok. | PoolProperties |
PoolProperties
| Név | Leírás | Érték |
|---|---|---|
| applicationLicenses | Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek részhalmazának kell lennie. Ha olyan licencre van szükség, amely nem támogatott, a készlet létrehozása sikertelen lesz. | sztring[] |
| applicationPackages | Az alkalmazáscsomag-hivatkozások módosítása hatással van a készlethez csatlakozó összes új számítási csomópontra, de nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítja vagy újra nem alakítja őket. Egy adott készleten legfeljebb 10 alkalmazáscsomag-hivatkozás található. | ApplicationPackageReference[] |
| Tanúsítványok | Windows számítási 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árán belül egy 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. | CertificateReference[] |
| deploymentConfiguration | A CloudServiceConfiguration használatával a csomópontoknak az Azure Cloud Services (PaaS) használatával kell létrejönnie, míg a VirtualMachineConfiguration azure-beli virtuális gépeket (IaaS) használ. | DeploymentConfiguration |
| displayName | A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat. | húr |
| interNodeCommunication | Ez korlátozza, hogy mely csomópontok rendelhetők hozzá a készlethez. Ennek az értéknek az engedélyezése csökkentheti a készletben lefoglalni kívánt csomópontok számát. Ha nincs megadva, ez az érték alapértelmezés szerint "Letiltva" lesz. | "Letiltva" "Engedélyezve" |
| metaadatok | 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. | metadataItem[] |
| mountConfiguration | Ez támogatja az Azure Filest, az NFS-t, a CIFS-t/SMB-t és a Blobfuse-t. | MountConfiguration[] |
| networkConfiguration | A készlet hálózati konfigurációja. | NetworkConfiguration |
| scaleSettings | Meghatározza a készlet kívánt méretét. Ez lehet "rögzített skálázás", ahol meg van adva a kért targetDedicatedNodes, vagy az "automatikus skálázás", amely egy rendszeresen újraértékelt képletet definiál. Ha ez a tulajdonság nincs megadva, a készlet rögzített skálával fog rendelkezni 0 targetDedicatedNodes értékekkel. | ScaleSettings |
| startTask | A PATCH (frissítési) műveletben ez a tulajdonság egy üres objektumra állítható be, hogy eltávolítsa a kezdő feladatot a készletből. | StartTask |
| taskSchedulingPolicy | Ha nincs megadva, az alapértelmezett oldalpár. | TaskSchedulingPolicy |
| taskSlotsPerNode | Az alapértelmezett érték 1. A maximális érték a készlet VmSize-jének 4-szerese, vagy 256. | Int |
| userAccounts | A készlet minden csomópontján létrehozandó felhasználói fiókok listája. | UserAccount[] |
| vmSize | A Cloud Services-készletek (cloudServiceConfiguration használatával létrehozott készletek) virtuális gépeinek elérhető méreteivel kapcsolatos információkért lásd a Cloud Services méreteit (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). A Batch az ExtraSmall kivételével minden Cloud Services virtuálisgép-méretet támogat. A virtuális gépek piacteréről (a virtualMachineConfiguration használatával létrehozott készletekből) származó rendszerképeket használó készletekhez elérhető virtuálisgép-méretekről további információt a Virtuális gépek méretei (Linux) (/azure/virtual-machines/sizes-general) vagy a Virtuális gépek méretei (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) című témakörben talál. A Batch az összes Azure-beli virtuálisgép-méretet támogatja, kivéve STANDARD_A0 és prémium szintű tárterülettel (STANDARD_GS, STANDARD_DS és STANDARD_DSV2 sorozattal). | húr |
ApplicationPackageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A telepíteni kívánt alkalmazáscsomag azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. Ez lehet egy adott verzióra vagy az alapértelmezett verzióra való hivatkozás, ha létezik. | sztring (kötelező) |
| verzió | Ha ez nincs megadva, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés az InvalidApplicationPackageReferences hibakóddal hiúsul meg. Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 409. | húr |
CertificateReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A készletre telepíteni kívánt tanúsítvány teljes azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. | sztring (kötelező) |
| storeLocation | Az alapértelmezett érték a currentUser. Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Linux számítási csomópontok esetén a tanúsítványok a feladat munkakönyvtárán belül egy 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. | "CurrentUser" 'LocalMachine' |
| storeName | Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Az áruházak gyakori nevei a következők: 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. | húr |
| láthatóság | 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. | Sztringtömb, amely a következők bármelyikét tartalmazza: "RemoteUser" "StartTask" "Tevékenység" |
DeploymentConfiguration
| Név | Leírás | Érték |
|---|---|---|
| cloudServiceConfiguration | Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiók a poolAllocationMode tulajdonsággal lett létrehozva, és a "UserSubscription" értékre van állítva. | CloudServiceConfiguration |
| virtualMachineConfiguration | Ez a tulajdonság és a cloudServiceConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Név | Leírás | Érték |
|---|---|---|
| osFamily | Lehetséges értékek: 2 – Os Family 2, egyenértékű a Windows Server 2008 R2 SP1 rendszerrel. 3 – 3. operációsrendszer-család, egyenértékű a Windows Server 2012-zel. 4 – Os Family 4, egyenértékű a Windows Server 2012 R2-zel. 5 – Os Family 5, egyenértékű a Windows Server 2016-dal. 6 – Os Family 6, egyenértékű a Windows Server 2019-zel. További információ: Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | sztring (kötelező) |
| osVersion | Az alapértelmezett érték * , amely a megadott operációsrendszer-család legújabb operációsrendszer-verzióját adja meg. | húr |
VirtualMachineConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerConfiguration | Ha meg van adva, a beállítás a készlet minden csomópontján történik, hogy a tevékenységek tárolókban fussanak. Az ezen 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. | ContainerConfiguration |
| dataDisks | Ezt a tulajdonságot akkor kell megadni, ha a készlet számítási csomópontjaihoz üres adatlemezeket kell csatolni. | DataDisk[] |
| diskEncryptionConfiguration | 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. | DiskEncryptionConfiguration |
| imageReference | Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy egyéni virtuális gép Azure Image-erőforrására. Az Összes imageReferences Azure Batch által ellenőrzött listájának lekéréséhez tekintse meg a "Támogatott csomópontügynök termékváltozatainak listázása" műveletet. | ImageReference (kötelező) |
| licenseType | 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 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. |
húr |
| nodeAgentSkuId | A Batch csomópontügynök egy olyan program, amely a készlet minden csomópontján fut, és biztosítja a parancs- és vezérlési felületet a csomópont és a Batch szolgáltatás között. A csomópontügynöknek, más néven termékváltozatoknak különböző implementációi vannak a különböző operációs rendszerekhez. Meg kell adnia egy csomópontügynök termékváltozatát, amely megfelel a kijelölt képhivatkozásnak. A támogatott 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 csomópontügynök termékváltozatainak listázása" műveletet. | sztring (kötelező) |
| windowsConfiguration | Ezt a tulajdonságot nem szabad megadni, ha az imageReference linuxos operációsrendszer-lemezképet ad meg. | WindowsConfiguration |
ContainerConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerImageNames | Ez a teljes képhivatkozás, ahogyan a "docker pull" kifejezés is meg van adva. A rendszerképek az alapértelmezett Docker-beállításjegyzékből származnak, kivéve, ha a rendszerkép teljes mértékben egy alternatív beállításjegyzékkel van minősítve. | sztring[] |
| containerRegistries | 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. | ContainerRegistry[] |
| típus | A használandó tárolótechnológia. | "DockerCompatible" (kötelező) |
ContainerRegistry
| Név | Leírás | Érték |
|---|---|---|
| jelszó | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó. | sztring (kötelező) |
| registryServer | Ha nincs megadva, az alapértelmezett érték a "docker.io". | húr |
| felhasználónév | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges felhasználónév. | sztring (kötelező) |
DataDisk
| Név | Leírás | Érték |
|---|---|---|
| gyorsítótárazás | Az értékek a következők: none – A lemez gyorsítótárazási módja nincs engedélyezve. readOnly – A lemez gyorsítótárazási módja csak olvasható. readWrite – A lemez gyorsítótárazási módja olvasás és írás. A gyorsítótárazás alapértelmezett értéke nincs. A gyorsítótárazási beállításokkal kapcsolatos információkért lásd: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Nincs" "ReadOnly" "ReadWrite" |
| diskSizeGB | A kezdeti lemezméret GB-ban az új adatlemez létrehozásakor. | int (kötelező) |
| Lun | 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. | int (kötelező) |
| storageAccountType | Ha nincs megadva, az alapértelmezett érték a "Standard_LRS". Az értékek a következők: Standard_LRS – Az adatlemeznek szabványos helyileg redundáns tárolást kell használnia. Premium_LRS – Az adatlemeznek prémium szintű helyileg redundáns tárolást kell használnia. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Célok | Linux-készleten csak a "TemporaryDisk" támogatott; A Windows-készletben meg kell adni az "OsDisk" és az "TemporaryDisk" értéket. | Sztringtömb, amely a következők bármelyikét tartalmazza: "OsDisk" "TemporaryDisk" |
ImageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot. A megosztott képgyűjtemény lemezképének replikáinak ugyanabban a régióban kell lenniük, mint az Azure Batch-fiók. A Batch-csomópont ügynökének a Batch szolgáltatással való kommunikációhoz szükséges tűzfalbeállításaival kapcsolatos információkért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | húr |
| ajánlat | Például: UbuntuServer vagy WindowsServer. | húr |
| kiadó | Például a Canonical vagy a MicrosoftWindowsServer. | húr |
| Sku | Például: 18.04-LTS vagy 2019-Datacenter. | húr |
| verzió | A rendszerkép legújabb verziójának kiválasztásához megadható a "legújabb" érték. Ha nincs megadva, az alapértelmezett érték a "legújabb". | húr |
WindowsConfiguration
| Név | Leírás | Érték |
|---|---|---|
| enableAutomaticUpdates | Ha nincs megadva, az alapértelmezett érték igaz. | Bool |
MetadataItem
| Név | Leírás | Érték |
|---|---|---|
| név | A metaadatelem neve. | sztring (kötelező) |
| érték | A metaadatelem értéke. | sztring (kötelező) |
MountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| azureBlobFileSystemConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureFileShareConfiguration |
| cifsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | CifsMountConfiguration |
| nfsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Ez a tulajdonság kölcsönösen kizárja a sasKey tulajdonságot, és egyet meg kell adni. | húr |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| blobfuseOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| containerName | Az Azure Blob Storage-tároló neve. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| sasKey | Ez a tulajdonság kölcsönösen kizárja az accountKey tulajdonságot, és egyet meg kell adni. | húr |
AzureFileShareConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Az Azure Storage-fiókkulcs. | sztring (kötelező) |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| azureFileUrl | Ez "https://{account}.file.core.windows.net/" formátumú. | sztring (kötelező) |
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
CifsMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| jelszó | A CIFS fájlrendszeren való hitelesítéshez használandó jelszó. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
| felhasználónév | A CIFS fájlrendszeren való hitelesítéshez használni kívánt felhasználó. | sztring (kötelező) |
NFSMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
NetworkConfiguration
| Név | Leírás | Érték |
|---|---|---|
| endpointConfiguration | A készletvégpont konfigurációja csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Ez a tulajdonság csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PublicIPAddressConfiguration |
| alhálózati azonosító | 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 csomópontjainak számához. Ha az alhálózat nem rendelkezik elegendő ingyenes IP-címmel, a készlet részben lefoglalja a számítási csomópontokat, és átméretezéskor hiba lép fel. 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 számítási 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 számítási 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. 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. 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-as portot Linuxhoz és a 3389-as portot a Windowshoz. Felhőszolgáltatás-konfigurációval létrehozott készletek esetén engedélyezze az 10100-s, a 20100-s és a 30100-s portokat. Engedélyezze a kimenő kapcsolatokat az Azure Storage-hoz a 443-as porton. A CloudServiceConfiguration-készletek esetében csak a "klasszikus" VNET-ek támogatottak. További részletekért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | húr |
PoolEndpointConfiguration
| Név | Leírás | Érték |
|---|---|---|
| inboundNatPools | A Bejövő NAT-készletek maximális száma Batch-készletenként 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. | InboundNatPool[] (kötelező) |
InboundNatPool
| Név | Leírás | Érték |
|---|---|---|
| backendPort | Ennek egyedinek kell lennie egy Batch-készleten belül. Az elfogadható értékek 1 és 65535 között vannak, kivéve a 22, 3389, 29876 és 29877 értéket, mivel ezek fenntartottak. Ha a rendszer fenntartott értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul. | int (kötelező) |
| frontendPortRangeEnd | 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. 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. | int (kötelező) |
| frontendPortRangeStart | 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. 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. | int (kötelező) |
| név | A névnek egyedinek kell lennie egy 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. | sztring (kötelező) |
| networkSecurityGroupRules | 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. | NetworkSecurityGroupRule[] |
| protokoll | A végpont protokollja. | "TCP" "UDP" (kötelező) |
NetworkSecurityGroupRule
| Név | Leírás | Érték |
|---|---|---|
| hozzáférés | A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet. | "Engedélyezés" "Megtagadás" (kötelező) |
| elsőbbség | A készleten belüli prioritásoknak egyedinek kell lenniük, és prioritás szerinti sorrendben kell értékelni. Minél alacsonyabb a szám, annál magasabb a prioritás. A szabályokat például 150, 250 és 350 sorszámmal lehet megadni. A 150-es sorszámú szabály elsőbbséget élvez a 250-es 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. | int (kötelező) |
| sourceAddressPrefix | 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. | sztring (kötelező) |
| sourcePortRanges | Az érvényes értékek a "*" (minden 0- 65535-ös port esetén) vagy portok vagy porttartományok tömbjei (pl. 100-200). A portoknak 0 és 65535 közötti tartományban kell lennie, és a porttartományok vagy portok nem fedhetik egymást. 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 *. | sztring[] |
PublicIPAddressConfiguration
| Név | Leírás | Érték |
|---|---|---|
| ipAddressIds | 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 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}. | sztring[] |
| céltartalék | Az alapértelmezett érték a BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| automatikus skálázás | Ez a tulajdonság és a rögzített skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | Automatikus méretezési beállítások |
| rögzített skálázás | Ez a tulajdonság és az automatikus skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | FixedScaleSettings |
Automatikus méretezési beállítások
| Név | Leírás | Érték |
|---|---|---|
| evaluationInterval | Ha nincs megadva, az alapértelmezett érték 15 perc (PT15M). | húr |
| képlet | A készletben lévő számítási csomópontok kívánt számának képlete. | sztring (kötelező) |
FixScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| nodeDeallocationOption | Ha nincs megadva, az alapértelmezett érték a Requeue lesz. | 'Requeue' "RetainedData" "TaskCompletion" "Leállítás" |
| resizeTimeout | Az alapértelmezett érték 15 perc. Az időtúllépési értékek ISO 8601 formátumot használnak. Használja például a PT10M-et 10 percig. 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). | húr |
| targetDedicatedNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
| targetLowPriorityNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
StartTask
| Név | Leírás | Érték |
|---|---|---|
| commandLine | 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. Kötelező, ha a startTask bármely más tulajdonsága meg van adva. | húr |
| containerSettings | Ha ez meg van adva, a rendszer a AZ_BATCH_NODE_ROOT_DIR alatt rekurzívan az összes könyvtárat (a csomóponton található Azure Batch-címtárak gyökerét) leképezi a tárolóba, az összes tevékenységkörnyezeti változót a tárolóba rendeli, és a feladat parancssora a tárolóban lesz végrehajtva. | TaskContainerSettings |
| environmentSettings | Az indítási tevékenység környezeti változóbeállításainak listája. | EnvironmentSetting[] |
| maxTaskRetryCount | 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 próbálja ki 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. | Int |
| resourceFiles | 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. | ResourceFile[] |
| userIdentity | Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a feladathoz. | UserIdentity |
| waitForSuccess | Ha igaz, és a kezdési tevékenység meghiúsul egy számítási csomóponton, a Batch szolgáltatás újrapróbálkozásokat indít el a maximális újrapróbálkozások számának (maxTaskRetryCount) értékével. 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 számítási csomópontot, és nem ütemezi a tevékenységeket. Ez a feltétel a csomópont állapotán és az ütemezési hiba részletein keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg a kezdési feladat befejezését. Ebben az esetben más tevékenységek is elkezdhetik a végrehajtást a számítási csomóponton, amíg a kezdő tevékenység még fut; és még ha az indítási feladat meghiúsul is, az új tevékenységek továbbra is ütemezve lesznek a csomóponton. Az alapértelmezett érték igaz. | Bool |
TaskContainerSettings
| Név | Leírás | Érték |
|---|---|---|
| containerRunOptions | 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. | húr |
| imageName | Ez a teljes képhivatkozás, ahogyan 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. | sztring (kötelező) |
| bejegyzés | Ez a beállítás kihagyható, ha már meg lett adva a készlet létrehozásakor. | ContainerRegistry |
| workingDirectory | A tárolótevékenység munkakönyvtárának helyét jelző jelző. Az alapértelmezett érték a "taskWorkingDirectory". | 'ContainerImageDefault' "TaskWorkingDirectory" |
EnvironmentSetting
| Név | Leírás | Érték |
|---|---|---|
| név | A környezeti változó neve. | sztring (kötelező) |
| érték | A környezeti változó értéke. | húr |
ResourceFile
| Név | Leírás | Érték |
|---|---|---|
| autoStorageContainerName | Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. | húr |
| blobPrefix | 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. | húr |
| fileMode | 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 az erőforrásfájlhoz van megadva, amely egy Windows-csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva Linux-csomóponthoz, akkor a rendszer egy alapértelmezett 0770-et alkalmaz a fájlra. | húr |
| filePath | 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). | húr |
| httpUrl | 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 Azure Blob Storage, akkor névtelen hozzáféréssel kell olvashatónak lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
| storageContainerUrl | 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 névtelen hozzáféréssel olvashatónak és listázhatónak kell lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
Felhasználóidentitás
| Név | Leírás | Érték |
|---|---|---|
| autoUser | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | AutoUserSpecification |
| userName | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | húr |
AutoUserSpecification
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| kiterjedés | 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 kezdési tevékenységeknek akadálymentesnek kell lenniük. | "Készlet" "Tevékenység" |
TaskSchedulingPolicy
| Név | Leírás | Érték |
|---|---|---|
| nodeFillType | Hogyan kell elosztani a feladatokat a számítási csomópontok között. | "Csomag" "Spread" (kötelező) |
UserAccount
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | nonAdmin – Az automatikus felhasználó egy normál, emelt szintű hozzáféréssel nem rendelkező felhasználó. rendszergazda – Az automatikus felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik. Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| linuxUserConfiguration | 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. | LinuxUserConfiguration |
| név | A felhasználói fiók neve. | sztring (kötelező) |
| jelszó | A felhasználói fiók jelszava. | sztring (kötelező) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration |
LinuxUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Gid | 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. | Int |
| sshPrivateKey | 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 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 csomópontok között (a felhasználó .ssh könyvtárának módosítása nem történik meg). | húr |
| Uid | 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. | Int |
WindowsUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| loginMode | Megadja a felhasználó bejelentkezési módját. A VirtualMachineConfiguration-készletek alapértelmezett értéke interaktív mód, a CloudServiceConfiguration-készletek esetében pedig kötegelt mód. | "Batch" "Interaktív" |
Rövid útmutatósablonok
Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.
ARM-sablon erőforrásdefiníciója
A batchAccounts/készletek erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következőkre irányulnak:
- Erőforráscsoportok – Lásd erőforráscsoport üzembe helyezési parancsaival
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.
Erőforrás formátuma
Microsoft.Batch/batchAccounts/pools erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.
{
"type": "Microsoft.Batch/batchAccounts/pools",
"apiVersion": "2020-09-01",
"name": "string",
"properties": {
"applicationLicenses": [ "string" ],
"applicationPackages": [
{
"id": "string",
"version": "string"
}
],
"certificates": [
{
"id": "string",
"storeLocation": "string",
"storeName": "string",
"visibility": [ "string" ]
}
],
"deploymentConfiguration": {
"cloudServiceConfiguration": {
"osFamily": "string",
"osVersion": "string"
},
"virtualMachineConfiguration": {
"containerConfiguration": {
"containerImageNames": [ "string" ],
"containerRegistries": [
{
"password": "string",
"registryServer": "string",
"username": "string"
}
],
"type": "DockerCompatible"
},
"dataDisks": [
{
"caching": "string",
"diskSizeGB": "int",
"lun": "int",
"storageAccountType": "string"
}
],
"diskEncryptionConfiguration": {
"targets": [ "string" ]
},
"imageReference": {
"id": "string",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
},
"licenseType": "string",
"nodeAgentSkuId": "string",
"windowsConfiguration": {
"enableAutomaticUpdates": "bool"
}
}
},
"displayName": "string",
"interNodeCommunication": "string",
"metadata": [
{
"name": "string",
"value": "string"
}
],
"mountConfiguration": [
{
"azureBlobFileSystemConfiguration": {
"accountKey": "string",
"accountName": "string",
"blobfuseOptions": "string",
"containerName": "string",
"relativeMountPath": "string",
"sasKey": "string"
},
"azureFileShareConfiguration": {
"accountKey": "string",
"accountName": "string",
"azureFileUrl": "string",
"mountOptions": "string",
"relativeMountPath": "string"
},
"cifsMountConfiguration": {
"mountOptions": "string",
"password": "string",
"relativeMountPath": "string",
"source": "string",
"username": "string"
},
"nfsMountConfiguration": {
"mountOptions": "string",
"relativeMountPath": "string",
"source": "string"
}
}
],
"networkConfiguration": {
"endpointConfiguration": {
"inboundNatPools": [
{
"backendPort": "int",
"frontendPortRangeEnd": "int",
"frontendPortRangeStart": "int",
"name": "string",
"networkSecurityGroupRules": [
{
"access": "string",
"priority": "int",
"sourceAddressPrefix": "string",
"sourcePortRanges": [ "string" ]
}
],
"protocol": "string"
}
]
},
"publicIPAddressConfiguration": {
"ipAddressIds": [ "string" ],
"provision": "string"
},
"subnetId": "string"
},
"scaleSettings": {
"autoScale": {
"evaluationInterval": "string",
"formula": "string"
},
"fixedScale": {
"nodeDeallocationOption": "string",
"resizeTimeout": "string",
"targetDedicatedNodes": "int",
"targetLowPriorityNodes": "int"
}
},
"startTask": {
"commandLine": "string",
"containerSettings": {
"containerRunOptions": "string",
"imageName": "string",
"registry": {
"password": "string",
"registryServer": "string",
"username": "string"
},
"workingDirectory": "string"
},
"environmentSettings": [
{
"name": "string",
"value": "string"
}
],
"maxTaskRetryCount": "int",
"resourceFiles": [
{
"autoStorageContainerName": "string",
"blobPrefix": "string",
"fileMode": "string",
"filePath": "string",
"httpUrl": "string",
"storageContainerUrl": "string"
}
],
"userIdentity": {
"autoUser": {
"elevationLevel": "string",
"scope": "string"
},
"userName": "string"
},
"waitForSuccess": "bool"
},
"taskSchedulingPolicy": {
"nodeFillType": "string"
},
"taskSlotsPerNode": "int",
"userAccounts": [
{
"elevationLevel": "string",
"linuxUserConfiguration": {
"gid": "int",
"sshPrivateKey": "string",
"uid": "int"
},
"name": "string",
"password": "string",
"windowsUserConfiguration": {
"loginMode": "string"
}
}
],
"vmSize": "string"
}
}
Tulajdonságértékek
batchAccounts/készletek
| Név | Leírás | Érték |
|---|---|---|
| típus | Az erőforrás típusa | "Microsoft.Batch/batchAccounts/pools" |
| apiVersion | Az erőforrás API-verziója | '2020-09-01' |
| név | Az erőforrás neve Megtudhatja, hogyan állíthat be neveket és típusokat a gyermekerőforrásokhoz JSON ARM-sablonokban. |
sztring (kötelező) Karakterkorlát: 1-64 Érvényes karakterek: Alfanumerikák, aláhúzásjelek és kötőjelek. |
| kellékek | A készlethez társított tulajdonságok. | PoolProperties |
PoolProperties
| Név | Leírás | Érték |
|---|---|---|
| applicationLicenses | Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek részhalmazának kell lennie. Ha olyan licencre van szükség, amely nem támogatott, a készlet létrehozása sikertelen lesz. | sztring[] |
| applicationPackages | Az alkalmazáscsomag-hivatkozások módosítása hatással van a készlethez csatlakozó összes új számítási csomópontra, de nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítja vagy újra nem alakítja őket. Egy adott készleten legfeljebb 10 alkalmazáscsomag-hivatkozás található. | ApplicationPackageReference[] |
| Tanúsítványok | Windows számítási 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árán belül egy 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. | CertificateReference[] |
| deploymentConfiguration | A CloudServiceConfiguration használatával a csomópontoknak az Azure Cloud Services (PaaS) használatával kell létrejönnie, míg a VirtualMachineConfiguration azure-beli virtuális gépeket (IaaS) használ. | DeploymentConfiguration |
| displayName | A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat. | húr |
| interNodeCommunication | Ez korlátozza, hogy mely csomópontok rendelhetők hozzá a készlethez. Ennek az értéknek az engedélyezése csökkentheti a készletben lefoglalni kívánt csomópontok számát. Ha nincs megadva, ez az érték alapértelmezés szerint "Letiltva" lesz. | "Letiltva" "Engedélyezve" |
| metaadatok | 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. | metadataItem[] |
| mountConfiguration | Ez támogatja az Azure Filest, az NFS-t, a CIFS-t/SMB-t és a Blobfuse-t. | MountConfiguration[] |
| networkConfiguration | A készlet hálózati konfigurációja. | NetworkConfiguration |
| scaleSettings | Meghatározza a készlet kívánt méretét. Ez lehet "rögzített skálázás", ahol meg van adva a kért targetDedicatedNodes, vagy az "automatikus skálázás", amely egy rendszeresen újraértékelt képletet definiál. Ha ez a tulajdonság nincs megadva, a készlet rögzített skálával fog rendelkezni 0 targetDedicatedNodes értékekkel. | ScaleSettings |
| startTask | A PATCH (frissítési) műveletben ez a tulajdonság egy üres objektumra állítható be, hogy eltávolítsa a kezdő feladatot a készletből. | StartTask |
| taskSchedulingPolicy | Ha nincs megadva, az alapértelmezett oldalpár. | TaskSchedulingPolicy |
| taskSlotsPerNode | Az alapértelmezett érték 1. A maximális érték a készlet VmSize-jének 4-szerese, vagy 256. | Int |
| userAccounts | A készlet minden csomópontján létrehozandó felhasználói fiókok listája. | UserAccount[] |
| vmSize | A Cloud Services-készletek (cloudServiceConfiguration használatával létrehozott készletek) virtuális gépeinek elérhető méreteivel kapcsolatos információkért lásd a Cloud Services méreteit (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). A Batch az ExtraSmall kivételével minden Cloud Services virtuálisgép-méretet támogat. A virtuális gépek piacteréről (a virtualMachineConfiguration használatával létrehozott készletekből) származó rendszerképeket használó készletekhez elérhető virtuálisgép-méretekről további információt a Virtuális gépek méretei (Linux) (/azure/virtual-machines/sizes-general) vagy a Virtuális gépek méretei (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) című témakörben talál. A Batch az összes Azure-beli virtuálisgép-méretet támogatja, kivéve STANDARD_A0 és prémium szintű tárterülettel (STANDARD_GS, STANDARD_DS és STANDARD_DSV2 sorozattal). | húr |
ApplicationPackageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A telepíteni kívánt alkalmazáscsomag azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. Ez lehet egy adott verzióra vagy az alapértelmezett verzióra való hivatkozás, ha létezik. | sztring (kötelező) |
| verzió | Ha ez nincs megadva, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés az InvalidApplicationPackageReferences hibakóddal hiúsul meg. Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 409. | húr |
CertificateReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A készletre telepíteni kívánt tanúsítvány teljes azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. | sztring (kötelező) |
| storeLocation | Az alapértelmezett érték a currentUser. Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Linux számítási csomópontok esetén a tanúsítványok a feladat munkakönyvtárán belül egy 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. | "CurrentUser" 'LocalMachine' |
| storeName | Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Az áruházak gyakori nevei a következők: 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. | húr |
| láthatóság | 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. | Sztringtömb, amely a következők bármelyikét tartalmazza: "RemoteUser" "StartTask" "Tevékenység" |
DeploymentConfiguration
| Név | Leírás | Érték |
|---|---|---|
| cloudServiceConfiguration | Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiók a poolAllocationMode tulajdonsággal lett létrehozva, és a "UserSubscription" értékre van állítva. | CloudServiceConfiguration |
| virtualMachineConfiguration | Ez a tulajdonság és a cloudServiceConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Név | Leírás | Érték |
|---|---|---|
| osFamily | Lehetséges értékek: 2 – Os Family 2, egyenértékű a Windows Server 2008 R2 SP1 rendszerrel. 3 – 3. operációsrendszer-család, egyenértékű a Windows Server 2012-zel. 4 – Os Family 4, egyenértékű a Windows Server 2012 R2-zel. 5 – Os Family 5, egyenértékű a Windows Server 2016-dal. 6 – Os Family 6, egyenértékű a Windows Server 2019-zel. További információ: Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | sztring (kötelező) |
| osVersion | Az alapértelmezett érték * , amely a megadott operációsrendszer-család legújabb operációsrendszer-verzióját adja meg. | húr |
VirtualMachineConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerConfiguration | Ha meg van adva, a beállítás a készlet minden csomópontján történik, hogy a tevékenységek tárolókban fussanak. Az ezen 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. | ContainerConfiguration |
| dataDisks | Ezt a tulajdonságot akkor kell megadni, ha a készlet számítási csomópontjaihoz üres adatlemezeket kell csatolni. | DataDisk[] |
| diskEncryptionConfiguration | 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. | DiskEncryptionConfiguration |
| imageReference | Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy egyéni virtuális gép Azure Image-erőforrására. Az Összes imageReferences Azure Batch által ellenőrzött listájának lekéréséhez tekintse meg a "Támogatott csomópontügynök termékváltozatainak listázása" műveletet. | ImageReference (kötelező) |
| licenseType | 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 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. |
húr |
| nodeAgentSkuId | A Batch csomópontügynök egy olyan program, amely a készlet minden csomópontján fut, és biztosítja a parancs- és vezérlési felületet a csomópont és a Batch szolgáltatás között. A csomópontügynöknek, más néven termékváltozatoknak különböző implementációi vannak a különböző operációs rendszerekhez. Meg kell adnia egy csomópontügynök termékváltozatát, amely megfelel a kijelölt képhivatkozásnak. A támogatott 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 csomópontügynök termékváltozatainak listázása" műveletet. | sztring (kötelező) |
| windowsConfiguration | Ezt a tulajdonságot nem szabad megadni, ha az imageReference linuxos operációsrendszer-lemezképet ad meg. | WindowsConfiguration |
ContainerConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerImageNames | Ez a teljes képhivatkozás, ahogyan a "docker pull" kifejezés is meg van adva. A rendszerképek az alapértelmezett Docker-beállításjegyzékből származnak, kivéve, ha a rendszerkép teljes mértékben egy alternatív beállításjegyzékkel van minősítve. | sztring[] |
| containerRegistries | 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. | ContainerRegistry[] |
| típus | A használandó tárolótechnológia. | "DockerCompatible" (kötelező) |
ContainerRegistry
| Név | Leírás | Érték |
|---|---|---|
| jelszó | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó. | sztring (kötelező) |
| registryServer | Ha nincs megadva, az alapértelmezett érték a "docker.io". | húr |
| felhasználónév | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges felhasználónév. | sztring (kötelező) |
DataDisk
| Név | Leírás | Érték |
|---|---|---|
| gyorsítótárazás | Az értékek a következők: none – A lemez gyorsítótárazási módja nincs engedélyezve. readOnly – A lemez gyorsítótárazási módja csak olvasható. readWrite – A lemez gyorsítótárazási módja olvasás és írás. A gyorsítótárazás alapértelmezett értéke nincs. A gyorsítótárazási beállításokkal kapcsolatos információkért lásd: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Nincs" "ReadOnly" "ReadWrite" |
| diskSizeGB | A kezdeti lemezméret GB-ban az új adatlemez létrehozásakor. | int (kötelező) |
| Lun | 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. | int (kötelező) |
| storageAccountType | Ha nincs megadva, az alapértelmezett érték a "Standard_LRS". Az értékek a következők: Standard_LRS – Az adatlemeznek szabványos helyileg redundáns tárolást kell használnia. Premium_LRS – Az adatlemeznek prémium szintű helyileg redundáns tárolást kell használnia. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Célok | Linux-készleten csak a "TemporaryDisk" támogatott; A Windows-készletben meg kell adni az "OsDisk" és az "TemporaryDisk" értéket. | Sztringtömb, amely a következők bármelyikét tartalmazza: "OsDisk" "TemporaryDisk" |
ImageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot. A megosztott képgyűjtemény lemezképének replikáinak ugyanabban a régióban kell lenniük, mint az Azure Batch-fiók. A Batch-csomópont ügynökének a Batch szolgáltatással való kommunikációhoz szükséges tűzfalbeállításaival kapcsolatos információkért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | húr |
| ajánlat | Például: UbuntuServer vagy WindowsServer. | húr |
| kiadó | Például a Canonical vagy a MicrosoftWindowsServer. | húr |
| Sku | Például: 18.04-LTS vagy 2019-Datacenter. | húr |
| verzió | A rendszerkép legújabb verziójának kiválasztásához megadható a "legújabb" érték. Ha nincs megadva, az alapértelmezett érték a "legújabb". | húr |
WindowsConfiguration
| Név | Leírás | Érték |
|---|---|---|
| enableAutomaticUpdates | Ha nincs megadva, az alapértelmezett érték igaz. | Bool |
MetadataItem
| Név | Leírás | Érték |
|---|---|---|
| név | A metaadatelem neve. | sztring (kötelező) |
| érték | A metaadatelem értéke. | sztring (kötelező) |
MountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| azureBlobFileSystemConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureFileShareConfiguration |
| cifsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | CifsMountConfiguration |
| nfsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Ez a tulajdonság kölcsönösen kizárja a sasKey tulajdonságot, és egyet meg kell adni. | húr |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| blobfuseOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| containerName | Az Azure Blob Storage-tároló neve. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| sasKey | Ez a tulajdonság kölcsönösen kizárja az accountKey tulajdonságot, és egyet meg kell adni. | húr |
AzureFileShareConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Az Azure Storage-fiókkulcs. | sztring (kötelező) |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| azureFileUrl | Ez "https://{account}.file.core.windows.net/" formátumú. | sztring (kötelező) |
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
CifsMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| jelszó | A CIFS fájlrendszeren való hitelesítéshez használandó jelszó. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
| felhasználónév | A CIFS fájlrendszeren való hitelesítéshez használni kívánt felhasználó. | sztring (kötelező) |
NFSMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
NetworkConfiguration
| Név | Leírás | Érték |
|---|---|---|
| endpointConfiguration | A készletvégpont konfigurációja csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Ez a tulajdonság csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PublicIPAddressConfiguration |
| alhálózati azonosító | 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 csomópontjainak számához. Ha az alhálózat nem rendelkezik elegendő ingyenes IP-címmel, a készlet részben lefoglalja a számítási csomópontokat, és átméretezéskor hiba lép fel. 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 számítási 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 számítási 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. 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. 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-as portot Linuxhoz és a 3389-as portot a Windowshoz. Felhőszolgáltatás-konfigurációval létrehozott készletek esetén engedélyezze az 10100-s, a 20100-s és a 30100-s portokat. Engedélyezze a kimenő kapcsolatokat az Azure Storage-hoz a 443-as porton. A CloudServiceConfiguration-készletek esetében csak a "klasszikus" VNET-ek támogatottak. További részletekért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | húr |
PoolEndpointConfiguration
| Név | Leírás | Érték |
|---|---|---|
| inboundNatPools | A Bejövő NAT-készletek maximális száma Batch-készletenként 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. | InboundNatPool[] (kötelező) |
InboundNatPool
| Név | Leírás | Érték |
|---|---|---|
| backendPort | Ennek egyedinek kell lennie egy Batch-készleten belül. Az elfogadható értékek 1 és 65535 között vannak, kivéve a 22, 3389, 29876 és 29877 értéket, mivel ezek fenntartottak. Ha a rendszer fenntartott értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul. | int (kötelező) |
| frontendPortRangeEnd | 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. 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. | int (kötelező) |
| frontendPortRangeStart | 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. 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. | int (kötelező) |
| név | A névnek egyedinek kell lennie egy 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. | sztring (kötelező) |
| networkSecurityGroupRules | 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. | NetworkSecurityGroupRule[] |
| protokoll | A végpont protokollja. | "TCP" "UDP" (kötelező) |
NetworkSecurityGroupRule
| Név | Leírás | Érték |
|---|---|---|
| hozzáférés | A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet. | "Engedélyezés" "Megtagadás" (kötelező) |
| elsőbbség | A készleten belüli prioritásoknak egyedinek kell lenniük, és prioritás szerinti sorrendben kell értékelni. Minél alacsonyabb a szám, annál magasabb a prioritás. A szabályokat például 150, 250 és 350 sorszámmal lehet megadni. A 150-es sorszámú szabály elsőbbséget élvez a 250-es 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. | int (kötelező) |
| sourceAddressPrefix | 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. | sztring (kötelező) |
| sourcePortRanges | Az érvényes értékek a "*" (minden 0- 65535-ös port esetén) vagy portok vagy porttartományok tömbjei (pl. 100-200). A portoknak 0 és 65535 közötti tartományban kell lennie, és a porttartományok vagy portok nem fedhetik egymást. 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 *. | sztring[] |
PublicIPAddressConfiguration
| Név | Leírás | Érték |
|---|---|---|
| ipAddressIds | 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 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}. | sztring[] |
| céltartalék | Az alapértelmezett érték a BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| automatikus skálázás | Ez a tulajdonság és a rögzített skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | Automatikus méretezési beállítások |
| rögzített skálázás | Ez a tulajdonság és az automatikus skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | FixedScaleSettings |
Automatikus méretezési beállítások
| Név | Leírás | Érték |
|---|---|---|
| evaluationInterval | Ha nincs megadva, az alapértelmezett érték 15 perc (PT15M). | húr |
| képlet | A készletben lévő számítási csomópontok kívánt számának képlete. | sztring (kötelező) |
FixScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| nodeDeallocationOption | Ha nincs megadva, az alapértelmezett érték a Requeue lesz. | 'Requeue' "RetainedData" "TaskCompletion" "Leállítás" |
| resizeTimeout | Az alapértelmezett érték 15 perc. Az időtúllépési értékek ISO 8601 formátumot használnak. Használja például a PT10M-et 10 percig. 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). | húr |
| targetDedicatedNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
| targetLowPriorityNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
StartTask
| Név | Leírás | Érték |
|---|---|---|
| commandLine | 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. Kötelező, ha a startTask bármely más tulajdonsága meg van adva. | húr |
| containerSettings | Ha ez meg van adva, a rendszer a AZ_BATCH_NODE_ROOT_DIR alatt rekurzívan az összes könyvtárat (a csomóponton található Azure Batch-címtárak gyökerét) leképezi a tárolóba, az összes tevékenységkörnyezeti változót a tárolóba rendeli, és a feladat parancssora a tárolóban lesz végrehajtva. | TaskContainerSettings |
| environmentSettings | Az indítási tevékenység környezeti változóbeállításainak listája. | EnvironmentSetting[] |
| maxTaskRetryCount | 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 próbálja ki 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. | Int |
| resourceFiles | 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. | ResourceFile[] |
| userIdentity | Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a feladathoz. | UserIdentity |
| waitForSuccess | Ha igaz, és a kezdési tevékenység meghiúsul egy számítási csomóponton, a Batch szolgáltatás újrapróbálkozásokat indít el a maximális újrapróbálkozások számának (maxTaskRetryCount) értékével. 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 számítási csomópontot, és nem ütemezi a tevékenységeket. Ez a feltétel a csomópont állapotán és az ütemezési hiba részletein keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg a kezdési feladat befejezését. Ebben az esetben más tevékenységek is elkezdhetik a végrehajtást a számítási csomóponton, amíg a kezdő tevékenység még fut; és még ha az indítási feladat meghiúsul is, az új tevékenységek továbbra is ütemezve lesznek a csomóponton. Az alapértelmezett érték igaz. | Bool |
TaskContainerSettings
| Név | Leírás | Érték |
|---|---|---|
| containerRunOptions | 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. | húr |
| imageName | Ez a teljes képhivatkozás, ahogyan 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. | sztring (kötelező) |
| bejegyzés | Ez a beállítás kihagyható, ha már meg lett adva a készlet létrehozásakor. | ContainerRegistry |
| workingDirectory | A tárolótevékenység munkakönyvtárának helyét jelző jelző. Az alapértelmezett érték a "taskWorkingDirectory". | 'ContainerImageDefault' "TaskWorkingDirectory" |
EnvironmentSetting
| Név | Leírás | Érték |
|---|---|---|
| név | A környezeti változó neve. | sztring (kötelező) |
| érték | A környezeti változó értéke. | húr |
ResourceFile
| Név | Leírás | Érték |
|---|---|---|
| autoStorageContainerName | Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. | húr |
| blobPrefix | 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. | húr |
| fileMode | 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 az erőforrásfájlhoz van megadva, amely egy Windows-csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva Linux-csomóponthoz, akkor a rendszer egy alapértelmezett 0770-et alkalmaz a fájlra. | húr |
| filePath | 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). | húr |
| httpUrl | 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 Azure Blob Storage, akkor névtelen hozzáféréssel kell olvashatónak lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
| storageContainerUrl | 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 névtelen hozzáféréssel olvashatónak és listázhatónak kell lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
Felhasználóidentitás
| Név | Leírás | Érték |
|---|---|---|
| autoUser | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | AutoUserSpecification |
| userName | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | húr |
AutoUserSpecification
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| kiterjedés | 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 kezdési tevékenységeknek akadálymentesnek kell lenniük. | "Készlet" "Tevékenység" |
TaskSchedulingPolicy
| Név | Leírás | Érték |
|---|---|---|
| nodeFillType | Hogyan kell elosztani a feladatokat a számítási csomópontok között. | "Csomag" "Spread" (kötelező) |
UserAccount
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | nonAdmin – Az automatikus felhasználó egy normál, emelt szintű hozzáféréssel nem rendelkező felhasználó. rendszergazda – Az automatikus felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik. Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| linuxUserConfiguration | 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. | LinuxUserConfiguration |
| név | A felhasználói fiók neve. | sztring (kötelező) |
| jelszó | A felhasználói fiók jelszava. | sztring (kötelező) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration |
LinuxUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Gid | 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. | Int |
| sshPrivateKey | 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 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 csomópontok között (a felhasználó .ssh könyvtárának módosítása nem történik meg). | húr |
| Uid | 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. | Int |
WindowsUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| loginMode | Megadja a felhasználó bejelentkezési módját. A VirtualMachineConfiguration-készletek alapértelmezett értéke interaktív mód, a CloudServiceConfiguration-készletek esetében pedig kötegelt mód. | "Batch" "Interaktív" |
Rövid útmutatósablonok
Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.
Terraform (AzAPI-szolgáltató) erőforrásdefiníciója
A batchAccounts/készletek erőforrástípusa üzembe helyezhető olyan műveletekkel, amelyek a következőkre irányulnak:
- erőforráscsoportok
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.
Erőforrás formátuma
Microsoft.Batch/batchAccounts/pools erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Batch/batchAccounts/pools@2020-09-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
applicationLicenses = [
"string"
]
applicationPackages = [
{
id = "string"
version = "string"
}
]
certificates = [
{
id = "string"
storeLocation = "string"
storeName = "string"
visibility = [
"string"
]
}
]
deploymentConfiguration = {
cloudServiceConfiguration = {
osFamily = "string"
osVersion = "string"
}
virtualMachineConfiguration = {
containerConfiguration = {
containerImageNames = [
"string"
]
containerRegistries = [
{
password = "string"
registryServer = "string"
username = "string"
}
]
type = "DockerCompatible"
}
dataDisks = [
{
caching = "string"
diskSizeGB = int
lun = int
storageAccountType = "string"
}
]
diskEncryptionConfiguration = {
targets = [
"string"
]
}
imageReference = {
id = "string"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
}
licenseType = "string"
nodeAgentSkuId = "string"
windowsConfiguration = {
enableAutomaticUpdates = bool
}
}
}
displayName = "string"
interNodeCommunication = "string"
metadata = [
{
name = "string"
value = "string"
}
]
mountConfiguration = [
{
azureBlobFileSystemConfiguration = {
accountKey = "string"
accountName = "string"
blobfuseOptions = "string"
containerName = "string"
relativeMountPath = "string"
sasKey = "string"
}
azureFileShareConfiguration = {
accountKey = "string"
accountName = "string"
azureFileUrl = "string"
mountOptions = "string"
relativeMountPath = "string"
}
cifsMountConfiguration = {
mountOptions = "string"
password = "string"
relativeMountPath = "string"
source = "string"
username = "string"
}
nfsMountConfiguration = {
mountOptions = "string"
relativeMountPath = "string"
source = "string"
}
}
]
networkConfiguration = {
endpointConfiguration = {
inboundNatPools = [
{
backendPort = int
frontendPortRangeEnd = int
frontendPortRangeStart = int
name = "string"
networkSecurityGroupRules = [
{
access = "string"
priority = int
sourceAddressPrefix = "string"
sourcePortRanges = [
"string"
]
}
]
protocol = "string"
}
]
}
publicIPAddressConfiguration = {
ipAddressIds = [
"string"
]
provision = "string"
}
subnetId = "string"
}
scaleSettings = {
autoScale = {
evaluationInterval = "string"
formula = "string"
}
fixedScale = {
nodeDeallocationOption = "string"
resizeTimeout = "string"
targetDedicatedNodes = int
targetLowPriorityNodes = int
}
}
startTask = {
commandLine = "string"
containerSettings = {
containerRunOptions = "string"
imageName = "string"
registry = {
password = "string"
registryServer = "string"
username = "string"
}
workingDirectory = "string"
}
environmentSettings = [
{
name = "string"
value = "string"
}
]
maxTaskRetryCount = int
resourceFiles = [
{
autoStorageContainerName = "string"
blobPrefix = "string"
fileMode = "string"
filePath = "string"
httpUrl = "string"
storageContainerUrl = "string"
}
]
userIdentity = {
autoUser = {
elevationLevel = "string"
scope = "string"
}
userName = "string"
}
waitForSuccess = bool
}
taskSchedulingPolicy = {
nodeFillType = "string"
}
taskSlotsPerNode = int
userAccounts = [
{
elevationLevel = "string"
linuxUserConfiguration = {
gid = int
sshPrivateKey = "string"
uid = int
}
name = "string"
password = "string"
windowsUserConfiguration = {
loginMode = "string"
}
}
]
vmSize = "string"
}
})
}
Tulajdonságértékek
batchAccounts/készletek
| Név | Leírás | Érték |
|---|---|---|
| típus | Az erőforrás típusa | "Microsoft.Batch/batchAccounts/pools@2020-09-01" |
| név | Az erőforrás neve | sztring (kötelező) Karakterkorlát: 1-64 Érvényes karakterek: Alfanumerikák, aláhúzásjelek és kötőjelek. |
| parent_id | Annak az erőforrásnak az azonosítója, amely az erőforrás szülője. | Típus típusú erőforrás azonosítója: batchAccounts |
| kellékek | A készlethez társított tulajdonságok. | PoolProperties |
PoolProperties
| Név | Leírás | Érték |
|---|---|---|
| applicationLicenses | Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek részhalmazának kell lennie. Ha olyan licencre van szükség, amely nem támogatott, a készlet létrehozása sikertelen lesz. | sztring[] |
| applicationPackages | Az alkalmazáscsomag-hivatkozások módosítása hatással van a készlethez csatlakozó összes új számítási csomópontra, de nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítja vagy újra nem alakítja őket. Egy adott készleten legfeljebb 10 alkalmazáscsomag-hivatkozás található. | ApplicationPackageReference[] |
| Tanúsítványok | Windows számítási 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árán belül egy 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. | CertificateReference[] |
| deploymentConfiguration | A CloudServiceConfiguration használatával a csomópontoknak az Azure Cloud Services (PaaS) használatával kell létrejönnie, míg a VirtualMachineConfiguration azure-beli virtuális gépeket (IaaS) használ. | DeploymentConfiguration |
| displayName | A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 hosszúságú Unicode-karaktereket tartalmazhat. | húr |
| interNodeCommunication | Ez korlátozza, hogy mely csomópontok rendelhetők hozzá a készlethez. Ennek az értéknek az engedélyezése csökkentheti a készletben lefoglalni kívánt csomópontok számát. Ha nincs megadva, ez az érték alapértelmezés szerint "Letiltva" lesz. | "Letiltva" "Engedélyezve" |
| metaadatok | 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. | metadataItem[] |
| mountConfiguration | Ez támogatja az Azure Filest, az NFS-t, a CIFS-t/SMB-t és a Blobfuse-t. | MountConfiguration[] |
| networkConfiguration | A készlet hálózati konfigurációja. | NetworkConfiguration |
| scaleSettings | Meghatározza a készlet kívánt méretét. Ez lehet "rögzített skálázás", ahol meg van adva a kért targetDedicatedNodes, vagy az "automatikus skálázás", amely egy rendszeresen újraértékelt képletet definiál. Ha ez a tulajdonság nincs megadva, a készlet rögzített skálával fog rendelkezni 0 targetDedicatedNodes értékekkel. | ScaleSettings |
| startTask | A PATCH (frissítési) műveletben ez a tulajdonság egy üres objektumra állítható be, hogy eltávolítsa a kezdő feladatot a készletből. | StartTask |
| taskSchedulingPolicy | Ha nincs megadva, az alapértelmezett oldalpár. | TaskSchedulingPolicy |
| taskSlotsPerNode | Az alapértelmezett érték 1. A maximális érték a készlet VmSize-jének 4-szerese, vagy 256. | Int |
| userAccounts | A készlet minden csomópontján létrehozandó felhasználói fiókok listája. | UserAccount[] |
| vmSize | A Cloud Services-készletek (cloudServiceConfiguration használatával létrehozott készletek) virtuális gépeinek elérhető méreteivel kapcsolatos információkért lásd a Cloud Services méreteit (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). A Batch az ExtraSmall kivételével minden Cloud Services virtuálisgép-méretet támogat. A virtuális gépek piacteréről (a virtualMachineConfiguration használatával létrehozott készletekből) származó rendszerképeket használó készletekhez elérhető virtuálisgép-méretekről további információt a Virtuális gépek méretei (Linux) (/azure/virtual-machines/sizes-general) vagy a Virtuális gépek méretei (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/) című témakörben talál. A Batch az összes Azure-beli virtuálisgép-méretet támogatja, kivéve STANDARD_A0 és prémium szintű tárterülettel (STANDARD_GS, STANDARD_DS és STANDARD_DSV2 sorozattal). | húr |
ApplicationPackageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A telepíteni kívánt alkalmazáscsomag azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. Ez lehet egy adott verzióra vagy az alapértelmezett verzióra való hivatkozás, ha létezik. | sztring (kötelező) |
| verzió | Ha ez nincs megadva, és nincs megadva alapértelmezett verzió ehhez az alkalmazáshoz, a kérés az InvalidApplicationPackageReferences hibakóddal hiúsul meg. Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 409. | húr |
CertificateReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | A készletre telepíteni kívánt tanúsítvány teljes azonosítója. Ennek ugyanabban a kötegfiókban kell lennie, mint a készletnek. | sztring (kötelező) |
| storeLocation | Az alapértelmezett érték a currentUser. Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Linux számítási csomópontok esetén a tanúsítványok a feladat munkakönyvtárán belül egy 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. | "CurrentUser" "LocalMachine" |
| storeName | Ez a tulajdonság csak a Windows-csomópontokkal konfigurált készletekre vonatkozik (azaz a cloudServiceConfiguration használatával vagy a VirtualMachineConfiguration használatával, Windows rendszerkép-referencia használatával). Az áruházak gyakori nevei a következők: 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. | húr |
| láthatóság | 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. | Sztringtömb, amely a következők bármelyikét tartalmazza: "RemoteUser" "StartTask" "Tevékenység" |
DeploymentConfiguration
| Név | Leírás | Érték |
|---|---|---|
| cloudServiceConfiguration | Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiók a poolAllocationMode tulajdonsággal lett létrehozva, és a "UserSubscription" értékre van állítva. | CloudServiceConfiguration |
| virtualMachineConfiguration | Ez a tulajdonság és a cloudServiceConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | VirtualMachineConfiguration |
CloudServiceConfiguration
| Név | Leírás | Érték |
|---|---|---|
| osFamily | Lehetséges értékek: 2 – Os Family 2, egyenértékű a Windows Server 2008 R2 SP1 rendszerrel. 3 – 3. operációsrendszer-család, egyenértékű a Windows Server 2012-zel. 4 – Os Family 4, egyenértékű a Windows Server 2012 R2-zel. 5 – Os Family 5, egyenértékű a Windows Server 2016-dal. 6 – Os Family 6, egyenértékű a Windows Server 2019-zel. További információ: Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). | sztring (kötelező) |
| osVersion | Az alapértelmezett érték * , amely a megadott operációsrendszer-család legújabb operációsrendszer-verzióját adja meg. | húr |
VirtualMachineConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerConfiguration | Ha meg van adva, a beállítás a készlet minden csomópontján történik, hogy a tevékenységek tárolókban fussanak. Az ezen 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. | ContainerConfiguration |
| dataDisks | Ezt a tulajdonságot akkor kell megadni, ha a készlet számítási csomópontjaihoz üres adatlemezeket kell csatolni. | DataDisk[] |
| diskEncryptionConfiguration | 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. | DiskEncryptionConfiguration |
| imageReference | Hivatkozás egy Azure Virtual Machines Marketplace-rendszerképre vagy egy egyéni virtuális gép Azure Image-erőforrására. Az Összes imageReferences Azure Batch által ellenőrzött listájának lekéréséhez tekintse meg a "Támogatott csomópontügynök termékváltozatainak listázása" műveletet. | ImageReference (kötelező) |
| licenseType | 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 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. |
húr |
| nodeAgentSkuId | A Batch csomópontügynök egy olyan program, amely a készlet minden csomópontján fut, és biztosítja a parancs- és vezérlési felületet a csomópont és a Batch szolgáltatás között. A csomópontügynöknek, más néven termékváltozatoknak különböző implementációi vannak a különböző operációs rendszerekhez. Meg kell adnia egy csomópontügynök termékváltozatát, amely megfelel a kijelölt képhivatkozásnak. A támogatott 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 csomópontügynök termékváltozatainak listázása" műveletet. | sztring (kötelező) |
| windowsConfiguration | Ezt a tulajdonságot nem szabad megadni, ha az imageReference linuxos operációsrendszer-lemezképet ad meg. | WindowsConfiguration |
ContainerConfiguration
| Név | Leírás | Érték |
|---|---|---|
| containerImageNames | Ez a teljes képhivatkozás, ahogyan a "docker pull" kifejezés is meg van adva. A rendszerképek az alapértelmezett Docker-beállításjegyzékből származnak, kivéve, ha a rendszerkép teljes mértékben egy alternatív beállításjegyzékkel van minősítve. | sztring[] |
| containerRegistries | 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. | ContainerRegistry[] |
| típus | A használandó tárolótechnológia. | "DockerCompatible" (kötelező) |
ContainerRegistry
| Név | Leírás | Érték |
|---|---|---|
| jelszó | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges jelszó. | sztring (kötelező) |
| registryServer | Ha nincs megadva, az alapértelmezett érték a "docker.io". | húr |
| felhasználónév | A beállításjegyzék-kiszolgálóra való bejelentkezéshez szükséges felhasználónév. | sztring (kötelező) |
DataDisk
| Név | Leírás | Érték |
|---|---|---|
| gyorsítótárazás | Az értékek a következők: none – A lemez gyorsítótárazási módja nincs engedélyezve. readOnly – A lemez gyorsítótárazási módja csak olvasható. readWrite – A lemez gyorsítótárazási módja olvasás és írás. A gyorsítótárazás alapértelmezett értéke nincs. A gyorsítótárazási beállításokkal kapcsolatos információkért lásd: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. |
"Nincs" "ReadOnly" "ReadWrite" |
| diskSizeGB | A kezdeti lemezméret GB-ban az új adatlemez létrehozásakor. | int (kötelező) |
| Lun | 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. | int (kötelező) |
| storageAccountType | Ha nincs megadva, az alapértelmezett érték a "Standard_LRS". Az értékek a következők: Standard_LRS – Az adatlemeznek szabványos helyileg redundáns tárolást kell használnia. Premium_LRS – Az adatlemeznek prémium szintű helyileg redundáns tárolást kell használnia. |
"Premium_LRS" "Standard_LRS" |
DiskEncryptionConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Célok | Linux-készleten csak a "TemporaryDisk" támogatott; A Windows-készletben meg kell adni az "OsDisk" és az "TemporaryDisk" értéket. | Sztringtömb, amely a következők bármelyikét tartalmazza: "OsDisk" "TemporaryDisk" |
ImageReference
| Név | Leírás | Érték |
|---|---|---|
| azonosító | Ez a tulajdonság kölcsönösen kizárja a többi tulajdonságot. A megosztott képgyűjtemény lemezképének replikáinak ugyanabban a régióban kell lenniük, mint az Azure Batch-fiók. A Batch-csomópont ügynökének a Batch szolgáltatással való kommunikációhoz szükséges tűzfalbeállításaival kapcsolatos információkért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. | húr |
| ajánlat | Például: UbuntuServer vagy WindowsServer. | húr |
| kiadó | Például a Canonical vagy a MicrosoftWindowsServer. | húr |
| Sku | Például: 18.04-LTS vagy 2019-Datacenter. | húr |
| verzió | A rendszerkép legújabb verziójának kiválasztásához megadható a "legújabb" érték. Ha nincs megadva, az alapértelmezett érték a "legújabb". | húr |
WindowsConfiguration
| Név | Leírás | Érték |
|---|---|---|
| enableAutomaticUpdates | Ha nincs megadva, az alapértelmezett érték igaz. | Bool |
MetadataItem
| Név | Leírás | Érték |
|---|---|---|
| név | A metaadatelem neve. | sztring (kötelező) |
| érték | A metaadatelem értéke. | sztring (kötelező) |
MountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| azureBlobFileSystemConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureBlobFileSystemConfiguration |
| azureFileShareConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | AzureFileShareConfiguration |
| cifsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | CifsMountConfiguration |
| nfsMountConfiguration | Ez a tulajdonság kölcsönösen kizárja az összes többi tulajdonságot. | NFSMountConfiguration |
AzureBlobFileSystemConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Ez a tulajdonság kölcsönösen kizárja a sasKey tulajdonságot, és egyet meg kell adni. | húr |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| blobfuseOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| containerName | Az Azure Blob Storage-tároló neve. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| sasKey | Ez a tulajdonság kölcsönösen kizárja az accountKey tulajdonságot, és egyet meg kell adni. | húr |
AzureFileShareConfiguration
| Név | Leírás | Érték |
|---|---|---|
| accountKey | Az Azure Storage-fiókkulcs. | sztring (kötelező) |
| accountName | Az Azure Storage-fiók neve. | sztring (kötelező) |
| azureFileUrl | Ez "https://{account}.file.core.windows.net/" formátumú. | sztring (kötelező) |
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
CifsMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| jelszó | A CIFS fájlrendszeren való hitelesítéshez használandó jelszó. | sztring (kötelező) |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
| felhasználónév | A CIFS fájlrendszeren való hitelesítéshez használni kívánt felhasználó. | sztring (kötelező) |
NFSMountConfiguration
| Név | Leírás | Érték |
|---|---|---|
| mountOptions | Ezek a Windowsban a "net use" és a "mount" (csatlakoztatási) lehetőségek a Linuxban. | húr |
| relativeMountPath | 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. | sztring (kötelező) |
| forrás | A csatlakoztatni kívánt fájlrendszer URI-ja. | sztring (kötelező) |
NetworkConfiguration
| Név | Leírás | Érték |
|---|---|---|
| endpointConfiguration | A készletvégpont konfigurációja csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PoolEndpointConfiguration |
| publicIPAddressConfiguration | Ez a tulajdonság csak a virtualMachineConfiguration tulajdonsággal rendelkező készleteken támogatott. | PublicIPAddressConfiguration |
| alhálózati azonosító | 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 csomópontjainak számához. Ha az alhálózat nem rendelkezik elegendő ingyenes IP-címmel, a készlet részben lefoglalja a számítási csomópontokat, és átméretezéskor hiba lép fel. 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 számítási 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 számítási 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. 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. 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-as portot Linuxhoz és a 3389-as portot a Windowshoz. Felhőszolgáltatás-konfigurációval létrehozott készletek esetén engedélyezze az 10100-s, a 20100-s és a 30100-s portokat. Engedélyezze a kimenő kapcsolatokat az Azure Storage-hoz a 443-as porton. A CloudServiceConfiguration-készletek esetében csak a "klasszikus" VNET-ek támogatottak. További részletekért lásd: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration | húr |
PoolEndpointConfiguration
| Név | Leírás | Érték |
|---|---|---|
| inboundNatPools | A Bejövő NAT-készletek maximális száma Batch-készletenként 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. | InboundNatPool[] (kötelező) |
InboundNatPool
| Név | Leírás | Érték |
|---|---|---|
| backendPort | Ennek egyedinek kell lennie egy Batch-készleten belül. Az elfogadható értékek 1 és 65535 között vannak, kivéve a 22, 3389, 29876 és 29877 értéket, mivel ezek fenntartottak. Ha a rendszer fenntartott értékeket ad meg, a kérés a 400-ás HTTP-állapotkóddal meghiúsul. | int (kötelező) |
| frontendPortRangeEnd | 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. 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. | int (kötelező) |
| frontendPortRangeStart | 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. 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. | int (kötelező) |
| név | A névnek egyedinek kell lennie egy 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. | sztring (kötelező) |
| networkSecurityGroupRules | 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. | NetworkSecurityGroupRule[] |
| protokoll | A végpont protokollja. | "TCP" "UDP" (kötelező) |
NetworkSecurityGroupRule
| Név | Leírás | Érték |
|---|---|---|
| hozzáférés | A megadott IP-cím, alhálózati tartomány vagy címke esetében végrehajtandó művelet. | "Engedélyezés" "Megtagadás" (kötelező) |
| elsőbbség | A készleten belüli prioritásoknak egyedinek kell lenniük, és prioritás szerinti sorrendben kell értékelni. Minél alacsonyabb a szám, annál magasabb a prioritás. A szabályokat például 150, 250 és 350 sorszámmal lehet megadni. A 150-es sorszámú szabály elsőbbséget élvez a 250-es 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. | int (kötelező) |
| sourceAddressPrefix | 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. | sztring (kötelező) |
| sourcePortRanges | Az érvényes értékek a "*" (minden 0- 65535-ös port esetén) vagy portok vagy porttartományok tömbjei (pl. 100-200). A portoknak 0 és 65535 közötti tartományban kell lennie, és a porttartományok vagy portok nem fedhetik egymást. 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 *. | sztring[] |
PublicIPAddressConfiguration
| Név | Leírás | Érték |
|---|---|---|
| ipAddressIds | 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 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}. | sztring[] |
| céltartalék | Az alapértelmezett érték a BatchManaged | "BatchManaged" "NoPublicIPAddresses" "UserManaged" |
ScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| automatikus skálázás | Ez a tulajdonság és a rögzített skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | Automatikus méretezési beállítások |
| rögzített skálázás | Ez a tulajdonság és az automatikus skálázás kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. | FixedScaleSettings |
Automatikus méretezési beállítások
| Név | Leírás | Érték |
|---|---|---|
| evaluationInterval | Ha nincs megadva, az alapértelmezett érték 15 perc (PT15M). | húr |
| képlet | A készletben lévő számítási csomópontok kívánt számának képlete. | sztring (kötelező) |
FixScaleSettings
| Név | Leírás | Érték |
|---|---|---|
| nodeDeallocationOption | Ha nincs megadva, az alapértelmezett érték a Requeue lesz. | "Requeue" "RetainedData" "Feladatkiegészítés" "Leállítás" |
| resizeTimeout | Az alapértelmezett érték 15 perc. Az időtúllépési értékek ISO 8601 formátumot használnak. Használja például a PT10M-et 10 percig. 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). | húr |
| targetDedicatedNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
| targetLowPriorityNodes | A targetDedicatedNodes legalább egyikét be kell állítania a targetLowPriorityNodes értékre. | Int |
StartTask
| Név | Leírás | Érték |
|---|---|---|
| commandLine | 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. Kötelező, ha a startTask bármely más tulajdonsága meg van adva. | húr |
| containerSettings | Ha ez meg van adva, a rendszer a AZ_BATCH_NODE_ROOT_DIR alatt rekurzívan az összes könyvtárat (a csomóponton található Azure Batch-címtárak gyökerét) leképezi a tárolóba, az összes tevékenységkörnyezeti változót a tárolóba rendeli, és a feladat parancssora a tárolóban lesz végrehajtva. | TaskContainerSettings |
| environmentSettings | Az indítási tevékenység környezeti változóbeállításainak listája. | EnvironmentSetting[] |
| maxTaskRetryCount | 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 próbálja ki 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. | Int |
| resourceFiles | 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. | ResourceFile[] |
| userIdentity | Ha nincs megadva, a tevékenység nem rendszergazdai felhasználóként fut, amely egyedi a feladathoz. | UserIdentity |
| waitForSuccess | Ha igaz, és a kezdési tevékenység meghiúsul egy számítási csomóponton, a Batch szolgáltatás újrapróbálkozásokat indít el a maximális újrapróbálkozások számának (maxTaskRetryCount) értékével. 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 számítási csomópontot, és nem ütemezi a tevékenységeket. Ez a feltétel a csomópont állapotán és az ütemezési hiba részletein keresztül észlelhető. Ha hamis, a Batch szolgáltatás nem várja meg a kezdési feladat befejezését. Ebben az esetben más tevékenységek is elkezdhetik a végrehajtást a számítási csomóponton, amíg a kezdő tevékenység még fut; és még ha az indítási feladat meghiúsul is, az új tevékenységek továbbra is ütemezve lesznek a csomóponton. Az alapértelmezett érték igaz. | Bool |
TaskContainerSettings
| Név | Leírás | Érték |
|---|---|---|
| containerRunOptions | 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. | húr |
| imageName | Ez a teljes képhivatkozás, ahogyan 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. | sztring (kötelező) |
| bejegyzés | Ez a beállítás kihagyható, ha már meg lett adva a készlet létrehozásakor. | ContainerRegistry |
| workingDirectory | A tárolótevékenység munkakönyvtárának helyét jelző jelző. Az alapértelmezett érték a "taskWorkingDirectory". | "ContainerImageDefault" "TaskWorkingDirectory" |
EnvironmentSetting
| Név | Leírás | Érték |
|---|---|---|
| név | A környezeti változó neve. | sztring (kötelező) |
| érték | A környezeti változó értéke. | húr |
ResourceFile
| Név | Leírás | Érték |
|---|---|---|
| autoStorageContainerName | Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni az egyiket. | húr |
| blobPrefix | 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. | húr |
| fileMode | 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 az erőforrásfájlhoz van megadva, amely egy Windows-csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva Linux-csomóponthoz, akkor a rendszer egy alapértelmezett 0770-et alkalmaz a fájlra. | húr |
| filePath | 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). | húr |
| httpUrl | 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 Azure Blob Storage, akkor névtelen hozzáféréssel kell olvashatónak lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
| storageContainerUrl | 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 névtelen hozzáféréssel olvashatónak és listázhatónak kell lennie; vagyis a Batch szolgáltatás nem tartalmaz hitelesítő adatokat a blob letöltésekor. Az Ilyen URL-címek kétféleképpen kérhetők le egy blobhoz az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedélyeket ad a blobhoz, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez. | húr |
Felhasználóidentitás
| Név | Leírás | Érték |
|---|---|---|
| autoUser | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | AutoUserSpecification |
| userName | A userName és az autoUser tulajdonságok kölcsönösen kizárják egymást; egyet kell megadnia, de mindkettőt nem. | húr |
AutoUserSpecification
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| kiterjedés | 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 kezdési tevékenységeknek akadálymentesnek kell lenniük. | "Készlet" "Tevékenység" |
TaskSchedulingPolicy
| Név | Leírás | Érték |
|---|---|---|
| nodeFillType | Hogyan kell elosztani a feladatokat a számítási csomópontok között. | "Csomag" "Spread" (kötelező) |
UserAccount
| Név | Leírás | Érték |
|---|---|---|
| elevationLevel | nonAdmin – Az automatikus felhasználó egy normál, emelt szintű hozzáféréssel nem rendelkező felhasználó. rendszergazda – Az automatikus felhasználó emelt szintű hozzáféréssel rendelkező felhasználó, és teljes rendszergazdai engedélyekkel rendelkezik. Az alapértelmezett érték nem Admin. | "Rendszergazda" "NonAdmin" |
| linuxUserConfiguration | 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. | LinuxUserConfiguration |
| név | A felhasználói fiók neve. | sztring (kötelező) |
| jelszó | A felhasználói fiók jelszava. | sztring (kötelező) |
| windowsUserConfiguration | 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. | WindowsUserConfiguration |
LinuxUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| Gid | 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. | Int |
| sshPrivateKey | 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 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 csomópontok között (a felhasználó .ssh könyvtárának módosítása nem történik meg). | húr |
| Uid | 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. | Int |
WindowsUserConfiguration
| Név | Leírás | Érték |
|---|---|---|
| loginMode | Megadja a felhasználó bejelentkezési módját. A VirtualMachineConfiguration-készletek alapértelmezett értéke interaktív mód, a CloudServiceConfiguration-készletek esetében pedig kötegelt mód. | "Batch" "Interaktív" |