JobAddParameter الفصل

وظيفة Azure Batch لإضافتها.

يجب ملء جميع المعلمات المطلوبة لإرسالها إلى Azure.

توريث

Model

JobAddParameter

الدالمنشئ

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)

المعلمات

id

str

مطلوب

مطلوب يمكن أن يحتوي المعرف على أي مجموعة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. المعرف هو الحفاظ على حالة الأحرف وغير حساس لحالة الأحرف (أي، قد لا يكون لديك معرفان داخل حساب يختلفان فقط حسب الحالة).

display_name

str

مطلوب

لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.

priority

int

مطلوب

أولوية الوظيفة. يمكن أن تتراوح قيم الأولوية من -1000 إلى 1000، مع أن يكون -1000 أقل أولوية و1000 هو الأولوية القصوى. القيمة الافتراضية هي 0.

max_parallel_tasks

int

مطلوب

الحد الأقصى لعدد المهام التي يمكن تنفيذها بالتوازي مع المهمة. يجب أن تكون قيمة maxParallelTasks -1 أو أكبر من 0 إذا تم تحديدها. إذا لم يتم تحديدها، فإن القيمة الافتراضية هي -1، ما يعني أنه لا يوجد حد لعدد المهام التي يمكن تشغيلها في وقت واحد. يمكنك تحديث maxParallelTasks الخاصة بالمهمة بعد إنشائها باستخدام واجهة برمجة تطبيقات مهمة التحديث. القيمة الافتراضية: -1 .

allow_task_preemption

bool

مطلوب

ما إذا كان يمكن استباق المهام في هذه الوظيفة بواسطة وظائف أخرى ذات أولوية عالية. إذا تم تعيين القيمة إلى True، فإن المهام الأخرى ذات الأولوية العالية المرسلة إلى النظام ستكون لها الأسبقية وستكون قادرة على إعادة ترتيب المهام من هذه الوظيفة. يمكنك تحديث allowTaskPreemption للوظيفة بعد إنشائها باستخدام واجهة برمجة تطبيقات مهمة التحديث.

constraints

JobConstraints

مطلوب

قيود التنفيذ للوظيفة.

job_manager_task

JobManagerTask

مطلوب

تفاصيل مهمة مدير الوظيفة التي سيتم تشغيلها عند بدء المهمة. إذا لم تحدد الوظيفة مهمة مدير الوظيفة، فيجب على المستخدم إضافة مهام بشكل صريح إلى المهمة. إذا حددت الوظيفة مهمة مدير الوظيفة، تقوم خدمة Batch بإنشاء مهمة مدير الوظيفة عند إنشاء المهمة، وستحاول جدولة مهمة مدير الوظيفة قبل جدولة المهام الأخرى في الوظيفة. الغرض النموذجي لمهمة مدير الوظيفة هو التحكم في تنفيذ المهمة و/أو مراقبته، على سبيل المثال عن طريق تحديد المهام الإضافية المطلوب تشغيلها، وتحديد وقت اكتمال العمل، وما إلى ذلك. (ومع ذلك، لا تقتصر مهمة مدير الوظائف على هذه الأنشطة - إنها مهمة كاملة في النظام وتنفذ أي إجراءات مطلوبة للوظيفة.) على سبيل المثال، قد تقوم مهمة مدير الوظيفة بتنزيل ملف محدد كمعلمة، وتحليل محتويات هذا الملف وإرسال مهام إضافية استنادا إلى تلك المحتويات.

job_preparation_task

JobPreparationTask

مطلوب

مهمة إعداد الوظيفة. إذا كانت الوظيفة تحتوي على مهمة إعداد مهمة، فستشغل خدمة Batch مهمة إعداد الوظيفة على عقدة قبل بدء أي مهام لهذه المهمة على عقدة الحساب هذه.

job_release_task

JobReleaseTask

مطلوب

