Skip to content

Commit da97bcd

Browse files
committed
Update docs metadata
1 parent 66ae366 commit da97bcd

File tree

2 files changed

+28
-28
lines changed

2 files changed

+28
-28
lines changed

docs-ref-services/preview/servicebus-readme.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: Azure Service Bus client library for Python
33
keywords: Azure, python, SDK, API, azure-servicebus, servicebus
44
author: annatisch
55
ms.author: antisch
6-
ms.date: 10/11/2022
6+
ms.date: 03/10/2023
77
ms.topic: reference
88
ms.devlang: python
99
ms.service: servicebus
1010
---
11-
# Azure Service Bus client library for Python - version 7.9.0a1
11+
# Azure Service Bus client library for Python - version 7.9.0b1
1212

1313

1414
Azure Service Bus is a high performance cloud-managed messaging service for providing real-time and fault-tolerant communication between distributed senders and receivers.
@@ -22,7 +22,7 @@ Use the Service Bus client library for Python to communicate between application
2222
* Send and receive messages within your Service Bus channels.
2323
* Utilize message locks, sessions, and dead letter functionality to implement complex messaging patterns.
2424

25-
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/) | [Package (PyPi)][pypi] | [API reference documentation][api_docs] | [Product documentation][product_docs] | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples) | [Changelog](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/CHANGELOG.md)
25+
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/) | [Package (PyPi)][pypi] | [API reference documentation][api_docs] | [Product documentation][product_docs] | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples) | [Changelog](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/CHANGELOG.md)
2626

2727
**NOTE**: If you are using version 0.50 or lower and want to migrate to the latest version
2828
of this package please look at our [migration guide to move from Service Bus V0.50 to Service Bus V7][migration_guide].
@@ -38,7 +38,7 @@ _Azure SDK Python packages support for Python 2.7 ended 01 January 2022. For mor
3838
Install the Azure Service Bus client library for Python with [pip][pip]:
3939

4040
```Bash
41-
pip install azure-servicebus
41+
pip install azure-servicebus==7.9.0b1
4242
```
4343

4444
### Prerequisites:
@@ -96,9 +96,9 @@ To interact with these resources, one should be familiar with the following SDK
9696

9797
* [ServiceBusClient][client_reference]: This is the object a user should first initialize to connect to a Service Bus Namespace. To interact with a queue, topic, or subscription, one would spawn a sender or receiver off of this client.
9898

99-
* [ServiceBusSender][sender_reference]: To send messages to a Queue or Topic, one would use the corresponding `get_queue_sender` or `get_topic_sender` method off of a `ServiceBusClient` instance as seen [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/send_queue.py).
99+
* [ServiceBusSender][sender_reference]: To send messages to a Queue or Topic, one would use the corresponding `get_queue_sender` or `get_topic_sender` method off of a `ServiceBusClient` instance as seen [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/send_queue.py).
100100

101-
* [ServiceBusReceiver][receiver_reference]: To receive messages from a Queue or Subscription, one would use the corresponding `get_queue_receiver` or `get_subscription_receiver` method off of a `ServiceBusClient` instance as seen [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_queue.py).
101+
* [ServiceBusReceiver][receiver_reference]: To receive messages from a Queue or Subscription, one would use the corresponding `get_queue_receiver` or `get_subscription_receiver` method off of a `ServiceBusClient` instance as seen [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_queue.py).
102102

103103
* [ServiceBusMessage][message_reference]: When sending, this is the type you will construct to contain your payload. When receiving, this is where you will access the payload.
104104

@@ -115,14 +115,14 @@ The following sections provide several code snippets covering some of the most c
115115

116116
To perform management tasks such as creating and deleting queues/topics/subscriptions, please utilize the azure-mgmt-servicebus library, available [here][servicebus_management_repository].
117117

118-
Please find further examples in the [samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples) directory demonstrating common Service Bus scenarios such as sending, receiving, session management and message handling.
118+
Please find further examples in the [samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples) directory demonstrating common Service Bus scenarios such as sending, receiving, session management and message handling.
119119

120120
### Send messages to a queue
121121
> **NOTE:** see reference documentation [here][send_reference].
122122
123123
This example sends single message and array of messages to a queue that is assumed to already exist, created via the Azure portal or az commands.
124124

125-
```Python
125+
```python
126126
from azure.servicebus import ServiceBusClient, ServiceBusMessage
127127

128128
import os
@@ -142,15 +142,15 @@ with ServiceBusClient.from_connection_string(connstr) as client:
142142

143143
> **NOTE:** A message may be scheduled for delayed delivery using the `ServiceBusSender.schedule_messages()` method, or by specifying `ServiceBusMessage.scheduled_enqueue_time_utc` before calling `ServiceBusSender.send_messages()`
144144
145-
> For more detail on scheduling and schedule cancellation please see a sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/schedule_messages_and_cancellation.py).
145+
> For more detail on scheduling and schedule cancellation please see a sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/schedule_messages_and_cancellation.py).
146146
147147
### Receive messages from a queue
148148

149149
To receive from a queue, you can either perform an ad-hoc receive via `receiver.receive_messages()` or receive persistently through the receiver itself.
150150

151151
#### [Receive messages from a queue through iterating over ServiceBusReceiver][streaming_receive_reference]
152152

153-
```Python
153+
```python
154154
from azure.servicebus import ServiceBusClient
155155

156156
import os
@@ -175,7 +175,7 @@ with ServiceBusClient.from_connection_string(connstr) as client:
175175

176176
> **NOTE:** `ServiceBusReceiver.receive_messages()` receives a single or constrained list of messages through an ad-hoc method call, as opposed to receiving perpetually from the generator. It always returns a list.
177177
178-
```Python
178+
```python
179179
from azure.servicebus import ServiceBusClient
180180

181181
import os
@@ -204,7 +204,7 @@ In this example, max_message_count declares the maximum number of messages to at
204204
205205
Sessions provide first-in-first-out and single-receiver semantics on top of a queue or subscription. While the actual receive syntax is the same, initialization differs slightly.
206206

207-
```Python
207+
```python
208208
from azure.servicebus import ServiceBusClient, ServiceBusMessage
209209

210210
import os
@@ -232,7 +232,7 @@ with ServiceBusClient.from_connection_string(connstr) as client:
232232
Topics and subscriptions give an alternative to queues for sending and receiving messages. See documents [here][topic_concept] for more overarching detail,
233233
and of how these differ from queues.
234234

235-
```Python
235+
```python
236236
from azure.servicebus import ServiceBusClient, ServiceBusMessage
237237

238238
import os
@@ -267,7 +267,7 @@ See [AutoLockRenewer](#automatically-renew-message-or-session-locks "Automatical
267267

268268
Declares the message processing to be successfully completed, removing the message from the queue.
269269

270-
```Python
270+
```python
271271
from azure.servicebus import ServiceBusClient
272272

273273
import os
@@ -285,7 +285,7 @@ with ServiceBusClient.from_connection_string(connstr) as client:
285285

286286
Abandon processing of the message for the time being, returning the message immediately back to the queue to be picked up by another (or the same) receiver.
287287

288-
```Python
288+
```python
289289
from azure.servicebus import ServiceBusClient
290290

291291
import os
@@ -301,9 +301,9 @@ with ServiceBusClient.from_connection_string(connstr) as client:
301301

302302
#### [DeadLetter][deadletter_reference]
303303

304-
Transfer the message from the primary queue into a special "dead-letter sub-queue" where it can be accessed using the `ServiceBusClient.get_<queue|subscription>_receiver` function with parameter `sub_queue=ServiceBusSubQueue.DEAD_LETTER` and consumed from like any other receiver. (see sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_deadlettered_messages.py))
304+
Transfer the message from the primary queue into a special "dead-letter sub-queue" where it can be accessed using the `ServiceBusClient.get_<queue|subscription>_receiver` function with parameter `sub_queue=ServiceBusSubQueue.DEAD_LETTER` and consumed from like any other receiver. (see sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_deadlettered_messages.py))
305305

306-
```Python
306+
```python
307307
from azure.servicebus import ServiceBusClient
308308

309309
import os
@@ -320,9 +320,9 @@ with ServiceBusClient.from_connection_string(connstr) as client:
320320
#### [Defer][defer_reference]
321321

322322
Defer is subtly different from the prior settlement methods. It prevents the message from being directly received from the queue
323-
by setting it aside such that it must be received by sequence number in a call to `ServiceBusReceiver.receive_deferred_messages` (see sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_deferred_message_queue.py))
323+
by setting it aside such that it must be received by sequence number in a call to `ServiceBusReceiver.receive_deferred_messages` (see sample [here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/receive_deferred_message_queue.py))
324324

325-
```Python
325+
```python
326326
from azure.servicebus import ServiceBusClient
327327

328328
import os
@@ -473,7 +473,7 @@ Please view the [exceptions reference docs][exception_reference] for detailed de
473473

474474
### More sample code
475475

