إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: الاستهلاك | المطور | أساسي | قياسي | قسط
يصف هذا التشغيل السريع خطوات إنشاء مثيل APIM جديد باستخدام أوامر Azure CLI. بعد إنشاء مثيل، يمكنك استخدام Azure CLI لمهام الإدارة الشائعة مثل استيراد واجهات برمجة التطبيقات في مثيل APIM.
تساعد إدارة واجهة برمجة التطبيقات Azure المؤسسات على نشر واجهات برمجة التطبيقات للمطورين الخارجيين والشركاء والداخليين لإطلاق العنان لإمكانات بياناتهم وخدماتهم. توفر إدارة واجهة برمجة التطبيقات الكفاءات الأساسية لضمان نجاح برنامج واجهة برمجة التطبيقات من خلال مشاركة المطورين ورؤى الأعمال والتحليلات والأمان والحماية. باستخدام APIM، قم بإنشاء وإدارة بوابات واجهة برمجة التطبيقات الحديثة لخدمات الواجهة الخلفية الموجودة المستضافة في أي مكان.
إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
المتطلبات الأساسية
استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع بدء استخدام Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام Azure CLI.
عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات حول الملحقات، راجع استخدام الملحقات وإدارتها باستخدام Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
- تتطلب هذه المقالة الإصدار 2.11.1 أو أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.
إنشاء مجموعة موارد
يجب نشر مثيلات Azure API Management، مثل جميع موارد Azure، في مجموعة موارد. تسمح لك مجموعات الموارد بتنظيم موارد Azure ذات الصلة وإدارتها.
أولا، أنشئ مجموعة موارد باسم myResourceGroup في موقع وسط الولايات المتحدة باستخدام الأمر التالي az group create :
az group create --name myResourceGroup --location centralus
إنشاء نموذج إدارة واجهة برمجة التطبيقات
الآن بعد أن أصبح لديك مجموعة موارد، يمكنك إنشاء مثيل APIM. إنشاء واحد باستخدام الأمر az apim create وتوفير اسم خدمة وتفاصيل الناشر. يجب أن يكون اسم الخدمة فريدا داخل Azure.
في المثال التالي، يتم استخدام myapim لاسم الخدمة. تحديث الاسم إلى قيمة فريدة. قم أيضا بتحديث اسم مؤسسة ناشر واجهة برمجة التطبيقات، ولتلقي الإشعارات، قم بتحديث عنوان البريد الإلكتروني.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
بشكل افتراضي، يقوم الأمر بإنشاء المثيل في مستوى المطور، وهو خيار اقتصادي لتقييم Azure API Management. هذا المستوى ليس للاستخدام الإنتاجي. لمزيد من المعلومات حول تحجيم مستويات إدارة واجهة برمجة التطبيقات، راجع الترقية والتحجيم.
نَصِيحة
قد يستغرق إنشاء خدمة APIM وتنشيطها في هذا المستوى ما بين 30 و40 دقيقة. يستخدم --no-wait الأمر السابق الخيار بحيث يعود الأمر فورا أثناء إنشاء الخدمة.
تحقق من حالة النشر عن طريق تشغيل الأمر az apim show :
az apim show --name myapim --resource-group myResourceGroup --output table
في البداية، يكون الإخراج مشابها للآتي، ويظهر Activating الحالة:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
بعد التنشيط، تكون الحالة ومثيل Online الخدمة له عنوان بوابة وعنوان IP عام. في الوقت الحالي، لا تعرض هذه العناوين أي محتوى. على سبيل المثال:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- --------------------------------- ------------ ------------ -------- --------- -------
myapim myResourceGroup Central US https://myapim.azure-api.net 203.0.113.1 Online Developer 1
عندما يكون مثيل خدمة APIM متصلا بالإنترنت، تكون جاهزا لاستخدامه. ابدأ بالبرنامج التعليمي لاستيراد ونشر واجهة برمجة التطبيقات الأولى.
تنظيف الموارد
يمكنك استخدام الأمر az group delete لإزالة مجموعة الموارد ومثيل خدمة APIM عندما لا تكون هناك حاجة إليها.
az group delete --name myResourceGroup