Pool - Add

Belirtilen Hesaba bir Havuz ekler.
Havuzları adlandırırken, kullanıcı adları veya gizli proje adları gibi hassas bilgileri eklemekten kaçının. Bu bilgiler, Microsoft Desteği mühendislerin erişebildiği telemetri günlüklerinde görünebilir.

POST {batchUrl}/pools?api-version=2023-11-01.18.0
POST {batchUrl}/pools?timeout={timeout}&api-version=2023-11-01.18.0

URI Parametreleri

Name İçinde Gerekli Tür Description
batchUrl
path True

string

Tüm Azure Batch hizmet isteklerinin temel URL'si.

api-version
query True

string

İstemci API Sürümü.

timeout
query

integer

int32

Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.

ocp-date

string

date-time-rfc1123

İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

İstek Gövdesi

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

Name Gerekli Tür Description
id True

string

Hesap içindeki Havuzu benzersiz olarak tanımlayan bir dize.
Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64 karakterden fazlasını içeremez. Kimlik büyük/küçük harfe duyarlı ve büyük/küçük harfe duyarlı değildir (başka bir ifadeyle, hesapta yalnızca büyük/küçük harfe göre farklılık gösteren iki Havuz Kimliğiniz olmayabilir).

vmSize True

string

Havuzdaki sanal makinelerin boyutu. Havuzdaki tüm sanal makineler aynı boyuttadır.
Cloud Services Havuzları (cloudServiceConfiguration ile oluşturulan havuzlar) için kullanılabilir sanal makine boyutları hakkında bilgi için bkz. Cloud Services boyutları (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch, ExtraSmall, A1V2 ve A2V2 dışında tüm Cloud Services VM boyutlarını destekler. Sanal Makineler Marketi'nden (virtualMachineConfiguration ile oluşturulan havuzlar) Görüntü Kullanan Havuzlar için kullanılabilir VM boyutları hakkında bilgi için bkz. Sanal Makineler Için Boyutlar (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) veya Sanal Makineler Boyutları (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch, STANDARD_A0 ve premium depolama alanı (STANDARD_GS, STANDARD_DS ve STANDARD_DSV2 serisi) olanlar dışında tüm Azure VM boyutlarını destekler.

applicationLicenses

string[]

Batch hizmetinin Havuzdaki her İşlem Düğümünde kullanıma sunacağı uygulama lisanslarının listesi.
Uygulama lisansları listesi, kullanılabilir Batch hizmeti uygulama lisanslarının bir alt kümesi olmalıdır. Desteklenmeyen bir lisans istenirse Havuz oluşturma başarısız olur.

applicationPackageReferences

ApplicationPackageReference[]

Havuzdaki her İşlem Düğümüne yüklenecek Paketlerin listesi.
Havuz oluştururken paketin uygulama kimliği tam (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}) olmalıdır. Paket başvurularındaki değişiklikler Havuza katılan tüm yeni Düğümleri etkiler, ancak yeniden başlatılana veya yeniden tasarlanana kadar Havuzda bulunan İşlem Düğümlerini etkilemez. Belirli bir Havuzda en fazla 10 Paket başvurusu vardır.

autoScaleEvaluationInterval

string

Havuz boyutunun otomatik ölçeklendirme formülüne göre otomatik olarak ayarlandığı zaman aralığı.
Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten büyük bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400 (Hatalı İstek) olur.

autoScaleFormula

string

Havuzdaki istenen İşlem Düğümü sayısı için bir formül.
enableAutoScale false olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale true olarak ayarlandıysa gereklidir. Havuz oluşturulmadan önce formül geçerliliği denetlendi. Formül geçerli değilse, Batch hizmeti ayrıntılı hata bilgileriyle isteği reddeder. Bu formülü belirtme hakkında daha fazla bilgi için bkz. 'Azure Batch Havuzundaki İşlem Düğümlerini Otomatik Olarak Ölçeklendirme' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Havuzdaki her İşlem Düğümüne yüklenecek Sertifikaların listesi.
Windows Düğümleri için Batch hizmeti Sertifikaları belirtilen Sertifika deposuna ve konumuna yükler. Linux İşlem Düğümleri için Sertifikalar Görev çalışma dizini içindeki bir dizinde depolanır ve bu konumu sorgulama görevine AZ_BATCH_CERTIFICATES_DIR bir ortam değişkeni sağlanır. 'remoteUser' görünürlüğüne sahip Sertifikalar için kullanıcının giriş dizininde bir 'certs' dizini oluşturulur (örn. /home/{user-name}/certs) ve Sertifikalar bu dizine yerleştirilir.

Uyarı: Bu özellik kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Lütfen bunun yerine Azure KeyVault Uzantısı'nı kullanın.

cloudServiceConfiguration

CloudServiceConfiguration

Havuz için bulut hizmeti yapılandırması.
Bu özellik ve virtualMachineConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir. Batch Hesabı poolAllocationMode özelliği 'UserSubscription' olarak ayarlanmış şekilde oluşturulduysa bu özellik belirtilemez.

displayName

string

Havuzun görünen adı.
Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğunda unicode karakter içerebilir.

enableAutoScale

boolean

Havuz boyutunun zaman içinde otomatik olarak ayarlanıp ayarlanmayacağı.
False ise, targetDedicatedNodes ve targetLowPriorityNodes'lardan en az biri belirtilmelidir. True ise autoScaleFormula özelliği gereklidir ve Havuz formüle göre otomatik olarak yeniden boyutlandırılır. Varsayılan değer false'tur.

enableInterNodeCommunication

boolean

Havuzun İşlem Düğümleri arasında doğrudan iletişime izin verip vermediği.
Düğümler arası iletişimin etkinleştirilmesi, Havuzun İşlem Düğümleri üzerindeki dağıtım kısıtlamaları nedeniyle Havuzun en büyük boyutunu sınırlar. Bu, Havuzun istenen boyuta ulaşmamasıyla sonuçlanabilir. Varsayılan değer false'tur.

metadata

MetadataItem[]

Havuz ile meta veri olarak ilişkili ad-değer çiftlerinin listesi.
Batch hizmeti meta veriye herhangi bir anlam atamaz; yalnızca kullanıcı kodunun kullanımına yöneliktir.

mountConfiguration

MountConfiguration[]

Havuzun tüm ömrü boyunca belirtilen dosya sistemini kullanarak depolamayı bağlayın.
Azure dosya paylaşımı, NFS, CIFS veya Blobfuse tabanlı dosya sistemini kullanarak depolamayı bağlayın.

networkConfiguration

NetworkConfiguration

Havuz için ağ yapılandırması.
Havuz için ağ yapılandırması.

resizeTimeout

string

İşlem Düğümlerinin Havuza ayrılması için zaman aşımı.
Bu zaman aşımı yalnızca el ile ölçeklendirme için geçerlidir; enableAutoScale true olarak ayarlandığında hiçbir etkisi olmaz. Varsayılan değer 15 dakikadır. En düşük değer 5 dakikadır. 5 dakikadan kısa bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

resourceTags

object

Havuzla ilişkili kullanıcı tarafından belirtilen etiketler.
Azure Batch Havuzu ile ilişkilendirilecek kullanıcı tanımlı etiketler. Belirtildiğinde, bu etiketler havuzla ilişkili yedekleme Azure kaynaklarına yayılır. Bu özellik yalnızca Batch hesabı poolAllocationMode özelliği 'UserSubscription' olarak ayarlanmış şekilde oluşturulduğunda belirtilebilir.

startTask

StartTask

Havuza katıldığında her İşlem Düğümünde çalıştırılacak şekilde belirtilen bir Görev.
Görev, İşlem Düğümü Havuza eklendiğinde veya İşlem Düğümü yeniden başlatıldığında çalışır.

targetDedicatedNodes

integer

Havuzdaki ayrılmış İşlem Düğümlerinin istenen sayısı.
enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.

targetLowPriorityNodes

integer

Havuzdaki spot/düşük öncelikli işlem düğümlerinin istenen sayısı.
enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.

targetNodeCommunicationMode

NodeCommunicationMode

Havuz için istenen düğüm iletişim modu.
Atlanırsa varsayılan değer Varsayılan'dır.

taskSchedulingPolicy

TaskSchedulingPolicy

Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı.
Belirtilmezse varsayılan değer yayılır.

taskSlotsPerNode

integer

Havuzdaki tek bir işlem düğümünde eşzamanlı görevleri çalıştırmak için kullanılabilecek görev yuvalarının sayısı.
Varsayılan değer 1’dir. Maksimum değer, havuzun vmSize veya 256 çekirdek sayısının 4 katı kadar küçüktür.

userAccounts

UserAccount[]

Havuzdaki her İşlem Düğümünde oluşturulacak kullanıcı Hesaplarının listesi.

virtualMachineConfiguration

VirtualMachineConfiguration

Havuz için sanal makine yapılandırması.
Bu özellik ve cloudServiceConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir.

Yanıtlar

Name Tür Description
201 Created

Batch hizmetine yapılan istek başarılı oldu.

Headers

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

BatchError

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

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

Scopes

Name Description
user_impersonation Kullanıcı hesabınızın kimliğine bürünme

Authorization

Type: apiKey
In: header

Örnekler

Add a CloudServiceConfiguration pool
Add a pool with accelerated networking
Add a pool with mount drive specified
Add a pool with SecurityProfile
Add a simple pool with resourceTags
Add a VirtualMachineConfiguration pool
Add a VirtualMachineConfiguration pool with containers
Add a VirtualMachineConfiguration pool with extensions
Add a VirtualMachineConfiguration pool with OS disk
Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Add a CloudServiceConfiguration pool

Sample Request

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