476-
Please find further examples in the [samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples) directory demonstrating common Service Bus scenarios such as sending, receiving, session management and message handling.
476+
Please find further examples in the [samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples) directory demonstrating common Service Bus scenarios such as sending, receiving, session management and message handling.
477477

478478
### Additional documentation
479479

@@ -483,7 +483,7 @@ For more extensive documentation on the Service Bus service, see the [Service Bu
483483

484484
For users seeking to perform management operations against ServiceBus (Creating a queue/topic/etc, altering filter rules, enumerating entities)
485485
please see the [azure-mgmt-servicebus documentation][service_bus_mgmt_docs] for API documentation. Terse usage examples can be found
486-
[here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-mgmt-servicebus/tests) as well.
486+
[here](https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-mgmt-servicebus/tests) as well.
487487

488488
### Building uAMQP wheel from source
489489

@@ -529,10 +529,10 @@ contact [[email protected]](mailto:[email protected]) with any additio
529529
[topic_concept]: /azure/service-bus-messaging/service-bus-messaging-overview#topics
530530
[subscription_concept]: /azure/service-bus-messaging/service-bus-queues-topics-subscriptions#topics-and-subscriptions
531531
[azure_namespace_creation]: /azure/service-bus-messaging/service-bus-create-namespace-portal
532-
[servicebus_management_repository]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-mgmt-servicebus
532+
[servicebus_management_repository]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-mgmt-servicebus
533533
[get_servicebus_conn_str]: /azure/service-bus-messaging/service-bus-create-namespace-portal#get-the-connection-string
534534
[servicebus_aad_authentication]: /azure/service-bus-messaging/service-bus-authentication-and-authorization
535-
[token_credential_interface]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/core/azure-core/azure/core/credentials.py
535+
[token_credential_interface]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/core/azure-core/azure/core/credentials.py
536536
[pypi_azure_identity]: https://pypi.org/project/azure-identity/
537537
[message_reference]: https://azuresdkdocs.blob.core.windows.net/$web/python/azure-servicebus/latest/azure.servicebus.html#azure.servicebus.ServiceBusMessage
538538
[receiver_reference]: https://azuresdkdocs.blob.core.windows.net/$web/python/azure-servicebus/latest/azure.servicebus.html#azure.servicebus.ServiceBusReceiver
@@ -551,7 +551,7 @@ contact [[email protected]](mailto:[email protected]) with any additio
551551
[exception_reference]: https://azuresdkdocs.blob.core.windows.net/$web/python/azure-servicebus/latest/azure.servicebus.html#module-azure.servicebus.exceptions
552552
[subscription_reference]: https://azuresdkdocs.blob.core.windows.net/$web/python/azure-servicebus/latest/azure.servicebus.aio.html?highlight=subscription#azure.servicebus.aio.ServiceBusClient.get_subscription_receiver
553553
[topic_reference]: https://azuresdkdocs.blob.core.windows.net/$web/python/azure-servicebus/latest/azure.servicebus.html?highlight=topic#azure.servicebus.ServiceBusClient.get_topic_sender
554-
[sample_authenticate_client_connstr]: https://github.com/Azure/azure-sdk-for-python/blob/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/authenticate_client_connstr.py
555-
[sample_authenticate_client_aad]: https://github.com/Azure/azure-sdk-for-python/blob/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/samples/sync_samples/client_identity_authentication.py
556-
[migration_guide]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0a1/sdk/servicebus/azure-servicebus/migration_guide.md
554+
[sample_authenticate_client_connstr]: https://github.com/Azure/azure-sdk-for-python/blob/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/authenticate_client_connstr.py
555+
[sample_authenticate_client_aad]: https://github.com/Azure/azure-sdk-for-python/blob/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/samples/sync_samples/client_identity_authentication.py
556+
[migration_guide]: https://github.com/Azure/azure-sdk-for-python/tree/azure-servicebus_7.9.0b1/sdk/servicebus/azure-servicebus/migration_guide.md
557557

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"Name": "azure-servicebus",
3-
"Version": "7.9.0a1",
3+
"Version": "7.9.0b1",
44
"DevVersion": null,
55
"DirectoryPath": "sdk/servicebus/azure-servicebus",
66
"ServiceDirectory": "servicebus",
@@ -10,5 +10,5 @@
1010
"SdkType": "client",
1111
"IsNewSdk": true,
1212
"ArtifactName": "azure-servicebus",
13-
"ReleaseStatus": "2022-10-11"
13+
"ReleaseStatus": "2023-03-09"
1414
}

0 commit comments

Comments
 (0)