啟用 Azure 服務匯流排佇列或訂閱的訊息工作階段

發行項
03/10/2024

Azure 服務匯流排工作階段能夠聯合和依序處理未繫結的相關訊息序列。工作階段可在先進先出 (FIFO) 和要求-回應模式中使用。如需詳細資訊，請參閱訊息工作階段。本文說明啟用服務匯流排佇列或訂閱工作階段的不同方式。

重要

基本層的服務匯流排並不支援工作階段。標準層和高階層則支援工作階段。如需這些階層之間的差異，請參閱服務匯流排定價。
建立佇列或訂閱之後，您將無法啟用或停用訊息會話。您只能在建立佇列或訂閱的期間這麼做。

使用 Azure 入口網站

在Azure 入口網站中建立佇列時，請選取 [啟用工作階段]，如下圖所示。

Enable session at the time of the queue creation

在 Azure 入口網站中味訂閱建立主題時時，請選取 [啟用工作階段]，如下圖所示。

Enable session at the time of the subscription creation

使用 Azure CLI

若要建立已啟用訊息工作階段的佇列，請使用 az servicebus queue create 命令，並將 --enable-session 設定為 true。

az servicebus queue create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --enable-session true

若要為已啟用訊息工作階段的主題建立訂閱，請使用 az servicebus topic subscription create 命令，並將 --enable-session 設定為 true。

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --enable-session true

使用 Azure PowerShell

若要建立已啟用訊息工作階段的佇列，請使用 New-AzServiceBusQueue 命令，並將 -RequiresSession 設定為 $True。

New-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue `
    -RequiresSession $True

若要為已啟用訊息工作階段的主題建立訂閱，請使用 New-AzServiceBusSubscription 命令，並將 -RequiresSession 設定為 true。

New-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -SubscriptionName mysubscription `
    -RequiresSession $True

使用 Azure Resource Manager 範本

若要建立已啟用訊息工作階段的佇列，請在佇列屬性區段中將 requiresSession 設定為 true。如需詳細資訊，請參閱 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": {
            "requiresSession": true
          }
        }
      ]
    }
  ]
}

若要為已啟用訊息工作階段的主題建立訂閱，請在訂閱屬性區段中將 requiresSession 設定為 true。如需詳細資訊，請參閱 Microsoft.ServiceBus 命名空間/主題/訂用帳戶範本參考。

{
  "$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": {
                "requiresSession": true
              }
            }
          ]
        }
      ]
    }
  ]
}

下一步

請以您所選擇的語言嘗試各式範例，以探索 Azure 服務匯流排的功能。

請在下方尋找舊版 .NET 和 JAVA 用戶端程式庫的範例：

在 2026 年 9 月 30 日，我們將淘汰不符合 Azure SDK 準則的 Azure 服務匯流排 SDK 程式庫 WindowsAzure.ServiceBus、Microsoft.Azure.ServiceBus 和 com.microsoft.azure.servicebus。我們也將結束 SBMP 通訊協定的支援，因此您將無法在 2026 年 9 月 30 日之後再使用此通訊協定。請在該日期之前移轉至最新的 Azure SDK 程式庫，該程式庫提供重要的安全性更新和改進的功能。

雖然較舊的程式庫仍可在 2026 年 9 月 30 日之後使用，但它們將不再收到 Microsoft 的官方支援和更新。如需詳細資訊，請參閱支援淘汰公告。

啟用 Azure 服務匯流排佇列或訂閱的訊息工作階段

使用 Azure 入口網站

使用 Azure CLI

使用 Azure PowerShell

使用 Azure Resource Manager 範本

下一步

其他資源