{
  "id": "poolId",
  "vmSize": "small",
  "cloudServiceConfiguration": {
    "osFamily": "4"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a pool with accelerated networking

Sample Request

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



{
  "id": "mypool01",
  "vmSize": "Standard_D1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2,
  "networkConfiguration": {
    "enableAcceleratedNetworking": true
  }
}

Sample Response

Add a pool with mount drive specified

Sample Request

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


{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "mountConfiguration": [
    {
      "azureBlobFileSystemConfiguration": {
        "accountName": "accountName",
        "containerName": "blobContainerName",
        "accountKey": "accountKey",
        "relativeMountPath": "bfusepath"
      }
    },
    {
      "azureFileShareConfiguration": {
        "accountName": "accountName",
        "azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
        "accountKey": "accountKey",
        "relativeMountPath": "filesharepath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "nfsMountConfiguration": {
        "source": "somesource nfs url",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "cifsMountConfiguration": {
        "username": "accountName",
        "password": "password",
        "source": "//myaccount.file.core.windows.net/file",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    }
  ],
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a pool with SecurityProfile

Sample Request

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



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04",
    "securityProfile": {
      "securityType": "trustedLaunch",
      "encryptionAtHost": true,
      "uefiSettings": {
        "secureBootEnabled": false
      }
    }
  },
  "targetDedicatedNodes": 1
}

Sample Response

Add a simple pool with resourceTags

Sample Request

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



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04"
  },
  "targetDedicatedNodes": 1,
  "resourceTags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

Sample Response

Add a VirtualMachineConfiguration pool

Sample Request

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Add a VirtualMachineConfiguration pool with containers

Sample Request

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "120_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "containerConfiguration": {
      "type": "dockerCompatible",
      "containerImageNames": [
        "busybox"
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with extensions

Sample Request

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "extensions": [
      {
        "name": "batchextension1",
        "type": "KeyVaultForLinux",
        "publisher": "Microsoft.Azure.KeyVault",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
      }
    ]
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ],
  "targetNodeCommunicationMode": "simplified"
}

Sample Response

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

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



{
  "id": "mypool001",
  "vmSize": "standard_d2s_v3",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "osDisk": {
      "diskSizeGB": 100,
      "managedDisk": {
        "storageAccountType": "standardssd_lrs"
      },
      "caching": "readwrite",
      "ephemeralOSDiskSettings": {
        "placement": "CacheDisk"
      }
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 1,
  "enableAutoScale": false
}

Sample Response

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

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



{
  "id": "mypool002",
  "vmSize": "Standard_A1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "windowsConfiguration": {
      "enableAutomaticUpdates": false
    },
    "serviceArtifactReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2
}

Sample Response

Tanımlar

Name Description
ApplicationPackageReference

İşlem Düğümlerine dağıtılacak bir Pakete başvuru.

AutoUserScope

Otomatik kullanıcının kapsamı

AutoUserSpecification

Batch hizmetinde görev çalıştıran otomatik kullanıcının parametrelerini belirtir.

AzureBlobFileSystemConfiguration

Blobfuse kullanarak Azure Depolama Kapsayıcısına bağlanmak için kullanılan bilgiler.

AzureFileShareConfiguration

Azure Fileshare'e bağlanmak için kullanılan bilgiler.

BatchError

Azure Batch hizmetinden alınan bir hata yanıtı.

BatchErrorDetail

Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.

CachingType

Disk için etkinleştirileceği önbelleğe alma türü.

CertificateReference

Havuzdaki İşlem Düğümlerine yüklenecek sertifika başvurusu.

CertificateStoreLocation

İşlem Düğümünde Sertifika deposunun sertifikanın yükleneceği konum.

CertificateVisibility

İşlem Düğümündeki hangi kullanıcı hesaplarının Sertifikanın özel verilerine erişimi olmalıdır.

CIFSMountConfiguration

CIFS dosya sistemine bağlanmak için kullanılan bilgiler.

CloudServiceConfiguration

Azure Cloud Services platformunu temel alan bir Havuzdaki İşlem Düğümleri yapılandırması.

ComputeNodeFillType

Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı.

ComputeNodeIdentityReference

İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

ContainerConfiguration

Kapsayıcı özellikli Havuzlar için yapılandırma.

ContainerRegistry

Özel bir kapsayıcı kayıt defteri.

ContainerType

Kullanılacak kapsayıcı teknolojisi.

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.

DataDisk

Havuzdaki İşlem Düğümleriyle ilişkili veri diskleri tarafından kullanılacak ayarlar. Ekli veri disklerini kullanırken, diskleri kullanmak için vm'nin içinden bağlamanız ve biçimlendirmeniz gerekir.

DiffDiskPlacement

Havuzdaki tüm işlem düğümleri (VM) için işletim sistemi diskinin kısa ömürlü disk yerleşimini belirtir.

DiffDiskSettings

İşlem düğümü (VM) tarafından kullanılan işletim sistemi diski için kısa ömürlü Disk Ayarlarını belirtir.

DiskEncryptionConfiguration

Havuzdaki işlem düğümlerine uygulanan disk şifreleme yapılandırması. Azure İşlem Galerisi Görüntüsü ile oluşturulan Linux havuzunda disk şifreleme yapılandırması desteklenmez.

DiskEncryptionTarget

Batch Hizmeti'nin işlem düğümünde şifreleeceği disk hedefleri listesi.

DynamicVNetAssignmentScope

Dinamik sanal ağ atamasının kapsamı.

ElevationLevel

Kullanıcının yükseltme düzeyi.

EnvironmentSetting

Görev işleminde ayarlanacak ortam değişkeni.

ErrorMessage

Azure Batch hata yanıtında alınan bir hata iletisi.

ImageReference

Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntü başvurularının listesini almak için bkz. 'Desteklenen Görüntüleri Listeleme' işlemi.

InboundEndpointProtocol

Uç noktanın protokolü.

InboundNATPool

Bir Batch Havuzundaki İşlem Düğümlerindeki belirli bağlantı noktalarını harici olarak ele almak için kullanılabilecek bir gelen NAT Havuzu.

IPAddressProvisioningType

Havuz için Genel IP Adresleri için sağlama türü.

LinuxUserConfiguration

Linux İşlem Düğümünde kullanıcı hesabı oluşturmak için kullanılan özellikler.

LoginMode

Kullanıcının oturum açma modu

ManagedDisk
MetadataItem

Batch hizmeti kaynağıyla ilişkilendirilmiş bir ad-değer çifti.

MountConfiguration

Her düğüme bağlanacak dosya sistemi.

NetworkConfiguration

Havuz için ağ yapılandırması.

NetworkSecurityGroupRule

Gelen uç noktaya uygulanacak bir ağ güvenlik grubu kuralı.

NetworkSecurityGroupRuleAccess

Belirtilen IP adresi, alt ağ aralığı veya etiketi için yapılması gereken eylem.

NFSMountConfiguration

Bir NFS dosya sistemine bağlanmak için kullanılan bilgiler.

NodeCommunicationMode

Bir havuzun Batch hizmetiyle nasıl iletişim kurdığını belirler.

NodePlacementConfiguration

Havuz için düğüm yerleştirme yapılandırması.

NodePlacementPolicyType

Havuzdaki düğümleri ayırmaya yönelik yerleştirme ilkesi.

OSDisk

İşlem düğümünün (VM) işletim sistemi diskinin ayarları.

PoolAddParameter

Eklenecek Azure Batch hizmetinde bir Havuz.

PoolEndpointConfiguration

Havuz için uç nokta yapılandırması.

PublicIPAddressConfiguration

Havuzun ağ yapılandırmasının genel IP Adresi yapılandırması.

ResourceFile

İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.

SecurityProfile

Sanal makine veya sanal makine ölçek kümesi için güvenlik profili ayarlarını belirtir.

SecurityTypes

Sanal makinenin SecurityType değerini belirtir. UefiSettings'i etkinleştirmek için belirtilen herhangi bir değere ayarlanması gerekir.

ServiceArtifactReference

'En son' görüntü sürümü kullanılırken ölçek kümesindeki tüm sanal makineler için aynı görüntü sürümünü ayarlamak için kullanılan hizmet yapıtı başvuru kimliğini belirtir.

StartTask

Düğüm Azure Batch hizmetindeki bir Havuza katıldığında veya İşlem Düğümü yeniden başlatıldığında veya yeniden oluşturulduğunda çalıştırılan görev.

StorageAccountType

Veri diskleri veya işletim sistemi diski oluştururken kullanılacak depolama Hesabı türü.

TaskContainerSettings

Görevin kapsayıcı ayarları.

TaskSchedulingPolicy

Görevlerin İşlem Düğümleri arasında nasıl dağıtılması gerektiğini belirtir.

UefiSettings

Sanal makineyi oluştururken kullanılan güvenli önyükleme ve vTPM gibi güvenlik ayarlarını belirtir.

UserAccount

Azure Batch İşlem Düğümünde Görevleri yürütmek için kullanılan bir kullanıcı oluşturmak için kullanılan özellikler.

UserIdentity

Görevin altında çalıştırıldığı kullanıcı kimliğinin tanımı.

VirtualMachineConfiguration

Azure Sanal Makineler altyapısını temel alan bir Havuzdaki İşlem Düğümleri yapılandırması.

VMExtension

Sanal makine uzantıları için yapılandırma.

WindowsConfiguration

Sanal makineye uygulanacak Windows işletim sistemi ayarları.

WindowsUserConfiguration

Bir Windows İşlem Düğümünde kullanıcı Hesabı oluşturmak için kullanılan özellikler.

ApplicationPackageReference

İşlem Düğümlerine dağıtılacak bir Pakete başvuru.

Name Tür Description
applicationId

string

Dağıtılacak uygulamanın kimliği.
Havuz oluştururken paketin uygulama kimliği tam olmalıdır (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

Dağıtılacak uygulamanın sürümü. Atlanırsa, varsayılan sürüm dağıtılır.
Bu bir Havuzda atlanırsa ve bu uygulama için varsayılan sürüm belirtilmezse, istek InvalidApplicationPackageReferences hata kodu ve HTTP durum kodu 409 ile başarısız olur. Bu bir Görevde atlanırsa ve bu uygulama için varsayılan sürüm belirtilmezse, Görev ön işleme hatasıyla başarısız olur.

AutoUserScope

Otomatik kullanıcının kapsamı

Name Tür Description
pool

string

Görevin, havuzdaki her İşlem Düğümünde oluşturulan ortak otomatik kullanıcı hesabı olarak çalıştırıldığını belirtir.

task

string

Hizmetin Görev için yeni bir kullanıcı oluşturması gerektiğini belirtir.

AutoUserSpecification

Batch hizmetinde görev çalıştıran otomatik kullanıcının parametrelerini belirtir.

Name Tür Description
elevationLevel

ElevationLevel

Otomatik kullanıcının yükseltme düzeyi.
Varsayılan değer nonAdmin'dir.

scope

AutoUserScope

Otomatik kullanıcının kapsamı
Varsayılan değer havuzdur. Havuz Windows çalıştırıyorsa, görevler arasında daha sıkı yalıtım gerekiyorsa Görev değeri belirtilmelidir. Örneğin, görev kayıt defterini diğer görevleri etkileyebilecek bir şekilde sessize alırsa veya havuzda normal görevler tarafından erişilemeyen ancak StartTasks tarafından erişilebilir olması gereken sertifikalar belirtilmişse.

AzureBlobFileSystemConfiguration

Blobfuse kullanarak Azure Depolama Kapsayıcısına bağlanmak için kullanılan bilgiler.

Name Tür Description
accountKey

string

Azure Depolama Hesabı anahtarı.
Bu özellik hem sasKey hem de identity ile birbirini dışlar; tam olarak bir belirtilmelidir.

accountName

string

Azure Depolama Hesabı adı.

blobfuseOptions

string

Bağlama komutuna geçirmek için ek komut satırı seçenekleri.
Bunlar Windows'daki 'net use' seçenekleri ve Linux'ta 'bağlama' seçenekleridir.

containerName

string

Azure Blob Depolama Kapsayıcısı adı.

identityReference

ComputeNodeIdentityReference

containerName'e erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru
Bu özellik hem accountKey hem de sasKey ile birbirini dışlar; tam olarak bir belirtilmelidir.

relativeMountPath

string

Dosya sisteminin bağlanacağı işlem düğümündeki göreli yol
Tüm dosya sistemleri, AZ_BATCH_NODE_MOUNTS_DIR ortam değişkeni aracılığıyla erişilebilen Batch bağlamaları dizinine göre bağlanır.

sasKey

string

Azure Depolama SAS belirteci.
Bu özellik hem accountKey hem de identity ile birbirini dışlar; tam olarak bir belirtilmelidir.

AzureFileShareConfiguration

Azure Fileshare'e bağlanmak için kullanılan bilgiler.

Name Tür Description
accountKey

string

Azure Depolama hesabı anahtarı.

accountName

string

Azure Depolama hesabı adı.

azureFileUrl

string

Azure Dosyalar URL'si.
Bu , 'https://{account}.file.core.windows.net/' biçimindedir.

mountOptions

string

Bağlama komutuna geçirmek için ek komut satırı seçenekleri.
Bunlar Windows'daki 'net use' seçenekleri ve Linux'ta 'bağlama' seçenekleridir.

relativeMountPath

string

Dosya sisteminin bağlanacağı işlem düğümündeki göreli yol
Tüm dosya sistemleri, AZ_BATCH_NODE_MOUNTS_DIR ortam değişkeni aracılığıyla erişilebilen Batch bağlamaları dizinine göre bağlanır.

BatchError

Azure Batch hizmetinden alınan bir hata yanıtı.

Name Tür Description
code

string

Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.

message

ErrorMessage

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

values

BatchErrorDetail[]

Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.

Name Tür Description
key

string

Value özelliğinin anlamını belirten tanımlayıcı.

value

string

Hata yanıtına eklenen ek bilgiler.

CachingType

Disk için etkinleştirileceği önbelleğe alma türü.

Name Tür Description
none

string

Disk için önbelleğe alma modu etkinleştirilmedi.

readonly

string

Diskin önbelleğe alma modu salt okunurdur.

readwrite

string

Diskin önbelleğe alma modu okunur ve yazılır.

CertificateReference

Havuzdaki İşlem Düğümlerine yüklenecek sertifika başvurusu.

Name Tür Description
storeLocation

CertificateStoreLocation

İşlem Düğümünde Sertifika deposunun sertifikanın yükleneceği konum.
Varsayılan değer currentuser'dır. Bu özellik yalnızca Windows İşlem Düğümleri ile yapılandırılmış havuzlar için geçerlidir (cloudServiceConfiguration ile veya bir Windows Görüntüsü başvurusu kullanılarak virtualMachineConfiguration ile oluşturulur). Linux İşlem Düğümleri için Sertifikalar Görev çalışma dizini içindeki bir dizinde depolanır ve bu konumu sorgulamak üzere Göreve bir ortam değişkeni AZ_BATCH_CERTIFICATES_DIR sağlanır. 'remoteUser' görünürlüğüne sahip sertifikalar için, kullanıcının giriş dizininde bir 'certs' dizini oluşturulur (ör. /home/{user-name}/certs) ve Sertifikalar bu dizine yerleştirilir.

storeName

string

Sertifikanın yükleneceği İşlem Düğümündeki Sertifika deposunun adı.
Bu özellik yalnızca Windows İşlem Düğümleri ile yapılandırılmış havuzlar için geçerlidir (cloudServiceConfiguration ile veya bir Windows Görüntüsü başvurusu kullanılarak virtualMachineConfiguration ile oluşturulur). Yaygın depo adları şunlardır: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ancak herhangi bir özel depo adı da kullanılabilir. Varsayılan değer My değeridir.

thumbprint

string

Sertifikanın parmak izi.

thumbprintAlgorithm

string

Parmak izinin ilişkilendirildiği algoritma. Bu sha1 olmalı.

visibility

CertificateVisibility[]

İşlem Düğümündeki hangi kullanıcı hesaplarının Sertifikanın özel verilerine erişimi olmalıdır.
Bu koleksiyonda birden fazla görünürlük belirtebilirsiniz. Varsayılan değer tüm Hesaplar'dır.

CertificateStoreLocation

İşlem Düğümünde Sertifika deposunun sertifikanın yükleneceği konum.

Name Tür Description
currentuser

string

Sertifikaların CurrentUser Sertifika deposuna yüklenmesi gerekir.

localmachine

string

Sertifikalar LocalMachine Sertifika deposuna yüklenmelidir.

CertificateVisibility

İşlem Düğümündeki hangi kullanıcı hesaplarının Sertifikanın özel verilerine erişimi olmalıdır.

Name Tür Description
remoteuser

string

Sertifika, kullanıcıların İşlem Düğümü'ne uzaktan erişecekleri kullanıcı hesaplarına görünür olmalıdır.

starttask

string

Sertifika, StartTask'ın altında çalıştırıldığı kullanıcı hesabına görünür olmalıdır. AutoUser Kapsamı hem StartTask hem de Görev için Pool ise, bu sertifikanın Görev tarafından da görüleceğini unutmayın.

task

string

Sertifika, altında İş Görevlerinin çalıştırıldığı kullanıcı hesaplarına görünür olmalıdır.

CIFSMountConfiguration

CIFS dosya sistemine bağlanmak için kullanılan bilgiler.

Name Tür Description
mountOptions

string

Bağlama komutuna geçirmek için ek komut satırı seçenekleri.
Bunlar Windows'daki 'net use' seçenekleri ve Linux'ta 'bağlama' seçenekleridir.

password

string

CIFS dosya sisteminde kimlik doğrulaması için kullanılacak parola.

relativeMountPath

string

Dosya sisteminin bağlanacağı işlem düğümündeki göreli yol
Tüm dosya sistemleri, AZ_BATCH_NODE_MOUNTS_DIR ortam değişkeni aracılığıyla erişilebilen Batch bağlamaları dizinine göre bağlanır.

source

string

Bağlanacak dosya sisteminin URI'si.

username

string

CIFS dosya sisteminde kimlik doğrulaması için kullanılacak kullanıcı.

CloudServiceConfiguration

Azure Cloud Services platformunu temel alan bir Havuzdaki İşlem Düğümleri yapılandırması.

Name Tür Description
osFamily

string

Havuzdaki sanal makinelere yüklenecek Azure Konuk İşletim Sistemi ailesi.
Olası değerler şunlardır: 2 - İşletim Sistemi Ailesi 2, Windows Server 2008 R2 SP1'e eşdeğerdir. 3 - Windows Server 2012 eşdeğer olan İs Ailesi 3. 4 - Windows Server 2012 R2'ye eşdeğer İs Ailesi 4. 5 - Windows Server 2016 eşdeğer olan İs Ailesi 5. 6 - İşletim Sistemi Ailesi 6, Windows Server 2019'a eşdeğerdir. Daha fazla bilgi için bkz. Azure Konuk İşletim Sistemi Sürümleri (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

osVersion

string

Havuzdaki sanal makinelere yüklenecek Azure Konuk İşletim Sistemi sürümü.
Varsayılan değer, belirtilen işletim sistemi ailesi için en son işletim sistemi sürümünü belirten * değeridir.

ComputeNodeFillType

Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı.

Name Tür Description
pack

string

Herhangi bir Görev Havuzdaki bir sonraki İşlem Düğümüne atanmadan önce havuzdaki her İşlem Düğümüne mümkün olduğunca çok Görev (taskSlotsPerNode) atanmalıdır.

spread

string

Görevler Havuzdaki tüm İşlem Düğümlerine eşit olarak atanmalıdır.

ComputeNodeIdentityReference

İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

Name Tür Description
resourceId

string

Kullanıcı tarafından atanan kimliğin ARM kaynak kimliği.

ContainerConfiguration

Kapsayıcı özellikli Havuzlar için yapılandırma.

Name Tür Description
containerImageNames

string[]

Kapsayıcı Görüntüsü adları koleksiyonu.
Bu, "docker pull" için belirtildiği gibi tam Görüntü başvurusudur. Görüntü, alternatif bir kayıt defteriyle tam olarak nitelemediği sürece varsayılan Docker kayıt defterinden kaynaklanır.

containerRegistries

ContainerRegistry[]

Kapsayıcıların çekilebileceği ek özel kayıt defterleri.
Kimlik bilgileri gerektiren özel bir kayıt defterinden herhangi bir Görüntü indirilmesi gerekiyorsa, bu kimlik bilgileri burada sağlanmalıdır.

type

ContainerType

Kullanılacak kapsayıcı teknolojisi.

ContainerRegistry

Özel bir kapsayıcı kayıt defteri.

Name Tür Description
identityReference

ComputeNodeIdentityReference

Kullanıcı adı ve parola yerine bir Azure Container Registry erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru.
İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkilendirilmiş kullanıcı tarafından atanan kimliğe başvuru.

password

string

Kayıt defteri sunucusunda oturum açma parolası.

registryServer

string

Kayıt defteri URL'si.
Atlanırsa, varsayılan değer "docker.io"dır.

username

string

Kayıt defteri sunucusunda oturum açmak için kullanıcı adı.

ContainerType

Kullanılacak kapsayıcı teknolojisi.

Name Tür Description
criCompatible

string

Kapsayıcıları başlatmak için CRI tabanlı bir teknoloji kullanılacaktır.

dockerCompatible

string

Kapsayıcıları başlatmak için Docker uyumlu bir kapsayıcı teknolojisi kullanılacaktır.

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.

Name Tür Description
containerImageDefault

string

Kapsayıcı görüntüsünde tanımlanan çalışma dizinini kullanın. Bu dizinin Batch tarafından indirilen Kaynak Dosyalarını içermeyeceğini dikkate alın.

taskWorkingDirectory

string

Batch tarafından doldurulan Görev Kaynak Dosyalarını içeren standart Batch hizmeti Görev çalışma dizinini kullanın.

DataDisk

Havuzdaki İşlem Düğümleriyle ilişkili veri diskleri tarafından kullanılacak ayarlar. Ekli veri disklerini kullanırken, diskleri kullanmak için vm'nin içinden bağlamanız ve biçimlendirmeniz gerekir.

Name Tür Description
caching

CachingType

Veri diskleri için etkinleştirilecek önbelleğe alma türü.
Önbelleğe alma için varsayılan değer readwrite'dir. Önbelleğe alma seçenekleri hakkında daha fazla bilgi için bkz. https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Gigabayt cinsinden ilk disk boyutu.

lun

integer

Mantıksal birim numarası.
Lun, her veri diskini benzersiz olarak tanımlamak için kullanılır. Birden çok disk ekliyse, her biri ayrı bir lun içermelidir. Değer 0 ile 63 (dahil) arasında olmalıdır.

storageAccountType

StorageAccountType

Veri diski için kullanılacak depolama Hesabı türü.
Atlanırsa, varsayılan değer "standard_lrs"dir.

DiffDiskPlacement

Havuzdaki tüm işlem düğümleri (VM) için işletim sistemi diskinin kısa ömürlü disk yerleşimini belirtir.

Name Tür Description
CacheDisk

string

Kısa Ömürlü İşletim Sistemi Diski VM önbelleğinde depolanır.

DiffDiskSettings

İşlem düğümü (VM) tarafından kullanılan işletim sistemi diski için kısa ömürlü Disk Ayarlarını belirtir.

Name Tür Description
placement

DiffDiskPlacement

Havuzdaki tüm VM'ler için işletim sistemi diskinin kısa ömürlü disk yerleşimini belirtir.
Bu özellik, istekteki kullanıcı tarafından kısa ömürlü işletim sistemi diski sağlama için önbellek disk alanı gibi bir konum seçmek için kullanılabilir. Kısa ömürlü işletim sistemi disk boyutu gereksinimleri hakkında daha fazla bilgi için, adresinde ve Linux https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirementsVM'leri https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements için kısa ömürlü işletim sistemi disk boyutu gereksinimlerine bakın.

DiskEncryptionConfiguration

Havuzdaki işlem düğümlerine uygulanan disk şifreleme yapılandırması. Azure İşlem Galerisi Görüntüsü ile oluşturulan Linux havuzunda disk şifreleme yapılandırması desteklenmez.

Name Tür Description
targets

DiskEncryptionTarget[]

Batch Hizmeti'nin işlem düğümünde şifreleeceği disk hedefleri listesi.
Atlanırsa, havuzdaki işlem düğümlerindeki diskler şifrelenmez. Linux havuzunda yalnızca "TemporaryDisk" desteklenir; Windows havuzunda "OsDisk" ve "TemporaryDisk" belirtilmelidir.

DiskEncryptionTarget

Batch Hizmeti'nin işlem düğümünde şifreleeceği disk hedefleri listesi.

Name Tür Description
osdisk

string

İşlem düğümündeki işletim sistemi diski şifrelenir.

temporarydisk

string

İşlem düğümündeki geçici disk şifrelenir. Linux'ta bu şifreleme, şifreleme önyükleme zamanında gerçekleştiğinde diğer bölümler (bağlı veri disklerindekiler gibi) için geçerlidir.

DynamicVNetAssignmentScope

Dinamik sanal ağ atamasının kapsamı.

Name Tür Description
job

string

Dinamik sanal ağ ataması iş başına yapılır.

none

string

Hiçbir dinamik sanal ağ ataması etkinleştirilmedi.

ElevationLevel

Kullanıcının yükseltme düzeyi.

Name Tür Description
admin

string

Kullanıcı, yükseltilmiş erişimi olan bir kullanıcıdır ve tam Yönetici izinleriyle çalışır.

nonadmin

string

Kullanıcı, yükseltilmiş erişimi olmayan standart bir kullanıcıdır.

EnvironmentSetting

Görev işleminde ayarlanacak ortam değişkeni.

Name Tür Description
name

string

Ortam değişkeninin adı.

value

string

Ortam değişkeninin değeri.

ErrorMessage

Azure Batch hata yanıtında alınan bir hata iletisi.

Name Tür Description
lang

string

Hata iletisinin dil kodu

value

string

İletinin metni.

ImageReference

Azure Sanal Makineler Market Görüntüsüne veya Azure İşlem Galerisi Görüntüsüne başvuru. Azure Batch tarafından doğrulanan tüm Azure Market Görüntü başvurularının listesini almak için bkz. 'Desteklenen Görüntüleri Listeleme' işlemi.

Name Tür Description
exactVersion

string

Düğümü oluşturmak için kullanılan platform görüntüsünün veya market görüntüsünün belirli sürümü. Bu salt okunur alan yalnızca havuz oluşturulurken 'version' için belirtilen değer 'en son' olduğunda 'sürüm'den farklıdır.

offer

string

Azure Sanal Makineler Market Görüntüsünün teklif türü.
Örneğin, UbuntuServer veya WindowsServer.

publisher

string

Azure Sanal Makineler Market Görüntüsünün yayımcısı.
Örneğin, Canonical veya MicrosoftWindowsServer.

sku

string

Azure Sanal Makineler Market Görüntüsünün SKU'su.
Örneğin, 18.04-LTS veya 2019-Datacenter.

version

string

Azure Sanal Makineler Market Görüntüsünün sürümü.
Görüntünün en son sürümünü seçmek için 'en son' değeri belirtilebilir. Atlanırsa, varsayılan değer 'en son' olur.

virtualMachineImageId

string

Azure İşlem Galerisi Görüntüsünün ARM kaynak tanımlayıcısı. Havuzdaki İşlem Düğümleri bu Görüntü Kimliği kullanılarak oluşturulur. Bu, her zaman en son görüntü sürümünü varsayılan olarak kullanmak için /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} veya /subscriptions/{subscriptionId}/resourceGroup}/providers/Microsoft.Compute/galleryName}/images/{imageDefinitionName} biçimindedir.
Bu özellik diğer ImageReference özellikleriyle birbirini dışlar. Azure İşlem Galerisi Görüntüsü'nün çoğaltmaları aynı bölgede olmalı ve Azure Batch hesabıyla aynı abonelikte olmalıdır. Görüntü sürümü imageId içinde belirtilmezse en son sürüm kullanılır. Batch İşlem Düğümü aracısının Batch hizmetiyle iletişim kurması için güvenlik duvarı ayarları hakkında bilgi için bkz https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. .

