Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Classic
  3. API Docs
  4. servicebus
  5. getQueue

We recommend using Azure Native.

Azure v6.21.0 published on Friday, Mar 7, 2025 by Pulumi
pulumi/pulumi-azure

azure.servicebus.getQueue

Explore with Pulumi AI

azure logo

We recommend using Azure Native.

Azure v6.21.0 published on Friday, Mar 7, 2025 by Pulumi
pulumi/pulumi-azure

    Use this data source to access information about an existing Service Bus Queue.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const example = azure.servicebus.getQueue({
    name: "existing",
    namespaceId: "existing",
});
export const id = example.then(example => example.id);

    import pulumi
import pulumi_azure as azure

example = azure.servicebus.get_queue(name="existing",
    namespace_id="existing")
pulumi.export("id", example.id)

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/servicebus"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := servicebus.LookupQueue(ctx, &servicebus.LookupQueueArgs{
			Name:        "existing",
			NamespaceId: pulumi.StringRef("existing"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("id", example.Id)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;

return await Deployment.RunAsync(() => 
{
    var example = Azure.ServiceBus.GetQueue.Invoke(new()
    {
        Name = "existing",
        NamespaceId = "existing",
    });

    return new Dictionary<string, object?>
    {
        ["id"] = example.Apply(getQueueResult => getQueueResult.Id),
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.servicebus.ServicebusFunctions;
import com.pulumi.azure.servicebus.inputs.GetQueueArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = ServicebusFunctions.getQueue(GetQueueArgs.builder()
            .name("existing")
            .namespaceId("existing")
            .build());

        ctx.export("id", example.applyValue(getQueueResult -> getQueueResult.id()));
    }
}

    variables:
  example:
    fn::invoke:
      function: azure:servicebus:getQueue
      arguments:
        name: existing
        namespaceId: existing
outputs:
  id: ${example.id}

    Using getQueue

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getQueue(args: GetQueueArgs, opts?: InvokeOptions): Promise<GetQueueResult>
function getQueueOutput(args: GetQueueOutputArgs, opts?: InvokeOptions): Output<GetQueueResult>
    def get_queue(name: Optional[str] = None,
              namespace_id: Optional[str] = None,
              namespace_name: Optional[str] = None,
              resource_group_name: Optional[str] = None,
              opts: Optional[InvokeOptions] = None) -> GetQueueResult
def get_queue_output(name: Optional[pulumi.Input[str]] = None,
              namespace_id: Optional[pulumi.Input[str]] = None,
              namespace_name: Optional[pulumi.Input[str]] = None,
              resource_group_name: Optional[pulumi.Input[str]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetQueueResult]
    func LookupQueue(ctx *Context, args *LookupQueueArgs, opts ...InvokeOption) (*LookupQueueResult, error)
func LookupQueueOutput(ctx *Context, args *LookupQueueOutputArgs, opts ...InvokeOption) LookupQueueResultOutput

    > Note: This function is named LookupQueue in the Go SDK.

    public static class GetQueue 
{
    public static Task<GetQueueResult> InvokeAsync(GetQueueArgs args, InvokeOptions? opts = null)
    public static Output<GetQueueResult> Invoke(GetQueueInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetQueueResult> getQueue(GetQueueArgs args, InvokeOptions options)
public static Output<GetQueueResult> getQueue(GetQueueArgs args, InvokeOptions options)

    fn::invoke:
  function: azure:servicebus/getQueue:getQueue
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Name string
    The name of this Service Bus Queue.
    NamespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    Name string
    The name of this Service Bus Queue.
    NamespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    name String
    The name of this Service Bus Queue.
    namespaceId String
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    name string
    The name of this Service Bus Queue.
    namespaceId string
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    name str
    The name of this Service Bus Queue.
    namespace_id str
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespace_name str

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resource_group_name str

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    name String
    The name of this Service Bus Queue.
    namespaceId String
    The ID of the ServiceBus Namespace where the Service Bus Queue exists.
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    getQueue Result

    The following output properties are available:

    AutoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    BatchedOperationsEnabled bool
    Boolean flag which controls whether server-side batched operations are enabled.
    DeadLetteringOnMessageExpiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    DefaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    DuplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    EnableBatchedOperations bool
    EnableExpress bool
    EnablePartitioning bool
    ExpressEnabled bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    ForwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    ForwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    Id string
    The provider-assigned unique ID for this managed resource.
    LockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    MaxDeliveryCount int
    Integer value which controls when a message is automatically dead lettered.
    MaxSizeInMegabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    Name string
    PartitioningEnabled bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    RequiresDuplicateDetection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    RequiresSession bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    Status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    NamespaceId string
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    AutoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    BatchedOperationsEnabled bool
    Boolean flag which controls whether server-side batched operations are enabled.
    DeadLetteringOnMessageExpiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    DefaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    DuplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    EnableBatchedOperations bool
    EnableExpress bool
    EnablePartitioning bool
    ExpressEnabled bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    ForwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    ForwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    Id string
    The provider-assigned unique ID for this managed resource.
    LockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    MaxDeliveryCount int
    Integer value which controls when a message is automatically dead lettered.
    MaxSizeInMegabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    Name string
    PartitioningEnabled bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    RequiresDuplicateDetection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    RequiresSession bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    Status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    NamespaceId string
    NamespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    ResourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    autoDeleteOnIdle String
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    batchedOperationsEnabled Boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    deadLetteringOnMessageExpiration Boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl String
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow String
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations Boolean
    enableExpress Boolean
    enablePartitioning Boolean
    expressEnabled Boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    forwardDeadLetteredMessagesTo String
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo String
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id String
    The provider-assigned unique ID for this managed resource.
    lockDuration String
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount Integer
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes Integer
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name String
    partitioningEnabled Boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    requiresDuplicateDetection Boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession Boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status String
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId String
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    autoDeleteOnIdle string
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    batchedOperationsEnabled boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    deadLetteringOnMessageExpiration boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl string
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow string
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations boolean
    enableExpress boolean
    enablePartitioning boolean
    expressEnabled boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    forwardDeadLetteredMessagesTo string
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo string
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id string
    The provider-assigned unique ID for this managed resource.
    lockDuration string
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount number
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes number
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name string
    partitioningEnabled boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    requiresDuplicateDetection boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status string
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId string
    namespaceName string

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName string

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    auto_delete_on_idle str
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    batched_operations_enabled bool
    Boolean flag which controls whether server-side batched operations are enabled.
    dead_lettering_on_message_expiration bool
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    default_message_ttl str
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicate_detection_history_time_window str
    The ISO 8601 timespan duration during which duplicates can be detected.
    enable_batched_operations bool
    enable_express bool
    enable_partitioning bool
    express_enabled bool
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    forward_dead_lettered_messages_to str
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forward_to str
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id str
    The provider-assigned unique ID for this managed resource.
    lock_duration str
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    max_delivery_count int
    Integer value which controls when a message is automatically dead lettered.
    max_size_in_megabytes int
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name str
    partitioning_enabled bool
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    requires_duplicate_detection bool
    Boolean flag which controls whether the Queue requires duplicate detection.
    requires_session bool
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status str
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespace_id str
    namespace_name str

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resource_group_name str

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    autoDeleteOnIdle String
    The ISO 8601 timespan duration of the idle interval after which the Queue is automatically deleted, minimum of 5 minutes.
    batchedOperationsEnabled Boolean
    Boolean flag which controls whether server-side batched operations are enabled.
    deadLetteringOnMessageExpiration Boolean
    Boolean flag which controls whether the Queue has dead letter support when a message expires.
    defaultMessageTtl String
    The ISO 8601 timespan duration of the TTL of messages sent to this queue. This is the default value used when TTL is not set on a message itself.
    duplicateDetectionHistoryTimeWindow String
    The ISO 8601 timespan duration during which duplicates can be detected.
    enableBatchedOperations Boolean
    enableExpress Boolean
    enablePartitioning Boolean
    expressEnabled Boolean
    Boolean flag which controls whether Express Entities are enabled. An express queue holds a message in memory temporarily before writing it to persistent storage.
    forwardDeadLetteredMessagesTo String
    The name of a Queue or Topic to automatically forward dead lettered messages to.
    forwardTo String
    The name of a Queue or Topic to automatically forward messages to. Please see the documentation for more information.
    id String
    The provider-assigned unique ID for this managed resource.
    lockDuration String
    The ISO 8601 timespan duration of a peek-lock; that is, the amount of time that the message is locked for other receivers.
    maxDeliveryCount Number
    Integer value which controls when a message is automatically dead lettered.
    maxSizeInMegabytes Number
    Integer value which controls the size of memory allocated for the queue. For supported values see the "Queue or topic size" section of Service Bus Quotas.
    name String
    partitioningEnabled Boolean
    Boolean flag which controls whether to enable the queue to be partitioned across multiple message brokers.
    requiresDuplicateDetection Boolean
    Boolean flag which controls whether the Queue requires duplicate detection.
    requiresSession Boolean
    Boolean flag which controls whether the Queue requires sessions. This will allow ordered handling of unbounded sequences of related messages. With sessions enabled a queue can guarantee first-in-first-out delivery of messages.
    status String
    The status of the Queue. Possible values are Active, Creating, Deleting, Disabled, ReceiveDisabled, Renaming, SendDisabled, Unknown.
    namespaceId String
    namespaceName String

    Deprecated: namespace_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    resourceGroupName String

    Deprecated: resource_group_name will be removed in favour of the property namespace_id in version 5.0 of the AzureRM Provider.

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Azure v6.21.0 published on Friday, Mar 7, 2025 by Pulumi
    pulumi/pulumi-azure