BatchTaskOutput interface

Paket:

@azure-rest/batch

Batch, Bir Düğümde kurtarma işlemi tetiklendiğinde Görevleri yeniden dener. İyi durumda olmayan bir Düğüm yeniden başlatıldığında veya konak hatası nedeniyle bir İşlem Düğümü kaybolduğunda kurtarma işlemlerine örnek olarak verilebilir (ancak bunlarla sınırlı değildir). Kurtarma işlemleri nedeniyle yapılan yeniden denemeler, maxTaskRetryCount'a göre bağımsızdır ve sayılmaz. maxTaskRetryCount değeri 0 olsa bile, kurtarma işlemi nedeniyle bir iç yeniden deneme gerçekleşebilir. Bu nedenle, tüm Görevler bir kez etkili olmalıdır. Bu, Görevlerin bozulmaya veya yinelenen verilere neden olmadan kesintiye uğramasına ve yeniden başlatılmasına tolerans göstermesi gerektiği anlamına gelir. Uzun süre çalışan Görevler için en iyi yöntem, bir tür denetim noktası kullanmaktır.

Ö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ı.
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.
creationTime	Görevin oluşturma zamanı.
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.
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.
eTag	Görevin ETag'i. Bu, opak bir dizedir. Görev'in istekler arasında değişip değişmediğini algılamak için bunu kullanabilirsiniz. Özellikle, bir Görevi güncelleştirirken ETag'i geçirerek, değişikliklerinizin yalnızca bu sırada başka kimsenin Görevi değiştirmemiş olması durumunda geçerli olacağını belirtebilirsiniz.
executionInfo	Görevin yürütülmesi hakkında bilgi.
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.
lastModified	Görevin son değiştirme zamanı.
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.
nodeInfo	Görevin üzerinde çalıştırıldığı İşlem Düğümü hakkında bilgi.
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.
previousState	Görevin önceki durumu. Görev ilk Etkin durumundaysa bu özellik ayarlanmaz. Olası değerler: "active", "preparing", "running", "completed"
previousStateTransitionTime	Görevin önceki durumuna girdiği saat. Görev ilk Etkin durumundaysa bu özellik ayarlanmaz.
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.
state	Görevin geçerli durumu. Olası değerler: "active", "preparing", "running", "completed"
stateTransitionTime	Görevin geçerli durumuna girdiği saat.
stats	Görev için kaynak kullanım istatistikleri.
url	Görevin URL'si.
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?: BatchAffinityInfoOutput

Özellik Değeri

BatchAffinityInfoOutput

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?: BatchApplicationPackageReferenceOutput[]

Özellik Değeri

BatchApplicationPackageReferenceOutput[]

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?: AuthenticationTokenSettingsOutput

Özellik Değeri

AuthenticationTokenSettingsOutput

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ı.

constraints?: BatchTaskConstraintsOutput

Özellik Değeri

BatchTaskConstraintsOutput

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?: BatchTaskContainerSettingsOutput

Özellik Değeri

BatchTaskContainerSettingsOutput

creationTime

Görevin oluşturma zamanı.

creationTime: string

Özellik Değeri

string

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.

dependsOn?: BatchTaskDependenciesOutput

Özellik Değeri

BatchTaskDependenciesOutput

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?: EnvironmentSettingOutput[]

Özellik Değeri

EnvironmentSettingOutput[]

eTag

Görevin ETag'i. Bu, opak bir dizedir. Görev'in istekler arasında değişip değişmediğini algılamak için bunu kullanabilirsiniz. Özellikle, bir Görevi güncelleştirirken ETag'i geçirerek, değişikliklerinizin yalnızca bu sırada başka kimsenin Görevi değiştirmemiş olması durumunda geçerli olacağını belirtebilirsiniz.

eTag: string

Özellik Değeri

string

executionInfo

Görevin yürütülmesi hakkında bilgi.

executionInfo?: BatchTaskExecutionInfoOutput

Özellik Değeri

BatchTaskExecutionInfoOutput

exitConditions

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

exitConditions?: ExitConditionsOutput

Özellik Değeri

ExitConditionsOutput

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.

id: string

Özellik Değeri

string

lastModified

Görevin son değiştirme zamanı.

lastModified: 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?: MultiInstanceSettingsOutput

Özellik Değeri

MultiInstanceSettingsOutput

nodeInfo

Görevin üzerinde çalıştırıldığı İşlem Düğümü hakkında bilgi.

nodeInfo?: BatchNodeInfoOutput

Özellik Değeri

BatchNodeInfoOutput

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?: OutputFileOutput[]

Özellik Değeri

OutputFileOutput[]

previousState

Görevin önceki durumu. Görev ilk Etkin durumundaysa bu özellik ayarlanmaz.

Olası değerler: "active", "preparing", "running", "completed"

previousState?: string

Özellik Değeri

string

previousStateTransitionTime

Görevin önceki durumuna girdiği saat. Görev ilk Etkin durumundaysa bu özellik ayarlanmaz.

previousStateTransitionTime?: string

Özellik Değeri

string

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?: ResourceFileOutput[]

Özellik Değeri

ResourceFileOutput[]

state

Görevin geçerli durumu.

Olası değerler: "active", "preparing", "running", "completed"

state: string

Özellik Değeri

string

stateTransitionTime

Görevin geçerli durumuna girdiği saat.

stateTransitionTime: string

Özellik Değeri

string

stats

Görev için kaynak kullanım istatistikleri.

stats?: BatchTaskStatisticsOutput

Özellik Değeri

BatchTaskStatisticsOutput

url

Görevin URL'si.

url: string

Özellik Değeri

string

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?: UserIdentityOutput

Özellik Değeri

UserIdentityOutput