BatchTaskCreateOptions interface

Paket:

@azure-rest/batch

Azure Batch Görevi oluşturma parametreleri.

Özellikler

affinityInfo	Batch hizmeti tarafından yeni Görevin başlatılacağı bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.
applicationPackageReferences	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	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	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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.
constraints	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	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	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	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	Görev için ortam değişkeni ayarlarının listesi.
exitConditions	Görev tamamlandığında Batch hizmetinin nasıl yanıt vermesi gerektiği.
id	İş 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	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.
outputFiles	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	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	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	Görevin çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

Özellik Ayrıntıları

affinityInfo

Batch hizmeti tarafından yeni Görevin başlatılacağı bir İşlem Düğümü seçmek için kullanılabilecek bir yerellik ipucu.

affinityInfo?: BatchAffinityInfo

Özellik Değeri

BatchAffinityInfo

applicationPackageReferences

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.

applicationPackageReferences?: BatchApplicationPackageReference[]

Özellik Değeri

BatchApplicationPackageReference[]

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.

authenticationTokenSettings?: AuthenticationTokenSettings

Özellik Değeri

AuthenticationTokenSettings

commandLine

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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.

commandLine: string

Özellik Değeri

string

constraints

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.

constraints?: BatchTaskConstraints

Özellik Değeri

BatchTaskConstraints

containerSettings

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.

containerSettings?: BatchTaskContainerSettings

Özellik Değeri

BatchTaskContainerSettings

dependsOn

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.

dependsOn?: BatchTaskDependencies

Özellik Değeri

BatchTaskDependencies

displayName

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.

displayName?: string

Özellik Değeri

string

environmentSettings

Görev için ortam değişkeni ayarlarının listesi.

environmentSettings?: EnvironmentSetting[]

Özellik Değeri

EnvironmentSetting[]

exitConditions

Görev tamamlandığında Batch hizmetinin nasıl yanıt vermesi gerektiği.

exitConditions?: ExitConditions

Özellik Değeri

ExitConditions

id

İş 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).

id: string

Özellik Değeri

string

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.

multiInstanceSettings?: MultiInstanceSettings

Özellik Değeri

MultiInstanceSettings

outputFiles

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.

outputFiles?: OutputFile[]

Özellik Değeri

OutputFile[]

requiredSlots

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.

requiredSlots?: number

Özellik Değeri

number

resourceFiles

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.

resourceFiles?: ResourceFile[]

Özellik Değeri

ResourceFile[]

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.

userIdentity?: UserIdentity

Özellik Değeri

UserIdentity