Skip to content

add Azure Service Bus service doc#501

Open
HarshCasper wants to merge 1 commit intomainfrom
harshmishra/doc-83
Open

add Azure Service Bus service doc#501
HarshCasper wants to merge 1 commit intomainfrom
harshmishra/doc-83

Conversation

@HarshCasper
Copy link
Member

Fixes DOC-83

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Mar 17, 2026

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c4de710
Status: ✅  Deploy successful!
Preview URL: https://5d29b152.localstack-docs.pages.dev
Branch Preview URL: https://harshmishra-doc-83.localstack-docs.pages.dev

View logs

@paolosalvatori
Copy link

Thanks for the article @HarshCasper. Please find below the sections to add at the end of the article before the API Coverage section. I integrated @bblommers bullet points.

Features

The emulator includes the following core capabilities:

  • Data Plane REST API: Supports message-level operations, including Send, Receive, and Peek.
  • Control Plane REST API: Enables CRUD operations for namespaces and messaging entities (queues, topics, and subscriptions) via Azure Resource Manager (ARM).
  • Multiple Authentication Modes: Supports both Connection String and Managed Identity authentication.
  • Containerized Deployment: Runs as a lightweight, Linux-based Docker container.
  • Cross-Platform Compatibility: Fully compatible with Windows, macOS, and Linux environments.
  • Flexible Configuration: Manage Service Bus entities via the Service Bus Administration Client or through JSON-based configuration files.
  • Advanced Streaming: Supports message streaming via the Advanced Message Queuing Protocol (AMQP).

Limitations

The current version of the emulator does not support the following:

  • Protocols: JMS protocol streaming and AMQP Web Sockets (AMQP over TCP is the only supported transport).
  • Messaging Patterns: Transactions, auto-forwarding (queue chaining), and message lock renewal.
  • Validation: Enforcements such as maximum entity counts or maximum message sizes.
  • Metrics: Property-based message counts for queues, topics, and subscriptions may be inaccurate.

The following Azure-native features are currently unavailable in the emulator:

  • Scaling & Resiliency: Autoscale, Geo-disaster recovery, and Large Message support.
  • Monitoring: Visual metrics, alerts, and telemetry dashboards.

Samples

Explore the following samples to get started with Service Bus on LocalStack:

Copy link

@paolosalvatori paolosalvatori left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @HarshCasper, the article looks solid. Please see my feedback and a few suggested additions in the comments below. Reach out to me and @bblommers once those are addressed, and we’ll get this approved right away.

Get and list queues:

```bash
azlocal servicebus queue show \

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest you add the JSON returned by the the show and list commands:

{
  "accessedAt": "2026-03-18T10:13:18.3906198Z",
  "autoDeleteOnIdle": "P10675199DT2H48M5.4775807S",
  "countDetails": {
    "activeMessageCount": 0,
    "deadLetterMessageCount": 0,
    "scheduledMessageCount": 0,
    "transferDeadLetterMessageCount": 0,
    "transferMessageCount": 0
  },
  ...
  "name": "input",
  ...
  "status": "Active",
  "type": "Microsoft.ServiceBus/namespaces/queues",
  ...
}

and

[
  {
    "accessedAt": "2026-03-18T10:14:44.3808099Z",
    "autoDeleteOnIdle": "P10675199DT2H48M5.4775807S",
    "countDetails": {
      "activeMessageCount": 0,
      "deadLetterMessageCount": 0,
      "scheduledMessageCount": 0,
      "transferDeadLetterMessageCount": 0,
      "transferMessageCount": 0
    },
    ...
    "name": "input",
    ...
    "status": "Active",
    "type": "Microsoft.ServiceBus/namespaces/queues",
    ...
  },
  {
    "accessedAt": "2026-03-18T10:14:44.3808099Z",
    "autoDeleteOnIdle": "P10675199DT2H48M5.4775807S",
    "countDetails": {
      "activeMessageCount": 0,
      "deadLetterMessageCount": 0,
      "scheduledMessageCount": 0,
      "transferDeadLetterMessageCount": 0,
      "transferMessageCount": 0
    },
    ...
    "name": "output",
    ...
    "status": "Active",
    "type": "Microsoft.ServiceBus/namespaces/queues",
    ...
  }
]

Please add a note to remark that the information under countDetails element may not be accurate. @bblommers for visibility

Get and list subscriptions:

```bash
azlocal servicebus topic subscription show \

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above for the azlocal servicebus queue show and azlocal servicebus queue list commands. Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants