مشاركة عبر

تمكين إعادة التوجيه التلقائي لقوائم انتظار واشتراكات ناقل خدمة Microsoft Azure

  • مقالة

تتيح لك ميزة إعادة التوجيه التلقائي لناقل الخدمة ربط قائمة انتظار، أو اشتراك في قائمة انتظار، أو موضوع آخر يمثل جزءًا من نفس مساحة الاسم. عند تمكين إعادة التوجيه التلقائي، يقوم ناقل خدمة Microsoft Azure تلقائيًا بإزالة الرسائل الموضوعة في قائمة الانتظار الأولى أو الاشتراك (المصدر)، ويضعها في قائمة الانتظار الثانية أو الموضوع (الوجهة). لا يزال من الممكن إرسال رسالة إلى الكيان الوجهة مباشرة. لمزيد من المعلومات، راجع تسلسل كيانات ناقل الخدمة ذات ميزة إعادة التوجيه التلقائي. توضح لك هذه المقالة طرقًا مختلفة لتمكين إعاجة التوجيه التلقائي لقوائم انتظار واشتراكات ناقل خدمة Microsoft Azure.

هام

لا يدعم المستوى الأساسي من ناقل الخدمة ميزة إعادة التوجيه التلقائي. المستويات القياسية والمتميزة تدعم هذه الميزة. لمعرفة الاختلافات بين هذه المستويات، راجع الأسعار الخاصة بناقل خدمة Microsoft Azure.

استخدام مدخل Microsoft Azure

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

إنشاء قائمة انتظار مع تمكين إعادة التوجيه التلقائي

تمكين إعادة التوجيه التلقائي في وقت إنشاء قائمة انتظار

إنشاء اشتراك لموضوع مع تمكين إعادة التوجيه التلقائي

تمكين إعادة التوجيه التلقائي في وقت إنشاء الاشتراك

تحديث إعداد إعادة التوجيه التلقائي لقائمة انتظار موجودة

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

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

تحديث إعداد إعادة التوجيه التلقائي لاشتراك موجود

في الصفحة نظرة عامة لاشتراك ناقل الخدمة، حدد القيمة الحالية لإعداد إعادة توجيه الرسائل إلى. في المثال التالي، القيمة الحالية هي معطل. في إطار إعادة توجيه الرسائل إلى قائمة الانتظار/الموضوع، يمكنك تحديد قائمة الانتظار أو الموضوع حيث تريد إعادة توجيه الرسائل.

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

استخدام Azure CLI

لإنشاء قائمة انتظار مع تمكين إعادة التوجيه التلقائي،استخدم الأمر az servicebus queue createمع --forward-toتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

az servicebus queue create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --forward-to myqueue2

لتحديث إعدادات إعادة التوجيه التلقائي لقائمة انتظار موجودةاستخدم الأمر az servicebus queue updateمع --forward-toتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

az servicebus queue update \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --forward-to myqueue2

لإنشاء اشتراك لموضوع مع تمكين إعادة التوجيه التلقائي،استخدم الأمر az servicebus topic subscription createمع --forward-toتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --forward-to myqueue2

لتحديث إعدادات إعادة التوجيه التلقائي لاشتراك أو موضوعاستخدم الأمر az servicebus topic subscription updateمع --forward-toتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

az servicebus topic subscription update \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --forward-to myqueue2

باستخدام Azure PowerShell

لإنشاء قائمة انتظار مع تمكين إعادة التوجيه التلقائي،استخدم الأمر New-AzServiceBusQueueمع -ForwardToتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

New-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -Name myqueue `
    -ForwardTo myqueue2

من أجل تحديث إعداد إعادة التوجيه التلقائي لقائمة انتظار موجودة،استخدم الأمر Set-AzServiceBusQueue كما هو موضح في المثال التالي.

Set-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -Name myqueue `
    -ForwardTo myqueue2

لإنشاء اشتراك لموضوع مع تمكين إعادة التوجيه التلقائي،استخدم الأمر New-AzServiceBusSubscriptionمع -ForwardToتعيين إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه.

New-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -Name mysubscription `
    -ForwardTo myqueue2

لتحديث إعداد إعادة التوجيه التلقائي لاشتراك موجود،راجع المثال التالي.

Set-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -Name mysub `
    -ForwardTo mytopic2

استخدام قالب Azure Resource Manager

لإنشاء قائمة انتظار مع تمكين إعادة التوجيه التلقائي، قم forwardTo بتعيينه في قسم خصائص قائمة الانتظار إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه. لمزيد من المعلومات، راجع مرجع قالب مساحات الأسماء / قوائم الانتظار في Microsoft.ServiceBus.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "serviceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusQueueName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Queue"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ServiceBus/namespaces",
      "apiVersion": "2018-01-01-preview",
      "name": "[parameters('serviceBusNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "type": "Queues",
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusQueueName')]",
          "dependsOn": [
            "[resourceId('Microsoft.ServiceBus/namespaces', parameters('serviceBusNamespaceName'))]"
          ],
          "properties": {
            "forwardTo": "myqueue2"
          }
        }
      ]
    }
  ]
}

