JobAddParameter Sınıf

Eklenecek bir Azure Batch İşi.

Azure'a göndermek için tüm gerekli parametrelerin doldurulması gerekir.

Devralma

Model

JobAddParameter

Oluşturucu

JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=None, **kwargs)

Parametreler

id

str

Gerekli

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

display_name

str

Gerekli

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

priority

int

Gerekli

İşin önceliği. Öncelik değerleri -1000 ile 1000 arasında değişebilir ve -1000 en düşük öncelik ve 1000 en yüksek önceliktir. Varsayılan değer 0’dır.

max_parallel_tasks

int

Gerekli

İş için paralel olarak yürütülebilecek en fazla görev sayısı. maxParallelTasks değeri -1 veya belirtilirse 0'dan büyük olmalıdır. Belirtilmezse, varsayılan değer -1'dir ve bu da aynı anda çalıştırılacak görev sayısıyla ilgili bir sınır olmadığı anlamına gelir. Güncelleştirme işi API'sini kullanarak oluşturulduktan sonra işin maxParallelTasks değerini güncelleştirebilirsiniz. Varsayılan değer: -1 .

allow_task_preemption

bool

Gerekli

Bu işteki Görevlerin diğer yüksek öncelikli işler tarafından önlenip önlenemez olup olmadığı. Değer True olarak ayarlanırsa, sisteme gönderilen diğer yüksek öncelikli işler öncelikli olur ve bu işten görevleri yeniden sıralayabilecektir. Güncelleştirme işi API'sini kullanarak oluşturulduktan sonra işin allowTaskPreemption değerini güncelleştirebilirsiniz.

constraints

JobConstraints

Gerekli

İş için yürütme kısıtlamaları.

job_manager_task

JobManagerTask

Gerekli

İş başlatıldığında başlatılacak İş Yöneticisi Görevinin ayrıntıları. İş bir İş Yöneticisi Görevi belirtmezse, kullanıcının göreve açıkça Görev eklemesi gerekir. İş bir İş Yöneticisi Görevi belirtiyorsa, Batch hizmeti İş oluşturulduğunda İş Yöneticisi Görevini oluşturur ve İşteki diğer Görevleri zamanlamadan önce İş Yöneticisi Görevini zamanlamayı dener. İş Yöneticisi Görevinin tipik amacı, örneğin çalıştırılacak ek Görevlere karar vererek, işin ne zaman tamamleneceğini belirleyerek vb. İş yürütmeyi denetlemek ve/veya izlemektir. (Ancak, bir İş Yöneticisi Görevi bu etkinliklerle sınırlı değildir; sistemde tam teşekküllü bir Görevdir ve İş için gereken eylemleri gerçekleştirir.) Örneğin, bir İş Yöneticisi Görevi parametre olarak belirtilen bir dosyayı indirebilir, bu dosyanın içeriğini analiz edebilir ve bu içeriklere göre ek Görevler gönderebilir.

job_preparation_task

JobPreparationTask

Gerekli

İş Hazırlama Görevi. Bir İşin bir İş Hazırlama Görevi varsa, Batch hizmeti bu İşlem Düğümünde bu işin görevlerini başlatmadan önce Bir Düğümde İş Hazırlama Görevini çalıştırır.

job_release_task

JobReleaseTask

Gerekli

İş Serbest Bırakma Görevi. İş için bir İş Hazırlama Görevi de belirtilmeden bir İş Serbest Bırakma Görevi belirtilemez. Batch hizmeti, İş Hazırlama Görevini çalıştıran Düğümlerde İş Serbest Bırakma Görevi'ni çalıştırır. İş Bırakma Görevinin birincil amacı, İş Hazırlama Görevi tarafından yapılan İşlem Düğümleri değişikliklerini geri almaktır. Örnek etkinlikler arasında yerel dosyaları silme veya İş hazırlama kapsamında başlatılan hizmetleri kapatma sayılabilir.

common_environment_settings

list[EnvironmentSetting]

Gerekli

Tek Tek Görevler, farklı bir değerle aynı ayar adını belirterek burada belirtilen bir ortam ayarını geçersiz kılabilir.

pool_info

PoolInformation

Gerekli

Gereklidir. Batch hizmetinin İşin Görevlerini çalıştırdığı Havuz.

on_all_tasks_complete

str veya OnAllTasksComplete

Gerekli

İş'teki tüm Görevler tamamlanmış durumdayken Batch hizmetinin gerçekleştirmesi gereken eylem. Bir İşin Görev içermediğini, tüm Görevlerin tamamlanmış olarak kabul edildiğini unutmayın. Bu nedenle bu seçenek en yaygın olarak bir İş Yöneticisi göreviyle kullanılır; otomatik İş sonlandırmayı İş Yöneticisi olmadan kullanmak istiyorsanız, Başlangıçta onAllTasksComplete'i noaction olarak ayarlamanız ve Görev eklemeyi tamamladıktan sonra onAllTasksComplete'i terminatejob olarak ayarlamak için İş özelliklerini güncelleştirmeniz gerekir. Varsayılan değer noaction'dır. Olası değerler şunlardır: 'noAction', 'terminateJob'

on_task_failure

str veya OnTaskFailure

