AMQP 1.0 في ناقل خدمة Microsoft Azure: العمليات المستندة إلى الطلب/الاستجابة
تُعرف هذه المقالة قائمة العمليات المستندة إلى الطلب/الاستجابة AMQP لناقل خدمة Microsoft Azure. تستند هذه المعلومات إلى مسودة العمل الإصدار 1.0 من إدارة AMQP.
للحصول على دليل بروتوكول AMQP 1.0 مُفصل على مستوى سلكي، الذي يشرح كيفية تنفيذ Service Bus للمواصفات التقنية OASIS AMQP والبناء عليها، راجع AMQP 1.0 في Azure Service Bus ودليل بروتوكول Event Hubs.
المفاهيم
ServiceBusReceivedMessage / ServiceBusMessage
تمثل رسالة في ناقل خدمة Microsoft Azure التي تم تعيينها إلى رسالة AMQP. يُعرّف التعيين في دليل بروتوكول AMQP لناقل خدمة Microsoft Azure.
إرفاق لعُقدة إدارة الكيان
تتبع كافة العمليات الموضحة في هذا المستند نمط الطلب/الاستجابة، ويُحدد نطاقها إلى كيان، وتتطلب إرفاقها لعُقدة إدارة كيان.
إنشاء ارتباط لإرسال الطلبات
إنشاء ارتباط إلى عُقدة إدارة لإرسال الطلبات.
requestLink = session.attach(
role: SENDER,
target: { address: "<entity address>/$management" },
source: { address: ""<my request link unique address>" }
)
إنشاء ارتباط لتلقي الاستجابات
إنشاء ارتباط لتلقي الاستجابات من عُقدة الإدارة.
responseLink = session.attach(
role: RECEIVER,
source: { address: "<entity address>/$management" }
target: { address: "<my response link unique address>" }
)
نقل رسالة طلب
نقل رسالة طلب.
يمكن إضافة حالة المعاملة اختياريا للعمليات التي تدعم المعاملات.
requestLink.sendTransfer(
Message(
properties: {
message-id: <request id>,
reply-to: "<my response link unique address>"
},
application-properties: {
"operation" -> "<operation>",
}
),
[Optional] State = transactional-state: {
txn-id: <txn-id>
}
)
استلام رسالة استجابة
استلام رسالة الاستجابة من ارتباط الاستجابة.
responseMessage = responseLink.receiveTransfer()
رسالة الاستجابة في النموذج التالي:
Message(
properties: {
correlation-id: <request id>
},
application-properties: {
"statusCode" -> <status code>,
"statusDescription" -> <status description>,
},
)
عنوان كيان ناقل خدمة Microsoft Azure
يجب معالجة كيانات ناقل خدمة Microsoft Azure على النحو التالي:
| نوع الكيان | العنوان | مثال |
|---|---|---|
| صف | <queue_name> |
“myQueue”“site1/myQueue” |
| الموضوع | <topic_name> |
“myTopic”“site2/page1/myQueue” |
| الاشتراك | <topic_name>/Subscriptions/<subscription_name> |
“myTopic/Subscriptions/MySub” |
عمليات الرسالة
تأمين تجديد الرسالة
تمديد تأمين رسالة حسب مدة التأمين المحددة في قائمة الانتظار أو الاشتراك.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:renew-lock |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
lock-tokens |
صفيف uuid | نعم | رموز تأمين الرسائل لتجديدها. |
إشعار
رمز التأمين هنا يشير إلى الخاصية delivery-tag على الرسالة AMQP المُستلمة. إذا استلمت رسالة مؤجلة وأردت تجديد تأمينها، فاستخدم الخاصية lock-token على الرسالة بدلًا من delivery-tag.
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل. |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| عمليات انتهاء الصلاحية | صفيف الطابع الزمني | نعم | انتهاء صلاحية جديد لرمز تأمين الرسالة المميز متوافق مع رموز تأمين الطلب المميزة. |
رسائل التحرير بسرعة
رسائل التحرير بسرعة دون تأمين.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
from-sequence-number |
طويل | نعم | رقم التسلسل الذي يبدأ منه التحرير بسرعة. |
message-count |
العدد الصحيح | نعم | الحد الأقصى لعدد رسائل التحرير بسرعة. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – لديه المزيد من الرسائل 204: لا يوجد محتوى - لا مزيد من الرسائل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من قسم amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| الرسائل | قائمة المخططات | نعم | قائمة بالرسائل التي يمثل فيها كل مخطط رسالة. |
يجب أن يحتوي المخطط الذي يمثل الرسالة على الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| رسالة | صفيف بايت | نعم | رسالة AMQP 1.0 مشفرة سلكيًا. |
جدولة الرسالة
جداول الرسائل. تدعم هذه العملية المعاملة.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:schedule-message |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| الرسائل | قائمة المخططات | نعم | قائمة بالرسائل التي يمثل فيها كل مخطط رسالة. |
يجب أن يحتوي المخطط الذي يمثل الرسالة على الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| message-id | سلسلة | نعم | amqpMessage.Properties.MessageId كسلسلة |
| session-id | سلسلة | لا | amqpMessage.Properties.GroupId as string |
| مفتاح القسم | سلسلة | لا | amqpMessage.MessageAnnotations.”x-opt-partition-key" |
| via-partition-key | سلسلة | لا | amqpMessage.MessageAnnotations."x-opt-via-partition-key" |
| رسالة | صفيف بايت | نعم | رسالة AMQP 1.0 مشفرة سلكيًا. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل. |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| sequence-numbers | صفيف long | نعم | رقم التسلسل للرسائل المجدولة. يُستخدم رقم التسلسل لإلغاء. |
إلغاء الرسالة المجدولة
إلغاء الرسائل المجدولة.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:cancel-scheduled-message |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| sequence-numbers | صفيف long | نعم | تسلسل أرقام الرسائل المجدولة للإلغاء. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل. |
| statusDescription | سلسلة | لا | وصف الحالة. |
عمليات الجلسة
تأمين تجديد الجلسة
تمديد تأمين رسالة حسب مدة التأمين المحددة في قائمة الانتظار أو الاشتراك.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:renew-session-lock |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| session-id | سلسلة | نعم | معرف جلسة العمل. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – لديه المزيد من الرسائل 204: لا يوجد محتوى - لا مزيد من الرسائل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| انتهاء الصلاحية | الطابع الزمني | نعم | انتهاء صلاحية جديد. |
رسائل جلسة التحرير بسرعة
رسائل جلسة التحرير بسرعة دون تأمين.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| from-sequence-number | طويل | نعم | رقم التسلسل الذي يبدأ منه التحرير بسرعة. |
| message-count | العدد الصحيح | نعم | الحد الأقصى لعدد رسائل التحرير بسرعة. |
| session-id | سلسلة | نعم | معرف جلسة العمل. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – لديه المزيد من الرسائل 204: لا يوجد محتوى - لا مزيد من الرسائل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| الرسائل | قائمة المخططات | نعم | قائمة بالرسائل التي يمثل فيها كل مخطط رسالة. |
يجب أن يحتوي المخطط الذي يمثل الرسالة على الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| رسالة | صفيف بايت | نعم | رسالة AMQP 1.0 مشفرة سلكيًا. |
مجموعة حالة الجلسة
تعيين حالة الجلسة.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:set-session-state |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| session-id | سلسلة | نعم | معرف جلسة العمل. |
| session-state | صفيف بايت | نعم | بيانات ثنائية مبهمة. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
الحصول على حالة الجلسة
يحصل على حالة الجلسة.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:get-session-state |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| session-id | سلسلة | نعم | معرف جلسة العمل. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من قسم amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| session-state | صفيف بايت | نعم | بيانات ثنائية مبهمة. |
تعداد الجلسات
تعداد الجلسات على كيان مراسلة.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:get-message-sessions |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| last-updated-time | الطابع الزمني | نعم | عامل التصفية لتضمين الجلسات المُحدثة فقط بعد وقت معين. |
| skip | العدد الصحيح | نعم | تخطي عدد من الجلسات. |
| أعلى | العدد الصحيح | نعم | الحد الأقصى لعدد الجلسات. |
إشعار
عند التعيين LastUpdatedTime إلى DateTime.MaxValue (في .NET)، يقوم الأسلوب تعداد جلسات العمل بإرجاع كافة جلسات العمل سواء كانت لها حالة أم لا. DateTime.MaxValue في .NET قد لا يكون موجودا في لغات البرمجة الأخرى. في مثل هذه الحالات، استخدم طابعا زمنيا يساوي 253402300800000 مللي ثانية من الفترة (1 يناير 1970، 00:00:00 بتوقيت جرينتش)، وهو ما يعادل DateTime.MaxValue في .NET.
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – لديه المزيد من الرسائل 204: لا يوجد محتوى - لا مزيد من الرسائل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من قسم amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| skip | العدد الصحيح | نعم | عدد الجلسات التي تم تخطيها إذا كان رمز الحالة 200. |
| sessions-ids | صفيف سلاسل | نعم | صفيف معرّفات الجلسة إذا كان رمز الحالة 200. |
عمليات القاعدة
إضافة قاعدة
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:add-rule |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| rule-name | سلسلة | نعم | اسم القاعدة، لا يشمل أسماء الاشتراك والموضوعات. |
| rule-description | map | نعم | وصف القاعدة كما هو محدد في القسم التالي. |
يجب أن يتضمن مخطط rule-description الإدخالات التالية، حيث لا يجتمع sql-filter وcorrelation-filter بشكل متبادل:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| sql-filter | map | نعم | sql-filter، كما هو محدد في القسم التالي. |
| correlation-filter | map | نعم | correlation-filter، كما هو محدد في القسم التالي. |
| sql-rule-action | map | نعم | sql-rule-action، كما هو محدد في القسم التالي. |
يجب أن يتضمن مخطط sql-filter على الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| تعبير | سلسلة | نعم | تعبير عامل تصفية Sql. |
يجب أن يتضمن مخطط correlation-filter أحد الإدخالات التالية على الأقل:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| correlation-id | سلسلة | لا | |
| message-id | سلسلة | لا | |
| to | سلسلة | لا | |
| reply-to | سلسلة | لا | |
| تسمية | سلسلة | لا | |
| session-id | سلسلة | لا | |
| reply-to-session-id | سلسلة | لا | |
| content-type | سلسلة | لا | |
| الخصائص | map | لا | الخرائط إلى ناقل خدمة Microsoft Azure ServiceBusMessage.Properties |
يجب أن يتضمن مخطط sql-rule-action الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| تعبير | سلسلة | نعم | تعبير إجراء Sql. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
إزالة القاعدة
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:remove-rule |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| rule-name | سلسلة | نعم | اسم القاعدة، لا يشمل أسماء الاشتراك والموضوعات. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
الحصول على القواعد
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:enumerate-rules |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| أعلى | العدد الصحيح | نعم | عدد القواعد التي يجب إحضارها في الصفحة. |
| skip | العدد الصحيح | نعم | عدد القواعد التي يجب تخطيها. تعريف فهرس البداية (1+) في قائمة القواعد. |
استجابة
تتضمن رسالة الاستجابة الخصائص التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| القواعد | قائمة المخططات | نعم | قائمة القواعد. تُمثل كل قاعدة بمخطط. |
يتضمن كل إدخال خريطة في القائمة الخصائص التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| rule-description | كائن موصوف | نعم | com.microsoft:rule-description مع رمز وصف 0x0000013700000004 لـ AMQP |
com.microsoft.rule-description نفسها هي قائمة موصوفة. يحتوي على الخصائص التالية:
| الفهرس | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| 0 | قائمة موصوفة | نعم | filter كما هو محدد في الجدول التالي. |
| 1 | قائمة موصوفة | نعم | ruleAction كما هو محدد لاحقا في هذا القسم. |
| 2 | سلسلة | نعم | اسم القاعدة. |
| 3 | الطابع الزمني | نعم | الطابع الزمني. |
filter يمكن أن يكون أحد الأنواع التالية:
| اسم الواصف | تعليمة برمجية للواصف | القيمة |
|---|---|---|
com.microsoft:sql-filter:list |
0x000001370000006 | عامل تصفية SQL |
com.microsoft:correlation-filter:list |
0x000001370000009 | عامل تصفية الارتباط |
com.microsoft:true-filter:list |
0x000001370000007 | عامل تصفية صحيح يمثل 1=1 |
com.microsoft:false-filter:list |
0x000001370000008 | عامل تصفية خاطئ يمثل 1=0 |
com.microsoft:sql-filter:list هي قائمة موصوفة، والتي تتضمن:
| الفهرس | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| 0 | سلسلة | نعم | تعبير عامل تصفية Sql |
| 1 | العدد الصحيح | نعم | دائما 20. هذا العدد الصحيح هو مستوى توافق عامل تصفية sql. يشير إلى إصدار بناء الجملة لعامل تصفية sql. |
com.microsoft:correlation-filter:list هي قائمة موصوفة، والتي تتضمن:
| الفهرس (إذا كان موجودًا) | نوع القيمة | محتويات القيمة |
|---|---|---|
| 0 | سلسلة | معرف الارتباط |
| 1 | سلسلة | معرّف الرسالة |
| 2 | سلسلة | لكي تتمكن من |
| 3 | سلسلة | الرد على |
| 4 | سلسلة | التسمية |
| 5 | سلسلة | معرف جلسة العمل: |
| 6 | سلسلة | الرد على معرّف الجلسة |
| 7 | سلسلة | نوع المحتوى |
| 8 | الخريطة | مخطط خصائص التطبيق المُعرفة |
ruleAction يمكن أن يكون أحد الأنواع التالية:
| اسم الواصف | تعليمة برمجية للواصف | القيمة |
|---|---|---|
com.microsoft:empty-rule-action:list |
0x0000013700000005 | إجراء قاعدة فارغ - لا يوجد إجراء للقعدة |
com.microsoft:sql-rule-action:list |
0x0000013700000006 | إجراء قاعدة SQL |
com.microsoft:sql-rule-action:list هي قائمة موصوفة تحتوي على عنصرين.
| الفهرس | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| 0 | سلسلة | نعم | تعبير إجراء قاعدة SQL |
| 1 | العدد الصحيح | نعم | دائما 20. هذا العدد الصحيح هو مستوى توافق عامل تصفية sql. يشير إلى إصدار بناء الجملة لعامل تصفية sql. |
عمليات الرسائل المؤجلة
الاستلام حسب رقم التسلسل
استلام الرسائل المؤجلة حسب رقم التسلسل.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:receive-by-sequence-number |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| sequence-numbers | صفيف long | نعم | أرقام التسلسل. |
| receiver-settle-mode | ubyte | نعم | وضع تسوية المُستلم كما محدد في AMQP الأساسي v1.0. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
نص رسالة الاستجابة يجب أن يتكون من قسم amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| الرسائل | قائمة المخططات | نعم | قائمة بالرسائل التي يُمثل فيها كل مخطط رسالة. |
يجب أن يحتوي المخطط الذي يمثل الرسالة على الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| lock-token | uuid | نعم | تأمين الرمز المميز إذا كان receiver-settle-mode هو 1. |
| رسالة | صفيف بايت | نعم | رسالة AMQP 1.0 مشفرة سلكيًا. |
تحديث حالة الإرجاع
تحديث حالة الإرجاع للرسائل المؤجلة. تدعم هذه العملية المعاملات.
طلب
يجب أن تتضمن رسالة الطلب خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| التشغيل | سلسلة | نعم | com.microsoft:update-disposition |
com.microsoft:server-timeout |
uint | لا | مهلة خادم العملية بالمللي ثانية. |
نص رسالة الطلب يجب أن يتكون من مقطع amqp-value يحتوي على مخطط مع الإدخالات التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| disposition-status | سلسلة | نعم | تم ملغي متوقف مؤقتًا |
| lock-tokens | صفيف uuid | نعم | رموز تأمين الرسائل لتحديث حالة الإرجاع. |
| deadletter-reason | سلسلة | لا | يتم تعيينه إذا تم تعيين حالة التصرف إلى معلق. |
| deadletter-description | سلسلة | لا | يتم تعيينه إذا تم تعيين حالة التصرف إلى معلق. |
| properties-to-modify | map | لا | قائمة خصائص رسالة الوسيط لناقل خدمة Microsoft Azure للتعديل. |
استجابة
يجب أن تتضمن رسالة الاستجابة خصائص التطبيق التالية:
| المفتاح | نوع القيمة | المطلوب | محتويات القيمة |
|---|---|---|---|
| statusCode | العدد الصحيح | نعم | رمز استجابة HTTP [RFC2616] 200: موافق – نجاح، وإلا فشل |
| statusDescription | سلسلة | لا | وصف الحالة. |
الخطوات التالية
لمعرفة المزيد حول AMQP وناقل خدمة Microsoft Azure، يُرجى زيارة الروابط التالية:
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