TaskOperations الفصل

عمليات TaskOperations.

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

توريث

builtins.object

TaskOperations

الدالمنشئ

TaskOperations(client, config, serializer, deserializer)

المعلمات

client

مطلوب

العميل لطلبات الخدمة.

config

مطلوب

تكوين عميل الخدمة.

serializer

مطلوب

مسلسل نموذج كائن.

deserializer

مطلوب

إلغاء تسلسل نموذج كائن.

المتغيرات

api_version

إصدار API المراد استخدامه للطلب. القيمة الثابتة: "2023-05-01.17.0".

الأساليب

add	إضافة مهمة إلى المهمة المحددة. الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، فسيتم إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت.
add_collection	إضافة مجموعة من المهام إلى المهمة المحددة. لاحظ أن كل مهمة يجب أن يكون لها معرف فريد. قد لا ترجع خدمة Batch النتائج لكل مهمة بنفس الترتيب الذي تم إرسال المهام به في هذا الطلب. إذا انتهت مهلة الخادم أو تم إغلاق الاتصال أثناء الطلب، فربما تمت معالجة الطلب جزئيا أو بالكامل، أو لم تتم معالجته على الإطلاق. في مثل هذه الحالات، يجب على المستخدم إعادة إصدار الطلب. لاحظ أن الأمر متروك للمستخدم لمعالجة حالات الفشل بشكل صحيح عند إعادة إصدار طلب. على سبيل المثال، يجب عليك استخدام معرفات المهمة نفسها أثناء إعادة المحاولة بحيث إذا نجحت العملية السابقة، فلن تنشئ إعادة المحاولة مهاما إضافية بشكل غير متوقع. إذا كانت الاستجابة تحتوي على أي مهام فشلت في إضافتها، يمكن للعميل إعادة محاولة الطلب. في إعادة المحاولة، من الأكثر كفاءة إعادة إرسال المهام التي فشلت في إضافتها فقط، وحذف المهام التي تمت إضافتها بنجاح في المحاولة الأولى. الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، فسيتم إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت.
delete	حذف مهمة من المهمة المحددة. عند حذف مهمة، يتم أيضا حذف جميع الملفات الموجودة في دليلها على عقدة الحساب حيث تم تشغيلها (بغض النظر عن وقت الاستبقاء). بالنسبة للمهام متعددة المثيلات، تطبق عملية حذف المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم حذف المهام الفرعية وملفاتها بشكل غير متزامن في الخلفية.
get	الحصول على معلومات حول المهمة المحددة. بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.
list	يسرد كافة المهام المقترنة بالمهمة المحددة. بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.
list_subtasks	يسرد جميع المهام الفرعية المقترنة بالمهمة متعددة المثيلات المحددة. إذا لم تكن المهمة مهمة متعددة المثيلات، فترجع هذه مجموعة فارغة.
reactivate	إعادة تنشيط مهمة، ما يسمح لها بالتشغيل مرة أخرى حتى إذا تم استنفاد عدد مرات إعادة المحاولة الخاصة بها. تجعل إعادة التنشيط المهمة مؤهلة لإعادة المحاولة مرة أخرى حتى الحد الأقصى لعدد مرات إعادة المحاولة. يتم تغيير حالة المهمة إلى نشطة. نظرا لأن المهمة لم تعد في الحالة المكتملة، فلن تتوفر أي تعليمات برمجية سابقة للخروج أو معلومات الفشل بعد إعادة التنشيط. في كل مرة يتم فيها إعادة تنشيط مهمة، تتم إعادة تعيين عدد مرات إعادة المحاولة الخاصة بها إلى 0. ستفشل إعادة التنشيط للمهام التي لم تكتمل أو التي تم إكمالها مسبقا بنجاح (مع رمز خروج من 0). بالإضافة إلى ذلك، سيفشل إذا اكتملت المهمة (أو تم إنهاؤها أو حذفها).
terminate	إنهاء المهمة المحددة. عند إنهاء المهمة، تنتقل إلى الحالة المكتملة. بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية إنهاء المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم إنهاء المهام الفرعية بشكل غير متزامن في الخلفية.
update	التحديثات خصائص المهمة المحددة.

add

إضافة مهمة إلى المهمة المحددة.

الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، فسيتم إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت.

