Skip to content

Commit 8cb8129

Browse files
committed
clarification on status
1 parent f602c39 commit 8cb8129

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

articles/service-bus-messaging/entity-suspend.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22
title: Azure Service Bus - suspend messaging entities
33
description: This article explains how to temporarily suspend and reactivate Azure Service Bus message entities (queues, topics, and subscriptions).
44
ms.topic: article
5-
ms.date: 09/28/2021
5+
ms.date: 09/06/2022
66
ms.custom: devx-track-azurepowershell
77
---
88

99
# Suspend and reactivate messaging entities (disable)
1010

11-
Queues, topics, and subscriptions can be temporarily suspended. Suspension puts the entity into a disabled state in which all messages are maintained in storage. However, messages cannot be removed or added, and the respective protocol operations yield errors.
11+
Queues, topics, and subscriptions can be temporarily suspended. Suspension puts the entity into a disabled state in which all messages are maintained in storage. However, messages can't be removed or added, and the respective protocol operations yield errors.
1212

1313
You may want to suspend an entity for urgent administrative reasons. For example, a faulty receiver takes messages off the queue, fails processing, and yet incorrectly completes the messages and removes them. In this case, you may want to disable the queue for receives until you correct and deploy the code.
1414

15-
A suspension or reactivation can be performed either by the user or by the system. The system only suspends entities because of grave administrative reasons such as hitting the subscription spending limit. System-disabled entities cannot be reactivated by the user, but are restored when the cause of the suspension has been addressed.
15+
A suspension or reactivation can be performed either by the user or by the system. The system only suspends entities because of grave administrative reasons such as hitting the subscription spending limit. System-disabled entities can't be reactivated by the user, but are restored when the cause of the suspension has been addressed.
1616

1717
## Queue status
1818
The states that can be set for a **queue** are:
1919

2020
- **Active**: The queue is active. You can send messages to and receive messages from the queue.
2121
- **Disabled**: The queue is suspended. It's equivalent to setting both **SendDisabled** and **ReceiveDisabled**.
2222
- **SendDisabled**: You can't send messages to the queue, but you can receive messages from it. You'll get an exception if you try to send messages to the queue.
23-
- **ReceiveDisabled**: You can send messages to the queue, but you can't receive messages from it. You'll get an exception if you try to receive messages to the queue.
23+
- **ReceiveDisabled**: You can send messages to the queue, but you can't receive messages from it. You'll get an exception if you try to receive messages from the queue.
2424

2525

2626
### Change the queue status in the Azure portal:
@@ -34,7 +34,7 @@ The states that can be set for a **queue** are:
3434

3535
:::image type="content" source="./media/entity-suspend/entity-state-change.png" alt-text="Set state of the queue":::
3636

37-
You can also disable the send and receive operations using the Service Bus [NamespaceManager](/dotnet/api/microsoft.servicebus.namespacemanager) APIs in the .NET SDK, or using an Azure Resource Manager template through Azure CLI or Azure PowerShell.
37+
You can also disable the send and receive operations using an Azure Resource Manager template through Azure CLI or Azure PowerShell.
3838

3939
### Change the queue status using Azure PowerShell
4040
The PowerShell command to disable a queue is shown in the following example. The reactivation command is equivalent, setting `Status` to **Active**.
@@ -54,7 +54,7 @@ You can change topic status in the Azure portal. Select the current status of th
5454

5555
The states that can be set for a **topic** are:
5656
- **Active**: The topic is active. You can send messages to the topic.
57-
- **Disabled**: The topic is suspended. You can't send messages to the topic.
57+
- **Disabled**: The topic is suspended. You can't send messages to the topic. Setting **Disabled** is equivalent to setting **SendDisabled** for a topic.
5858
- **SendDisabled**: Same effect as **Disabled**. You can't send messages to the topic. You'll get an exception if you try to send messages to the topic.
5959

6060
## Subscription status
@@ -64,8 +64,10 @@ You can change subscription status in the Azure portal. Select the current statu
6464

6565
The states that can be set for a **subscription** are:
6666
- **Active**: The subscription is active. You can receive messages from the subscription.
67-
- **Disabled**: The subscription is suspended. You can't receive messages from the subscription.
68-
- **ReceiveDisabled**: Same effect as **Disabled**. You can't receive messages from the subscription. You'll get an exception if you try to receive messages to the subscription.
67+
- **Disabled**: The subscription is suspended. You can't receive messages from the subscription. Setting **Disabled** on a subscription is equivalent to setting **ReceiveDisabled**. You'll get an exception if you try to receive messages from the subscription.
68+
- **ReceiveDisabled**: Same effect as **Disabled**. You can't receive messages from the subscription. You'll get an exception if you try to receive messages from the subscription.
69+
70+
Here's how the behavior is based on the status you set on a topic and its subscription.
6971

7072
| Topic status | Subscription status | Behavior |
7173
| ------------ | ------------------- | -------- |

0 commit comments

Comments
 (0)