BatchTaskCreateOptions interface

الحزمة:

@azure/batch

معلمات لإنشاء مهمة Azure Batch.

الخصائص

affinityInfo	تلميح محلي يمكن استخدامه من قبل خدمة الدفعات لاختيار عقدة حوسبة لبدء المهمة الجديدة عليها.
applicationPackageReferences	قائمة بالحزم التي ستنشرها خدمة الدفعة على عقدة الحوسبة قبل تشغيل سطر الأوامر. يتم تنزيل حزم التطبيقات ونشرها في دليل مشترك، وليس في دليل العمل الخاص بالمهام. لذلك، إذا كانت الحزمة المشار إليها موجودة بالفعل على العقدة ومحدثة، فلا يتم إعادة تحميلها؛ يتم استخدام النسخة الموجودة على عقدة الحوسبة. إذا لم يكن بالإمكان تثبيت حزمة مشار إليها، على سبيل المثال لأن الحزمة تم حذفها أو فشل التحميل، تفشل المهمة.
authenticationTokenSettings	إعدادات الرمز المميز للمصادقة التي يمكن للمهمة استخدامها لتنفيذ عمليات خدمة الدفعات. إذا تم تعيين هذه الخاصية، توفر خدمة الدفعة للمهمة رمز مصادقة يمكن استخدامه لمصادقة عمليات خدمة الدفعة دون الحاجة إلى مفتاح وصول للحساب. يتم توفير الرمز عبر متغير البيئة AZ_BATCH_AUTHENTICATION_TOKEN. تعتمد العمليات التي يمكن للمهمة تنفيذها باستخدام الرمز على الإعدادات. على سبيل المثال، يمكن للمهمة طلب أذونات الوظيفة لإضافة مهام أخرى إلى الوظيفة، أو التحقق من حالة الوظيفة أو مهام أخرى تحت الوظيفة.
commandLine	سطر الأوامر في المهمة. بالنسبة للمهام متعددة المثلات، يتم تنفيذ سطر الأوامر كمهمة رئيسية، بعد أن تنتهي المهمة الأساسية وجميع المهام الفرعية من تنفيذ سطر أوامر التنسيق. لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. إذا كان سطر الأوامر يشير إلى مسارات الملفات، يجب أن يستخدم مسارا نسبيا (بالنسبة لدليل عمل المهمة)، أو يستخدم متغير البيئة المقدم من دفعة (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
constraints	قيود التنفيذ التي تنطبق على هذه المهمة. إذا لم تحدد القيود، فإن maxTaskRetryCount هو maxTaskRetryCount المحدد للوظيفة، وmaxWallClockTime لا نهائي، ومدة الاحتفاظ هي 7 أيام.
containerSettings	إعدادات الحاوية التي تعمل تحت المهمة المهمة أيضا. إذا كان المجمع الذي سيشغل هذه المهمة يحتوي على تكوين containerConfiguration، فيجب تعيين هذا أيضا. إذا لم يكن لدى المجموعة التي ستشغل هذه المهمة تكوين containerConfiguration، فلا يجب أن يكون هذا ضبطا. عند تحديد ذلك، يتم تعيين جميع المجلدات بشكل متكرر أسفل AZ_BATCH_NODE_ROOT_DIR (جذر أدلة Azure Batch على العقدة) إلى الحاوية، ويتم تعيين جميع متغيرات بيئة المهمة إلى الحاوية، ويتم تنفيذ سطر أوامر المهمة داخل الحاوية. قد لا تنعكس الملفات المنتجة في الحاوية خارج AZ_BATCH_NODE_ROOT_DIR على قرص المضيف، مما يعني أن واجهات برمجة تطبيقات الملفات الدفعية لن تتمكن من الوصول إلى تلك الملفات.
dependsOn	المهام التي تعتمد عليها هذه المهمة. لن يتم جدولة هذه المهمة حتى تكتمل جميع المهام التي تعتمد عليها بنجاح. إذا فشلت أي من تلك المهام واستنفدت عدد المحاولات الجديدة، فلن يتم جدولة هذه المهمة أبدا. إذا لم يكن لدى الوظيفة usesTaskDependencies مضبوطة على true، وكان هذا العنصر موجودا، فإن الطلب يفشل مع رمز خطأ TaskDependenciesNotSpecifiedOnJob.
displayName	اسم عرض للمهمة. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
environmentSettings	قائمة بإعدادات متغيرات البيئة الخاصة بالمهمة.
exitConditions	كيف يجب أن تستجيب خدمة الدفعة عند اكتمال المهمة.
id	سلسلة تحدد بشكل فريد المهمة داخل الوظيفة. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. الهوية تحافظ على القضية وغير حساسة لحالة القضية (أي أنه لا يمكنك أن يكون لديك معرفان داخل الوظيفة يختلفان فقط حسب الحالة).
multiInstanceSettings	كائن يشير إلى أن المهمة هي مهمة متعددة الحالات، وتحتوي على معلومات حول كيفية تشغيل مهمة متعددة المشاكل.
outputFiles	قائمة بالملفات التي تقوم خدمة الدفعة برفعها من عقدة الحوسبة بعد تشغيل سطر الأوامر. بالنسبة للمهام متعددة المثلات، سيتم رفع الملفات فقط من عقدة الحوسبة التي يتم تنفيذ المهمة الأساسية عليها.
requiredSlots	عدد فترات الجدولة التي تحتاجها المهمة للعمل. الإعداد الافتراضي هو 1. يمكن جدولة المهمة لتعمل على عقدة حوسبة فقط إذا كان لديها عدد كاف من فتحات الجدولة المتاحة. بالنسبة للمهام متعددة الحالات، يجب أن يكون 1.
resourceFiles	قائمة بالملفات التي تقوم خدمة الدفعة بتنزيلها إلى عقدة الحوسبة قبل تشغيل سطر الأوامر. بالنسبة للمهام متعددة المثلات، سيتم تنزيل ملفات الموارد فقط إلى عقدة الحوسبة التي يتم تنفيذ المهمة الأساسية عليها. هناك حد أقصى لحجم قائمة ملفات الموارد. عندما يتجاوز الحد الأقصى للحجم، سيفشل الطلب ويصبح رمز خطأ الاستجابة هو RequestEntityTooLarge. إذا حدث ذلك، يجب تقليل حجم مجموعة ملفات الموارد. يمكن تحقيق ذلك باستخدام ملفات .zip، أو حزم التطبيقات، أو حاويات دوكر.
userIdentity	هوية المستخدم التي تعمل تحتها المهمة. إذا تم حذفها، تعمل المهمة كمستخدم غير إداري فريد من نوعها.

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

affinityInfo

تلميح محلي يمكن استخدامه من قبل خدمة الدفعات لاختيار عقدة حوسبة لبدء المهمة الجديدة عليها.

affinityInfo?: BatchAffinityInfo

قيمة الخاصية

BatchAffinityInfo

applicationPackageReferences

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

applicationPackageReferences?: BatchApplicationPackageReference[]

قيمة الخاصية

BatchApplicationPackageReference[]

authenticationTokenSettings

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

authenticationTokenSettings?: AuthenticationTokenSettings

قيمة الخاصية

AuthenticationTokenSettings

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

constraints

قيود التنفيذ التي تنطبق على هذه المهمة. إذا لم تحدد القيود، فإن maxTaskRetryCount هو maxTaskRetryCount المحدد للوظيفة، وmaxWallClockTime لا نهائي، ومدة الاحتفاظ هي 7 أيام.

constraints?: BatchTaskConstraints

قيمة الخاصية

BatchTaskConstraints

containerSettings

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

containerSettings?: BatchTaskContainerSettings

قيمة الخاصية

BatchTaskContainerSettings

dependsOn

المهام التي تعتمد عليها هذه المهمة. لن يتم جدولة هذه المهمة حتى تكتمل جميع المهام التي تعتمد عليها بنجاح. إذا فشلت أي من تلك المهام واستنفدت عدد المحاولات الجديدة، فلن يتم جدولة هذه المهمة أبدا. إذا لم يكن لدى الوظيفة usesTaskDependencies مضبوطة على true، وكان هذا العنصر موجودا، فإن الطلب يفشل مع رمز خطأ TaskDependenciesNotSpecifiedOnJob.

dependsOn?: BatchTaskDependencies

قيمة الخاصية

BatchTaskDependencies

displayName

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

displayName?: string

قيمة الخاصية

string

environmentSettings

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

environmentSettings?: EnvironmentSetting[]

قيمة الخاصية

EnvironmentSetting[]

exitConditions

كيف يجب أن تستجيب خدمة الدفعة عند اكتمال المهمة.

exitConditions?: ExitConditions

قيمة الخاصية

ExitConditions

id

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

id: string

قيمة الخاصية

string

multiInstanceSettings

كائن يشير إلى أن المهمة هي مهمة متعددة الحالات، وتحتوي على معلومات حول كيفية تشغيل مهمة متعددة المشاكل.

multiInstanceSettings?: MultiInstanceSettings

قيمة الخاصية

MultiInstanceSettings

outputFiles

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

outputFiles?: OutputFile[]

قيمة الخاصية

OutputFile[]

requiredSlots

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

requiredSlots?: number

قيمة الخاصية

number

resourceFiles

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

resourceFiles?: ResourceFile[]

قيمة الخاصية

ResourceFile[]

userIdentity

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

userIdentity?: UserIdentity

قيمة الخاصية

UserIdentity