add(job_id, task, task_add_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي ستتم إضافة المهمة إليها.

task

TaskAddParameter

مطلوب

المهمة التي ستتم إضافتها.

task_add_options

TaskAddOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

لا شيء أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

None,

ClientRawResponse

استثناءات

BatchErrorException

add_collection

إضافة مجموعة من المهام إلى المهمة المحددة.

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

add_collection(job_id, value, task_add_collection_options=None, custom_headers=None, raw=False, threads=0, **operation_config)

المعلمات

job_id

str

مطلوب

معرف المهمة التي ستتم إضافة مجموعة المهام إليها.

value

list of TaskAddParameter

مطلوب

مجموعة المهام المراد إضافتها. يجب أن يكون الحجم التسلسلي الإجمالي لهذه المجموعة أقل من 4 ميغابايت. إذا كان أكبر من 4 ميغابايت (على سبيل المثال إذا كانت كل مهمة تحتوي على 100 ملف من ملفات الموارد أو متغيرات البيئة)، فسيفشل الطلب مع التعليمات البرمجية "RequestBodyTooLarge" ويجب إعادة المحاولة مرة أخرى مع مهام أقل.

task_add_collection_options

TaskAddCollectionOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

threads

int

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

عدد مؤشرات الترابط التي يجب استخدامها بالتوازي عند إضافة المهام. إذا تم تحديدها وأكبر من 0، فستبدأ مؤشرات ترابط إضافية لإرسال الطلبات والانتظار حتى تنتهي. وإلا سيرسل add_collection الطلبات بالتتابع على مؤشر الترابط الرئيسي

المرتجعات

TaskAddCollectionResult أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

TaskAddCollectionResult,

ClientRawResponse

استثناءات

azure.batch.custom.CreateTasksErrorException

delete

حذف مهمة من المهمة المحددة.

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

delete(job_id, task_id, task_delete_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي سيتم حذف المهمة منها.

task_id

str

مطلوب

معرف المهمة المراد حذفها.

task_delete_options

TaskDeleteOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

لا شيء أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

None,

ClientRawResponse

استثناءات

BatchErrorException

get

الحصول على معلومات حول المهمة المحددة.

بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.

get(job_id, task_id, task_get_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي تحتوي على المهمة.

task_id

str

مطلوب

معرف المهمة للحصول على معلومات حولها.

task_get_options

TaskGetOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

CloudTask أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

CloudTask,

ClientRawResponse

استثناءات

BatchErrorException

list

يسرد كافة المهام المقترنة بالمهمة المحددة.

بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.

list(job_id, task_list_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة.

task_list_options

TaskListOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

مكرر مثل مثيل CloudTask

نوع الإرجاع

CloudTaskPaged[CloudTask]

استثناءات

BatchErrorException

list_subtasks

يسرد جميع المهام الفرعية المقترنة بالمهمة متعددة المثيلات المحددة.

إذا لم تكن المهمة مهمة متعددة المثيلات، فترجع هذه مجموعة فارغة.

list_subtasks(job_id, task_id, task_list_subtasks_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة.

task_id

str

مطلوب

معرف المهمة.

task_list_subtasks_options

TaskListSubtasksOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

CloudTaskListSubtasksResult أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

CloudTaskListSubtasksResult,

ClientRawResponse

استثناءات

BatchErrorException

reactivate

إعادة تنشيط مهمة، ما يسمح لها بالتشغيل مرة أخرى حتى إذا تم استنفاد عدد مرات إعادة المحاولة الخاصة بها.

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

reactivate(job_id, task_id, task_reactivate_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي تحتوي على المهمة.

task_id

str

مطلوب

معرف المهمة لإعادة التنشيط.

task_reactivate_options

TaskReactivateOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

لا شيء أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

None,

ClientRawResponse

استثناءات

BatchErrorException

terminate

إنهاء المهمة المحددة.

عند إنهاء المهمة، تنتقل إلى الحالة المكتملة. بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية إنهاء المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم إنهاء المهام الفرعية بشكل غير متزامن في الخلفية.

terminate(job_id, task_id, task_terminate_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي تحتوي على المهمة.

task_id

str

مطلوب

معرف المهمة المراد إنهائها.

task_terminate_options

TaskTerminateOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوز تكوين العملية.

المرتجعات

لا شيء أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

None,

ClientRawResponse

استثناءات

BatchErrorException

update

التحديثات خصائص المهمة المحددة.

update(job_id, task_id, constraints=None, task_update_options=None, custom_headers=None, raw=False, **operation_config)

المعلمات

job_id

str

مطلوب

معرف الوظيفة التي تحتوي على المهمة.

task_id

str

مطلوب

معرف المهمة المراد تحديثها.

constraints

TaskConstraints

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

القيود التي تنطبق على هذه المهمة. إذا تم حذفها، يتم إعطاء المهمة القيود الافتراضية. بالنسبة للمهام متعددة المثيلات، ينطبق تحديث وقت الاستبقاء فقط على المهمة الأساسية وليس المهام الفرعية.

task_update_options

TaskUpdateOptions

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

معلمات إضافية للعملية

custom_headers

dict

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

الرؤوس التي ستتم إضافتها إلى الطلب

raw

bool

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

إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها

operation_config

مطلوب

تجاوزات تكوين العملية.

المرتجعات

لا شيء أو ClientRawResponse إذا كانت raw=true

نوع الإرجاع

None,

ClientRawResponse

استثناءات

BatchErrorException

السمات

models

models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>