Berichtentiteiten opschorten en opnieuw activeren (uitschakelen)

Wachtrijen, onderwerpen en abonnementen kunnen tijdelijk worden opgeschort. Als de entiteit wordt opgehouden, wordt de status uitgeschakeld waarin alle berichten in de opslag worden bewaard. Berichten kunnen echter niet worden verwijderd of toegevoegd en de respectieve protocolbewerkingen leveren fouten op.

Mogelijk wilt u een entiteit om urgente administratieve redenen opschorten. Een defecte ontvanger haalt bijvoorbeeld berichten uit de wachtrij, mislukt de verwerking en voltooit de berichten echter onjuist en verwijdert ze. In dit geval kunt u de wachtrij voor ontvangen uitschakelen totdat u de code hebt gecorrigeerd en geïmplementeerd.

Een opzegging of heractivering kan worden uitgevoerd door de gebruiker of door het systeem. Het systeem schort entiteiten alleen op vanwege ernstige administratieve redenen, zoals het overschrijden van de bestedingslimiet van het abonnement. Door het systeem uitgeschakelde entiteiten kunnen niet opnieuw worden geactiveerd door de gebruiker, maar worden hersteld wanneer de oorzaak van de opzegging is verholpen.

Wachtrijstatus

De volgende staten kunnen worden ingesteld voor een wachtrij:

  • Actief: de wachtrij is actief. U kunt berichten verzenden naar en ontvangen van de wachtrij.
  • Uitgeschakeld: de wachtrij is tijdelijk uitgeschakeld. Dit is gelijk aan het instellen van zowel SendDisabled als ReceiveDisabled.
  • SendDisabled: u kunt geen berichten naar de wachtrij verzenden, maar u kunt er wel berichten van ontvangen. U krijgt een uitzondering als u berichten naar de wachtrij probeert te verzenden.
  • ReceiveDisabled: u kunt berichten naar de wachtrij verzenden, maar u kunt er geen berichten van ontvangen. U krijgt een uitzondering als u berichten naar de wachtrij probeert te ontvangen.

Wijzig de wachtrijstatus in de Azure Portal:

  1. Ga in Azure Portal naar uw Service Bus-naamruimte.

  2. Selecteer de wachtrij waarvoor u de status wilt wijzigen. U ziet wachtrijen in het onderste deelvenster in het midden.

  3. Bekijk op Service Bus pagina Wachtrij de huidige status van de wachtrij als hyperlink. Als overzicht niet is geselecteerd in het menu links, selecteert u het om de status van de wachtrij te bekijken. Selecteer de huidige status van de wachtrij om deze te wijzigen.

    Status van de wachtrij selecteren

  4. Selecteer de nieuwe status voor de wachtrij en selecteer OK.

    Status van de wachtrij instellen

U kunt ook de verzend- en ontvangstbewerkingen uitschakelen met behulp van de Service Bus NamespaceManager-API's in de .NET SDK of met behulp van een Azure Resource Manager-sjabloon via Azure CLI of Azure PowerShell.

Wijzig de wachtrijstatus met behulp van Azure PowerShell

De PowerShell-opdracht voor het uitschakelen van een wachtrij wordt weergegeven in het volgende voorbeeld. De opdracht voor opnieuw activeren is gelijk aan, en wordt Status in stellen op Actief.

$q = Get-AzServiceBusQueue -ResourceGroup mygrp -NamespaceName myns -QueueName myqueue

$q.Status = "Disabled"

Set-AzServiceBusQueue -ResourceGroup mygrp -NamespaceName myns -QueueName myqueue -QueueObj $q

Onderwerpstatus

U kunt de onderwerpstatus wijzigen in de Azure Portal. Selecteer de huidige status van het onderwerp om de volgende pagina weer te geven, zodat u de status kunt wijzigen.

Onderwerpstatus wijzigen

De staten die kunnen worden ingesteld voor een onderwerp zijn:

  • Actief: het onderwerp is actief. U kunt berichten naar het onderwerp verzenden.
  • Uitgeschakeld: het onderwerp is tijdelijk uitgeschakeld. U kunt geen berichten naar het onderwerp verzenden.
  • SendDisabled: hetzelfde effect als Uitgeschakeld. U kunt geen berichten naar het onderwerp verzenden. U krijgt een uitzondering als u berichten naar het onderwerp probeert te verzenden.

Abonnementsstatus

U kunt de abonnementsstatus wijzigen in de Azure Portal. Selecteer de huidige status van het abonnement om de volgende pagina weer te geven, zodat u de status kunt wijzigen.

Abonnementsstatus wijzigen

De volgende staten kunnen worden ingesteld voor een abonnement:

  • Actief: het abonnement is actief. U kunt berichten ontvangen van het abonnement.
  • Uitgeschakeld: het abonnement is tijdelijk uitgeschakeld. U kunt geen berichten ontvangen van het abonnement.
  • ReceiveDisabled: hetzelfde effect als Uitgeschakeld. U kunt geen berichten ontvangen van het abonnement. U krijgt een uitzondering als u berichten naar het abonnement probeert te ontvangen.
Onderwerpstatus Abonnementsstatus Gedrag
Actief Actief U kunt berichten naar het onderwerp verzenden en berichten ontvangen van het abonnement.
Actief Uitgeschakeld of Ontvangen uitgeschakeld U kunt berichten naar het onderwerp verzenden, maar u kunt geen berichten ontvangen van het abonnement
Uitgeschakeld of Verzenden uitgeschakeld Actief U kunt geen berichten naar het onderwerp verzenden, maar u kunt wel berichten ontvangen die zich al in het abonnement hebben.
Uitgeschakeld of Verzenden uitgeschakeld Uitgeschakeld of Ontvangen uitgeschakeld U kunt geen berichten naar het onderwerp verzenden en u kunt ook geen berichten ontvangen van het abonnement.

Andere statussen

De entiteitstatus-enumeratie definieert ook een set overgangsstatussen die alleen door het systeem kunnen worden ingesteld.

Volgende stappen

Zie de volgende onderwerpen voor Service Bus informatie over berichten: