مشاركة عبر

كيفية إرسال رسائل إلى ناقل خدمة Azure من إدارة واجهة برمجة تطبيقات Azure

ينطبق إلى: المطور | أساسي | قياسي | قسط

توضح هذه المقالة كيفية إرسال رسائل من إدارة واجهة برمجة التطبيقات إلى ناقل خدمة Azure باستخدام التكامل المستند إلى النهج. استخدم إدارة واجهة برمجة التطبيقات لتوفير طريقة آمنة وقابلة للتطوير لإرسال الرسائل إلى ناقل الخدمة.

رسم تخطيطي لتكامل إدارة واجهة برمجة التطبيقات مع ناقل خدمة Microsoft Azure للمراسلة.

Azure Service Bus هي خدمة مراسلة مؤسسية مدارة بالكامل مصممة لفصل التطبيقات والخدمات، مما يتيح المراسلة السحابية الموثوقة بين الأنظمة الموزعة. وهو يدعم AMQP (بروتوكول قائمة انتظار الرسائل المتقدم) للأنظمة لإرسال الرسائل إلى قوائم انتظار الرسائل للاتصال الفردي وموضوعات أنماط النشر/الاشتراك. يعد ناقل خدمة Microsoft Azure مثاليا للسيناريوهات التي تتطلب عمليات غير متزامنة أو تسوية تحميل أو تكامل عبر بيئات السحابة المختلطة. لمزيد من المعلومات، راجع وثائق ناقل خدمة Azure.

من خلال التكامل المستند إلى النهج، توفر إدارة واجهة برمجة التطبيقات:

  • المراسلة الآمنة المستندة إلى REST للعملاء الخارجيين - يمكن للأنظمة الخارجية وتطبيقات الأجهزة المحمولة التي تفتقر إلى دعم AMQP الأصلي إرسال رسائل إلى ناقل خدمة Microsoft Azure باستخدام واجهات برمجة تطبيقات HTTP/REST القياسية عبر إدارة واجهة برمجة التطبيقات. يعمل هذا النهج على تبسيط التكامل وتعزيز الأمان من خلال التخلص من الحاجة إلى وسطاء مخصصين.
  • عمليات تكامل الجهات الخارجية الخاضعة للرقابة - يمكن للمؤسسات الكشف عن نقاط نهاية ناقل خدمة Microsoft Azure من خلال إدارة واجهة برمجة التطبيقات من خلال مصادقة الهوية المدارة المضمنة، مما يتيح أنماط المراسلة الآمنة والقابلة للملاحظة للشركاء وتطبيقات الجهات الخارجية.
  • نموذج النار والانسيان - لا توجد خدمات خلفية أخرى مطلوبة لإرسال رسائل إلى ناقل الخدمة، مما يسمح ببنى أبسط وتقليل النفقات التشغيلية.

إشعار

  • تكامل إدارة واجهة برمجة التطبيقات مع ناقل خدمة Microsoft Azure قيد المعاينة حاليا.
  • يتم دعم إرسال الرسائل إلى ناقل خدمة Microsoft Azure فقط.

إشعار

حاليا، هذه الميزة غير متوفرة في مساحات العمل.

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

تكوين الوصول إلى ناقل خدمة Microsoft Azure

لإرسال رسائل إلى ناقل الخدمة، تحتاج إلى تكوين هوية مدارة لمثيل إدارة واجهة برمجة التطبيقات:

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

    • إذا قمت بتمكين هوية مدارة معينة من قبل المستخدم، فقم بتدوين رقم تعريف العميل للهوية.

  2. قم بتعيين الهوية دور مرسل بيانات ناقل خدمة Azure ، المحدد إلى ناقل الخدمة. لتعيين الدور، استخدم مدخل Microsoft Azure أو أدوات Azure الأخرى.

تكوين نهج إرسال ناقل خدمة الرسائل

قم بتكوين نهج send-service-bus-message لإرسال الرسائل إلى قائمة الانتظار أو الموضوع المطلوب.

على سبيل المثال، استخدم النهج send-service-bus-message في قسم النهج الوارد لإرسال نص الطلب لطلب واجهة برمجة التطبيقات عندما تستلمه البوابة:

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

  2. في القائمة اليمنى، اختر واجهات برمجة التطبيقات، ثم اختر واجهة برمجة التطبيقات التي تريد إضافة النهج إليها.

  3. حدد كافة العمليات.

  4. في أعلى الشاشة، حدد علامة التبويب تصميم .

  5. في نافذة المعالجة الواردة أو المعالجة الصادرة ، حدد </> أيقونة (محرر التعليمات البرمجية). لمزيد من المعلومات، راجع كيفية تعيين النهج أو تحريرها.

  6. ضع المؤشر في inbound قسم النهج أو outbound

  7. أضف النهج send-service-bus-message إلى تكوين النهج، ثم قم بتكوين السمات والعناصر حسب الحاجة.

    على سبيل المثال، أرسل نص الطلب كرسالة:

    <send-service-bus-message queue-name="my-queue">
    <payload>@(context.Request.Body.As<string>())</payload>
</send-service-bus-message>

    يمكنك استخدام أي تعبير يرجع سلسلة كقيمة للعنصر payload .

  8. حدد حفظ لحفظ تكوين النهج المحدث. بمجرد حفظه، يكون النهج نشطا ويتم إرسال الرسائل إلى ناقل خدمة Microsoft Azure المخصص.

المحتوى ذو الصلة

  • Last updated on