PoolAddParameter الفصل

تجمع في خدمة Azure Batch لإضافته.

يجب ملء جميع المعلمات المطلوبة لإرسالها إلى Azure.

توريث

Model

PoolAddParameter

الدالمنشئ

PoolAddParameter(*, id: str, vm_size: str, display_name: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, mount_configuration=None, target_node_communication_mode=None, **kwargs)

المعلمات

id

str

مطلوب

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

display_name

str

مطلوب

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

vm_size

str

مطلوب

مطلوب للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية لتجمعات الخدمات السحابية (التجمعات التي تم إنشاؤها باستخدام cloudServiceConfiguration)، راجع أحجام الخدمات السحابية (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). تدعم Batch جميع أحجام الأجهزة الظاهرية للخدمات السحابية باستثناء ExtraSmall و A1V2 و A2V2. للحصول على معلومات حول أحجام الأجهزة الظاهرية المتوفرة للتجمعات التي تستخدم الصور من سوق الأجهزة الظاهرية (التجمعات التي تم إنشاؤها باستخدام virtualMachineConfiguration)، راجع أحجام الأجهزة الظاهرية (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) أو أحجام الأجهزة الظاهرية (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). يدعم Batch جميع أحجام أجهزة Azure الظاهرية باستثناء STANDARD_A0 وتلك ذات التخزين المتميز (STANDARD_GS STANDARD_DS وسلسلة STANDARD_DSV2).

cloud_service_configuration

CloudServiceConfiguration

مطلوب

تكوين الخدمة السحابية للتجمع. هذه الخاصية و virtualMachineConfiguration حصريان بشكل متبادل ويجب تحديد إحدى الخصائص. لا يمكن تحديد هذه الخاصية إذا تم إنشاء حساب الدفعة مع تعيين الخاصية poolAllocationMode الخاصة به إلى "UserSubscription".

virtual_machine_configuration

VirtualMachineConfiguration

مطلوب

تكوين الجهاز الظاهري للتجمع. هذه الخاصية وcloudServiceConfiguration حصريان بشكل متبادل ويجب تحديد إحدى الخصائص.

resize_timeout

<xref:timedelta>

مطلوب

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

target_dedicated_nodes

int

مطلوب

العدد المطلوب من عقد الحوسبة المخصصة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.

target_low_priority_nodes

int

مطلوب

العدد المطلوب من Spot/Low-priority Compute Nodes في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.

enable_auto_scale

bool

مطلوب

ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كان خطأ، يجب تحديد واحد على الأقل من targetDedicatedNodes و targetLowPriorityNodes. إذا كان صحيحا، تكون الخاصية autoScaleFormula مطلوبة ويتم تغيير حجم التجمع تلقائيا وفقا للصيغة. القيمة الافتراضية كاذبة.

auto_scale_formula

str

مطلوب

يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى خطأ. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صالحة، ترفض خدمة Batch الطلب بمعلومات مفصلة عن الخطأ. لمزيد من المعلومات حول تحديد هذه الصيغة، راجع "قياس عقد الحوسبة تلقائيا في تجمع Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

auto_scale_evaluation_interval

<xref:timedelta>

مطلوب

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

enable_inter_node_communication

bool

مطلوب

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

network_configuration

NetworkConfiguration

مطلوب

تكوين الشبكة للتجمع.

start_task

StartTask

مطلوب

مهمة محددة للتشغيل على كل عقدة حساب أثناء انضمامها إلى التجمع. يتم تشغيل المهمة عند إضافة عقدة الحساب إلى التجمع أو عند إعادة تشغيل عقدة الحساب.

certificate_references

list[CertificateReference]

مطلوب

بالنسبة لعقد Windows، تقوم خدمة Batch بتثبيت الشهادات إلى مخزن الشهادات والموقع المحددين. بالنسبة لعقد حساب Linux، يتم تخزين الشهادات في دليل داخل دليل عمل المهمة ويتم توفير متغير بيئة AZ_BATCH_CERTIFICATES_DIR إلى المهمة للاستعلام عن هذا الموقع. بالنسبة للشهادات التي لها رؤية "remoteUser"، يتم إنشاء دليل "certs" في الدليل الرئيسي للمستخدم (على سبيل المثال، /home/{user-name}/certs) ويتم وضع الشهادات في هذا الدليل. تحذير: تم إهمال هذه الخاصية وستتم إزالتها بعد فبراير 2024. يرجى استخدام ملحق Azure KeyVault بدلا من ذلك.

application_package_references

list[ApplicationPackageReference]

مطلوب

عند إنشاء تجمع، يجب أن يكون معرف تطبيق الحزمة مؤهلا بالكامل (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكنها لا تؤثر على عقد الحوسبة الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.

application_licenses

list[str]

مطلوب

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

task_slots_per_node

int

مطلوب

عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.

task_scheduling_policy

TaskSchedulingPolicy

مطلوب

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

user_accounts

list[UserAccount]

مطلوب

metadata

list[MetadataItem]

مطلوب

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

mount_configuration

list[MountConfiguration]

مطلوب

قم بتحميل التخزين باستخدام Azure fileshare أو NFS أو CIFS أو نظام الملفات المستند إلى Blobfuse.

target_node_communication_mode

str أو NodeCommunicationMode

مطلوب

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

الأساليب

as_dict	إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump. قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا: المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن. سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر ذلك إملاءا للنتيجة الهرمية. راجع الأمثلة الثلاثة في هذا الملف: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
deserialize	تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.
enable_additional_properties_sending
from_dict	تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا. بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج. هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ). إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
validate	تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

as_dict

إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump.

قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا:

المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن.

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

راجع الأمثلة الثلاثة في هذا الملف:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

المعلمات

key_transformer

<xref:function>

دالة محول مفاتيح.

keep_readonly

القيمة الافتراضية: True

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

deserialize

تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.

deserialize(data, content_type=None)

المعلمات

data

str

مطلوب

سلسلة باستخدام بنية RestAPI. JSON بشكل افتراضي.

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا.

بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

المعلمات

data

dict

مطلوب

إملاء باستخدام بنية RestAPI

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

key_extractors

القيمة الافتراضية: None

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج.

هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ).

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

المعلمات

keep_readonly

bool

القيمة الافتراضية: False

إذا كنت تريد إجراء تسلسل للسمات للقراءة فقط

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

validate

تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

validate()

المرتجعات

قائمة بخطأ التحقق من الصحة

نوع الإرجاع

list