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

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

للحصول على معلومات خلفية حول بيانات التعريف في Azure API Center، راجع:

• المفاهيم الأساسية:
• بيانات التعريف لحوكمة واجهة برمجة التطبيقات

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

المتطلبات الأساسية

• مركز API في اشتراك Azure الخاص بك. إذا لم تكن قد أنشأت واحدا بالفعل، فشاهد التشغيل السريع: إنشاء مركز واجهة برمجة التطبيقات.

تعريف بيانات التعريف

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

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

2. في القائمة اليسرى، ضمن Assets، حدد Metadata > + New metadata.

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

   1. في العنوان، أدخل خط العمل.

   2. اختياريا، أدخل Description.

   3. حدد "type Predefined choices " وأدخل خيارات مثل Marketing و Finance و IT و Sales وما إلى ذلك. تمكين السماح بتحديد قيم متعددة اختياريا. حدد التالي.

   

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

   

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

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

6. حدد + New metadata لإضافة مثال آخر.

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

   1. في العنوان، أدخل Public-facing.

   2. حدد type Boolean.

8. في علامة التبويب الواجبات ، حدد مطلوب لواجهات برمجة التطبيقات. حدد Not applicable for Deployments and Environments.

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

   تتم إضافة بيانات التعريف إلى القائمة.

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

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

1. في القائمة اليمنى، ضمن Assets، حدد Metadata > View metadata schema.

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

   

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

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

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