مهمة إصدار الوظيفة. لا يمكن تحديد مهمة إصدار الوظيفة دون تحديد مهمة إعداد الوظيفة للوظيفة أيضا. تقوم خدمة Batch بتشغيل مهمة إصدار الوظيفة على العقد التي شغلت مهمة إعداد الوظيفة. الغرض الأساسي من مهمة إصدار الوظيفة هو التراجع عن التغييرات التي تم إجراؤها على عقد الحوسبة التي تم إجراؤها بواسطة مهمة إعداد الوظيفة. تتضمن الأنشطة المثال حذف الملفات المحلية أو إيقاف تشغيل الخدمات التي بدأت كجزء من إعداد الوظيفة.

common_environment_settings

list[EnvironmentSetting]

مطلوب

يمكن للمهام الفردية تجاوز إعداد بيئة محدد هنا عن طريق تحديد نفس اسم الإعداد بقيمة مختلفة.

pool_info

PoolInformation

مطلوب

مطلوب التجمع الذي تقوم خدمة Batch بتشغيل مهام الوظيفة عليه.

on_all_tasks_complete

str أو OnAllTasksComplete

مطلوب

الإجراء الذي يجب أن تتخذه خدمة Batch عندما تكون جميع المهام في الوظيفة في حالة مكتملة. لاحظ أنه إذا كانت الوظيفة لا تحتوي على مهام، فسيتم اعتبار جميع المهام مكتملة. لذلك يتم استخدام هذا الخيار الأكثر شيوعا مع مهمة Job Manager؛ إذا كنت ترغب في استخدام إنهاء المهمة التلقائي دون مدير وظيفة، فيجب عليك في البداية تعيين OnAllTasksComplete إلى noaction وتحديث خصائص المهمة لتعيين onAllTasksComplete إلى finishjob بمجرد الانتهاء من إضافة المهام. الافتراضي هو noaction. تتضمن القيم المحتملة: "noAction" و"terminateJob"

on_task_failure

str أو OnTaskFailure

مطلوب

الإجراء الذي يجب أن تتخذه خدمة Batch عند فشل أي مهمة في الوظيفة. تعتبر المهمة قد فشلت إذا كانت تحتوي على failureInfo. يتم تعيين failureInfo إذا اكتملت المهمة برمز خروج غير صفري بعد استنفاد عدد مرات إعادة المحاولة الخاصة بها، أو إذا كان هناك خطأ في بدء المهمة، على سبيل المثال بسبب خطأ تنزيل ملف مورد. الافتراضي هو noaction. تتضمن القيم المحتملة: "noAction"، "performExitOptionsJobAction"

metadata

list[MetadataItem]

مطلوب

لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.

uses_task_dependencies

bool

مطلوب

ما إذا كانت المهام في الوظيفة يمكنها تحديد التبعيات على بعضها البعض. يعد الافتراضي غير صحيح.

network_configuration

JobNetworkConfiguration

مطلوب

تكوين الشبكة للوظيفة.

الأساليب

as_dict	إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump. قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا: المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن. سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر ذلك إملاءا للنتيجة الهرمية. راجع الأمثلة الثلاثة في هذا الملف: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
deserialize	تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.
enable_additional_properties_sending
from_dict	تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا. بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج. هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ). إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
validate	تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

as_dict

إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump.

قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا:

المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن.

سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر ذلك إملاءا للنتيجة الهرمية.

راجع الأمثلة الثلاثة في هذا الملف:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

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

المعلمات

key_transformer

<xref:function>

دالة محول مفاتيح.

keep_readonly

القيمة الافتراضية: True

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

deserialize

تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.

deserialize(data, content_type=None)

المعلمات

data

str

مطلوب

سلسلة باستخدام بنية RestAPI. JSON بشكل افتراضي.

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا.

بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)

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

المعلمات

data

dict

مطلوب

إملاء باستخدام بنية RestAPI

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

key_extractors

القيمة الافتراضية: None

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج.

هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ).

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

المعلمات

keep_readonly

bool

القيمة الافتراضية: False

إذا كنت تريد إجراء تسلسل للسمات للقراءة فقط

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

validate

تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

validate()

المرتجعات

قائمة بخطأ التحقق من الصحة

نوع الإرجاع

list