مشاركة عبر

إرسال رسالة ناقل الخدمة

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

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

إشعار

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<send-service-bus-message queue-name="service bus queue" topic-name="service bus topic"
      namespace="FQDN of service bus namespace" client-id="ID of user-assigned managed identity">
        <message-properties>
                <message-property name="property-name">property-value</message-property>
                <!-- if there are multiple properties, then add additional message-property elements -->
        </message-properties>
        <payload>"message content"</payload>
</send-service-bus-message>

سمات

صفة وصف مطلوب افتراضي
queue-name يحدد اسم قائمة انتظار ناقل الخدمة لإرسال الرسالة إليها. يسمح بتعبيرات النهج والقيم المسماة. إما queue-name أو topic-name يجب تحديده. لا N/A
topic-name يحدد اسم موضوع ناقل الخدمة لإرسال الرسالة إليه. يسمح بتعبيرات النهج والقيم المسماة. إما queue-name أو topic-name يجب تحديده. لا N/A
namespace تحديد اسم المجال المؤهل بالكامل لمساحة اسم ناقل الخدمة. يسمح بتعبيرات النهج والقيم المسماة. لا N/A
client-id يحدد معرف العميل للهوية المدارة المعينة من قبل المستخدم للمصادقة مع ناقل الخدمة. يجب تعيين الهوية لدور مرسل بيانات ناقل خدمة Microsoft Azure. يسمح بتعبيرات النهج والقيم المسماة. إذا لم يتم تحديدها، يتم استخدام الهوية المعينة من قبل النظام. لا N/A

Elements

العنصر وصف مطلوب
payload تحديد حمولة الرسالة لإرسالها إلى ناقل الخدمة. يسمح بتعبيرات النهج والقيم المسماة. ‏‏نعم‬
message-properties مجموعة من message-property العناصر الفرعية التي تحدد بيانات التعريف لتمريرها مع حمولة الرسالة. يتكون كل message-property منها من زوج الاسم والقيمة. يسمح بتعبيرات النهج والقيم المسماة. لا

الاستخدام

ملاحظات الاستخدام

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

Examples

إرسال رسالة إلى قائمة انتظار ناقل الخدمة

في هذا المثال، يتم إرسال رسالة تتكون من نص الطلب إلى قائمة انتظار ناقل الخدمة. يستخدم مثيل API Management هوية معينة من قبل المستخدم للوصول. ثم تتم إعادة توجيه الطلب إلى خدمة الواجهة الخلفية.

<policies>
    <inbound>
        <send-service-bus-message queue-name="orders" client-id="00001111-aaaa-2222-bbbb-3333cccc4444" namespace="my-service-bus.servicebus.windows.net">
           <payload>@(context.Request.Body.As<string>(preserveContent: true))</payload>
        </send-service-bus-message>
    </inbound>
    <backend>
        <forward-request timeout="60"/>
    </backend>
</policies>

إرسال رسالة إلى موضوع ناقل خدمة

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

<policies>
    <inbound>
        <send-service-bus-message topic-name="orders" namespace="my-service-bus.servicebus.windows.net">
           <payload>@(context.Request.Body.As<string>(preserveContent: true))</payload>
        </send-service-bus-message>
    </inbound>
    <backend>
        <forward-request timeout="60"/>
    </backend>
</policies>

إرسال رسالة وبيانات تعريف

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

<policies>
    <inbound>
        <send-service-bus-message topic-name="orders" namespace="my-service-bus.servicebus.windows.net">
           <message-properties>
              <message-property name="Customer">Contoso</message-property>
           </message-properties>
           <payload>@(context.Request.Body.As<string>(preserveContent: true))</payload>
        </send-service-bus-message>
    </inbound>
    <backend>
        <forward-request timeout="60"/>
    </backend>
</policies>

إرسال رسالة والعودة على الفور

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

<policies>
    <inbound>
        <send-service-bus-message topic-name="orders" namespace="my-service-bus.servicebus.windows.net">
           <payload>@(context.Request.Body.As<string>(preserveContent: true))</payload>
        </send-service-bus-message>
        <return-response>
            <set-status code="201" reason="Created!" />
        </return-response>
    </inbound>
</policies>

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

لمزيد من المعلومات حول العمل مع النُهج، راجع:

  • Last updated on