Task class
فئة تمثل مهمة.
المنشئون
| Task(Batch |
إنشاء مهمة. |
الأساليب
| add(string, Task |
|
| add(string, Task |
الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت. |
| add(string, Task |
|
| add |
|
| add |
لاحظ أنه يجب أن يكون لكل مهمة معرف فريد. قد لا ترجع خدمة Batch النتائج لكل مهمة بالترتيب نفسه الذي تم إرسال المهام به في هذا الطلب. إذا انتهت مهلة الخادم أو تم إغلاق الاتصال أثناء الطلب، فربما تمت معالجة الطلب جزئيا أو بالكامل، أو لا تتم معالجته على الإطلاق. في مثل هذه الحالات، يجب على المستخدم إعادة إصدار الطلب. لاحظ أن الأمر متروك للمستخدم لمعالجة حالات الفشل بشكل صحيح عند إعادة إصدار طلب. على سبيل المثال، يجب استخدام معرفات المهمة نفسها أثناء إعادة المحاولة بحيث إذا نجحت العملية السابقة، فلن تنشئ إعادة المحاولة مهاما إضافية بشكل غير متوقع. إذا كانت الاستجابة تحتوي على أي مهام فشلت في إضافتها، يمكن للعميل إعادة محاولة الطلب. في إعادة المحاولة، من الأكثر فعالية إعادة إرسال المهام التي فشلت في إضافتها فقط، وحذف المهام التي تمت إضافتها بنجاح في المحاولة الأولى. الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت. |
| add |
|
| delete |
|
| delete |
عند حذف مهمة، يتم أيضا حذف جميع الملفات الموجودة في دليلها على عقدة الحساب حيث تم تشغيلها (بغض النظر عن وقت الاستبقاء). بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية حذف المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم حذف المهام الفرعية وملفاتها بشكل غير متزامن في الخلفية. |
| delete |
|
| get(string, string, Service |
|
| get(string, string, Task |
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية. |
| get(string, string, Task |
|
| list(string, Service |
|
| list(string, Task |
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية. |
| list(string, Task |
|
| list |
|
| list |
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية. |
| list |
|
| list |
|
| list |
إذا لم تكن المهمة مهمة متعددة المثيلات، فترجع هذه مجموعة فارغة. |
| list |
|
| reactivate(string, string, Service |
|
| reactivate(string, string, Task |
إعادة التنشيط تجعل المهمة مؤهلة لإعادة المحاولة مرة أخرى حتى الحد الأقصى لعدد مرات إعادة المحاولة. يتم تغيير حالة المهمة إلى نشطة. نظرا لأن المهمة لم تعد في الحالة المكتملة، فلن تتوفر أي تعليمات برمجية سابقة للخروج أو معلومات الفشل بعد إعادة التنشيط. في كل مرة يتم فيها إعادة تنشيط مهمة، تتم إعادة تعيين عدد مرات إعادة المحاولة إلى 0. ستفشل إعادة التنشيط للمهام غير المكتملة أو التي تم إكمالها مسبقا بنجاح (مع رمز خروج من 0). بالإضافة إلى ذلك، سيفشل إذا اكتملت المهمة (أو تم إنهاؤها أو حذفها). |
| reactivate(string, string, Task |
|
| terminate(string, string, Service |
|
| terminate(string, string, Task |
عند إنهاء المهمة، تنتقل إلى الحالة المكتملة. بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية إنهاء المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم إنهاء المهام الفرعية بشكل غير متزامن في الخلفية. |
| terminate(string, string, Task |
|
| update(string, string, Service |
|
| update(string, string, Task |
تحديث خصائص المهمة المحددة. |
| update(string, string, Task |
تفاصيل المنشئ
Task(BatchServiceClientContext)
إنشاء مهمة.
new Task(client: BatchServiceClientContext)المعلمات
- client
- BatchServiceClientContext
الرجوع إلى عميل الخدمة.
تفاصيل الأسلوب
add(string, TaskAddParameter, ServiceCallback<void>)
function add(jobId: string, task: TaskAddParameter, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة المهمة إليها.
- task
- TaskAddParameter
المهمة المراد إضافتها.
- callback
-
ServiceCallback<void>
رد الاتصال
add(string, TaskAddParameter, TaskAddOptionalParams)
الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت.
function add(jobId: string, task: TaskAddParameter, options?: TaskAddOptionalParams): Promise<TaskAddResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة المهمة إليها.
- task
- TaskAddParameter
المهمة المراد إضافتها.
- options
- TaskAddOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskAddResponse>
وعد<Models.TaskAddResponse>
add(string, TaskAddParameter, TaskAddOptionalParams, ServiceCallback<void>)
function add(jobId: string, task: TaskAddParameter, options: TaskAddOptionalParams, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة المهمة إليها.
- task
- TaskAddParameter
المهمة المراد إضافتها.
- options
- TaskAddOptionalParams
المعلمات الاختيارية
- callback
-
ServiceCallback<void>
رد الاتصال
addCollection(string, TaskAddParameter[], ServiceCallback<TaskAddCollectionResult>)
function addCollection(jobId: string, value: TaskAddParameter[], callback: ServiceCallback<TaskAddCollectionResult>)المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة مجموعة المهام إليها.
- value
مجموعة المهام المراد إضافتها. الحد الأقصى لعدد المهام هو 100. يجب أن يكون الحجم التسلسلي الإجمالي لهذه المجموعة أقل من 1 ميغابايت. إذا كان أكبر من 1 ميغابايت (على سبيل المثال إذا كانت كل مهمة تحتوي على 100 ملف مورد أو متغيرات بيئة)، فسيفشل الطلب مع التعليمات البرمجية 'RequestBodyTooLarge' ويجب إعادة المحاولة مرة أخرى مع مهام أقل.
- callback
رد الاتصال
addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams)
لاحظ أنه يجب أن يكون لكل مهمة معرف فريد. قد لا ترجع خدمة Batch النتائج لكل مهمة بالترتيب نفسه الذي تم إرسال المهام به في هذا الطلب. إذا انتهت مهلة الخادم أو تم إغلاق الاتصال أثناء الطلب، فربما تمت معالجة الطلب جزئيا أو بالكامل، أو لا تتم معالجته على الإطلاق. في مثل هذه الحالات، يجب على المستخدم إعادة إصدار الطلب. لاحظ أن الأمر متروك للمستخدم لمعالجة حالات الفشل بشكل صحيح عند إعادة إصدار طلب. على سبيل المثال، يجب استخدام معرفات المهمة نفسها أثناء إعادة المحاولة بحيث إذا نجحت العملية السابقة، فلن تنشئ إعادة المحاولة مهاما إضافية بشكل غير متوقع. إذا كانت الاستجابة تحتوي على أي مهام فشلت في إضافتها، يمكن للعميل إعادة محاولة الطلب. في إعادة المحاولة، من الأكثر فعالية إعادة إرسال المهام التي فشلت في إضافتها فقط، وحذف المهام التي تمت إضافتها بنجاح في المحاولة الأولى. الحد الأقصى لعمر المهمة من بالإضافة إلى الاكتمال هو 180 يوما. إذا لم تكتمل المهمة في غضون 180 يوما من إضافتها، إنهاؤها بواسطة خدمة Batch وتركها في أي حالة كانت فيها في ذلك الوقت.
function addCollection(jobId: string, value: TaskAddParameter[], options?: TaskAddCollectionOptionalParams): Promise<TaskAddCollectionResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة مجموعة المهام إليها.
- value
مجموعة المهام المراد إضافتها. الحد الأقصى لعدد المهام هو 100. يجب أن يكون الحجم التسلسلي الإجمالي لهذه المجموعة أقل من 1 ميغابايت. إذا كان أكبر من 1 ميغابايت (على سبيل المثال إذا كانت كل مهمة تحتوي على 100 ملف مورد أو متغيرات بيئة)، فسيفشل الطلب مع التعليمات البرمجية 'RequestBodyTooLarge' ويجب إعادة المحاولة مرة أخرى مع مهام أقل.
- options
- TaskAddCollectionOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskAddCollectionResponse>
وعد<Models.TaskAddCollectionResponse>
addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams, ServiceCallback<TaskAddCollectionResult>)
function addCollection(jobId: string, value: TaskAddParameter[], options: TaskAddCollectionOptionalParams, callback: ServiceCallback<TaskAddCollectionResult>)المعلمات
- jobId
-
string
معرف الوظيفة التي ستتم إضافة مجموعة المهام إليها.
- value
مجموعة المهام المراد إضافتها. الحد الأقصى لعدد المهام هو 100. يجب أن يكون الحجم التسلسلي الإجمالي لهذه المجموعة أقل من 1 ميغابايت. إذا كان أكبر من 1 ميغابايت (على سبيل المثال إذا كانت كل مهمة تحتوي على 100 ملف مورد أو متغيرات بيئة)، فسيفشل الطلب مع التعليمات البرمجية 'RequestBodyTooLarge' ويجب إعادة المحاولة مرة أخرى مع مهام أقل.
- options
- TaskAddCollectionOptionalParams
المعلمات الاختيارية
- callback
رد الاتصال
deleteMethod(string, string, ServiceCallback<void>)
function deleteMethod(jobId: string, taskId: string, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي سيتم حذف المهمة منها.
- taskId
-
string
معرف المهمة المراد حذفها.
- callback
-
ServiceCallback<void>
رد الاتصال
deleteMethod(string, string, TaskDeleteMethodOptionalParams)
عند حذف مهمة، يتم أيضا حذف جميع الملفات الموجودة في دليلها على عقدة الحساب حيث تم تشغيلها (بغض النظر عن وقت الاستبقاء). بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية حذف المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم حذف المهام الفرعية وملفاتها بشكل غير متزامن في الخلفية.
function deleteMethod(jobId: string, taskId: string, options?: TaskDeleteMethodOptionalParams): Promise<TaskDeleteResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي سيتم حذف المهمة منها.
- taskId
-
string
معرف المهمة المراد حذفها.
- options
- TaskDeleteMethodOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskDeleteResponse>
وعد<Models.TaskDeleteResponse>
deleteMethod(string, string, TaskDeleteMethodOptionalParams, ServiceCallback<void>)
function deleteMethod(jobId: string, taskId: string, options: TaskDeleteMethodOptionalParams, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي سيتم حذف المهمة منها.
- taskId
-
string
معرف المهمة المراد حذفها.
- options
- TaskDeleteMethodOptionalParams
المعلمات الاختيارية
- callback
-
ServiceCallback<void>
رد الاتصال
get(string, string, ServiceCallback<CloudTask>)
function get(jobId: string, taskId: string, callback: ServiceCallback<CloudTask>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة للحصول على معلومات حولها.
- callback
رد الاتصال
get(string, string, TaskGetOptionalParams)
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية.
function get(jobId: string, taskId: string, options?: TaskGetOptionalParams): Promise<TaskGetResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة للحصول على معلومات حولها.
- options
- TaskGetOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskGetResponse>
وعد<Models.TaskGetResponse>
get(string, string, TaskGetOptionalParams, ServiceCallback<CloudTask>)
function get(jobId: string, taskId: string, options: TaskGetOptionalParams, callback: ServiceCallback<CloudTask>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة للحصول على معلومات حولها.
- options
- TaskGetOptionalParams
المعلمات الاختيارية
- callback
رد الاتصال
list(string, ServiceCallback<CloudTaskListResult>)
function list(jobId: string, callback: ServiceCallback<CloudTaskListResult>)المعلمات
- jobId
-
string
معرف الوظيفة.
- callback
رد الاتصال
list(string, TaskListOptionalParams)
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية.
function list(jobId: string, options?: TaskListOptionalParams): Promise<TaskListResponse>المعلمات
- jobId
-
string
معرف الوظيفة.
- options
- TaskListOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskListResponse>
وعد<Models.TaskListResponse>
list(string, TaskListOptionalParams, ServiceCallback<CloudTaskListResult>)
function list(jobId: string, options: TaskListOptionalParams, callback: ServiceCallback<CloudTaskListResult>)المعلمات
- jobId
-
string
معرف الوظيفة.
- options
- TaskListOptionalParams
المعلمات الاختيارية
- callback
رد الاتصال
listNext(string, ServiceCallback<CloudTaskListResult>)
function listNext(nextPageLink: string, callback: ServiceCallback<CloudTaskListResult>)المعلمات
- nextPageLink
-
string
NextLink من عملية الاستدعاء الناجحة السابقة إلى القائمة.
- callback
رد الاتصال
listNext(string, TaskListNextOptionalParams)
بالنسبة للمهام متعددة المثيلات، تشير معلومات مثل affinityId و executionInfo و nodeInfo إلى المهمة الأساسية. استخدم واجهة برمجة تطبيقات المهام الفرعية القائمة لاسترداد معلومات حول المهام الفرعية.
function listNext(nextPageLink: string, options?: TaskListNextOptionalParams): Promise<TaskListResponse>المعلمات
- nextPageLink
-
string
NextLink من عملية الاستدعاء الناجحة السابقة إلى القائمة.
- options
- TaskListNextOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskListResponse>
وعد<Models.TaskListResponse>
listNext(string, TaskListNextOptionalParams, ServiceCallback<CloudTaskListResult>)
function listNext(nextPageLink: string, options: TaskListNextOptionalParams, callback: ServiceCallback<CloudTaskListResult>)المعلمات
- nextPageLink
-
string
NextLink من عملية الاستدعاء الناجحة السابقة إلى القائمة.
- options
- TaskListNextOptionalParams
المعلمات الاختيارية
- callback
رد الاتصال
listSubtasks(string, string, ServiceCallback<CloudTaskListSubtasksResult>)
function listSubtasks(jobId: string, taskId: string, callback: ServiceCallback<CloudTaskListSubtasksResult>)المعلمات
- jobId
-
string
معرف الوظيفة.
- taskId
-
string
معرف المهمة.
- callback
رد الاتصال
listSubtasks(string, string, TaskListSubtasksOptionalParams)
إذا لم تكن المهمة مهمة متعددة المثيلات، فترجع هذه مجموعة فارغة.
function listSubtasks(jobId: string, taskId: string, options?: TaskListSubtasksOptionalParams): Promise<TaskListSubtasksResponse>المعلمات
- jobId
-
string
معرف الوظيفة.
- taskId
-
string
معرف المهمة.
- options
- TaskListSubtasksOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskListSubtasksResponse>
وعد<Models.TaskListSubtasksResponse>
listSubtasks(string, string, TaskListSubtasksOptionalParams, ServiceCallback<CloudTaskListSubtasksResult>)
function listSubtasks(jobId: string, taskId: string, options: TaskListSubtasksOptionalParams, callback: ServiceCallback<CloudTaskListSubtasksResult>)المعلمات
- jobId
-
string
معرف الوظيفة.
- taskId
-
string
معرف المهمة.
- options
- TaskListSubtasksOptionalParams
المعلمات الاختيارية
- callback
رد الاتصال
reactivate(string, string, ServiceCallback<void>)
function reactivate(jobId: string, taskId: string, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة لإعادة التنشيط.
- callback
-
ServiceCallback<void>
رد الاتصال
reactivate(string, string, TaskReactivateOptionalParams)
إعادة التنشيط تجعل المهمة مؤهلة لإعادة المحاولة مرة أخرى حتى الحد الأقصى لعدد مرات إعادة المحاولة. يتم تغيير حالة المهمة إلى نشطة. نظرا لأن المهمة لم تعد في الحالة المكتملة، فلن تتوفر أي تعليمات برمجية سابقة للخروج أو معلومات الفشل بعد إعادة التنشيط. في كل مرة يتم فيها إعادة تنشيط مهمة، تتم إعادة تعيين عدد مرات إعادة المحاولة إلى 0. ستفشل إعادة التنشيط للمهام غير المكتملة أو التي تم إكمالها مسبقا بنجاح (مع رمز خروج من 0). بالإضافة إلى ذلك، سيفشل إذا اكتملت المهمة (أو تم إنهاؤها أو حذفها).
function reactivate(jobId: string, taskId: string, options?: TaskReactivateOptionalParams): Promise<TaskReactivateResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة لإعادة التنشيط.
- options
- TaskReactivateOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskReactivateResponse>
وعد<Models.TaskReactivateResponse>
reactivate(string, string, TaskReactivateOptionalParams, ServiceCallback<void>)
function reactivate(jobId: string, taskId: string, options: TaskReactivateOptionalParams, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة لإعادة التنشيط.
- options
- TaskReactivateOptionalParams
المعلمات الاختيارية
- callback
-
ServiceCallback<void>
رد الاتصال
terminate(string, string, ServiceCallback<void>)
function terminate(jobId: string, taskId: string, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد إنهائها.
- callback
-
ServiceCallback<void>
رد الاتصال
terminate(string, string, TaskTerminateOptionalParams)
عند إنهاء المهمة، تنتقل إلى الحالة المكتملة. بالنسبة للمهام متعددة المثيلات، يتم تطبيق عملية إنهاء المهمة بشكل متزامن على المهمة الأساسية؛ ثم يتم إنهاء المهام الفرعية بشكل غير متزامن في الخلفية.
function terminate(jobId: string, taskId: string, options?: TaskTerminateOptionalParams): Promise<TaskTerminateResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد إنهائها.
- options
- TaskTerminateOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskTerminateResponse>
وعد<Models.TaskTerminateResponse>
terminate(string, string, TaskTerminateOptionalParams, ServiceCallback<void>)
function terminate(jobId: string, taskId: string, options: TaskTerminateOptionalParams, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد إنهائها.
- options
- TaskTerminateOptionalParams
المعلمات الاختيارية
- callback
-
ServiceCallback<void>
رد الاتصال
update(string, string, ServiceCallback<void>)
function update(jobId: string, taskId: string, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد تحديثها.
- callback
-
ServiceCallback<void>
رد الاتصال
update(string, string, TaskUpdateOptionalParams)
تحديث خصائص المهمة المحددة.
function update(jobId: string, taskId: string, options?: TaskUpdateOptionalParams): Promise<TaskUpdateResponse>المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد تحديثها.
- options
- TaskUpdateOptionalParams
المعلمات الاختيارية
المرتجعات
Promise<TaskUpdateResponse>
وعد<Models.TaskUpdateResponse>
update(string, string, TaskUpdateOptionalParams, ServiceCallback<void>)
function update(jobId: string, taskId: string, options: TaskUpdateOptionalParams, callback: ServiceCallback<void>)المعلمات
- jobId
-
string
معرف الوظيفة التي تحتوي على المهمة.
- taskId
-
string
معرف المهمة المراد تحديثها.
- options
- TaskUpdateOptionalParams
المعلمات الاختيارية
- callback
-
ServiceCallback<void>
رد الاتصال