InboundEndpointProtocol

Uç noktanın protokolü.

Name Tür Description
tcp

string

Uç nokta için TCP kullanın.

udp

string

Uç nokta için UDP kullanın.

InboundNATPool

Bir Batch Havuzundaki İşlem Düğümlerindeki belirli bağlantı noktalarını harici olarak ele almak için kullanılabilecek bir gelen NAT Havuzu.

Name Tür Description
backendPort

integer

İşlem Düğümündeki bağlantı noktası numarası.
Bu, batch havuzu içinde benzersiz olmalıdır. Kabul edilebilir değerler 22, 3389, 29876 ve 29877 hariç 1 ile 65535 arasındadır. Ayrılmış değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

frontendPortRangeEnd

integer

Tek tek İşlem Düğümlerinde arka uçPort'a gelen erişim sağlamak için kullanılacak dış bağlantı noktaları aralığındaki son bağlantı noktası numarası.
Batch hizmeti tarafından ayrılan 50000 ile 55000 arasındaki bağlantı noktaları dışında kabul edilebilir değerler 1 ile 65534 arasında değişir. Havuz içindeki tüm aralıklar ayrı olmalı ve çakışmamalıdır. Her aralık en az 40 bağlantı noktası içermelidir. Ayrılmış veya çakışan değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

