BatchJobCreateOptions interface

الحزمة:

@azure/batch

معلمات لإنشاء وظيفة Azure Batch.

الخصائص

allowTaskPreemption	ما إذا كان يمكن استباق المهام في هذه الوظيفة بواسطة وظائف أخرى ذات أولوية عالية. (هذه الخاصية غير متوفرة افتراضيا. يرجى الاتصال بالدعم للحصول على مزيد من المعلومات) إذا تم تعيين القيمة إلى True، فستكون الأولوية للمهام الأخرى ذات الأولوية العالية المرسلة إلى النظام وستكون قادرة على إعادة قائمة الانتظار للمهام من هذه الوظيفة. يمكنك تحديث allowTaskPreemption للوظيفة بعد إنشائها باستخدام واجهة برمجة تطبيقات مهمة التحديث.
allTasksCompleteMode	الإجراء الذي يجب أن تتخذه خدمة Batch عندما تكون كافة المهام في الوظيفة في حالة مكتملة. لاحظ أنه إذا كانت المهمة لا تحتوي على مهام، اعتبار كافة المهام مكتملة. لذلك يتم استخدام هذا الخيار الأكثر شيوعا مع مهمة Job Manager؛ إذا كنت ترغب في استخدام إنهاء الوظيفة التلقائي دون مدير وظيفة، يجب عليك في البداية تعيين onAllTasksComplete إلى noaction وتحديث خصائص المهمة لتعيين onAllTasksComplete إلى finishjob بمجرد الانتهاء من إضافة المهام. الإعداد الافتراضي هو noaction.
commonEnvironmentSettings	قائمة إعدادات متغير البيئة الشائعة. يتم تعيين متغيرات البيئة هذه لكافة المهام في الوظيفة (بما في ذلك مدير الوظيفة وإعداد الوظيفة ومهام إصدار الوظيفة). يمكن للمهام الفردية تجاوز إعداد بيئة محدد هنا عن طريق تحديد نفس اسم الإعداد بقيمة مختلفة.
constraints	قيود التنفيذ للوظيفة.
displayName	اسم العرض للوظيفة. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
id	سلسلة تعرف المهمة بشكل فريد داخل الحساب. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. المعرف هو الحفاظ على حالة الأحرف وغير حساس لحالة الأحرف (أي، قد لا يكون لديك معرفان داخل حساب يختلفان فقط حسب الحالة).
jobManagerTask	تفاصيل مهمة مدير الوظيفة التي سيتم تشغيلها عند بدء المهمة. إذا لم تحدد الوظيفة مهمة مدير الوظيفة، فيجب على المستخدم إضافة مهام بشكل صريح إلى المهمة. إذا حددت الوظيفة مهمة مدير الوظيفة، تقوم خدمة Batch بإنشاء مهمة مدير الوظيفة عند إنشاء الوظيفة، وستحاول جدولة مهمة مدير الوظيفة قبل جدولة المهام الأخرى في الوظيفة. الغرض النموذجي لمهمة مدير الوظيفة هو التحكم في تنفيذ المهمة و/أو مراقبته، على سبيل المثال عن طريق تحديد المهام الإضافية التي يجب تشغيلها، وتحديد وقت اكتمال العمل، وما إلى ذلك. (ومع ذلك، لا تقتصر مهمة مدير الوظيفة على هذه الأنشطة - فهي مهمة كاملة في النظام وتنفيذ أي إجراءات مطلوبة للوظيفة.) على سبيل المثال، قد تقوم مهمة مدير الوظيفة بتنزيل ملف محدد كمعلمة، وتحليل محتويات هذا الملف وإرسال مهام إضافية استنادا إلى تلك المحتويات.
jobPreparationTask	مهمة إعداد الوظيفة. إذا كانت الوظيفة تحتوي على مهمة إعداد وظيفة، فستشغل خدمة Batch مهمة إعداد الوظيفة على عقدة قبل بدء أي مهام من تلك المهمة على عقدة الحساب هذه.
jobReleaseTask	مهمة إصدار الوظيفة. لا يمكن تحديد مهمة إصدار مهمة دون تحديد مهمة إعداد وظيفة للوظيفة أيضا. تقوم خدمة Batch بتشغيل مهمة إصدار الوظيفة على العقد التي شغلت مهمة إعداد الوظيفة. الغرض الأساسي من مهمة إصدار الوظيفة هو التراجع عن التغييرات التي تم إجراؤها على عقد الحوسبة التي تم إجراؤها بواسطة مهمة إعداد الوظيفة. تتضمن الأنشطة المثال حذف الملفات المحلية أو إيقاف تشغيل الخدمات التي تم تشغيلها كجزء من إعداد الوظيفة.
maxParallelTasks	الحد الأقصى لعدد المهام التي يمكن تنفيذها بالتوازي مع المهمة. (هذه الخاصية غير متوفرة افتراضيا. يرجى الاتصال بالدعم للحصول على مزيد من المعلومات) يجب أن تكون قيمة maxParallelTasks -1 أو أكبر من 0 إذا تم تحديدها. إذا لم يتم تحديدها، فإن القيمة الافتراضية هي -1، ما يعني أنه لا يوجد حد لعدد المهام التي يمكن تشغيلها في وقت واحد. يمكنك تحديث maxParallelTasks لمهمة بعد إنشائها باستخدام واجهة برمجة تطبيقات مهمة التحديث.
metadata	قائمة أزواج الاسم والقيمة المقترنة بالوظيفة كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.
networkConfiguration	(هذه الخاصية غير متوفرة افتراضيا. يرجى الاتصال بالدعم للحصول على مزيد من المعلومات) تكوين الشبكة للوظيفة.
poolInfo	التجمع الذي تقوم خدمة Batch بتشغيل مهام المهمة عليه.
priority	أولوية الوظيفة. يمكن أن تتراوح قيم الأولوية من -1000 إلى 1000، مع -1000 أقل أولوية و1000 أولوية قصوى. إن القيمة الافتراضية هي 0.
taskFailureMode	الإجراء الذي يجب أن تتخذه خدمة Batch عند فشل أي مهمة في المهمة. تعتبر المهمة قد فشلت إذا كانت تحتوي على failureInfo. يتم تعيين failureInfo إذا اكتملت المهمة برمز خروج غير صفري بعد استنفاد عدد مرات إعادة المحاولة، أو إذا كان هناك خطأ في بدء المهمة، على سبيل المثال بسبب خطأ في تنزيل ملف مورد. الإعداد الافتراضي هو noaction.
usesTaskDependencies	ما إذا كان يمكن للمهام في الوظيفة تحديد التبعيات على بعضها البعض. الإعداد الافتراضي خطأ.

