TaskOperations الفصل
عمليات TaskOperations.
يجب عدم إنشاء مثيل مباشرة لهذه الفئة، ولكن إنشاء مثيل العميل الذي سيقوم بإنشائه لك وإرفاقه كسمة.
- توريث
-
builtins.objectTaskOperations
الدالمنشئ
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)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
لا شيء أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
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)
المعلمات
- value
- list of TaskAddParameter
مجموعة المهام المراد إضافتها. يجب أن يكون الحجم التسلسلي الإجمالي لهذه المجموعة أقل من 4 ميغابايت. إذا كان أكبر من 4 ميغابايت (على سبيل المثال إذا كانت كل مهمة تحتوي على 100 ملف من ملفات الموارد أو متغيرات البيئة)، فسيفشل الطلب مع التعليمات البرمجية "RequestBodyTooLarge" ويجب إعادة المحاولة مرة أخرى مع مهام أقل.
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- threads
- int
عدد مؤشرات الترابط التي يجب استخدامها بالتوازي عند إضافة المهام. إذا تم تحديدها وأكبر من 0، فستبدأ مؤشرات ترابط إضافية لإرسال الطلبات والانتظار حتى تنتهي. وإلا سيرسل add_collection الطلبات بالتتابع على مؤشر الترابط الرئيسي
المرتجعات
TaskAddCollectionResult أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
delete
حذف مهمة من المهمة المحددة.
عند حذف مهمة، يتم أيضا حذف جميع الملفات الموجودة في دليلها على عقدة الحساب حيث تم تشغيلها (بغض النظر عن وقت الاستبقاء). بالنسبة للمهام متعددة المثيلات، تطبق عملية حذف المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم حذف المهام الفرعية وملفاتها بشكل غير متزامن في الخلفية.
delete(job_id, task_id, task_delete_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
لا شيء أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
get
الحصول على معلومات حول المهمة المحددة.
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.
get(job_id, task_id, task_get_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
CloudTask أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
list
يسرد كافة المهام المقترنة بالمهمة المحددة.
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية للقائمة لاسترداد معلومات حول المهام الفرعية.
list(job_id, task_list_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
مكرر مثل مثيل CloudTask
نوع الإرجاع
استثناءات
list_subtasks
يسرد جميع المهام الفرعية المقترنة بالمهمة متعددة المثيلات المحددة.
إذا لم تكن المهمة مهمة متعددة المثيلات، فترجع هذه مجموعة فارغة.
list_subtasks(job_id, task_id, task_list_subtasks_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
CloudTaskListSubtasksResult أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
reactivate
إعادة تنشيط مهمة، ما يسمح لها بالتشغيل مرة أخرى حتى إذا تم استنفاد عدد مرات إعادة المحاولة الخاصة بها.
تجعل إعادة التنشيط المهمة مؤهلة لإعادة المحاولة مرة أخرى حتى الحد الأقصى لعدد مرات إعادة المحاولة. يتم تغيير حالة المهمة إلى نشطة. نظرا لأن المهمة لم تعد في الحالة المكتملة، فلن تتوفر أي تعليمات برمجية سابقة للخروج أو معلومات الفشل بعد إعادة التنشيط. في كل مرة يتم فيها إعادة تنشيط مهمة، تتم إعادة تعيين عدد مرات إعادة المحاولة الخاصة بها إلى 0. ستفشل إعادة التنشيط للمهام التي لم تكتمل أو التي تم إكمالها مسبقا بنجاح (مع رمز خروج من 0). بالإضافة إلى ذلك، سيفشل إذا اكتملت المهمة (أو تم إنهاؤها أو حذفها).
reactivate(job_id, task_id, task_reactivate_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
لا شيء أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
terminate
إنهاء المهمة المحددة.
عند إنهاء المهمة، تنتقل إلى الحالة المكتملة. بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية إنهاء المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم إنهاء المهام الفرعية بشكل غير متزامن في الخلفية.
terminate(job_id, task_id, task_terminate_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوز تكوين العملية.
المرتجعات
لا شيء أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
update
التحديثات خصائص المهمة المحددة.
update(job_id, task_id, constraints=None, task_update_options=None, custom_headers=None, raw=False, **operation_config)
المعلمات
- constraints
- TaskConstraints
القيود التي تنطبق على هذه المهمة. إذا تم حذفها، يتم إعطاء المهمة القيود الافتراضية. بالنسبة للمهام متعددة المثيلات، ينطبق تحديث وقت الاستبقاء فقط على المهمة الأساسية وليس المهام الفرعية.
- raw
- bool
إرجاع الاستجابة المباشرة جنبا إلى جنب مع الاستجابة التي تم إلغاء تسلسلها
- operation_config
تجاوزات تكوين العملية.
المرتجعات
لا شيء أو ClientRawResponse إذا كانت raw=true
نوع الإرجاع
استثناءات
السمات
models
models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>
Azure SDK for Python