TaskAddParameter Sınıf

Eklenecek bir Azure Batch Görevi.

Batch, Düğümde bir 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 yeniden denemeler şunlardan bağımsızdır ve maxTaskRetryCount'a göre 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.

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

Devralma

Model

TaskAddParameter

Oluşturucu

TaskAddParameter(*, id: str, command_line: str, display_name: str = None, container_settings=None, exit_conditions=None, resource_files=None, output_files=None, environment_settings=None, affinity_info=None, constraints=None, required_slots: int = None, user_identity=None, multi_instance_settings=None, depends_on=None, application_package_references=None, authentication_token_settings=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 (yani, bir İş içinde 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.

command_line

str

Gerekli

Gereklidir. Ç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ş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).

container_settings

TaskContainerSettings

Gerekli

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, ayarlanmamalıdır. 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 ana bilgisayar diskine yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.

exit_conditions

ExitConditions

Gerekli

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

resource_files

list[ResourceFile]

Gerekli

Ç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. Maksimum boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu küçültülmelidir. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.

output_files

list[OutputFile]

Gerekli

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

environment_settings

list[EnvironmentSetting]

Gerekli

affinity_info

AffinityInformation

Gerekli

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

constraints

TaskConstraints

Gerekli

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.

required_slots

int

Gerekli

Görevin çalışması için gereken zamanlama yuvası sayısı. Varsayılan değer 1'dir. Bir Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa bir işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu 1 olmalıdır.

user_identity

UserIdentity

Gerekli

Görevin altında çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

multi_instance_settings

MultiInstanceSettings

Gerekli

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.

depends_on

TaskDependencies

Gerekli

Bu Görevin bağımlı olduğu Görevler. Bağlı 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 varsa, istek TaskDependenciesNotSpecifiedOnJob hata koduyla başarısız olur.

application_package_references

list[ApplicationPackageReference]

Gerekli

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 indirme başarısız olduğu için yüklenemediğinde Görev başarısız olur.

authentication_token_settings

AuthenticationTokenSettings

Gerekli

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu özellik ayarlanırsa Batch hizmeti, Görev'e Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci 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, işe başka Görevler eklemek için İş izinleri isteyebilir veya İşin durumunu ya da İş altındaki diğer Görevlerin durumunu denetleyebilir.

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