مخطط نقطة نهاية YAML لواجهة سطر الأوامر (v2) المتصلة

مقالة
11/15/2023

ينطبق على:ملحق CLI للتعلم الآلي من Microsoft Azure v2 (الحالي)

يمكن العثور على مخطط JSON المصدر في https://azuremlschemas.azureedge.net/latest/managedOnlineEndpoint.schema.json لنقطة النهاية المدارة عبر الإنترنت، وفي https://azuremlschemas.azureedge.net/latest/kubernetesOnlineEndpoint.schema.json نقطة نهاية Kubernetes عبر الإنترنت. يتم وصف الاختلافات بين نقطة النهاية المدارة عبر الإنترنت ونقطة نهاية Kubernetes عبر الإنترنت في جدول الخصائص في هذه المقالة. تركز العينة في هذه المقالة على نقطة النهاية المدارة عبر الإنترنت.

إشعار

يعتمد بناء YAML المفصل في هذا المستند على مخطط JSON لأحدث إصدار من ملحق الإصدار الثاني من واجهة مستوى الاستدعاء للتعليم الآلي. إن هذا البناء مضمون للعمل فقط مع أحدث إصدار من ملحق الإصدار الثاني من واجهة مستوى الاستدعاء للتعليم الآلي. بإمكانك العثور على مخططات إصدارات الملحق الأقدم في https://azuremlschemasprod.azureedge.net/.

إشعار

يتوفر نموذج YAML محدد تماماً لنقاط النهاية المتصلة المدارة كمرجع

بناء YAML

