# AzureServiceBusExtensions

- Kind: `class`
- Package: [Aspire.Hosting.Azure.ServiceBus](/reference/api/csharp/aspire.hosting.azure.servicebus.md)
- Version: `13.4.0`
- Namespace: `Aspire.Hosting`
- Target framework: `net8.0`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/cbc352350f1a9bafbaff10d14a2c8de4ac186a48/src/Aspire.Hosting.Azure.ServiceBus/AzureServiceBusExtensions.cs)

Provides extension methods for adding the Azure Service Bus resources to the application model.

## Definition

```csharp
namespace Aspire.Hosting;

public static class AzureServiceBusExtensions
{
    // ...
}
```

## Methods

- [AddAzureServiceBus(IDistributedApplicationBuilder, string)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addazureservicebus-idistributedapplicationbuilder-string) : `IResourceBuilder<AzureServiceBusResource>` `extension` `ats export` -- Adds an Azure Service Bus Namespace resource to the application model. This resource can be used to create queue, topic, and subscription resources.
- [AddQueue(IResourceBuilder<AzureServiceBusResource>, string)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addqueue-iresourcebuilder-azureservicebusresource-string) : `IResourceBuilder<AzureServiceBusResource>` `extension` `obsolete` `ats ignored` -- Adds an Azure Service Bus Queue resource to the application model.
- [AddServiceBusQueue(IResourceBuilder<AzureServiceBusResource>, string, string?)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addservicebusqueue-iresourcebuilder-azureservicebusresource-string-string) : `IResourceBuilder<AzureServiceBusQueueResource>` `extension` `ats export` -- Adds an Azure Service Bus Queue resource to the application model.
- [AddServiceBusSubscription(IResourceBuilder<AzureServiceBusTopicResource>, string, string?)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addservicebussubscription-iresourcebuilder-azureservicebustopicresource-string-string) : `IResourceBuilder<AzureServiceBusSubscriptionResource>` `extension` `ats export` -- Adds an Azure Service Bus Subscription resource to the application model.
- [AddServiceBusTopic(IResourceBuilder<AzureServiceBusResource>, string, string?)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addservicebustopic-iresourcebuilder-azureservicebusresource-string-string) : `IResourceBuilder<AzureServiceBusTopicResource>` `extension` `ats export` -- Adds an Azure Service Bus Topic resource to the application model.
- [AddSubscription(IResourceBuilder<AzureServiceBusResource>, string, string)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addsubscription-iresourcebuilder-azureservicebusresource-string-string) : `IResourceBuilder<AzureServiceBusResource>` `extension` `obsolete` `ats ignored` -- Adds an Azure Service Bus Subscription resource to the application model.
- [AddTopic(IResourceBuilder<AzureServiceBusResource>, string)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addtopic-iresourcebuilder-azureservicebusresource-string) : `IResourceBuilder<AzureServiceBusResource>` `extension` `obsolete` `ats ignored` -- Adds an Azure Service Bus Topic resource to the application model.
- [AddTopic(IResourceBuilder<AzureServiceBusResource>, string, string[])](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#addtopic-iresourcebuilder-azureservicebusresource-string-string) : `IResourceBuilder<AzureServiceBusResource>` `extension` `obsolete` `ats ignored` -- Adds an Azure Service Bus Topic resource to the application model.
- [RunAsEmulator(IResourceBuilder<AzureServiceBusResource>, Action<IResourceBuilder<AzureServiceBusEmulatorResource>>)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#runasemulator-iresourcebuilder-azureservicebusresource-action-iresourcebuilder-azureservicebusemulatorresource) : `IResourceBuilder<AzureServiceBusResource>` `extension` `ats export` -- Configures an Azure Service Bus resource to be emulated. This resource requires an [AzureServiceBusResource](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusresource.md) to be added to the application model.
- [WithConfiguration(IResourceBuilder<AzureServiceBusEmulatorResource>, Action<JsonNode>)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withconfiguration-iresourcebuilder-azureservicebusemulatorresource-action-jsonnode) : `IResourceBuilder<AzureServiceBusEmulatorResource>` `extension` `ats ignored` -- Alters the JSON configuration document used by the emulator.
- [WithConfigurationFile(IResourceBuilder<AzureServiceBusEmulatorResource>, string)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withconfigurationfile-iresourcebuilder-azureservicebusemulatorresource-string) : `IResourceBuilder<AzureServiceBusEmulatorResource>` `extension` `ats export` -- Copies the configuration file into an Azure Service Bus emulator resource.
- [WithHostPort(IResourceBuilder<AzureServiceBusEmulatorResource>, int?)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withhostport-iresourcebuilder-azureservicebusemulatorresource-int) : `IResourceBuilder<AzureServiceBusEmulatorResource>` `extension` `ats export` -- Configures the host port for the Azure Service Bus emulator is exposed on instead of using randomly assigned port.
- [WithProperties(IResourceBuilder<AzureServiceBusQueueResource>, Action<AzureServiceBusQueueResource>)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withproperties-iresourcebuilder-azureservicebusqueueresource-action-azureservicebusqueueresource) : `IResourceBuilder<AzureServiceBusQueueResource>` `extension` `ats export` -- Allows setting the properties of an Azure Service Bus Queue resource.
- [WithProperties(IResourceBuilder<AzureServiceBusTopicResource>, Action<AzureServiceBusTopicResource>)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withproperties-iresourcebuilder-azureservicebustopicresource-action-azureservicebustopicresource) : `IResourceBuilder<AzureServiceBusTopicResource>` `extension` `ats export` -- Allows setting the properties of an Azure Service Bus Topic resource.
- [WithProperties(IResourceBuilder<AzureServiceBusSubscriptionResource>, Action<AzureServiceBusSubscriptionResource>)](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withproperties-iresourcebuilder-azureservicebussubscriptionresource-action-azureservicebussubscriptionresource) : `IResourceBuilder<AzureServiceBusSubscriptionResource>` `extension` `ats export` -- Allows setting the properties of an Azure Service Bus Subscription resource.
- [WithRoleAssignments(IResourceBuilder<T>, IResourceBuilder<AzureServiceBusResource>, ServiceBusBuiltInRole[])](/reference/api/csharp/aspire.hosting.azure.servicebus/azureservicebusextensions/methods.md#withroleassignments-iresourcebuilder-t-iresourcebuilder-azureservicebusresource-servicebusbuiltinrole) : `IResourceBuilder<T>` `extension` `ats ignored` -- Assigns the specified roles to the given resource, granting it the necessary permissions on the target Azure Service Bus namespace. This replaces the default role assignments for the resource.