Pool - Update Properties

Service:

Batch Service

API Version:

2023-11-01.18.0

Belirtilen Havuzun özelliklerini Güncelleştirmeler.
Bu, Havuzun tüm güncelleştirilebilir özelliklerinin yerini alır. Örneğin, Havuz ile ilişkilendirilmiş bir StartTask varsa ve StartTask bu istekle belirtilmezse, Batch hizmeti mevcut StartTask'ı kaldırır.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/updateproperties?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.
poolId	path	True	string	Güncelleştirilecek havuzun kimliği.
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 tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan 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 saatine 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
applicationPackageReferences	True	ApplicationPackageReference[]	Havuzdaki her İşlem Düğümüne yüklenecek Uygulama Paketlerinin listesi. Liste, Havuzdaki mevcut Uygulama Paketi başvurularının yerini alır. Uygulama Paketi başvurularındaki değişiklikler Havuza katılan tüm yeni İşlem Düğümlerini etkiler, ancak yeniden başlatılana veya yeniden tasarlanana kadar Zaten Havuzda bulunan İşlem Düğümlerini etkilemez. Belirli bir Havuzda en fazla 10 Uygulama Paketi başvurusu vardır. Atlanırsa veya boş bir koleksiyon belirtirseniz, mevcut Uygulama Paketleri başvuruları Havuzdan kaldırılır. Belirli bir Havuzda en fazla 10 başvuru belirtilebilir.
certificateReferences	True	CertificateReference[]	Havuzdaki her İşlem Düğümüne yüklenecek Sertifikaların listesi. Bu liste, Havuz'da yapılandırılan tüm mevcut Sertifika başvurularının yerini alır. Boş bir koleksiyon belirtirseniz, var olan tüm Sertifika başvuruları Havuzdan kaldırılır. 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.
metadata	True	MetadataItem[]	Havuz ile meta veri olarak ilişkili ad-değer çiftlerinin listesi. Bu liste, Havuz'da yapılandırılmış olan tüm meta verilerin yerini alır. Atlanırsa veya boş bir koleksiyon belirtirseniz, mevcut meta veriler Havuzdan kaldırılır.
startTask		StartTask	Havuza katıldığında her İşlem Düğümünde çalıştırılacak bir Görev. Görev, İşlem Düğümü Havuza eklendiğinde veya İşlem Düğümü yeniden başlatıldığında çalışır. Bu öğe varsa, mevcut StartTask öğelerinin üzerine yazar. Atlanırsa, var olan tüm StartTask Havuz'dan kaldırılır.
targetNodeCommunicationMode		NodeCommunicationMode	Havuz için istenen düğüm iletişim modu. Bu ayar, Havuzdaki mevcut targetNodeCommunication ayarının yerini alır. Atlanırsa, mevcut ayar varsayılan ayardır.

Yanıtlar

Name	Tür	Description
204 No Content		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

Pool update

Sample Request

HTTP

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



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Sample Response

Status code:

204

Tanımlar

Name	Description
ApplicationPackageReference	İşlem Düğümlerine dağıtılacak bir Paket başvurusu.
AutoUserScope	Otomatik kullanıcının kapsamı
AutoUserSpecification	Batch hizmetinde görev çalıştıran otomatik kullanıcının parametrelerini belirtir.
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.
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.
ComputeNodeIdentityReference	İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.
ContainerRegistry	Özel kapsayıcı kayıt defteri.
ContainerWorkingDirectory	Kapsayıcı Görev çalışma dizininin konumu.
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 bir hata iletisi alındı.
MetadataItem	Batch hizmet kaynağıyla ilişkilendirilmiş bir ad-değer çifti.
NodeCommunicationMode	Havuzun Batch hizmetiyle nasıl iletişim kurdığını belirler.
PoolUpdatePropertiesParameter	Havuzda yapılacak değişiklik kümesi.
ResourceFile	İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.
StartTask	Düğüm Azure Batch hizmetindeki bir Havuza katıldığında veya İşlem Düğümü yeniden başlatıldığında veya yeniden başlatıldığında çalıştırılan görev.
TaskContainerSettings	Görevin kapsayıcı ayarları.
UserIdentity	Görevin altında çalıştırıldığı kullanıcı kimliğinin tanımı.

ApplicationPackageReference

İşlem Düğümlerine dağıtılacak bir Paket başvurusu.

