Dela via

Aktivera obeställbara bokstäver vid förfallodatum för meddelanden för Azure Service Bus-köer och prenumerationer

  • Artikel

Azure Service Bus-köer och prenumerationer för ämnen ger en sekundär underfråga, kallad en kö med obeställbara bokstäver (DLQ). Kön för obeställbara meddelanden behöver inte uttryckligen skapas och kan inte tas bort eller hanteras oberoende av huvudentiteten. Syftet med kön med obeställbara meddelanden är att lagra meddelanden som inte kan levereras till någon mottagare eller meddelanden som inte kunde bearbetas. Mer information finns i Översikt över Service Bus-köer med obeställbara meddelanden. Den här artikeln visar olika sätt att aktivera obeställbara bokstäver för Service Bus-köer och prenumerationer.

Med Azure-portalen

När du skapar en kö eller en prenumeration för ett ämne i Azure-portalen väljer du Aktivera obeställbara bokstäver vid förfallodatum för meddelanden enligt följande exempel.

Skapa en kö med obeställbara bokstäver aktiverat

Aktivera obeställbara bokstäver när kön skapas

Skapa en prenumeration med obeställbara bokstäver aktiverat

Aktivera obeställbara bokstäver när prenumerationen skapas

Uppdatera inställningen för förfallodatum för meddelanden för en befintlig kö

På sidan Översikt för Service Bus-kön väljer du det aktuella värdet för inställningen Förfallodatum för meddelanden. I följande exempel är det aktuella värdet Inaktiverat. Du kan aktivera eller inaktivera obeställbara bokstäver när meddelandet upphör att gälla i popup-fönstret.

Aktivera obeställbara bokstäver vid meddelandeförfallodatum för en befintlig kö

Uppdatera inställningen för förfallodatum för meddelanden för en befintlig prenumeration

På sidan Översikt för din Service Bus-prenumeration väljer du det aktuella värdet för inställningen Förfallodatum för meddelanden. I följande exempel är det aktuella värdet Inaktiverat. Du kan aktivera eller inaktivera obeställbara bokstäver när meddelandet upphör att gälla i popup-fönstret.

Aktivera obeställbara bokstäver vid meddelandeförfallodatum för en befintlig prenumeration

Använda Azure CLI

Om du vill skapa en kö med obeställbara bokstäver vid meddelande förfallodatum aktiverat använder du az servicebus queue create kommandot med --enable-dead-lettering-on-message-expiration inställt på true.

az servicebus queue create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --enable-dead-lettering-on-message-expiration true

Om du vill aktivera inställningen för förfallodatum för meddelanden för en befintlig kö använder du az servicebus queue update kommandot med --enable-dead-lettering-on-message-expiration inställt på true.

az servicebus queue update \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --enable-dead-lettering-on-message-expiration true

Om du vill skapa en prenumeration på ett ämne med obeställbara bokstäver vid meddelande förfallodatum aktiverat använder du az servicebus topic subscription create kommandot med --enable-dead-lettering-on-message-expiration värdet true.

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --enable-dead-lettering-on-message-expiration true

Om du vill aktivera inställningen för förfallodatum för meddelanden för en prenumeration på ett ämne använder du az servicebus topic subscription update kommandot med --enable-dead-lettering-on-message-expiration uppsättningen true.

az servicebus topic subscription update \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --enable-dead-lettering-on-message-expiration true

Kommentar

Om du anger en kö eller ett ämne med hjälp av parametern --forward-dead-lettered-messages-to vidarebefordrar Service Bus automatiskt meddelanden med obeställbara meddelanden till kön eller ämnet. Här följer ett exempel: az servicebus queue create --resource-group mysbusrg --namespace-name mysbusns --name myqueue --enable-dead-lettering-on-message-expiration true --forward-dead-lettered-messages-to myqueue2.

Använda Azure PowerShell

Om du vill skapa en kö med obeställbara bokstäver vid meddelande förfallodatum aktiverat använder du New-AzServiceBusQueue kommandot med -DeadLetteringOnMessageExpiration inställt på $True.

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

Om du vill aktivera inställningen för förfallodatum för meddelanden för en befintlig kö använder Set-AzServiceBusQueue du kommandot enligt följande exempel.

$queue=Get-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue 

$queue.DeadLetteringOnMessageExpiration=$True

Set-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue `
    -QueueObj $queue

Om du vill skapa en prenumeration för ett ämne med obeställbara bokstäver vid meddelande förfallodatum aktiverat använder du New-AzServiceBusSubscription kommandot med -DeadLetteringOnMessageExpiration inställt på $True.

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

Information om hur du aktiverar inställningen för förfallodatum för meddelanden för en befintlig prenumeration finns i följande exempel.

$subscription=Get-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -SubscriptionName mysub

$subscription.DeadLetteringOnMessageExpiration=$True

Set-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -Name mytopic `
    -SubscriptionName mysub `
    -SubscriptionObj $subscription

Kommentar

Om du anger en kö eller ett ämne med hjälp av parametern -ForwardDeadLetteredMessagesTo vidarebefordrar Event Grid automatiskt meddelanden med obeställbara bokstäver till kön eller ämnet.

Använda Azure Resource Manager-mall

Om du vill skapa en kö med obeställbara bokstäver vid meddelandets förfallotid aktiverad anger du deadLetteringOnMessageExpiration i avsnittet köegenskaper till true. Mer information finns i Mallreferens för Microsoft.ServiceBus-namnområden/köer.

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

Om du vill skapa en prenumeration för ett ämne med obeställbara bokstäver vid meddelande förfallodatum aktiverat anger du deadLetteringOnMessageExpiration i avsnittet köegenskaper till true. Mer information finns i Mallreferens för Microsoft.ServiceBus-namnområden/ämnen/prenumerationer.

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

Kommentar

Om du anger en kö eller ett ämne för forwardDeadLetteredMessagesTo egenskapen vidarebefordrar Event Grid automatiskt meddelanden med obeställbara bokstäver till kön eller ämnet.

Nästa steg

Prova exemplen på det språk du väljer för att utforska Azure Service Bus-funktioner.

Hitta exempel för äldre .NET- och Java-klientbibliotek:

Den 30 september 2026 drar vi tillbaka Azure Service Bus SDK-biblioteken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus och com.microsoft.azure.servicebus, som inte följer Riktlinjerna för Azure SDK. Vi kommer också att avsluta stödet för SBMP-protokollet, så du kommer inte längre att kunna använda det här protokollet efter den 30 september 2026. Migrera till de senaste Azure SDK-biblioteken, som erbjuder kritiska säkerhetsuppdateringar och förbättrade funktioner, före det datumet.

Även om de äldre biblioteken fortfarande kan användas efter den 30 september 2026 får de inte längre officiell support och uppdateringar från Microsoft. Mer information finns i meddelandet om supportavgång.