التشغيل السريع: إنشاء مثيل Azure API Management جديد باستخدام Azure CLI

ينطبق على: الاستهلاك | المطور | أساسي | قياسي | بريميوم

يصف هذا التشغيل السريع خطوات إنشاء مثيل APIM جديد باستخدام أوامر Azure CLI. بعد إنشاء مثيل، يمكنك استخدام Azure CLI لمهام الإدارة الشائعة مثل استيراد واجهات برمجة التطبيقات في مثيل APIM.

تساعد إدارة واجهة برمجة التطبيقات Azure المؤسسات على نشر واجهات برمجة التطبيقات للمطورين الخارجيين والشركاء والداخليين لإطلاق العنان لإمكانات بياناتهم وخدماتهم. توفر إدارة واجهة برمجة التطبيقات الكفاءات الأساسية لضمان نجاح برنامج واجهة برمجة التطبيقات من خلال مشاركة المطورين ورؤى الأعمال والتحليلات والأمان والحماية. باستخدام APIM، قم بإنشاء وإدارة بوابات واجهة برمجة التطبيقات الحديثة لخدمات الواجهة الخلفية الموجودة المستضافة في أي مكان.

إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

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

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

• تتطلب هذه المقالة الإصدار 2.11.1 أو أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.

إنشاء مجموعة موارد

يجب نشر مثيلات إدارة Azure API، مثل جميع موارد Azure، في مجموعة موارد. تسمح لك مجموعات الموارد بتنظيم موارد Azure ذات الصلة وإدارتها.

أولاً، أنشئ مجموعة موارد باسم myResourceGroup في موقع Central US باستخدام الأمر التالي az group create:

az group create --name myResourceGroup --location centralus

إنشاء نموذج إدارة واجهة برمجة التطبيقات

الآن بعد أن أصبح لديك مجموعة موارد، يمكنك إنشاء مثيل APIM. قم بإنشاء واحد باستخدام الأمر az apim create وقدم اسم الخدمة وتفاصيل الناشر. يجب أن يكون اسم الخدمة فريداً داخل Azure.

في المثال التالي، يتم استخدام myapim لاسم الخدمة. قم بتحديث الاسم إلى قيمة فريدة. قم أيضاً بتحديث اسم مؤسسة ناشر API وعنوان البريد الإلكتروني لتلقي الإخطارات.

az apim create --name myapim --resource-group myResourceGroup \
  --publisher-name Contoso --publisher-email admin@contoso.com \
  --no-wait

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

تلميح

قد يستغرق إنشاء وتفعيل خدمة إدارة واجهة برمجة التطبيقات في هذا المستوى ما بين 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

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

تنظيف الموارد

يمكنك استخدام الأمر az group delete لإزالة مجموعة الموارد ومثيل خدمة APIM عند عدم الحاجة إليها.

az group delete --name myResourceGroup

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

استيراد ونشر أول واجهة برمجة تطبيقات