BatchJobReleaseTask interface

الحزمة:

@azure/batch

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

الخصائص

commandLine	سطر الأوامر لمهمة إصدار الوظيفة. لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. إذا كان سطر الأوامر يشير إلى مسارات الملفات، يجب أن يستخدم مسارا نسبيا (بالنسبة لدليل عمل المهمة)، أو يستخدم متغير البيئة المقدم من دفعة (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	إعدادات الحاوية التي تعمل تحتها مهمة إصدار الوظيفة. عند تحديد ذلك، يتم تعيين جميع المجلدات بشكل متكرر أسفل AZ_BATCH_NODE_ROOT_DIR (جذر أدلة Azure Batch على العقدة) إلى الحاوية، ويتم تعيين جميع متغيرات بيئة المهمة إلى الحاوية، ويتم تنفيذ سطر أوامر المهمة داخل الحاوية. قد لا تنعكس الملفات المنتجة في الحاوية خارج AZ_BATCH_NODE_ROOT_DIR على قرص المضيف، مما يعني أن واجهات برمجة تطبيقات الملفات الدفعية لن تتمكن من الوصول إلى تلك الملفات.
environmentSettings	قائمة بإعدادات متغيرات البيئة لمهمة إصدار الوظيفة.
id	سلسلة تحدد بشكل فريد مهمة إصدار الوظيفة داخل الوظيفة. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الشرطات والخطوط السفلية، ولا يمكن أن يحتوي على أكثر من 64 حرفا. إذا لم تحدد هذه الخاصية، تقوم خدمة الدفعة بتعيين قيمة افتراضية هي 'release'. لا يمكن لأي مهمة أخرى في الوظيفة أن يكون لها نفس معرف مهمة تحرير الوظيفة. إذا حاولت تقديم مهمة بنفس المعرف، ترفض خدمة الدفعة الطلب برمز خطأ TaskIdSameAsJobReleaseTask؛ إذا كنت تتصل مباشرة بواجهة برمجة تطبيقات REST، فإن رمز حالة HTTP هو 409 (تعارض).
maxWallClockTime	أقصى وقت مضى يمكن أن تعمل فيه مهمة تحرير الوظيفة على عقدة حوسبة معينة، ويقااس من وقت بدء المهمة. إذا لم تكتمل المهمة ضمن الوقت المحدد، تقوم خدمة الدفعة بإنهائها. القيمة الافتراضية هي 15 دقيقة. لا يمكنك تحديد مهلة تتجاوز 15 دقيقة. إذا فعلت ذلك، فإن خدمة الدفعة ترفضها بخطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب خاطئ).
resourceFiles	قائمة بالملفات التي تقوم خدمة الدفعة بتنزيلها إلى عقدة الحوسبة قبل تشغيل سطر الأوامر. هناك حد أقصى لحجم قائمة ملفات الموارد. عندما يتجاوز الحد الأقصى للحجم، سيفشل الطلب ويصبح رمز خطأ الاستجابة هو RequestEntityTooLarge. إذا حدث ذلك، يجب تقليل حجم مجموعة ملفات الموارد. يمكن تحقيق ذلك باستخدام ملفات .zip، أو حزم التطبيقات، أو حاويات دوكر. الملفات المدرجة تحت هذا العنصر موجودة في مجلد العمل الخاص بالمهمة.
retentionTime	الحد الأدنى للوقت للاحتفاظ بدليل المهام لمهمة إصدار الوظيفة على عقدة الحوسبة. بعد هذا الوقت، قد تحذف خدمة الدفعة مجلد المهام وجميع محتوياته. الإعداد الافتراضي هو 7 أيام، أي أن دليل المهمة سيبقى لمدة 7 أيام ما لم تتم إزالة عقدة الحوسبة أو حذف الوظيفة.
userIdentity	هوية المستخدم التي تعمل تحتها مهمة إصدار الوظيفة. إذا تم حذفها، تعمل المهمة كمستخدم غير إداري فريد من نوعها.

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

commandLine

سطر الأوامر لمهمة إصدار الوظيفة. لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. إذا كان سطر الأوامر يشير إلى مسارات الملفات، يجب أن يستخدم مسارا نسبيا (بالنسبة لدليل عمل المهمة)، أو يستخدم متغير البيئة المقدم من دفعة (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

commandLine: string

قيمة الخاصية

string

containerSettings

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

containerSettings?: BatchTaskContainerSettings

قيمة الخاصية

BatchTaskContainerSettings

environmentSettings

قائمة بإعدادات متغيرات البيئة لمهمة إصدار الوظيفة.

environmentSettings?: EnvironmentSetting[]

قيمة الخاصية

EnvironmentSetting[]

id

سلسلة تحدد بشكل فريد مهمة إصدار الوظيفة داخل الوظيفة. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الشرطات والخطوط السفلية، ولا يمكن أن يحتوي على أكثر من 64 حرفا. إذا لم تحدد هذه الخاصية، تقوم خدمة الدفعة بتعيين قيمة افتراضية هي 'release'. لا يمكن لأي مهمة أخرى في الوظيفة أن يكون لها نفس معرف مهمة تحرير الوظيفة. إذا حاولت تقديم مهمة بنفس المعرف، ترفض خدمة الدفعة الطلب برمز خطأ TaskIdSameAsJobReleaseTask؛ إذا كنت تتصل مباشرة بواجهة برمجة تطبيقات REST، فإن رمز حالة HTTP هو 409 (تعارض).

id?: string

قيمة الخاصية

string

maxWallClockTime

أقصى وقت مضى يمكن أن تعمل فيه مهمة تحرير الوظيفة على عقدة حوسبة معينة، ويقااس من وقت بدء المهمة. إذا لم تكتمل المهمة ضمن الوقت المحدد، تقوم خدمة الدفعة بإنهائها. القيمة الافتراضية هي 15 دقيقة. لا يمكنك تحديد مهلة تتجاوز 15 دقيقة. إذا فعلت ذلك، فإن خدمة الدفعة ترفضها بخطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب خاطئ).

maxWallClockTime?: string

قيمة الخاصية

string

resourceFiles

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

resourceFiles?: ResourceFile[]

قيمة الخاصية

ResourceFile[]

retentionTime

الحد الأدنى للوقت للاحتفاظ بدليل المهام لمهمة إصدار الوظيفة على عقدة الحوسبة. بعد هذا الوقت، قد تحذف خدمة الدفعة مجلد المهام وجميع محتوياته. الإعداد الافتراضي هو 7 أيام، أي أن دليل المهمة سيبقى لمدة 7 أيام ما لم تتم إزالة عقدة الحوسبة أو حذف الوظيفة.

retentionTime?: string

قيمة الخاصية

string

userIdentity

هوية المستخدم التي تعمل تحتها مهمة إصدار الوظيفة. إذا تم حذفها، تعمل المهمة كمستخدم غير إداري فريد من نوعها.

userIdentity?: UserIdentity

قيمة الخاصية

UserIdentity