ServiceBusManagementClient

Name: ServiceBusManagementClient API
Brand: Service Bus Management
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCloud InfrastructureServerlessoauth265 EndpointsREST

For Agents

Provision Azure Service Bus namespaces, queues, topics, subscriptions, authorization rules, and disaster-recovery pairings through the Azure Resource Manager control plane.

Connect the ServiceBusManagementClient to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ServiceBusManagementClient, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with ServiceBusManagementClient API.

Provision Service Bus namespaces with a chosen SKU and capacity

Create queues with dead-lettering, sessions, and duplicate detection settings

Create topics with subscriptions and SQL filter rules

Manage SAS authorization rules and rotate primary or secondary keys

GET STARTED

Start building with ServiceBusManagementClient API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for ServiceBusManagementClient, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for ServiceBusManagementClient, keeping it validated and agent-ready. The Azure Service Bus management API exposes the Microsoft.ServiceBus resource provider so agents can provision Service Bus namespaces, create queues and topics with subscriptions and rules, manage authorization rules and shared access keys, configure network rule sets, and orchestrate geo-disaster-recovery pairings between namespaces. It is the control plane for setting up messaging infrastructure — the data plane for sending and receiving messages lives separately.

Use Cases

Patterns agents use ServiceBusManagementClient API for, with concrete tasks.

★ Messaging Infrastructure Provisioning

Platform teams provision Service Bus namespaces, queues, and topics as part of an environment bootstrap rather than clicking through the portal. The namespaces, queues, and topics endpoints accept the full resource definition — SKU, capacity, message TTL, lock duration, and dead-letter settings — so an agent can stand up a fully configured messaging tier from a template in one pass.

PUT a Premium namespace in West Europe, then PUT a queue named orders with deadLetteringOnMessageExpiration true and lockDuration PT1M

SAS Key Rotation

Security teams rotate Service Bus SAS keys on a schedule to limit blast radius if a key leaks. The AuthorizationRules/regenerateKeys endpoint regenerates either the primary or secondary key in place, and the listKeys endpoint returns the new connection strings so an agent can push them to dependent services or a secrets vault without downtime.

POST to /.../AuthorizationRules/{authorizationRuleName}/regenerateKeys with keyType PrimaryKey, then call listKeys and store the new connection string in the secrets manager

Geo Disaster Recovery Failover

Resilience engineers pair two Service Bus namespaces into a geo-DR alias so that consumers can keep using the same connection string when a region fails. The disasterRecoveryConfigs endpoint creates the pairing, breakPairing dissolves it, and failover promotes the secondary namespace, giving an agent the full set of operations to execute a documented runbook.

PUT a disasterRecoveryConfigs alias linking the primary and secondary namespaces, then on incident POST failover on the alias

AI Agent Messaging Setup

An agent built on Jentic stands up a complete pub-sub topology when a developer asks for somewhere to publish events. The agent provisions a namespace, creates a topic, attaches subscriptions for each consumer, and returns the connection string from listKeys, all without the developer touching the Azure portal.

Search Jentic for create azure service bus topic, load the schema, and execute PUT topics/{topicName} followed by PUT subscriptions/{subscriptionName} for each consumer

Key Endpoints

65 endpoints — jentic publishes the only available openapi specification for servicebusmanagementclient, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}

Create or update a Service Bus namespace

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName}

Create or update a queue

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}

Create or update a topic

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/AuthorizationRules/{authorizationRuleName}/listKeys

List the connection strings for an authorization rule

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/AuthorizationRules/{authorizationRuleName}/regenerateKeys

Regenerate primary or secondary SAS key

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/disasterRecoveryConfigs/{alias}/failover

Trigger geo-DR failover on a namespace alias

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}

Create or update a Service Bus namespace

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/queues/{queueName}

Create or update a queue

PUT

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/topics/{topicName}

Create or update a topic

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/AuthorizationRules/{authorizationRuleName}/listKeys

List the connection strings for an authorization rule

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure AD service principal credentials sit encrypted in the Jentic vault. Agents receive a short-lived bearer token scoped to user_impersonation — raw client secrets and Service Bus SAS keys returned by listKeys flow back through Jentic without leaking into the agent prompt.

Intent-based discovery

Agents search Jentic by intent such as create azure service bus queue or rotate service bus key and Jentic returns the matching Microsoft.ServiceBus operation with its full input schema.

Time to first call

Direct integration with the Microsoft.ServiceBus ARM endpoints: 1-3 days for AAD setup, async operation polling, and ARM error retries. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Azure Event Hubs Management

High-throughput event streaming control plane

Use Event Hubs when the workload is high-volume telemetry streams rather than transactional messaging

Alternative

Azure Event Grid Management

Event routing service for event-driven architectures

Use Event Grid when the agent needs cloud event routing rather than guaranteed-delivery queues

Complementary

Azure Relay

Hybrid connections and WCF relays often deployed alongside Service Bus

Use Relay when the agent needs hybrid connection tunneling rather than queue and topic messaging

FAQs

Specific to using ServiceBusManagementClient API through Jentic.

Why is there no official OpenAPI spec for ServiceBusManagementClient?

Microsoft Azure does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call ServiceBusManagementClient via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Service Bus management API use?

It uses Azure AD OAuth 2.0 with the implicit flow against https://login.microsoftonline.com/common/oauth2/authorize and the user_impersonation scope. When called through Jentic, your AAD service principal credentials live in the Jentic vault and the agent receives only a short-lived bearer token.

Can I send messages with this API?

No — this is the management control plane. To send and receive messages you use the Service Bus AMQP or REST data plane endpoints scoped to the namespace's servicebus.windows.net hostname. Use this management API to provision the namespace, queues, topics, and authorization rules first, then use the data plane for messaging.

How do I rotate a Service Bus SAS key?

POST to /.../namespaces/{namespaceName}/AuthorizationRules/{authorizationRuleName}/regenerateKeys with a body containing keyType set to PrimaryKey or SecondaryKey. Then call listKeys at the same authorization rule path to retrieve the new connection strings.

What are the rate limits for this API?

Azure Resource Manager throttles around 12,000 reads and 1,200 writes per hour per principal at subscription scope, surfaced via x-ms-ratelimit-remaining-subscription-reads and x-ms-ratelimit-remaining-subscription-writes headers. Long namespace provisioning operations return a 202 with an asyncOperation URL to poll.

How do I create a topic with subscriptions through Jentic?

Search Jentic for create azure service bus topic, load the schema for PUT /.../topics/{topicName}, execute it, then PUT each subscription under /.../topics/{topicName}/subscriptions/{subscriptionName}. The full search, load, and execute pattern is in the Jentic Python SDK after pip install jentic.

Can I trigger a geo-DR failover with this API?

Yes. POST to /.../disasterRecoveryConfigs/{alias}/failover on the secondary namespace and the alias promotes it to primary. /breakPairing on either namespace dissolves the pairing without failover when you simply want to detach.