Name	Tür	Description
applicationId	string	Dağıtılacak uygulamanın kimliği. Havuz oluştururken paketin uygulama kimliği tam (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}) olmalıdır.
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.

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.

CertificateReference

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

Name	Tür	Description
storeLocation	CertificateStoreLocation	Sertifikanın yükleneceği İşlem Düğümündeki Sertifika deposunun konumu. 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ü 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 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.
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ü 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.

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.

ContainerRegistry

Özel 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şkili 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" olur.
username	string	Kayıt defteri sunucusunda oturum açmak için kullanıcı adı.

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.

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 bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.

MetadataItem

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

NodeCommunicationMode

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ı noktaları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ından "BatchNodeManagement"a giden TCP iletişimi gerektirir. {region}" hizmet etiketi. Açık gelen bağlantı noktası gerekmez.

PoolUpdatePropertiesParameter

Havuzda yapılacak değişiklik kümesi.

Name	Tür	Description
applicationPackageReferences	ApplicationPackageReference[]	Havuzdaki her İşlem Düğümüne yüklenecek Uygulama Paketlerinin listesi. Liste, Havuzdaki mevcut Uygulama Paketi başvurularının yerini alır. Uygulama Paketi başvurularında yapılan değişiklikler Havuza katılan tüm yeni İşlem Düğümlerini etkiler, ancak yeniden başlatılana veya yeniden tasarlanana kadar Havuzda bulunan İşlem Düğümlerini etkilemez. Belirli bir Havuzda en fazla 10 Uygulama Paketi başvurusu vardır. Atlanırsa veya boş bir koleksiyon belirtirseniz, var olan tüm Uygulama Paketleri başvuruları Havuzdan kaldırılır. Belirli bir Havuzda en fazla 10 başvuru belirtilebilir.
certificateReferences	CertificateReference[]	Havuzdaki her İşlem Düğümüne yüklenecek Sertifikaların listesi. Bu liste, Havuz'da yapılandırılan tüm mevcut Sertifika başvurularının yerini alır. Boş bir koleksiyon belirtirseniz, var olan tüm Sertifika başvuruları Havuzdan kaldırılır. 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.
metadata	MetadataItem[]	Havuz ile meta veri olarak ilişkili ad-değer çiftlerinin listesi. Bu liste, Havuz'da yapılandırılmış olan tüm meta verilerin yerini alır. Atlanırsa veya boş bir koleksiyon belirtirseniz, var olan tüm meta veriler Havuzdan kaldırılır.
startTask	StartTask	Havuza katıldığında her İşlem Düğümünde çalıştırılacak bir Görev. Görev, İşlem Düğümü Havuza eklendiğinde veya İşlem Düğümü yeniden başlatıldığında çalışır. Bu öğe varsa, mevcut StartTask öğelerinin üzerine yazar. Atlanırsa, var olan tüm StartTask Havuz'dan kaldırılır.
targetNodeCommunicationMode	NodeCommunicationMode	Havuz için istenen düğüm iletişim modu. Bu ayar, Havuz'daki mevcut targetNodeCommunication ayarının yerini alır. Atlanırsa, mevcut ayar varsayılan ayardı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.

StartTask

Düğüm Azure Batch hizmetindeki bir Havuza katıldığında veya İşlem Düğümü yeniden başlatıldığında veya yeniden başlatıldığında ç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 konak diske 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örev'i 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 (bir ilk 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[]	Batch hizmetinin komut satırını çalıştırmadan önce İşlem Düğümü'ne indireceği dosyaların listesi. Kaynak dosyaları listesi için boyut üst sınırı 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 azaltılmalıdır. 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	Batch hizmetinin İşlem Düğümünde herhangi bir Görevi zamanlamadan önce StartTask'ın başarıyla tamamlanmasını (yani çıkış kodu 0 ile çıkmak için) beklemesi gerekip gerekmediği. True ise ve StartTask bir Node'da başarısız olursa, Batch hizmeti StartTask'ı en yüksek yeniden deneme sayısı (maxTaskRetryCount) kadar yeniden dener. Tüm yeniden denemelerden sonra Görev hala 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 zamanlamaya devam eder. Varsayılan değer true'dur.

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" komutuna bağımsız değişken 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, ":latest" etiketi varsayılan olarak 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	Görev çalışma dizini kapsayıcısının konumu. Varsayılan değer 'taskWorkingDirectory'dir.

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.