لإنشاء اشتراك لموضوع مع تمكين إعادة التوجيه التلقائي، قم forwardTo بتعيينه في قسم خصائص قائمة الانتظار إلى اسم قائمة الانتظار أو الموضوع الذي تريد إعادة توجيه الرسائل إليه. لمزيد من المعلومات، راجع مرجع قالب مساحات الأسماء / الموضوعات / الاشتراكات في ناقل خدمة Microsoft.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "service_BusNamespace_Name": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusTopicName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Topic"
      }
    },
    "serviceBusSubscriptionName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Subscription"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "apiVersion": "2018-01-01-preview",
      "name": "[parameters('service_BusNamespace_Name')]",
      "type": "Microsoft.ServiceBus/namespaces",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusTopicName')]",
          "type": "topics",
          "dependsOn": [
            "[resourceId('Microsoft.ServiceBus/namespaces/', parameters('service_BusNamespace_Name'))]"
          ],
          "properties": {
            "maxSizeInMegabytes": 1024
          },
          "resources": [
            {
              "apiVersion": "2017-04-01",
              "name": "[parameters('serviceBusSubscriptionName')]",
              "type": "Subscriptions",
              "dependsOn": [
                "[parameters('serviceBusTopicName')]"
              ],
              "properties": {
                "forwardTo": "myqueue2"
              }
            }
          ]
        }
      ]
    }
  ]
}

.NET

azure-messaging-servicebus (الأحدث)

يمكنك تمكين ميزة إعادة التوجيه التلقائي عن طريق تعيين CreateQueueOptions.ForwardTo أو CreateSubscriptionOptions.ForwardTo،ثم باستخدام أساليبCreateQueueAsync أو CreateSubscriptionAsync التي تأخذ CreateQueueOptions أو CreateSubscriptionOptions المعلمات.

Microsoft.Azure.ServiceBus (القديم)

يمكنك تمكين إعادة التوجيه التلقائي عن طريق تعيين QueueDescription.ForwardTo أو SubscriptionDescription.ForwardTo للمصدر، كما في المثال التالي:

SubscriptionDescription srcSubscription = new SubscriptionDescription (srcTopic, srcSubscriptionName);
srcSubscription.ForwardTo = destTopic;
namespaceManager.CreateSubscription(srcSubscription));

في 30 سبتمبر 2026، سنتقاعد مكتبات SDK ناقل خدمة Azure WindowsAzure.ServiceBus وMicrosoft.Azure.ServiceBus و com.microsoft.azure.servicebus، والتي لا تتوافق مع إرشادات Azure SDK. سننهي أيضا دعم بروتوكول SBMP، لذلك لن تتمكن من استخدام هذا البروتوكول بعد 30 سبتمبر 2026. قم بالترحيل إلى أحدث مكتبات Azure SDK، والتي توفر تحديثات أمان هامة وقدرات محسنة، قبل ذلك التاريخ.

على الرغم من أنه لا يزال من الممكن استخدام المكتبات القديمة بعد 30 سبتمبر 2026، إلا أنها لن تتلقى بعد ذلك الدعم والتحديثات الرسمية من Microsoft. لمزيد من المعلومات، راجع إعلان إيقاف الدعم.

Java

azure-messaging-servicebus (الأحدث)

يمكنك تمكين ميزة إعادة التوجيه التلقائي باستخدام أسلوبCreateQueueOptions.setForwardTo(123696000) أو CreateSubscriptionOptions.setForwardTo(123696000)، ومن ثم باستخدام أسلوبcreateQueue أو createSubscription التي تأخذ CreateQueueOptions أو CreateSubscriptionOptions المعلمات.

azure-servicebus (القديم)

يمكنك تمكين إعادة التوجيه التلقائي باستخدام QueueDescription.setForwardTo(String forwardTo) أو SubscriptionDescription.setForwardTo(String forwardTo) للمصدر.

في 30 سبتمبر 2026، سنتقاعد مكتبات SDK ناقل خدمة Azure WindowsAzure.ServiceBus وMicrosoft.Azure.ServiceBus و com.microsoft.azure.servicebus، والتي لا تتوافق مع إرشادات Azure SDK. سننهي أيضا دعم بروتوكول SBMP، لذلك لن تتمكن من استخدام هذا البروتوكول بعد 30 سبتمبر 2026. قم بالترحيل إلى أحدث مكتبات Azure SDK، والتي توفر تحديثات أمان هامة وقدرات محسنة، قبل ذلك التاريخ.

على الرغم من أنه لا يزال من الممكن استخدام المكتبات القديمة بعد 30 سبتمبر 2026، إلا أنها لن تتلقى بعد ذلك الدعم والتحديثات الرسمية من Microsoft. لمزيد من المعلومات، راجع إعلان إيقاف الدعم.

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

جرب العينات باللغة التي تختارها لاستكشاف ميزات ناقل خدمة Microsoft Azure.

ابحث عن نماذج لمكتبات عميل .NET وJava الأقدم:

في 30 سبتمبر 2026، سنتقاعد مكتبات SDK ناقل خدمة Azure WindowsAzure.ServiceBus وMicrosoft.Azure.ServiceBus و com.microsoft.azure.servicebus، والتي لا تتوافق مع إرشادات Azure SDK. سننهي أيضا دعم بروتوكول SBMP، لذلك لن تتمكن من استخدام هذا البروتوكول بعد 30 سبتمبر 2026. قم بالترحيل إلى أحدث مكتبات Azure SDK، والتي توفر تحديثات أمان هامة وقدرات محسنة، قبل ذلك التاريخ.

على الرغم من أنه لا يزال من الممكن استخدام المكتبات القديمة بعد 30 سبتمبر 2026، إلا أنها لن تتلقى بعد ذلك الدعم والتحديثات الرسمية من Microsoft. لمزيد من المعلومات، راجع إعلان إيقاف الدعم.