مشاركة عبر


البرنامج التعليمي: تعريف بيانات التعريف المخصصة

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

لمزيد من المعلومات حول بيانات التعريف في مركز واجهة برمجة تطبيقات Azure، راجع:

في هذا البرنامج التعليمي، ستتعلم كيفية استخدام مدخل Microsoft Azure من أجل:

  • تحديد البيانات الوصفية المخصصة في مركز واجهة برمجة التطبيقات
  • عرض مخطط بيانات التعريف

المتطلبات المسبقه

تعريف البيانات الوصفية

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

هام

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

  1. سجل الدخول إلى مدخل Microsoft Azure، ثم انتقل إلى مركز واجهة برمجة التطبيقات.

  2. في قائمة الشريط الجانبي، ضمن مواد العرض، اختر البيانات>الوصفية + بيانات وصفية جديدة.

  3. في علامة التبويب التفاصيل ، أدخل معلومات حول بيانات التعريف.

    1. بالنسبة إلى العنوان، أدخل خط العمل.

    2. اختياريا، أدخل وصفا.

    3. حدد النوع خيارات محددة مسبقا وأدخل خيارات مثل التسويق والتمويل وتكنولوجيا المعلومات والمبيعات وما إلى ذلك. اختياريا، قم بتمكين السماح بتحديد قيم متعددة. حدد التالي.

    لقطة شاشة توضح كيفية إضافة بيانات تعريف مخصصة في المدخل.

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

    لقطة شاشة لتعيينات بيانات التعريف في المدخل.

  5. في علامة التبويب Review + create ، راجع الإعدادات، وحدد Create.

    تتم إضافة البيانات التعريفية إلى القائمة الموجودة في صفحة البيانات التعريفية .

  6. حدد + بيانات تعريف جديدة لإضافة مثال آخر.

  7. في علامة التبويب التفاصيل ، أدخل معلومات حول بيانات التعريف.

    1. بالنسبة إلى العنوان، أدخل واجهة عامة.

    2. حدد النوع المنطقي.

  8. في علامة التبويب التعيينات ، حدد مطلوب لواجهات برمجة التطبيقات. حدد غير قابل للتطبيق لعمليات التوزيع والبيئات.

  9. في علامة التبويب Review + create ، راجع الإعدادات، وحدد Create.

    تتم إضافة البيانات الوصفية إلى القائمة.

عرض مخطط بيانات التعريف

يمكنك عرض مخطط JSON وتنزيله للبيانات الوصفية المحددة في مركز واجهة برمجة التطبيقات. يتضمن المخطط بيانات تعريف مضمنة ومخصصة.

  1. في القائمة اليمنى، ضمن مواد العرض، اخترمخطط عرض البيانات>الوصفية.

  2. حدد عرضواجهات برمجة تطبيقات مخطط >البيانات الوصفيةللاطلاع على مخطط البيانات الوصفية لواجهات برمجة التطبيقات، والذي يتضمن بيانات التعريف المضمنة والمخصصة. يمكنك أيضا عرض مخطط بيانات التعريف المحدد لعمليات التوزيع والبيئات في مركز واجهة برمجة التطبيقات الخاص بك.

    لقطة شاشة لمخطط بيانات التعريف في المدخل.

الخطوة التالية

أضف واجهات برمجة التطبيقات إلى المخزون في مركز واجهة برمجة التطبيقات الخاص بك.