frontendPortRangeStart

integer

Tek tek İşlem Düğümlerinde arka uçPort'a gelen erişim sağlamak için kullanılacak dış bağlantı noktaları aralığındaki ilk bağlantı noktası numarası.
Kabul edilebilir değerler, ayrılmış olan 50000 ile 55000 arasındaki bağlantı noktaları dışında 1 ile 65534 arasında değişir. Havuz içindeki tüm aralıklar ayrı olmalı ve çakışmamalıdır. Her aralık en az 40 bağlantı noktası içermelidir. Ayrılmış veya çakışan değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

name

string

Uç noktanın adı.
Ad bir Batch Havuzu içinde benzersiz olmalıdır; harf, sayı, alt çizgi, nokta ve kısa çizgi içerebilir. Adlar bir harf veya sayı ile başlamalı, harf, sayı veya alt çizgiyle bitmelidir ve 77 karakteri aşamaz. Geçersiz değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Uç noktaya uygulanacak ağ güvenlik grubu kurallarının listesi.
Batch Havuzundaki tüm uç noktalarda belirtilebilen kural sayısı üst sınırı 25'tir. Hiçbir ağ güvenlik grubu kuralı belirtilmezse, belirtilen arka uçPort'a gelen erişime izin vermek için varsayılan bir kural oluşturulur. Ağ güvenlik grubu kuralı sayısı üst sınırı aşılırsa istek HTTP durum kodu 400 ile başarısız olur.

