مخطط نقطة نهاية YAML لواجهة سطر الأوامر (v2) المتصلة
ينطبق على: ملحق ML Azure CLI 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_token aad_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
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