تفاصيل الخاصية

allowTaskPreemption

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

allowTaskPreemption?: boolean

قيمة الخاصية

boolean

allTasksCompleteMode

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

allTasksCompleteMode?: BatchAllTasksCompleteMode

قيمة الخاصية

BatchAllTasksCompleteMode

commonEnvironmentSettings

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

commonEnvironmentSettings?: EnvironmentSetting[]

قيمة الخاصية

EnvironmentSetting[]

constraints

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

constraints?: BatchJobConstraints

قيمة الخاصية

BatchJobConstraints

displayName

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

displayName?: string

قيمة الخاصية

string

id

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

id: string

قيمة الخاصية

string

jobManagerTask

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

jobManagerTask?: BatchJobManagerTask

قيمة الخاصية

BatchJobManagerTask

jobPreparationTask

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

jobPreparationTask?: BatchJobPreparationTask

قيمة الخاصية

BatchJobPreparationTask

jobReleaseTask

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

jobReleaseTask?: BatchJobReleaseTask

قيمة الخاصية

BatchJobReleaseTask

maxParallelTasks

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

maxParallelTasks?: number

قيمة الخاصية

number

metadata

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

metadata?: BatchMetadataItem[]

قيمة الخاصية

BatchMetadataItem[]

networkConfiguration

(هذه الخاصية غير متوفرة افتراضيا. يرجى الاتصال بالدعم للحصول على مزيد من المعلومات) تكوين الشبكة للوظيفة.

networkConfiguration?: BatchJobNetworkConfiguration

قيمة الخاصية

BatchJobNetworkConfiguration

poolInfo

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

poolInfo: BatchPoolInfo

قيمة الخاصية

BatchPoolInfo

priority

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

priority?: number

قيمة الخاصية

number

taskFailureMode

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

taskFailureMode?: BatchTaskFailureMode

قيمة الخاصية

BatchTaskFailureMode

usesTaskDependencies

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

usesTaskDependencies?: boolean

قيمة الخاصية

boolean