protocol

InboundEndpointProtocol

Uç noktanın protokolü.

IPAddressProvisioningType

Havuz için Genel IP Adresleri için sağlama türü.

Name Tür Description
batchmanaged

string

Batch tarafından bir genel IP oluşturulur ve yönetilir. Havuzun boyutuna bağlı olarak birden çok genel IP olabilir.

nopublicipaddresses

string

Genel IP Adresi oluşturulmaz.

usermanaged

string

Genel IP'ler kullanıcı tarafından sağlanır ve İşlem Düğümlerini sağlamak için kullanılır.

LinuxUserConfiguration

Linux İşlem Düğümünde kullanıcı hesabı oluşturmak için kullanılan özellikler.

Name Tür Description
gid

integer

Kullanıcı Hesabının grup kimliği.
Uid ve gid özellikleri birlikte belirtilmeli veya hiç belirtilmemelidir. Belirtilmezse, temel işletim sistemi gid'i seçer.

sshPrivateKey

string

Kullanıcı Hesabı için SSH özel anahtarı.
Özel anahtar parola korumalı olmamalıdır. Özel anahtar, Havuzun enableInterNodeCommunication özelliği true olduğunda linux havuzundaki İşlem Düğümleri arasında SSH için asimetrik anahtar tabanlı kimlik doğrulamasını otomatik olarak yapılandırmak için kullanılır (enableInterNodeCommunication yanlışsa yoksayılır). Bunu yapmak için anahtar çiftini kullanıcının .ssh dizinine yerleştirir. Belirtilmezse, İşlem Düğümleri arasında parolasız SSH yapılandırılmaz (kullanıcının .ssh dizininde değişiklik yapılmaz).

uid

integer

Kullanıcı Hesabının kullanıcı kimliği.
Uid ve gid özellikleri birlikte belirtilmeli veya hiç belirtilmemelidir. Belirtilmezse, temel işletim sistemi uid'yi seçer.

LoginMode

Kullanıcının oturum açma modu

Name Tür Description
batch

string

win32 oturum açma modunu LOGON32_LOGON_BATCH. Uzun süre çalışan paralel işlemler için toplu oturum açma modu önerilir.

interactive

string

win32 oturum açma modunu LOGON32_LOGON_INTERACTIVE. UAC, Windows VirtualMachineConfiguration Havuzlarında etkindir. Bu seçenek Bir Windows VirtualMachineConfiguration Havuzunda yükseltilmiş bir kullanıcı kimliğiyle kullanılıyorsa, Görev komut satırı tarafından yürütülen uygulama her zaman yönetim ayrıcalığı gerektirecek veya her zaman en yüksek ayrıcalık gerektirecek şekilde yapılandırılmadığı sürece kullanıcı oturumu yükseltilmeyecektir.

ManagedDisk

Name Tür Description
storageAccountType

StorageAccountType

Yönetilen disk için depolama hesabı türü.

MetadataItem

Batch hizmeti kaynağıyla ilişkilendirilmiş bir ad-değer çifti.

Name Tür Description
name

string

Meta veri öğesinin adı.

value

string

Meta veri öğesinin değeri.

MountConfiguration

Her düğüme bağlanacak dosya sistemi.

Name Tür Description
azureBlobFileSystemConfiguration

AzureBlobFileSystemConfiguration

Her düğümde blob FUSE kullanılarak bağlanacak Azure Depolama Kapsayıcısı.
Bu özellik diğer tüm özelliklerle birbirini dışlar.

azureFileShareConfiguration

AzureFileShareConfiguration

Her düğüme bağlanacak Azure Dosya Paylaşımı.
Bu özellik diğer tüm özelliklerle birbirini dışlar.

cifsMountConfiguration

CIFSMountConfiguration

Her düğüme bağlanacak CIFS/SMB dosya sistemi.
Bu özellik diğer tüm özelliklerle birbirini dışlar.

nfsMountConfiguration

NFSMountConfiguration

Her düğüme bağlanacak NFS dosya sistemi.
Bu özellik diğer tüm özelliklerle birbirini dışlar.

NetworkConfiguration

Havuz için ağ yapılandırması.

Name Tür Description
dynamicVNetAssignmentScope

DynamicVNetAssignmentScope

Dinamik sanal ağ atamasının kapsamı.

enableAcceleratedNetworking

boolean

Bu havuzun hızlandırılmış ağı etkinleştirmesi gerekip gerekmediği.
Hızlandırılmış ağ, vm için tek kök G/Ç sanallaştırmasını (SR-IOV) etkinleştirir ve bu da ağ performansının iyileştirilmesine neden olabilir. Diğer ayrıntılar için bkz: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

PoolEndpointConfiguration

Batch Havuzundaki İşlem Düğümlerindeki uç noktalar için yapılandırma.
Havuz uç noktası yapılandırması yalnızca virtualMachineConfiguration özelliğine sahip havuzlarda desteklenir.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Batch Havuzundaki İşlem Düğümleri için Genel IPAddress yapılandırması.
Genel IP yapılandırma özelliği yalnızca virtualMachineConfiguration özelliğine sahip havuzlarda desteklenir.

subnetId

string

Havuzun İşlem Düğümlerinin katılacağı sanal ağ alt ağının ARM kaynak tanımlayıcısı. Bu , /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet} biçimindedir.
Sanal ağ, Azure Batch Hesabı ile aynı bölgede ve abonelikte olmalıdır. Belirtilen alt ağ, Havuzdaki İşlem Düğümlerinin sayısını karşılamak için yeterli boş IP adresine sahip olmalıdır. Alt ağda yeterli boş IP adresi yoksa Havuz Düğümleri kısmen ayırır ve yeniden boyutlandırma hatası oluşur. 'MicrosoftAzureBatch' hizmet sorumlusu, belirtilen sanal ağ için 'Klasik Sanal Makine Katılımcısı' Role-Based Access Control (RBAC) rolüne sahip olmalıdır. Belirtilen alt ağ, Düğümlerde Görevleri zamanlayabilmek için Azure Batch hizmetinden gelen iletişime izin vermelidir. Bu, belirtilen sanal ağın ilişkili ağ güvenlik grupları (NSG) olup olmadığını denetleyerek doğrulanabilir. Belirtilen alt ağ içindeki Düğümlerle iletişim NSG tarafından reddedilirse, Batch hizmeti İşlem Düğümlerinin durumunu kullanılamaz olarak ayarlar. virtualMachineConfiguration ile oluşturulan Havuzlar için yalnızca ARM sanal ağları ('Microsoft.Network/virtualNetworks') desteklenir, ancak cloudServiceConfiguration ile oluşturulan Havuzlar için hem ARM hem de klasik sanal ağlar desteklenir. Belirtilen sanal ağ ile ilişkilendirilmiş Ağ Güvenlik Grupları (NSG) varsa, gelen iletişim istekleri için birkaç ayrılmış sistem bağlantı noktasının etkinleştirilmesi gerekir. Sanal makine yapılandırmasıyla oluşturulan Havuzlar için 29876 ve 29877 numaralı bağlantı noktalarının yanı sıra Linux için 22 numaralı bağlantı noktasını ve Windows için 3389 numaralı bağlantı noktasını etkinleştirin. Bulut hizmeti yapılandırmasıyla oluşturulan Havuzlar için 10100, 20100 ve 30100 bağlantı noktalarını etkinleştirin. Ayrıca 443 numaralı bağlantı noktasından Azure Depolama'ya giden bağlantıları etkinleştirin. Daha fazla ayrıntı için bkz. https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Gelen uç noktaya uygulanacak bir ağ güvenlik grubu kuralı.

Name Tür Description
access

NetworkSecurityGroupRuleAccess

Belirtilen IP adresi, alt ağ aralığı veya etiketi için yapılması gereken eylem.

priority

integer

Bu kuralın önceliği.
Havuz içindeki önceliklerin benzersiz olması ve öncelik sırasına göre değerlendirilmesi gerekir. Sayı ne kadar düşük ise öncelik o kadar yüksektir. Örneğin, kurallar 150, 250 ve 350 sipariş numaralarıyla belirtilebilir. Sipariş numarası 150 olan kural, 250 sırasına sahip kuraldan önceliklidir. İzin verilen öncelikler 150 ile 4096'dır. Ayrılmış veya yinelenen değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

sourceAddressPrefix

string

Kuralla eşleşecek kaynak adres ön eki veya etiketi.
Geçerli değerler tek bir IP adresi (örneğin 10.10.10.10), IP alt ağı (192.168.1.0/24), varsayılan etiket veya * (tüm adresler için) şeklindedir. Başka değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur.

sourcePortRanges

string[]

Kaynak bağlantı noktası, kuralla eşleşecek aralıklar.
Geçerli değerler : '' (0 - 65535 numaralı tüm bağlantı noktaları için), belirli bir bağlantı noktası (örneğin 22) veya bağlantı noktası aralığıdır (100-200). Bağlantı noktaları 0 ile 65535 arasında olmalıdır. Bu koleksiyondaki her giriş başka bir girişle (bir aralık veya tek bir bağlantı noktası) çakışmamalıdır. Başka değerler sağlanırsa istek HTTP durum kodu 400 ile başarısız olur. Varsayılan değer: ''.

NetworkSecurityGroupRuleAccess

Belirtilen IP adresi, alt ağ aralığı veya etiketi için yapılması gereken eylem.

Name Tür Description
allow

string

Erişime izin ver.

deny

string

Erişimi reddet.

NFSMountConfiguration

Bir NFS dosya sistemine bağlanmak için kullanılan bilgiler.

Name Tür Description
mountOptions

string

Bağlama komutuna geçirmek için ek komut satırı seçenekleri.
Bunlar Windows'daki 'net use' seçenekleri ve Linux'ta 'bağlama' seçenekleridir.

relativeMountPath

string

Dosya sisteminin bağlanacağı işlem düğümündeki göreli yol
Tüm dosya sistemleri, AZ_BATCH_NODE_MOUNTS_DIR ortam değişkeni aracılığıyla erişilebilen Batch bağlamaları dizinine göre bağlanır.

source

string

Bağlanacak dosya sisteminin URI'si.