Gerekli

Batch hizmetinin İş'teki herhangi bir Görev başarısız olduğunda gerçekleştirmesi gereken eylem. FailureInfo varsa bir Görevin başarısız olduğu kabul edilir. Görev, yeniden deneme sayısı tüketildikten sonra sıfır olmayan bir çıkış koduyla tamamlanırsa veya görevi başlatırken bir hata oluştuysa (örneğin, bir kaynak dosyası indirme hatası) failureInfo ayarlanır. Varsayılan değer noaction'dır. Olası değerler şunlardır: 'noAction', 'performExitOptionsJobAction'

metadata

list[MetadataItem]

Gerekli

Batch hizmeti meta veriler için herhangi bir anlam atamaz; yalnızca kullanıcı kodunun kullanımına yöneliktir.

uses_task_dependencies

bool

Gerekli

İşteki Görevlerin birbirine bağımlılıkları tanımlayıp tanımlayamayacağı. Varsayılan değer false.

network_configuration

JobNetworkConfiguration

Gerekli

İş için ağ yapılandırması.

Yöntemler

as_dict	json.dump kullanarak JSONify olabilecek bir dikte döndürebilirsiniz. Gelişmiş kullanım isteğe bağlı olarak parametre olarak bir geri çağırma kullanabilir: Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc, meta verilerin bir diktesidir. Şu anda msrest türüyle 'type' ve RestAPI kodlanmış anahtarıyla 'key' içerir. Değer, bu nesnedeki geçerli değerdir. Döndürülen dize, anahtarı seri hale getirmek için kullanılır. Dönüş türü bir listeyse, bu hiyerarşik sonuç diktesi olarak kabul edilir. Bu dosyadaki üç örne bakın: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer XML serileştirme istiyorsanız, kwargs is_xml=True geçirebilirsiniz.
deserialize	RestAPI söz dizimini kullanarak bir str ayrıştırın ve bir model döndürün.
enable_additional_properties_sending
from_dict	Verilen anahtar ayıklayıcıyı kullanarak bir dikteyi ayrıştırma bir model döndürür. Varsayılan olarak anahtar ayıklayıcıları (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor ve last_rest_key_case_insensitive_extractor) göz önünde bulundurun
is_xml_model
serialize	Bu modelden Azure'a gönderilecek JSON kodunu döndür. Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır. XML serileştirme istiyorsanız, kwargs is_xml=True geçirebilirsiniz.
validate	Bu modeli yinelemeli olarak doğrulayın ve ValidationError listesini döndürür.

as_dict

json.dump kullanarak JSONify olabilecek bir dikte döndürebilirsiniz.

Gelişmiş kullanım isteğe bağlı olarak parametre olarak bir geri çağırma kullanabilir:

Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc, meta verilerin bir diktesidir. Şu anda msrest türüyle 'type' ve RestAPI kodlanmış anahtarıyla 'key' içerir. Değer, bu nesnedeki geçerli değerdir.

Döndürülen dize, anahtarı seri hale getirmek için kullanılır. Dönüş türü bir listeyse, bu hiyerarşik sonuç diktesi olarak kabul edilir.

Bu dosyadaki üç örne bakın:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

XML serileştirme istiyorsanız, kwargs is_xml=True geçirebilirsiniz.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Parametreler

key_transformer

<xref:function>

Anahtar transformatörü işlevi.

keep_readonly

varsayılan değer: True

Döndürülenler

JSON uyumlu bir dikte nesnesi

Dönüş türü

dict

deserialize

RestAPI söz dizimini kullanarak bir str ayrıştırın ve bir model döndürün.

deserialize(data, content_type=None)

Parametreler

data

str

Gerekli

RestAPI yapısını kullanan bir str. Varsayılan olarak JSON.

content_type

str

varsayılan değer: None

JSON varsayılan olarak, XML ise application/xml değerini ayarlayın.

Döndürülenler

Bu modelin bir örneği

Özel durumlar

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Verilen anahtar ayıklayıcıyı kullanarak bir dikteyi ayrıştırma bir model döndürür.

Varsayılan olarak anahtar ayıklayıcıları (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor ve last_rest_key_case_insensitive_extractor) göz önünde bulundurun

from_dict(data, key_extractors=None, content_type=None)

Parametreler

data

dict

Gerekli

RestAPI yapısını kullanan bir dikte

content_type

str

varsayılan değer: None

JSON varsayılan olarak, XML ise application/xml değerini ayarlayın.

key_extractors

varsayılan değer: None

Döndürülenler

Bu modelin bir örneği

Özel durumlar

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Bu modelden Azure'a gönderilecek JSON kodunu döndür.

Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır.

XML serileştirme istiyorsanız, kwargs is_xml=True geçirebilirsiniz.

serialize(keep_readonly=False, **kwargs)

Parametreler

keep_readonly

bool

varsayılan değer: False

Salt okunur öznitelikleri seri hale getirmek istiyorsanız

Döndürülenler

JSON uyumlu bir dikte nesnesi

Dönüş türü

dict

validate

Bu modeli yinelemeli olarak doğrulayın ve ValidationError listesini döndürür.

validate()

Döndürülenler

Doğrulama hatası listesi

Dönüş türü

list