المفتاح	النوع	الوصف	القيم المسموح بها	القيمة الافتراضية
`$schema`	سلسلة	مخطط YAML. في حال كنت تستخدم ملحق التعلم الآلي من Microsoft Azure VS Code لتأليف ملف «YAML»، بما في ذلك `$schema` في الجزء العلوي من الملف، يمكنك استدعاء عمليات إكمال المخطط والمورد.
`name`	سلسلة	مطلوب اسم نقطة النهاية. يجب أن يكون فريدًا على مستوى منطقة Azure. يتم تعريف قواعد التسمية ضمن حدود نقطة النهاية.
`description`	سلسلة	وصف نقطة النهاية.
`tags`	كائن	قاموس العلامات لنقاط النهاية.
`auth_mode`	سلسلة	أسلوب المصادقة لاستدعاء نقطة النهاية (عملية مستوى البيانات). استخدام `key` للمصادقة المستندة إلى المفتاح. استخدم `aml_token` للمصادقة المستندة إلى الرمز المميز التعلم الآلي من Microsoft Azure. استخدم `aad_token` للمصادقة المستندة إلى الرمز المميز ل Microsoft Entra (معاينة).	`key`، ، `aml_tokenaad_token`	`key`
`compute`	سلسلة	اسم الحساب الهدف الذي سيتم تشغيل عمليات توزيع نقطة النهاية عليه. ينطبق هذا الحقل فقط على عمليات توزيع نقاط النهاية إلى مجموعات Kubernetes الممكنة في Azure Arc (يجب أن يحتوي الحساب الهدف الحساب المحدد في هذا الحقل على `type: kubernetes`). لا تحدد هذا الحقل إذا كنت تقوم بإدارة الاستدلال عبر الإنترنت.
`identity`	كائن	تكوين الهوية المدار للوصول إلى موارد Azure لتوفير نقطة النهاية والاستدلال.
`identity.type`	سلسلة	نوع هوية مدارة. إذا كان النوع هو `user_assigned`، ينبغي أيضا تحديد خاصية `identity.user_assigned_identities`.	`system_assigned`, `user_assigned`
`identity.user_assigned_identities`	صفيف	قائمة معرفات الموارد المؤهلة بالكامل للهويات المعينة من المستخدم.
`traffic`	كائن	تمثل نسبة استخدام الشبكة النسبة المئوية للطلبات التي ستقدم بواسطة عمليات نشر مختلفة. يتم تمثيلها بواسطة قاموس أزواج قيم المفاتيح، حيث تمثل المفاتيح اسم التوزيع والقيمة التي تمثل النسبة المئوية لنسبة استخدام الشبكة إلى هذا التوزيع. على سبيل المثال، `blue: 90 green: 10` يعني أن 90٪ من الطلبات تم إرسالها إلى التوزيع المسمى `blue` وتم إرسال 10٪ إلى التوزيع`green`. يجب أن يكون إجمالي نسبة استخدام الشبكة 0 أو ما يصل إلى 100. راجع الإطلاق الآمن لنقاط النهاية عبر الإنترنت لمعرفة تكوين نسبة استخدام الشبكة قيد التنفيذ. ملاحظة: لا يمكنك تعيين هذا الحقل أثناء إنشاء نقطة النهاية عبر الإنترنت، حيث يجب إنشاء عمليات التوزيع ضمن نقطة النهاية هذه قبل ضبط نسبة استخدام الشبكة. بإمكانك تحديث نسبة استخدام الشبكة لنقطة نهاية عبر الإنترنت بعد إنشاء عمليات التوزيع باستخدام `az ml online-endpoint update`؛ على سبيل المثال، `az ml online-endpoint update --name <endpoint_name> --traffic "blue=90 green=10"`.
`public_network_access`	سلسلة	تتحكم هذه العلامة في ظهور نقطة النهاية المدارة. عند `disabled`يتم استلام طلبات التسجيل الواردة باستخدام نقطة النهاية الخاصة لمساحة عمل التعلم الآلي من Microsoft Azure ولا يمكن الوصول إلى نقطة النهاية من الشبكات العامة. لا تنطبق هذه العلامة إلا على نقاط النهاية المدارة	`enabled`, `disabled`	`enabled`
`mirror_traffic`	سلسلة	النسبة المئوية لنسبة استخدام الشبكة المباشرة التي تعكس عملية التوزيع. لا يغير النسخ المتطابق لنسبة استخدام الشبكة إلى تغيير النتائج التي تم إرجاعها إلى العملاء. يتم نسخ النسبة المئوية المتطابقة لنسبة استخدام الشبكة وإرسالها إلى التوزيع المحدد حتى تتمكن من جمع المقاييس والتسجيل دون التأثير على العملاء. على سبيل المثال، للتحقق مما إذا كان وقت الاستجابة ضمن الحدود المقبولة وأنه لا توجد أخطاء HTTP. يتم تمثيله بواسطة قاموس مع زوج واحد من قيم المفاتيح، حيث يمثل المفتاح اسم التوزيع وتمثل القيمة النسبة المئوية لنسبة استخدام الشبكة التي تعكس عملية التوزيع. للحصول على مزيد من المعلومات، راجع اختبار توزيع باستخدام نسبة استخدام الشبكة المتطابقة.

الملاحظات

يمكن استخدام أوامرaz ml online-endpoint لإدارة نقاط نهاية التعلم الآلي من Microsoft Azure عبر الإنترنت.

أمثلة

الأمثلة متوفرة في مستودع أمثلة GitHub. ويرد أدناه العديد منها.

YAML: أساسي

$schema: https://azuremlschemas.azureedge.net/latest/managedOnlineEndpoint.schema.json
name: my-endpoint
auth_mode: key

YAML: الهوية التي تم تعيينها من قِبل النظام

$schema: https://azuremlschemas.azureedge.net/latest/managedOnlineEndpoint.schema.json
name: my-sai-endpoint
auth_mode: key

YAML: الهوية المعينة من المستخدم

$schema: https://azuremlschemas.azureedge.net/latest/managedOnlineEndpoint.schema.json
name: my-uai-endpoint
auth_mode: key
identity:
  type: user_assigned
  user_assigned_identities:
    - resource_id: user_identity_ARM_id_place_holder

Share via