NodeCommunicationMode

Bir havuzun Batch hizmetiyle nasıl iletişim kurdığını belirler.

Name Tür Description
classic

string

Klasik iletişim modunu kullanan düğümler, "BatchNodeManagement" bağlantı noktalarından 29876 ve 29877 numaralı bağlantı noktalarında gelen TCP iletişimi gerektirir. {region}" hizmet etiketi ve 443 numaralı bağlantı noktasından "Storage.region" ve "BatchNodeManagement" bağlantı noktasına giden TCP iletişimi. {region}" hizmet etiketleri.

default

string

Düğüm iletişim modu Batch hizmeti tarafından otomatik olarak ayarlanır.

simplified

string

Basitleştirilmiş iletişim modunu kullanan düğümler, 443 numaralı bağlantı noktasında "BatchNodeManagement" bağlantı noktasına giden TCP iletişimi gerektirir. {region}" hizmet etiketi. Açık gelen bağlantı noktası gerekmez.

NodePlacementConfiguration

Havuz için düğüm yerleştirme yapılandırması.

Name Tür Description
policy

NodePlacementPolicyType

Batch Havuzlarında düğüm yerleştirme İlke türü.
Batch Hizmeti tarafından düğümleri sağlamak için kullanılan ayırma ilkesi. Belirtilmezse, Batch bölgesel ilkeyi kullanır.

NodePlacementPolicyType

Havuzdaki düğümleri ayırmaya yönelik yerleştirme ilkesi.

Name Tür Description
regional

string

Havuzdaki tüm düğümler aynı bölgede ayrılır.

zonal

string

Havuzdaki düğümler, en iyi çaba dengelemesi ile farklı kullanılabilirlik alanlarına yayılır.

OSDisk

İşlem düğümünün (VM) işletim sistemi diskinin ayarları.

Name Tür Description
caching

CachingType

Önbelleğe alma gereksinimlerini belirtir. Olası değerler şunlardır: None, ReadOnly, ReadWrite. Varsayılan değerler şunlardır: Standart depolama için yok. Premium depolama için ReadOnly.
Önbelleğe alma için varsayılan değer yoktur. Önbelleğe alma seçenekleri hakkında daha fazla bilgi için bkz. https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer

Yeni işletim sistemi diski oluşturulurken GB cinsinden ilk disk boyutu.

ephemeralOSDiskSettings

DiffDiskSettings

İşlem düğümü (VM) tarafından kullanılan işletim sistemi diski için kısa ömürlü Disk Ayarlarını belirtir.

managedDisk

ManagedDisk

Yönetilen disk parametreleri.

writeAcceleratorEnabled

boolean

diskte writeAccelerator'ın etkinleştirilmesi veya devre dışı bırakılması gerektiğini belirtir.

PoolAddParameter

Eklenecek Azure Batch hizmetinde bir Havuz.

Name Tür Description
applicationLicenses

string[]

Batch hizmetinin Havuzdaki her İşlem Düğümünde kullanıma sunacağı uygulama lisanslarının listesi.
Uygulama lisansları listesi, kullanılabilir Batch hizmeti uygulama lisanslarının bir alt kümesi olmalıdır. Desteklenmeyen bir lisans istenirse Havuz oluşturma başarısız olur.

applicationPackageReferences

ApplicationPackageReference[]

Havuzdaki her İşlem Düğümüne yüklenecek Paketlerin listesi.
Havuz oluştururken paketin uygulama kimliği tam olmalıdır (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Paket başvurularındaki değişiklikler Havuza katılan tüm yeni Düğümleri etkiler, ancak yeniden başlatılana veya yeniden tasarlanana kadar Havuzda bulunan İşlem Düğümlerini etkilemez. Belirli bir Havuzda en fazla 10 Paket başvurusu vardır.

autoScaleEvaluationInterval

string

Havuz boyutunun otomatik ölçeklendirme formülüne göre otomatik olarak ayarlandığı zaman aralığı.
Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten büyük bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

autoScaleFormula

string

Havuzdaki istenen İşlem Düğümü sayısı için bir formül.
enableAutoScale false olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale true olarak ayarlandıysa gereklidir. Havuz oluşturulmadan önce formül geçerliliği denetlendi. Formül geçerli değilse Batch hizmeti ayrıntılı hata bilgileriyle isteği reddeder. Bu formülü belirtme hakkında daha fazla bilgi için bkz. 'Azure Batch Havuzunda İşlem Düğümlerini otomatik olarak ölçeklendirme' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

CertificateReference[]

Havuzdaki her İşlem Düğümüne yüklenecek Sertifikaların listesi.
Windows Düğümleri için Batch hizmeti Sertifikaları belirtilen Sertifika deposuna ve konumuna yükler. Linux İşlem Düğümleri için Sertifikalar Görev çalışma dizini içindeki bir dizinde depolanır ve bu konumu sorgulamak üzere Göreve bir ortam değişkeni AZ_BATCH_CERTIFICATES_DIR sağlanır. 'remoteUser' görünürlüğüne sahip sertifikalar için, kullanıcının giriş dizininde bir 'certs' dizini oluşturulur (ör. /home/{user-name}/certs) ve Sertifikalar bu dizine yerleştirilir.

Uyarı: Bu özellik kullanım dışıdır ve Şubat 2024'den sonra kaldırılacaktır. Lütfen bunun yerine Azure KeyVault Uzantısını kullanın.

cloudServiceConfiguration

CloudServiceConfiguration

Havuz için bulut hizmeti yapılandırması.
Bu özellik ve virtualMachineConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir. Batch Hesabı poolAllocationMode özelliği 'UserSubscription' olarak ayarlanmış şekilde oluşturulduysa bu özellik belirtilemez.

displayName

string

Havuzun görünen adı.
Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğunda unicode karakter içerebilir.

enableAutoScale

boolean

Havuz boyutunun zaman içinde otomatik olarak ayarlanıp ayarlanmayacağı.
False ise, targetDedicatedNodes ve targetLowPriorityNodes'lardan en az biri belirtilmelidir. True ise autoScaleFormula özelliği gereklidir ve Havuz formüle göre otomatik olarak yeniden boyutlandırılır. Varsayılan değer false'tur.

enableInterNodeCommunication

boolean

Havuzun İşlem Düğümleri arasında doğrudan iletişime izin verip vermediği.
Düğümler arası iletişimin etkinleştirilmesi, Havuzun İşlem Düğümlerindeki dağıtım kısıtlamaları nedeniyle Havuzun en büyük boyutunu sınırlar. Bu durum Havuzun istenen boyuta ulaşmamasıyla sonuçlanabilir. Varsayılan değer false'tur.

id

string

Hesap içindeki Havuzu benzersiz olarak tanımlayan bir dize.
Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64 karakterden fazlasını içeremez. Kimlik büyük/küçük harfe duyarlı ve büyük/küçük harfe duyarlı değildir (başka bir ifadeyle, hesapta yalnızca büyük/küçük harfe göre farklılık gösteren iki Havuz Kimliğiniz olmayabilir).

metadata

MetadataItem[]

Havuz ile meta veri olarak ilişkili ad-değer çiftlerinin listesi.
Batch hizmeti meta veriler için herhangi bir anlam atamaz; yalnızca kullanıcı kodunun kullanımına yöneliktir.

mountConfiguration

MountConfiguration[]

Havuzun tüm ömrü boyunca belirtilen dosya sistemini kullanarak depolamayı bağlayın.
Azure dosya paylaşımı, NFS, CIFS veya Blobfuse tabanlı dosya sistemini kullanarak depolamayı bağlayın.

networkConfiguration

NetworkConfiguration

Havuz için ağ yapılandırması.
Havuz için ağ yapılandırması.

resizeTimeout

string

İşlem Düğümlerinin Havuza ayrılması için zaman aşımı.
Bu zaman aşımı yalnızca el ile ölçeklendirme için geçerlidir; enableAutoScale true olarak ayarlandığında hiçbir etkisi olmaz. Varsayılan değer 15 dakikadır. En düşük değer 5 dakikadır. 5 dakikadan kısa bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

resourceTags

object

Havuzla ilişkili kullanıcı tarafından belirtilen etiketler.
Azure Batch Havuzu ile ilişkilendirilecek kullanıcı tanımlı etiketler. Belirtildiğinde, bu etiketler havuzla ilişkili yedekleme Azure kaynaklarına yayılır. Bu özellik yalnızca poolAllocationMode özelliği 'UserSubscription' olarak ayarlanmış batch hesabı oluşturulduğunda belirtilebilir.

startTask

StartTask

Havuza katıldığında her İşlem Düğümünde çalıştırılacak şekilde belirtilen bir Görev.
Görev, İşlem Düğümü Havuza eklendiğinde veya İşlem Düğümü yeniden başlatıldığında çalışır.

targetDedicatedNodes

integer

Havuzdaki ayrılmış İşlem Düğümlerinin istenen sayısı.
enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.

targetLowPriorityNodes

integer

Havuzdaki spot/düşük öncelikli işlem düğümlerinin istenen sayısı.
enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.

targetNodeCommunicationMode

NodeCommunicationMode

Havuz için istenen düğüm iletişim modu.
Atlanırsa, varsayılan değer Varsayılan'dır.

taskSchedulingPolicy

TaskSchedulingPolicy

Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı.
Belirtilmezse, varsayılan değer yayılır.

taskSlotsPerNode

integer

Havuzdaki tek bir işlem düğümünde eşzamanlı görevleri çalıştırmak için kullanılabilecek görev yuvası sayısı.
Varsayılan değer 1’dir. Maksimum değer, havuzun vmSize veya 256 çekirdek sayısının 4 katı kadar küçüktür.

userAccounts

UserAccount[]

Havuzdaki her İşlem Düğümünde oluşturulacak kullanıcı Hesaplarının listesi.

virtualMachineConfiguration

VirtualMachineConfiguration

Havuz için sanal makine yapılandırması.
Bu özellik ve cloudServiceConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir.

vmSize

string

Havuzdaki sanal makinelerin boyutu. Havuzdaki tüm sanal makineler aynı boyuttadır.
Cloud Services Havuzları (cloudServiceConfiguration ile oluşturulan havuzlar) için kullanılabilir sanal makine boyutları hakkında bilgi için bkz. Cloud Services boyutları (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch, ExtraSmall, A1V2 ve A2V2 dışında tüm Cloud Services VM boyutlarını destekler. Sanal Makineler Marketi'nden (virtualMachineConfiguration ile oluşturulan havuzlar) Görüntü Kullanan Havuzlar için kullanılabilir VM boyutları hakkında bilgi için bkz. Sanal Makineler Için Boyutlar (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) veya Sanal Makineler Boyutları (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch, STANDARD_A0 ve premium depolama alanı (STANDARD_GS, STANDARD_DS ve STANDARD_DSV2 serisi) olanlar dışında tüm Azure VM boyutlarını destekler.

PoolEndpointConfiguration

Havuz için uç nokta yapılandırması.

Name Tür Description
inboundNATPools

InboundNATPool[]

Tek bir İşlem Düğümündeki belirli bağlantı noktalarını harici olarak ele almak için kullanılabilecek gelen NAT Havuzlarının listesi.
Batch Havuzu başına en fazla gelen NAT Havuzu sayısı 5'tir. Gelen NAT Havuzu sayısı üst sınırı aşılırsa istek HTTP durum kodu 400 ile başarısız olur. IPAddressProvisioningType NoPublicIPAddresses ise bu belirtilemez.

PublicIPAddressConfiguration

Havuzun ağ yapılandırmasının genel IP Adresi yapılandırması.

Name Tür Description
ipAddressIds

string[]

Batch hizmetinin İşlem Düğümleri sağlarken kullanacağı genel IP'lerin listesi.
Burada belirtilen IP sayısı Havuzun en büyük boyutunu sınırlar- Her genel IP için 100 ayrılmış düğüm veya 100 Spot/Düşük öncelikli düğüm atanabilir. Örneğin, 250 ayrılmış VM'ye ihtiyaç duyan bir havuz için en az 3 genel IP belirtilmesi gerekir. Bu koleksiyonun her öğesi şu biçimdedir: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

provision

IPAddressProvisioningType

Havuz için Genel IP Adresleri için sağlama türü.
Varsayılan değer BatchManaged'dır.

ResourceFile

İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.

Name Tür Description
autoStorageContainerName

string

Otomatik depolama hesabındaki depolama kapsayıcısı adı.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir.

blobPrefix

string

Azure Depolama kapsayıcısından blob indirirken kullanılacak blob ön eki. Yalnızca adları belirtilen ön ek ile başlayan bloblar indirilir.
özelliği yalnızca autoStorageContainerName veya storageContainerUrl kullanıldığında geçerlidir. Bu ön ek kısmi bir dosya adı veya alt dizin olabilir. Ön ek belirtilmezse, kapsayıcıdaki tüm dosyalar indirilir.

fileMode

string

Sekizli biçimde dosya izin modu özniteliği.
Bu özellik yalnızca Linux İşlem Düğümlerine indirilen dosyalar için geçerlidir. Windows İşlem Düğümü'ne indirilecek bir resourceFile için belirtilirse yoksayılır. Bu özellik bir Linux İşlem Düğümü için belirtilmezse, dosyaya varsayılan 0770 değeri uygulanır.

filePath

string

İşlem Düğümünde, Görevin çalışma dizinine göre dosyaları indirebileceğiniz konum.
httpUrl özelliği belirtilirse filePath gereklidir ve dosya adı da dahil olmak üzere dosyanın indirileceği yolu açıklar. Aksi takdirde, autoStorageContainerName veya storageContainerUrl özelliği belirtilirse filePath isteğe bağlıdır ve dosyaların indirilme dizinidir. filePath'in dizin olarak kullanıldığı durumlarda, giriş verileriyle ilişkili tüm dizin yapısı tam olarak korunur ve belirtilen filePath dizinine eklenir. Belirtilen göreli yol, Görevin çalışma dizininden ayrılamaz (örneğin, '..' kullanılarak).

httpUrl

string

İndirilmesi gereken dosyanın URL'si.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir. URL Azure Blob Depolama işaret ederse, işlem düğümlerinden okunabilir olmalıdır. Azure depolamadaki bir blob için böyle bir URL almanın üç yolu vardır: Blob üzerinde okuma izinleri veren Paylaşılan Erişim İmzası (SAS) ekleyin, okuma iznine sahip yönetilen bir kimlik kullanın veya blob veya kapsayıcısının ACL'sini genel erişime izin verecek şekilde ayarlayın.

identityReference

ComputeNodeIdentityReference

storageContainerUrl veya httpUrl tarafından belirtilen Azure Blob Depolama erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru
İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.

storageContainerUrl

string

Azure Blob Depolama içindeki blob kapsayıcısının URL'si.
autoStorageContainerName, storageContainerUrl ve httpUrl özellikleri birbirini dışlar ve bunlardan biri belirtilmelidir. Bu URL, işlem düğümlerinden okunabilir ve listelenebilir olmalıdır. Azure depolamadaki bir kapsayıcı için böyle bir URL almanın üç yolu vardır: Kapsayıcıda okuma ve liste izinleri veren Paylaşılan Erişim İmzası (SAS) ekleyin, okuma ve liste izinlerine sahip yönetilen bir kimlik kullanın veya kapsayıcının ACL'sini genel erişime izin verecek şekilde ayarlayın.

SecurityProfile

Sanal makine veya sanal makine ölçek kümesi için güvenlik profili ayarlarını belirtir.

Name Tür Description
encryptionAtHost

boolean

Bu özellik, istekteki kullanıcı tarafından sanal makine veya sanal makine ölçek kümesi için Konak Şifrelemesi'ni etkinleştirmek veya devre dışı bırakmak için kullanılabilir. Bu, ana bilgisayarın kendisinde Kaynak/Geçici disk de dahil olmak üzere tüm diskler için şifrelemeyi etkinleştirir.

securityType

SecurityTypes

Sanal makinenin SecurityType değerini belirtir. UefiSettings'i etkinleştirmek için belirtilen herhangi bir değere ayarlanması gerekir.

uefiSettings

UefiSettings

Sanal makineyi oluştururken kullanılan güvenli önyükleme ve vTPM gibi güvenlik ayarlarını belirtir.
Sanal makineyi oluştururken kullanılan güvenli önyükleme ve vTPM gibi güvenlik ayarlarını belirtir.

SecurityTypes

Sanal makinenin SecurityType değerini belirtir. UefiSettings'i etkinleştirmek için belirtilen herhangi bir değere ayarlanması gerekir.

Name Tür Description
trustedLaunch

string

Güvenilir başlatma, gelişmiş ve kalıcı saldırı tekniklerine karşı koruma sağlar.

ServiceArtifactReference

'En son' görüntü sürümü kullanılırken ölçek kümesindeki tüm sanal makineler için aynı görüntü sürümünü ayarlamak için kullanılan hizmet yapıtı başvuru kimliğini belirtir.

Name Tür Description
id

string

ServiceArtifactReference hizmetinin hizmet yapıtı başvuru kimliği
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} biçiminde hizmet yapıtı başvuru kimliği

StartTask

Düğüm Azure Batch hizmetindeki bir Havuza katıldığında veya İşlem Düğümü yeniden başlatıldığında veya yeniden oluşturulduğunda çalıştırılan görev.

Name Tür Description
commandLine

string

StartTask komut satırı.
Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletmesi gibi kabuk özelliklerinden yararlanamaz. Bu tür özelliklerden yararlanmak istiyorsanız, kabuğu komut satırında çağırmanız gerekir; örneğin, Windows'ta "cmd /c MyCommand" veya Linux'ta "/bin/sh -c MyCommand" kullanın. Komut satırı dosya yollarına başvuruyorsa, göreli bir yol (Görev çalışma dizinine göre) veya Batch tarafından sağlanan ortam değişkenini (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables kullanmalıdır).

containerSettings

TaskContainerSettings

StartTask'ın altında çalıştığı kapsayıcının ayarları.
Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR (düğümdeki Azure Batch dizinlerinin kökü) altında özyinelemeli olarak tüm dizinler kapsayıcıyla eşlenir, tüm Görev ortamı değişkenleri kapsayıcıya eşlenir ve Görev komut satırı kapsayıcıda yürütülür. AZ_BATCH_NODE_ROOT_DIR dışında kapsayıcıda üretilen dosyalar ana bilgisayar diskine yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.

environmentSettings

EnvironmentSetting[]

StartTask için ortam değişkeni ayarlarının listesi.

maxTaskRetryCount

integer

Görevin yeniden denenebileceği en fazla sayı.
Batch hizmeti, çıkış kodu sıfır olmayan bir Görevi yeniden denenir. Bu değerin özellikle yeniden deneme sayısını denetlediğini unutmayın. Batch hizmeti Görevi bir kez dener ve bu sınıra kadar yeniden deneyebilir. Örneğin, en fazla yeniden deneme sayısı 3 ise, Batch Görevi en fazla 4 kez dener (ilk bir deneme ve 3 yeniden deneme). Yeniden deneme sayısı üst sınırı 0 ise, Batch hizmeti Görevi yeniden denemez. Yeniden deneme sayısı üst sınırı -1 ise, Batch hizmeti Görevi sınırsız olarak yeniden dener, ancak bu bir başlangıç görevi veya herhangi bir görev için önerilmez. Varsayılan değer 0'dır (yeniden deneme yoktur).

resourceFiles

ResourceFile[]

Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümü'ne indireceği dosyaların listesi. Kaynak dosyaları listesi için en büyük boyut vardır. Maksimum boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu küçültülmelidir. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.
Bu öğe altında listelenen dosyalar Görevin çalışma dizininde bulunur.

userIdentity

UserIdentity

StartTask'ın altında çalıştığı kullanıcı kimliği.
Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

waitForSuccess

boolean

İşlem Düğümünde herhangi bir Görev zamanlamadan önce Batch hizmetinin StartTask'ın başarıyla tamamlanmasını (yani çıkış kodu 0 ile çıkmak için) beklemesi gerekip gerekmediği.
True ise ve StartTask bir Düğümde başarısız olursa, Batch hizmeti StartTask'i en fazla yeniden deneme sayısı (maxTaskRetryCount) kadar yeniden dener. Tüm yeniden denemelerden sonra Görev yine de başarıyla tamamlanmamışsa, Batch hizmeti Düğümü kullanılamaz olarak işaretler ve Görevler'i buna zamanlamaz. Bu koşul İşlem Düğümü durumu ve hata bilgileri ayrıntıları aracılığıyla algılanabilir. False ise, Batch hizmeti StartTask'ın tamamlanmasını beklemez. Bu durumda, StartTask hala çalışırken diğer Görevler İşlem Düğümünde yürütülmeye başlayabilir; Ve StartTask başarısız olsa bile, yeni Görevler İşlem Düğümünde zamanlanmaya devam eder. Varsayılan değer true'dur.

StorageAccountType

Veri diskleri veya işletim sistemi diski oluştururken kullanılacak depolama Hesabı türü.

Name Tür Description
premium_lrs

string

Veri diski /işletim sistemi diski premium yerel olarak yedekli depolama kullanmalıdır.

standard_lrs

string

Veri diski /işletim sistemi diski standart yerel olarak yedekli depolama kullanmalıdır.

standardssd_lrs

string

Veri diski /işletim sistemi diski standart SSD yerel olarak yedekli depolama kullanmalıdır.

TaskContainerSettings

Görevin kapsayıcı ayarları.

Name Tür Description
containerRunOptions

string

Kapsayıcı oluşturma komutuna ek seçenekler.
Bu ek seçenekler, Batch Hizmeti tarafından denetlenenlere ek olarak "docker create" komutunun bağımsız değişkenleri olarak sağlanır.

imageName

string

Görevin çalıştırılacağı kapsayıcıyı oluşturmak için kullanılacak Görüntü.
Bu, "docker pull" için belirtildiği gibi tam Görüntü başvurusudur. Görüntü adının bir parçası olarak hiçbir etiket sağlanmazsa, varsayılan olarak ":latest" etiketi kullanılır.

registry

ContainerRegistry

Kapsayıcı görüntüsünü içeren özel kayıt defteri.
Havuz oluşturma sırasında zaten sağlanmışsa bu ayar atlanabilir.

workingDirectory

ContainerWorkingDirectory

Kapsayıcı Görev çalışma dizininin konumu.
Varsayılan değer 'taskWorkingDirectory'dir.

TaskSchedulingPolicy

Görevlerin İşlem Düğümleri arasında nasıl dağıtılması gerektiğini belirtir.

Name Tür Description
nodeFillType

ComputeNodeFillType

Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı.
Belirtilmezse, varsayılan değer yayılır.

UefiSettings

Sanal makineyi oluştururken kullanılan güvenli önyükleme ve vTPM gibi güvenlik ayarlarını belirtir.

Name Tür Description
secureBootEnabled

boolean

Sanal makinede güvenli önyüklemenin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.

vTpmEnabled

boolean

Sanal makinede vTPM'nin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.

UserAccount

Azure Batch İşlem Düğümünde Görevleri yürütmek için kullanılan bir kullanıcı oluşturmak için kullanılan özellikler.

Name Tür Description
elevationLevel

ElevationLevel

Kullanıcı Hesabının yükseltme düzeyi.
Varsayılan değer nonAdmin'dir.

linuxUserConfiguration

LinuxUserConfiguration

Kullanıcı Hesabı için Linux'a özgü kullanıcı yapılandırması.
Bir Windows Havuzunda belirtilirse bu özellik yoksayılır. Belirtilmezse, kullanıcı varsayılan seçeneklerle oluşturulur.

name

string

Kullanıcı Hesabının adı. Adlar en fazla 20 unicode karakter içerebilir.

password

string

Kullanıcı Hesabının parolası.

windowsUserConfiguration

WindowsUserConfiguration

Kullanıcı Hesabı için Windows'a özgü kullanıcı yapılandırması.
Bu özellik yalnızca kullanıcı bir Windows Havuzundaysa belirtilebilir. Belirtilmezse ve bir Windows Havuzunda kullanıcı varsayılan seçeneklerle oluşturulur.

UserIdentity

Görevin altında çalıştırıldığı kullanıcı kimliğinin tanımı.

Name Tür Description
autoUser

AutoUserSpecification

Görevin altında çalıştırıldığı otomatik kullanıcı.
userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.

username

string

Görevin altında çalıştırıldığı kullanıcı kimliğinin adı.
userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.

VirtualMachineConfiguration

Azure Sanal Makineler altyapısını temel alan bir Havuzdaki İşlem Düğümleri yapılandırması.

Name Tür Description
containerConfiguration

ContainerConfiguration

Havuz için kapsayıcı yapılandırması.
Belirtilirse, Görevlerin kapsayıcılarda çalışmasına izin vermek için havuzdaki her İşlem Düğümünde kurulum gerçekleştirilir. Bu Havuzda çalıştırılacak tüm normal Görevler ve İş yöneticisi Görevleri containerSettings özelliğini belirtmelidir ve diğer tüm Görevler bunu belirtebilir.

dataDisks

DataDisk[]

Havuzdaki İşlem Düğümlerine bağlı veri diskleri için yapılandırma.
Havuzdaki İşlem Düğümlerinin kendilerine bağlı boş veri diskleri olması gerekiyorsa bu özellik belirtilmelidir. Bu güncelleştirilemez. Her İşlem Düğümü kendi diskini alır (disk bir dosya paylaşımı değildir). Mevcut diskler eklenemez, eklenen her disk boş olur. İşlem Düğümü Havuzdan kaldırıldığında disk ve onunla ilişkili tüm veriler de silinir. Disk eklendikten sonra biçimlendirilmemiştir, kullanılmadan önce biçimlendirilmelidir. Daha fazla bilgi için ve https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machinebölümüne bakınhttps://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux.

diskEncryptionConfiguration

DiskEncryptionConfiguration

Havuzun disk şifreleme yapılandırması.
Belirtilirse, düğüm sağlama sırasında havuzdaki her düğümde şifreleme gerçekleştirilir.

extensions

VMExtension[]

Havuzun sanal makine uzantısı.
Belirtilirse, bu yapılandırmada belirtilen uzantılar her düğüme yüklenir.

imageReference

ImageReference

Azure Sanal Makineler Market Görüntüsüne veya kullanılacak özel Sanal Makine Görüntüsüne başvuru.

licenseType

string

İşletim sistemi dağıtılırken kullanılacak şirket içi lisansın türü.
Bu yalnızca Windows işletim sistemini içeren Görüntüler için geçerlidir ve yalnızca dağıtılacak İşlem Düğümleri için geçerli şirket içi lisanslara sahip olduğunuzda kullanılmalıdır. Atlanırsa, şirket içi lisans indirimi uygulanmaz. Değerler şunlardır:

Windows_Server - Şirket içi lisans Windows Server içindir. Windows_Client - Şirket içi lisans Windows İstemcisi'ne yöneliktir.

nodeAgentSKUId

string

Havuzdaki İşlem Düğümlerinde sağlanacak Batch İşlem Düğümü aracısının SKU'su.
Batch İşlem Düğümü aracısı, Havuzdaki her İşlem Düğümünde çalışan ve İşlem Düğümü ile Batch hizmeti arasında komut ve denetim arabirimi sağlayan bir programdır. İşlem Düğümü aracısının farklı işletim sistemleri için SKU'lar olarak bilinen farklı uygulamaları vardır. Seçili Görüntü başvurusuyla eşleşen bir İşlem Düğümü aracısı SKU'su belirtmeniz gerekir. Desteklenen İşlem Düğümü aracısı SKU'larının ve doğrulanmış Görüntü başvurularının listesini almak için 'Desteklenen İşlem Düğümü aracısı SKU'larını listeleme' işlemine bakın.

nodePlacementConfiguration

NodePlacementConfiguration

Havuz için düğüm yerleştirme yapılandırması.
Bu yapılandırma, havuzdaki düğümlerin fiziksel olarak nasıl ayrılacağıyla ilgili kuralları belirtir.

osDisk

OSDisk

Sanal Makinenin işletim sistemi diskinin ayarları.

securityProfile

SecurityProfile

Sanal makine veya sanal makine ölçek kümesi için güvenlik profili ayarlarını belirtir.
Sanal makine veya sanal makine ölçek kümesi için güvenlik profili ayarlarını belirtir.

serviceArtifactReference

ServiceArtifactReference

'En son' görüntü sürümü kullanılırken ölçek kümesindeki tüm sanal makineler için aynı görüntü sürümünü ayarlamak için kullanılan hizmet yapıtı başvuru kimliğini belirtir.
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} biçiminde hizmet yapıtı başvuru kimliği

