Task - Add

Hizmet:

Batch Service

API Sürümü:

2024-07-01.20.0

Belirtilen İşe bir Görev ekler.
Görevin tamamlanmasına ek olarak en uzun yaşam süresi 180 gündür. Görev eklendikten sonraki 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda olduğu durumda bırakılır.

POST {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0

İsteğe bağlı parametrelerle:

POST {batchUrl}/jobs/{jobId}/tasks?timeout={timeout}&api-version=2024-07-01.20.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
batchUrl	path	True	string	Tüm Azure Batch hizmet isteklerinin temel URL'si.
jobId	path	True	string	Görevin eklendiği İşin 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 cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name	Gerekli	Tür	Description
client-request-id		string uuid	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, ö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
commandLine	True	string	Görevin komut satırı. Çok örnekli Görevler için, birincil Görev ve tüm alt görevler koordinasyon komut satırını yürütmeyi bitirdikten sonra komut satırı birincil Görev olarak yürütülür. Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletme 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/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.
id	True	string	İş içindeki Görevi 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 fazla karakter içeremez. Kimlik büyük/küçük harf koruyucu ve büyük/küçük harfe duyarlı değildir (yani, bir İş içinde yalnızca büyük/küçük harfe göre farklılık gösteren iki kimliğiniz olmayabilir).
affinityInfo		AffinityInformation	Batch hizmeti tarafından yeni Görevin başlatılacağı bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.
applicationPackageReferences		ApplicationPackageReference[]	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne dağıtacağı Paketlerin listesi. Uygulama paketleri indirilir ve Görev çalışma dizinine değil paylaşılan bir dizine dağıtılır. Bu nedenle, başvuruda bulunılan bir paket zaten Node'daysa ve güncelse, yeniden indirılmaz; İşlem Düğümündeki mevcut kopya kullanılır. Başvurulan bir Paket, örneğin paket silindiği veya indirilemediği için yüklenemediyse, Görev başarısız olur.
authenticationTokenSettings		AuthenticationTokenSettings	Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu özellik ayarlanırsa Batch hizmeti, Bir Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci ile Görev sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, Bir Görev, İş'e başka Görevler eklemek için İş izinleri isteyebilir veya İşin veya İş altındaki diğer Görevlerin durumunu denetleyebilir.
constraints		TaskConstraints	Bu Göreve uygulanan yürütme kısıtlamaları. Kısıtlamaları belirtmezseniz maxTaskRetryCount, İş için belirtilen maxTaskRetryCount değeridir, maxWallClockTime değeri sonsuzdur ve retentionTime değeri 7 gündür.
containerSettings		TaskContainerSettings	Görevin altında çalıştığı kapsayıcının ayarları. Bu Görevi çalıştıracak Havuz containerConfiguration kümesine sahipse, bunun da ayarlanması gerekir. Bu Görevi çalıştıracak Havuzda containerConfiguration ayarlanmamışsa, bu ayar yapılmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya 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.
dependsOn		TaskDependencies	Bu Görevin bağlı olduğu Görevler. Bağımlı olduğu tüm Görevler başarıyla tamamlanana kadar bu Görev zamanlanmaz. Bu Görevlerden herhangi biri başarısız olursa ve yeniden deneme sayılarını tüketirse, bu Görev hiçbir zaman zamanlanamaz. İşin usesTaskDependencies değeri true olarak ayarlanmamışsa ve bu öğe mevcutsa istek TaskDependenciesNotSpecifiedOnJob hata koduyla başarısız olur.
displayName		string	Görev için görünen ad. Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğa kadar unicode karakter içerebilir.
environmentSettings		EnvironmentSetting[]	Görev için ortam değişkeni ayarlarının listesi.
exitConditions		ExitConditions	Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir. Görev tamamlandığında Batch hizmetinin nasıl yanıt vermesi gerektiği.
multiInstanceSettings		MultiInstanceSettings	Görevin çok örnekli bir Görev olduğunu belirten ve çok örnekli Görevin nasıl çalıştırıldığını gösteren bir nesne. Çok Örnekli Görevler genellikle MPI Görevlerini desteklemek için kullanılır. MPI örneğinde, alt görevlerden herhangi biri başarısız olursa (örneğin, sıfır olmayan bir çıkış koduyla çıkılması nedeniyle) çok örnekli Görevin tamamı başarısız olur. Çok örnekli Görev daha sonra sonlandırılır ve yeniden denenerek yeniden deneme sınırına kadar devam eder.
outputFiles		OutputFile[]	Komut satırını çalıştırdıktan sonra Batch hizmetinin İşlem Düğümü'nden karşıya yükleyeceği dosyaların listesi. Çok örnekli Görevler için dosyalar yalnızca birincil Görevin yürütüleceği İşlem Düğümü'nden karşıya yüklenir.
requiredSlots		integer	Görevin çalışması için gereken zamanlama yuvalarının sayısı. Varsayılan değer 1'dir. Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu 1 olmalıdır.
resourceFiles		ResourceFile[]	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne indireceği dosyaların listesi. Çok örnekli Görevler için kaynak dosyaları yalnızca birincil Görevin yürütüleceği İşlem Düğümüne indirilir. Kaynak dosyaları listesi için en büyük boyut vardır. En büyük 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.
userIdentity		UserIdentity	Görevin çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

Yanıtlar

Name	Tür	Description
201 Created		Batch hizmetine yapılan istek başarılı oldu. Üst Bilgiler 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

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

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Authorization

Tür: apiKey
İçinde: header

Örnekler

Add a basic task

Add a container task with container data isolation

Add a container task with container data isolation bad request duplicate sources

Add a task with container settings

Add a task with exit conditions

Add a task with extra slot requirement

Add a basic task

Örnek isteği

HTTP

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



{
  "id": "task1",
  "commandLine": "cmd /c echo task1"
}

Örnek yanıt

Durum kodu:

201

Add a container task with container data isolation

Örnek isteği

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Örnek yanıt

Durum kodu:

201

Add a container task with container data isolation bad request duplicate sources

Örnek isteği

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      },
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Örnek yanıt