windowsConfiguration

WindowsConfiguration

Sanal makinedeki Windows işletim sistemi ayarları.
imageReference özelliği bir Linux işletim sistemi görüntüsü belirtiyorsa bu özellik belirtilmemelidir.

VMExtension

Sanal makine uzantıları için yapılandırma.

Name Tür Description
autoUpgradeMinorVersion

boolean

Dağıtım zamanında kullanılabilirse uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra uzantı, bu özellik true olarak ayarlanmış olsa bile yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.

enableAutomaticUpgrade

boolean

Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.

name

string

Sanal makine uzantısının adı.

protectedSettings

object

Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.

provisionAfterExtensions

string[]

Uzantı adları koleksiyonu.
Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.

publisher

string

Uzantı işleyici yayımcısının adı.

settings

object

Uzantı için JSON biçimli genel ayarlar.

type

string

Uzantının türü.

typeHandlerVersion

string

Betik işleyicisinin sürümü.

WindowsConfiguration

Sanal makineye uygulanacak Windows işletim sistemi ayarları.

Name Tür Description
enableAutomaticUpdates

boolean

Sanal makinede otomatik güncelleştirmelerin etkinleştirilip etkinleştirilmediği.
Atlanırsa, varsayılan değer true olur.

WindowsUserConfiguration

Bir Windows İşlem Düğümünde kullanıcı Hesabı oluşturmak için kullanılan özellikler.

Name Tür Description
loginMode

LoginMode

Kullanıcının oturum açma modu
VirtualMachineConfiguration Havuzları için varsayılan değer 'batch' ve CloudServiceConfiguration Havuzları için 'interactive' değeridir.