Durum kodu:

201

Add a task with container settings

Örnek isteği

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerRunOptions": "--rm"
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Örnek yanıt

Durum kodu:

201

Add a task with exit conditions

Örnek isteği

HTTP

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



{
  "id": "taskId",
  "commandLine": "cmd /c exit 3",
  "exitConditions": {
    "exitCodeRanges": [
      {
        "start": 2,
        "end": 4,
        "exitOptions": {
          "jobAction": "terminate"
        }
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

Örnek yanıt

Durum kodu:

201

Add a task with extra slot requirement

Örnek isteği

HTTP

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



{
  "id": "task1",
  "requiredSlots": 2,
  "commandLine": "cmd /c echo task1"
}

Örnek yanıt

Durum kodu:

201

Tanımlar

Name	Description
AccessScope	Belirtecin erişim izni veren Batch kaynakları.
AffinityInformation	Batch hizmeti tarafından görev başlatılacak bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.
ApplicationPackageReference	İşlem Düğümlerine dağıtılacak paket başvurusu.
AuthenticationTokenSettings	Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları.
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 dahil edilen ek bilgilerden oluşan bir öğe.
ComputeNodeIdentityReference	İşlem düğümlerinin kullanacağı Batch havuzuyla ilişkili kullanıcı tarafından atanan kimliğe başvuru.
ContainerHostBatchBindMountEntry	Görev kapsayıcısına bağlamak istediğiniz yol ve bağlama modunun girişi.
ContainerHostDataPath	Kapsayıcı görevinin kapsayıcısına bağlanacak yollar.
ContainerRegistry	Özel bir kapsayıcı kayıt defteri.
ContainerWorkingDirectory	Kapsayıcı Görev çalışma dizininin konumu.
DependencyAction	Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem.
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ı.
ExitCodeMapping	Görevden belirli bir çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.
ExitCodeRangeMapping	Çıkış kodları aralığı ve Batch hizmetinin bu aralıktaki çıkış kodlarına nasıl yanıt vermesi gerektiği.
ExitConditions	Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir.
ExitOptions	Batch hizmetinin belirli bir çıkış koşuluna nasıl yanıt vereceğini belirtir.
HttpHeader	HTTP üst bilgisi ad-değer çifti
JobAction	Görev belirtilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem.
MultiInstanceSettings	Çok örnekli bir Görevin nasıl çalıştırılacağını belirten ayarlar.
OutputFile	Batch hizmeti Görev işlemini yürütmeyi tamamladıktan sonra Azure Batch İşlem Düğümü'nden başka bir konuma dosya yüklemeye yönelik belirtim.
OutputFileBlobContainerDestination	Azure blob depolama kapsayıcısı içinde bir dosya karşıya yükleme hedefi belirtir.
OutputFileDestination	Dosyanın karşıya yüklenmesi gereken hedef.
OutputFileUploadCondition	Görev çıktı dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar.
OutputFileUploadOptions	Karşıya yüklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili ayrıntılar.
ResourceFile	İşlem Düğümüne indirilecek tek bir dosya veya birden çok dosya.
TaskAddParameter	Eklenecek bir Azure Batch Görevi.
TaskConstraints	Göreve uygulanacak yürütme kısıtlamaları.
TaskContainerSettings	Görev için kapsayıcı ayarları.
TaskDependencies	Görevin bağımlılıklarını belirtir. Bağımlı Görevin zamanlanmasından önce açıkça belirtilen veya bağımlılık aralığındaki tüm Görevlerin tamamlanması gerekir.
TaskIdRange	Bir Görevin bağlı olabileceği görev kimlikleri aralığı. Bağımlı Görevin zamanlanması için önce aralıktaki kimlikleri olan tüm Görevlerin başarıyla tamamlanması gerekir.
UserIdentity	Görevin çalıştırıldığı kullanıcı kimliğinin tanımı.

AccessScope

Belirtecin erişim izni veren Batch kaynakları.

Name	Tür	Description
job	string	Görevi içeren İş'te tüm işlemleri gerçekleştirmek için erişim verir.

AffinityInformation

Batch hizmeti tarafından görev başlatılacak bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.

Name	Tür	Description
affinityId	string	İşlem Düğümünün veya daha önce çalıştırılmış bir Görevin konumunu temsil eden opak bir dize. Bu Görevin söz konusu İşlem Düğümünde çalıştırılması gerektiğini belirtmek için bir Düğümün affinityId değerini geçirebilirsiniz. Bunun yalnızca geçici bir benzite olduğunu unutmayın. Görev zamanlandığı sırada hedef İşlem Düğümü meşgul veya kullanılamıyorsa, Görev başka bir yerde zamanlanır.

ApplicationPackageReference

İşlem Düğümlerine dağıtılacak 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 ve HTTP durum kodu 409 hata koduyla başarısız olur. Bir Görevde bu belirtilmezse ve bu uygulama için varsayılan sürüm belirtilmezse, Görev ön işleme hatasıyla başarısız olur.

AuthenticationTokenSettings

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları.

Name	Tür	Description
access	AccessScope[]	Belirtecin erişim izni veren Batch kaynakları. Kimlik doğrulama belirteci sınırlı bir Batch hizmeti işlemleri kümesine erişim verir. Şu anda erişim özelliği için desteklenen tek değer, Görevi içeren İş ile ilgili tüm işlemlere erişim sağlayan 'job' değeridir.

AutoUserScope

Otomatik kullanıcının kapsamı

Name	Tür	Description
pool	string	Görevin bir 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[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına dahil edilen 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.

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.

ContainerHostBatchBindMountEntry

Görev kapsayıcısına bağlamak istediğiniz yol ve bağlama modunun girişi.

Name	Tür	Description
isReadOnly	boolean	Bu kaynak yolu salt okunur mod olarak bağlayın veya bağlamayın. Varsayılan değer false (okuma/yazma modu). Linux için bu yolu okuma/yazma modu olarak bağlarsanız bu, kapsayıcıdaki tüm kullanıcıların yol için okuma/yazma erişimine sahip olduğu anlamına gelmez; konak VM'deki erişime bağlıdır. Bu yol salt okunur olarak bağlanırsa, kapsayıcıdaki tüm kullanıcılar yolu değiştiremez.
source	ContainerHostDataPath	Kapsayıcı müşterisine bağlanacak yol seçilebilir.

ContainerHostDataPath

Kapsayıcı görevinin kapsayıcısına bağlanacak yollar.

Name	Tür	Description
Applications	string	Uygulama yolu.
JobPrep	string	İş hazırlama görev yolu.
Shared	string	Çok örnekli görevin dosyalarını paylaşma yolu.
Startup	string	Başlangıç görevinin yolu.
Task	string	Görev yolu.
VfsMounts	string	Yol, bu düğüme bağlı olan tüm sanal dosya sistemlerini içerir.

ContainerRegistry

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

Name	Tür	Description
identityReference	ComputeNodeIdentityReference	Kullanıcı adı ve parola yerine Azure Container Registry'ye 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"dir.
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.

DependencyAction

Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem.

Name	Tür	Description
block	string	Bu görevde bekleyen görevleri engelleyerek bunların zamanlanmasını engeller.
satisfy	string	Bu görevde bekleyen görevleri karşılar; tüm bağımlılıklar karşılandıktan sonra görev çalıştırılacak şekilde zamanlanır.

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.

ExitCodeMapping

Görevden belirli bir çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.

Name	Tür	Description
code	integer	İşlem çıkış kodu.
exitOptions	ExitOptions	Görevden bu çıkış koduyla çıkılması durumunda Batch hizmetinin nasıl yanıt vermesi gerektiği.

ExitCodeRangeMapping

Çıkış kodları aralığı ve Batch hizmetinin bu aralıktaki çıkış kodlarına nasıl yanıt vermesi gerektiği.

Name	Tür	Description
end	integer	Aralıktaki son çıkış kodu.
exitOptions	ExitOptions	Görevden çıkış kodu aralık başından sonuna (dahil) çıkarsa Batch hizmetinin nasıl yanıt vermesi gerekir?
start	integer	Aralıktaki ilk çıkış kodu.

ExitConditions

Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir.

Name	Tür	Description
default	ExitOptions	Görev diğer özelliklerden herhangi biri tarafından kapsanmayan bir çıkış koşuluyla başarısız olursa Batch hizmetinin nasıl yanıt vermesi gerekir? Bu değer, Görev exitCodes veya exitCodeRanges koleksiyonunda listelenmeyen sıfır olmayan çıkış koduyla çıkılırsa, preProcessingError özelliği yoksa ön işleme hatasıyla veya fileUploadError özelliği yoksa dosya yükleme hatasıyla birlikte kullanılır. Çıkış kodu 0'da varsayılan olmayan bir davranış istiyorsanız, exitCodes veya exitCodeRanges koleksiyonunu kullanarak bunu açıkça listelemeniz gerekir.
exitCodeRanges	ExitCodeRangeMapping[]	Görev çıkış kodu aralıklarının listesi ve Batch hizmetinin bunlara nasıl yanıt vermesi gerektiği.
exitCodes	ExitCodeMapping[]	Tek tek Görev çıkış kodlarının listesi ve Batch hizmetinin bunlara nasıl yanıt vermesi gerektiği.
fileUploadError	ExitOptions	Dosya karşıya yükleme hatası oluşursa Batch hizmetinin nasıl yanıt vermesi gerekir? Görevden exitCodes veya exitCodeRanges aracılığıyla belirtilen bir çıkış koduyla çıktıysa ve sonra bir dosya yükleme hatasıyla karşılaştıysa, çıkış kodu tarafından belirtilen eylem önceliklidir.
preProcessingError	ExitOptions	Görev bir hata nedeniyle başlatılamıyorsa Batch hizmetinin nasıl yanıt vermesi gerektiği.

ExitOptions

Batch hizmetinin belirli bir çıkış koşuluna nasıl yanıt vereceğini belirtir.

Name	Tür	Description
dependencyAction	DependencyAction	Batch hizmetinin bu Göreve bağlı Görevler üzerinde gerçekleştirdiği bir eylem. Olası değerler 'tatmin' (bağımlı görevlerin ilerlemesine izin verme) ve 'engelle' (bağımlı görevler beklemeye devam eder). Batch henüz bağımlı görevlerin iptalini desteklemez.
jobAction	JobAction	Görev belirtilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem. Varsayılan değer 0 çıkış kodu için yoktur ve diğer tüm çıkış koşulları için sonlandırılır. İşin onTaskFailed özelliği noaction ise, bu özelliğin belirtilmesi bir hata döndürür ve Görev ekleme isteği geçersiz özellik değeri hatasıyla başarısız olur; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).

HttpHeader

HTTP üst bilgisi ad-değer çifti

Name	Tür	Description
name	string	Çıkış dosyaları karşıya yüklenirken kullanılacak üst bilginin büyük/küçük harfe duyarlı olmayan adı
value	string	Çıkış dosyaları karşıya yüklenirken kullanılacak üst bilginin değeri

JobAction

Görev belirtilen çıkış koşuluyla tamamlanırsa ve İşin onTaskFailed özelliği 'performExitOptionsJobAction' ise, Görevi içeren İş üzerinde gerçekleştirilecek bir eylem.

Name	Tür	Description
disable	string	İşi devre dışı bırakın. Bu, disableTasks değeri requeue olan disable Job API'sini çağırmaya eşdeğerdir.
none	string	Hiçbir işlem yapılmaz.
terminate	string	İşi sonlandırın. İşin executionInfo'sunda terminateReason "TaskFailed" olarak ayarlanır.

MultiInstanceSettings

Çok örnekli bir Görevin nasıl çalıştırılacağını belirten ayarlar.

Name	Tür	Description
commonResourceFiles	ResourceFile[]	Batch hizmetinin koordinasyon komut satırını çalıştırmadan önce indireceği dosyaların listesi. Ortak kaynak dosyaları ile Görev kaynak dosyaları arasındaki fark, ortak kaynak dosyalarının birincil dahil olmak üzere tüm alt görevler için indirilmiş olması, Görev kaynak dosyalarının ise yalnızca birincil için indirilmiş olmasıdır. Ayrıca, bu kaynak dosyalarının Görev çalışma dizinine indirilmediğini, bunun yerine Görev kök dizinine (çalışma dizininin üstündeki bir dizin) indirildiğini unutmayın. Kaynak dosyaları listesi için en büyük boyut vardır. En büyük 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.
coordinationCommandLine	string	Birincil görev ana Görev komutunu çalıştırdığında eşgüdümlü olmalarını sağlamak için tüm İşlem Düğümlerinde çalıştırılacak komut satırı. Tipik bir koordinasyon komut satırı bir arka plan hizmeti başlatır ve hizmetin düğümler arası iletileri işlemeye hazır olduğunu doğrular.
numberOfInstances	integer	Görev için gereken İşlem Düğümlerinin sayısı. Atlanırsa, varsayılan değer 1'dir.

OutputFile

Batch hizmeti Görev işlemini yürütmeyi tamamladıktan sonra Azure Batch İşlem Düğümü'nden başka bir konuma dosya yüklemeye yönelik belirtim.

Name	Tür	Description
destination	OutputFileDestination	Çıkış dosyalarının hedefi.
filePattern	string	Hangi dosyaları karşıya yükleyeceklerini gösteren desen. Hem göreli hem de mutlak yollar desteklenir. Göreli yollar Görev çalışma dizinine göredir. Aşağıdaki joker karakterler desteklenir: * 0 veya daha fazla karakterle eşleşir (örneğin, abc deseni* abc veya abcdef ile eşleşir), ** herhangi bir dizinle eşleşir, ? tek bir karakterle, [abc] köşeli ayraçtaki bir karakterle ve [a-c] aralıktaki bir karakterle eşleşir. Köşeli ayraçlar, belirtilmeyen herhangi bir karakterle (örneğin [!abc] a, b veya c dışında herhangi bir karakterle eşleşir) eşleşmesi için bir olumsuzlama içerebilir. Dosya adı "." ile başlıyorsa, varsayılan olarak yoksayılır ancak açıkça belirtilerek eşleştirilebilir (örneğin .gif .a.gifeşleşmez, ancak.gif eşleşir). Basit bir örnek: ***.txt , '.' ile başlamayan ve Görev çalışma dizininde veya herhangi bir alt dizinde .txt ile biten dosyalarla eşleşir. Dosya adı joker karakter içeriyorsa köşeli ayraçlar kullanılarak (örneğin, abc[], abc) adlı bir dosyayla eşleşebilir. Hem \ hem de / değerlerinin Windows'ta dizin ayırıcısı olarak ele alındıklarına, ancak yalnızca / 'nin Linux'ta olduğuna dikkat edin. Ortam değişkenleri (Windows'ta%var% veya Linux'ta $var) desen uygulanmadan önce genişletilir.
uploadOptions	OutputFileUploadOptions	Karşıya yükleme işleminin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere, karşıya yükleme işlemi için ek seçenekler.

OutputFileBlobContainerDestination

Azure blob depolama kapsayıcısı içinde bir dosya karşıya yükleme hedefi belirtir.

Name	Tür	Description
containerUrl	string	Azure Blob Depolama'da dosyaları karşıya yüklenecek kapsayıcının URL'si. Yönetilen kimlik kullanılmıyorsa, URL'nin kapsayıcıya yazma izinleri veren bir Paylaşılan Erişim İmzası (SAS) içermesi gerekir.
identityReference	ComputeNodeIdentityReference	containerUrl tarafından belirtilen Azure Blob Depolama'ya erişmek için kullanılacak kullanıcı tarafından atanan kimliğe başvuru Kimliğin Azure Blob Depolama kapsayıcısına yazma erişimi olmalıdır
path	string	Azure Depolama kapsayıcısı içindeki hedef blob veya sanal dizin. filePattern belirli bir dosyaya başvuruyorsa (yani joker karakter içermiyorsa), yol bu dosyanın karşıya yüklendiği blobun adıdır. filePattern bir veya daha fazla joker karakter içeriyorsa (ve bu nedenle birden çok dosyayla eşleşebilirse), yol, dosyaların karşıya yüklendiği blob sanal dizininin adıdır (her blob adına eklenir). Belirtilmezse, dosyalar kapsayıcının köküne, dosya adıyla eşleşen bir blob adıyla yüklenir.
uploadHeaders	HttpHeader[]	Çıktı dosyalarını karşıya yüklerken kullanılacak üst bilgilerin ad-değer çiftlerinin listesi Bu üst bilgiler, Dosyaları Azure Depolama'ya yüklerken belirtilir. Blobları karşıya yüklerken izin verilen üst bilgilerle ilgili resmi belge: https://docs.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

Dosyanın karşıya yüklenmesi gereken hedef.

Name	Tür	Description
container	OutputFileBlobContainerDestination	Azure blob depolamada dosyaların karşıya yüklendiği konum.

OutputFileUploadCondition

Görev çıktı dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar.

Name	Tür	Description
taskcompletion	string	Çıkış kodu ne olursa olsun Görev işlemi çıktıktan sonra dosyaları karşıya yükleyin.
taskfailure	string	Dosyaları yalnızca Görev işlemi sıfır olmayan bir çıkış koduyla çıktıktan sonra karşıya yükleyin.
tasksuccess	string	Dosyaları yalnızca Görev işlemi 0 çıkış koduyla çıktıktan sonra karşıya yükleyin.

OutputFileUploadOptions

Karşıya yüklemenin hangi koşullar altında gerçekleştirildiği de dahil olmak üzere bir çıktı dosyası karşıya yükleme işlemiyle ilgili ayrıntılar.

Name	Tür	Description
uploadCondition	OutputFileUploadCondition	Görev çıktı dosyasının veya dosya kümesinin karşıya yüklenmesi gereken koşullar. Varsayılan değer görev derlemedir.

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 indirilmesi gereken dizindir. filePath'in dizin olarak kullanıldığı durumlarda, giriş verileriyle zaten ilişkili tüm dizin yapıları 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'yı işaret ederse işlem düğümlerinden okunabilir olmalıdır. Azure depolama alanındaki bir blob için böyle bir URL almanın üç yolu vardır: Blob üzerinde okuma izinleri veren Paylaşılan Erişim İmzası (SAS) dahil, okuma izni olan bir yönetilen 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'ya 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) dahil, okuma ve liste izinleri olan yönetilen bir kimlik kullanın veya kapsayıcının ACL'sini genel erişime izin verecek şekilde ayarlayın.

TaskAddParameter

Eklenecek bir Azure Batch Görevi.

Name	Tür	Description
affinityInfo	AffinityInformation	Batch hizmeti tarafından yeni Görevin başlatılacağı bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.
applicationPackageReferences	ApplicationPackageReference[]	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne dağıtacağı Paketlerin listesi. Uygulama paketleri indirilir ve Görev çalışma dizinine değil paylaşılan bir dizine dağıtılır. Bu nedenle, başvuruda bulunılan bir paket zaten Node'daysa ve güncelse, yeniden indirılmaz; İşlem Düğümündeki mevcut kopya kullanılır. Başvurulan bir Paket, örneğin paket silindiği veya indirilemediği için yüklenemediyse, Görev başarısız olur.
authenticationTokenSettings	AuthenticationTokenSettings	Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu özellik ayarlanırsa Batch hizmeti, Bir Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci ile Görev sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, Bir Görev, İş'e başka Görevler eklemek için İş izinleri isteyebilir veya İşin veya İş altındaki diğer Görevlerin durumunu denetleyebilir.
commandLine	string	Görevin komut satırı. Çok örnekli Görevler için, birincil Görev ve tüm alt görevler koordinasyon komut satırını yürütmeyi bitirdikten sonra komut satırı birincil Görev olarak yürütülür. Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletme 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/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.
constraints	TaskConstraints	Bu Göreve uygulanan yürütme kısıtlamaları. Kısıtlamaları belirtmezseniz maxTaskRetryCount, İş için belirtilen maxTaskRetryCount değeridir, maxWallClockTime değeri sonsuzdur ve retentionTime değeri 7 gündür.
containerSettings	TaskContainerSettings	Görevin altında çalıştığı kapsayıcının ayarları. Bu Görevi çalıştıracak Havuz containerConfiguration kümesine sahipse, bunun da ayarlanması gerekir. Bu Görevi çalıştıracak Havuzda containerConfiguration ayarlanmamışsa, bu ayar yapılmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya 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.
dependsOn	TaskDependencies	Bu Görevin bağlı olduğu Görevler. Bağımlı olduğu tüm Görevler başarıyla tamamlanana kadar bu Görev zamanlanmaz. Bu Görevlerden herhangi biri başarısız olursa ve yeniden deneme sayılarını tüketirse, bu Görev hiçbir zaman zamanlanamaz. İşin usesTaskDependencies değeri true olarak ayarlanmamışsa ve bu öğe mevcutsa istek TaskDependenciesNotSpecifiedOnJob hata koduyla başarısız olur.
displayName	string	Görev için görünen ad. Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğa kadar unicode karakter içerebilir.
environmentSettings	EnvironmentSetting[]	Görev için ortam değişkeni ayarlarının listesi.
exitConditions	ExitConditions	Görev tamamlandığında Batch hizmetinin nasıl yanıt vereceğini belirtir. Görev tamamlandığında Batch hizmetinin nasıl yanıt vermesi gerektiği.
id	string	İş içindeki Görevi 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 fazla karakter içeremez. Kimlik büyük/küçük harf koruyucu ve büyük/küçük harfe duyarlı değildir (yani, bir İş içinde yalnızca büyük/küçük harfe göre farklılık gösteren iki kimliğiniz olmayabilir).
multiInstanceSettings	MultiInstanceSettings	Görevin çok örnekli bir Görev olduğunu belirten ve çok örnekli Görevin nasıl çalıştırıldığını gösteren bir nesne. Çok Örnekli Görevler genellikle MPI Görevlerini desteklemek için kullanılır. MPI örneğinde, alt görevlerden herhangi biri başarısız olursa (örneğin, sıfır olmayan bir çıkış koduyla çıkılması nedeniyle) çok örnekli Görevin tamamı başarısız olur. Çok örnekli Görev daha sonra sonlandırılır ve yeniden denenerek yeniden deneme sınırına kadar devam eder.
outputFiles	OutputFile[]	Komut satırını çalıştırdıktan sonra Batch hizmetinin İşlem Düğümü'nden karşıya yükleyeceği dosyaların listesi. Çok örnekli Görevler için dosyalar yalnızca birincil Görevin yürütüleceği İşlem Düğümü'nden karşıya yüklenir.
requiredSlots	integer	Görevin çalışması için gereken zamanlama yuvalarının sayısı. Varsayılan değer 1'dir. Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu 1 olmalıdır.
resourceFiles	ResourceFile[]	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne indireceği dosyaların listesi. Çok örnekli Görevler için kaynak dosyaları yalnızca birincil Görevin yürütüleceği İşlem Düğümüne indirilir. Kaynak dosyaları listesi için en büyük boyut vardır. En büyük 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.
userIdentity	UserIdentity	Görevin çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

TaskConstraints

Göreve uygulanacak yürütme kısıtlamaları.

Name	Tür	Description
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, sıfır olmayan bir çıkış kodu nedeniyle Görev yürütülebilir dosyası için yeniden deneme sayısını özellikle denetlediğini unutmayın. Batch hizmeti Görevi bir kez dener ve bu sınıra kadar yeniden deneyebilir. Örneğin, yeniden deneme sayısı üst sınırı 3 ise Batch Görevi en fazla 4 kez dener (ilk deneme ve 3 yeniden deneme). Yeniden deneme sayısı üst sınırı 0 ise, Batch hizmeti ilk denemeden sonra 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 yok).
maxWallClockTime	string	Görevin çalıştırabileceği, Görevin başladığı zamandan ölçülen en uzun süre. Görev zaman sınırı içinde tamamlanmazsa Batch hizmeti görevi sonlandırır. Bu belirtilmezse, Görevin ne kadar süreyle çalışabileceğine ilişkin bir zaman sınırı yoktur.
retentionTime	string	Yürütmeyi tamamladığı zamandan itibaren görev dizinini çalıştığı İşlem Düğümünde tutmak için gereken en düşük süre. Bu süreden sonra Batch hizmeti Görev dizinini ve tüm içeriğini silebilir. Varsayılan değer 7 gündür; yani İşlem Düğümü kaldırılmadığı veya İş silinmediği sürece Görev dizini 7 gün boyunca saklanır.

TaskContainerSettings

Görev için kapsayıcı ayarları.

Name	Tür	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Kapsayıcı görevine bağlanmak istediğiniz yollar. Bu dizi null ise veya yoksa, kapsayıcı görevi windows'ta (veya Linux'ta AZ_BATCH_NODE_ROOT_DIR) geçici disk sürücüsünün tamamını bağlar. Bu dizi boş olarak ayarlanırsa kapsayıcıya veri yolu bağlamaz.
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, 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.

TaskDependencies

Görevin bağımlılıklarını belirtir. Bağımlı Görevin zamanlanmasından önce açıkça belirtilen veya bağımlılık aralığındaki tüm Görevlerin tamamlanması gerekir.

Name	Tür	Description
taskIdRanges	TaskIdRange[]	Bu Görevin bağlı olduğu Görev Kimliği aralıklarının listesi. Bağımlı Görevin zamanlayabilmesi için tüm aralıklardaki tüm Görevlerin başarıyla tamamlanması gerekir.
taskIds	string[]	Bu Görevin bağlı olduğu Görev Kimliklerinin listesi. Bağımlı Görevin zamanlayabilmesi için bu listedeki tüm Görevlerin başarıyla tamamlanması gerekir. taskIds koleksiyonu toplam 64000 karakterle sınırlıdır (tüm Görev Kimliklerinin birleşik uzunluğu). taskIds koleksiyonu uzunluk üst sınırını aşarsa, Görev Ekle isteği TaskDependencyListTooLong hata koduyla başarısız olur. Bu durumda bunun yerine Görev Kimliği aralıklarını kullanmayı göz önünde bulundurun.

TaskIdRange

Bir Görevin bağlı olabileceği görev kimlikleri aralığı. Bağımlı Görevin zamanlanması için önce aralıktaki kimlikleri olan tüm Görevlerin başarıyla tamamlanması gerekir.

Name	Tür	Description
end	integer	Aralıktaki son Görev Kimliği.
start	integer	Aralıktaki ilk Görev Kimliği.

UserIdentity

Görevin ç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 çalıştırıldığı kullanıcı kimliğinin adı. userName ve autoUser özellikleri birbirini dışlar; birini belirtmeniz gerekir, ancak ikisini birden belirtmemelisiniz.